# Traer pedidos pagados

`POST https://api.fiscalisto.com/v1/store_connections/{id}/import_orders`

Los pedidos pagados desde una fecha (hasta 31 días, 200 a la vez) que no llegaron por webhook: la tienda se conectó después o estuvo caída. Un pedido que ya es ticket no se repite.

## Parámetros

| Nombre | Dónde | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `id` | ruta | sí | El id del objeto. |
| `Idempotency-Key` | encabezado |  | Opcional (los SDK la mandan solos). Si la respuesta se pierde, repita la solicitud con el mismo valor durante 24 horas: contesta lo mismo, con idempotent-replayed: true, y no lo hace dos veces (ni crea, ni manda correos, ni cobra). |

## Cuerpo

| Campo | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `since` | string |  | Desde qué día (AAAA-MM-DD, hasta 31 días atrás). Por omisión, hace 7 días. |

Ejemplo:

```json
{
  "since": "2026-10-18"
}
```

## Con el SDK de TypeScript

```ts
import { Fiscalisto } from "fiscalisto";

// La llave viene de FISCALISTO_API_KEY.
const fiscalisto = new Fiscalisto();

const storeImport = await fiscalisto.storeConnections.importOrders("id", { since: "2026-10-18" }, { idempotencyKey: "pedido-A-1042" });
```

## Con el SDK de Python

```python
from fiscalisto import Fiscalisto

# La llave viene de FISCALISTO_API_KEY.
fiscalisto = Fiscalisto()

store_import = fiscalisto.store_connections.import_orders("id", {"since": "2026-10-18"}, idempotency_key="pedido-A-1042")
```

## Con el SDK de PHP

```php
<?php

use Fiscalisto\Fiscalisto;

// La llave viene de FISCALISTO_API_KEY.
$fiscalisto = new Fiscalisto();

$storeImport = $fiscalisto->storeConnections->importOrders('id', ['since' => '2026-10-18'], ['idempotency_key' => 'pedido-A-1042']);
```

## Con el SDK de .NET

```csharp
using Fiscalisto;

// La llave viene de FISCALISTO_API_KEY.
var fiscalisto = new FiscalistoClient();

var storeImport = await fiscalisto.StoreConnections.ImportOrdersAsync("id", new ImportStoreOrdersParams { Since = "2026-10-18" }, new RequestOptions { IdempotencyKey = "pedido-A-1042" });
```

## Con el SDK de Go

```go
package main

import (
	"context"
	"fmt"
	"log"

	fiscalisto "fiscalisto.com/go"
)

func main() {
	// La llave viene de FISCALISTO_API_KEY.
	client, err := fiscalisto.NewClient("")
	if err != nil {
		log.Fatal(err)
	}
	ctx := context.Background()

	storeImport, err := client.StoreConnections.ImportOrders(ctx, "id", &fiscalisto.ImportStoreOrdersParams{
		Since: fiscalisto.String("2026-10-18"),
	}, fiscalisto.WithIdempotencyKey("pedido-A-1042"))
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", *storeImport)
}
```

## Con el SDK de Java

```java
import com.fiscalisto.FiscalistoClient;
import com.fiscalisto.RequestOptions;
import com.fiscalisto.model.ImportStoreOrdersParams;

// La llave viene de FISCALISTO_API_KEY.
var fiscalisto = new FiscalistoClient();

var storeImport = fiscalisto.storeConnections().importOrders("id", new ImportStoreOrdersParams().setSince("2026-10-18"), RequestOptions.idempotencyKey("pedido-A-1042"));
System.out.println(storeImport);
```

## Respuesta 200

Correcto.

Un objeto `StoreImport`:

| Campo | Tipo | Siempre viene | Descripción |
| --- | --- | --- | --- |
| `object` | `"store_import"` | sí | Qué tipo de objeto es («invoice», «customer»…). |
| `livemode` | boolean | sí | true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. |
| `store_connection` | string | sí | La conexión (stc_…). |
| `since` | string | sí | Desde qué día se buscaron pedidos. |
| `tickets` | integer | sí | Pedidos que son tickets (los que ya lo eran cuentan otra vez). (de -9007199254740991 a 9007199254740991) |
| `invoiced` | integer | sí | De ellos, los que se facturaron al momento con los datos del comprador. (de -9007199254740991 a 9007199254740991) |
| `skipped` | arreglo de objeto | sí | Los que no se volvieron ticket, con el motivo. |
| `skipped[].order` | string | sí | El pedido. |
| `skipped[].reason` | string | sí | Por qué no se volvió ticket. |

```json
{
  "object": "store_import",
  "livemode": false,
  "store_connection": "stc_OufpKqnrvx9p3Kd8sLm2XyT5uBcW8sKdLx",
  "since": "2026-10-18",
  "tickets": 14,
  "invoiced": 0,
  "skipped": [
    {
      "order": "1042",
      "reason": "está en USD; solo se registran pedidos en pesos."
    }
  ]
}
```

## Errores

Puede responder 400, 401, 403, 404, 429, 500 con el cuerpo de error de siempre; cada código está en https://fiscalisto.com/docs/api/errores.md.