Importaciones

Importar historial

POST
/v1/ec/imports

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.

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

Encabezados

idempotency-key?string
Longitud1 <= length <= 255

Cuerpo de la solicitud

multipart/form-data

Tipos de TypeScript

Usa el tipo request body en TypeScript.

file*array<>

De 1 a 20 archivos: XML autorizados o solo firmados (como los que descarga el Facturador del SRI), ZIP de XML, o texto con claves de acceso (el listado del Facturador o el reporte de emitidos de SRI en línea, guardados como texto o CSV). Una clave listada confirma el XML firmado de esa clave, en esta importación o en una anterior. Un PDF no sirve: el RIDE no prueba nada. Una hoja de Excel tampoco: guárdala como CSV.

entity_id?string

Obligatorio si la organización tiene varias entidades.

Formatouuid

Cuerpo de la respuesta

application/json

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/ec/imports" \  -F file="[    \"string\"  ]"
{  "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"}