Fiscalbase
PlataformaEstado de la API
GuíasReferencia de la API
Importaciones

Listar importaciones

GET
/v1/ec/imports

De la más reciente a la más antigua, en el ambiente de tu clave.

Autorización

AutorizaciónBearer <tu clave API>

Tu clave API: fb_sandbox_… emite en Sandbox, fb_test_… en test, el servicio de pruebas de la autoridad tributaria, y fb_live_… en live, su producción.

En: header

Parámetros de consulta

limit?integer

Cuántos por página, de 1 a 100.

Rango1 <= value <= 100
Por defecto20
cursor?string

El next_cursor o el prev_cursor de una respuesta anterior. Sin cursor, la primera página.

Longitudlength <= 200
status?string

Valores posibles

  • "queued"
  • "processing"
  • "completed"
  • "failed"
  • "canceled"
entity_id?string

Solo las importaciones de este negocio; sin él, las de todos los de tu organización en este ambiente.

Formatouuid

Cuerpo de la respuesta

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/ec/imports"
{  "object": "list",  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "object": "import",      "country": "ec",      "environment": "sandbox",      "entity_id": "8161163a-f227-466f-bc01-090a01e80165",      "status": "queued",      "status_transitions": {        "queued": "2019-08-24T14:15:22Z",        "processing": "2019-08-24T14:15:22Z",        "completed": "2019-08-24T14:15:22Z",        "failed": "2019-08-24T14:15:22Z",        "canceled": "2019-08-24T14:15:22Z"      },      "files": [        {          "name": "string",          "kind": "xml",          "size": 0,          "sha256": "string",          "ignored_entries": 0        }      ],      "counts": {        "found": 0,        "pending": 0,        "imported": 0,        "duplicate": 0,        "skipped": 0,        "failed": 0      },      "verification": {        "sri": 0,        "listed": 0,        "signature": 0,        "unconfirmed": 0      },      "currency": "string",      "sales_total": "string",      "upgraded": {        "signature": 0,        "unconfirmed": 0      },      "numbering": [        {          "series_id": "0f6582ac-1e7e-41dc-a63a-24fccd074d0c",          "document_type": "invoice",          "establishment": "string",          "emission_point": "string",          "highest_imported": 0,          "highest_reserved": 0,          "next_number": 0,          "active": true,          "created": true        }      ],      "failure": {        "code": "unreadable_archive",        "message": "string"      },      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z"    }  ],  "next_cursor": "string",  "prev_cursor": "string"}

Importar historial POST

Sube los comprobantes autorizados de tu sistema anterior como `multipart/form-data`. Se guardan y se encolan: responde `201` con la importación `queued`. Consúltala o espera el evento `import.completed`. Los mismos archivos mientras su importación sigue en curso devuelven esa importación con `200`, y también un `Idempotency-Key` repetido.

Consultar una importación GET

La importación con su estado, los archivos que subiste y cuántos comprobantes se encontraron, importaron, repitieron, omitieron o fallaron. Para ver cuál le pasó qué a cada uno usa `GET /v1/ec/imports/{id}/items`.