Import history
Upload your key's business's authorized documents from your previous system as multipart/form-data. They are stored and queued: it answers 201 with the import in queued. Retrieve it or wait for the import.completed event. The same files while their import is still running return that import with 200, and so does a repeated Idempotency-Key.
Your API key, which acts for the one business it was created for: fb_sandbox_… issues in sandbox, fb_test_… in test, the tax authority's testing service, and fb_live_… in live.
In: header
Header Parameters
1 <= length <= 255Request Body
multipart/form-data
TypeScript Definitions
Use the request body type in TypeScript.
From 1 to 20 files: authorized or merely signed XML (like those the SRI's Facturador downloads), ZIPs of XML, or text with access keys (the Facturador listing or the issued-documents report from the SRI's online portal, saved as text or CSV). A listed key confirms the signed XML of that key, in this import or an earlier one. A PDF will not do: the RIDE proves nothing. Neither will an Excel sheet: save it as CSV.
Response Body
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"}Email purchase settlement POST
Queues an email with the RIDE and the authorized XML. In every environment the document is already sent on its own when it is authorized, to its recipient; this send is for resending it, to its recipient or to the addresses you give.
List imports GET
Your key's business's imports in its environment, from newest to oldest.