Skip to main content

How Transfer works

Transfer processes your uploaded files, converts them when needed, and sends the documents to the destination API. It records whether that API accepted or rejected each document.

Your ERP uploads a file, such as a CSV, through SFTP or the API. Transfer turns the upload into one document per invoice and sends each document to the A-Cube e-invoicing API, which delivers it to the government platform.Your ERP uploads a file, such as a CSV, through SFTP or the API. Transfer turns the upload into one document per invoice and sends each document to the A-Cube e-invoicing API, which delivers it to the government platform.

Key terms​

These terms appear throughout the Transfer docs and in the tracking API.

TermMeaning
UploadOne file you send to Transfer, through SFTP or the REST API.
DocumentEach invoice Transfer sends to the destination, with its own status. A CSV with three invoices is one upload and three documents.
End-to-end IDYour own identifier for one document sent to the destination (e2e_id), unique in your account, stored exactly as you send it and searchable.

The tracking API also lists the CSV file itself, so it can report problems found while reading it.

The flow​

  1. Upload a file to your home directory through SFTP or the REST API.
  2. Transfer checks the file extension. Unsupported extensions and files in ignored/ or supplier/ directories are skipped. See Troubleshooting.
  3. Transfer prepares the documents:
    • CSV: converted into one document per invoice.
    • Native XML in the destination format: sent as it is.
    • ZIP or P7M: Transfer opens the archive and processes the files inside. The archive is not tracked as a document.
    • UBL invoice: converted to the destination format, where A-Cube configured it (on request).
  4. Transfer sends each document to A-Cube's service for the destination.
  5. Transfer records the result on each document. Failed documents include violations. The upload status summarizes these results.

Feedback on every document​

The A-Cube e-invoicing API accepts or rejects each document. Accepted documents become transmitted, rejected ones failed with violations. The upload status summarizes them: completed, partial or failed.The A-Cube e-invoicing API accepts or rejects each document. Accepted documents become transmitted, rejected ones failed with violations. The upload status summarizes them: completed, partial or failed.

Each document ends as transmitted, when the A-Cube e-invoicing API accepts it, or failed, with violations that tell you what to fix. An invoice in a CSV can also fail before it is sent, when a value cannot be converted: its violations are reported on the CSV file.

Processing is asynchronous. An upload stays ingested until its documents reach a final status, then becomes completed, partial, or failed. Read the results through the tracking API, the dashboard, or an email digest and daily report (on request).

On request, Transfer webhooks notify your application of processing success or failure, with coverage confirmed during onboarding. For complete API examples, follow UBL JSON to KSeF or CSV to SdI.

From your ID to the destination API​

Give each invoice your own End-to-end ID. You can then find its document in Transfer and reach it in A-Cube's e-invoicing API for that country, without storing any Transfer ID.

Upload a file with your e2e_id. Find the document by e2e_id in the Transfer API to get its transmission_uuid. Use the transmission_uuid in the A-Cube e-invoicing API of the country to read the status and the outcome from the government platform.Upload a file with your e2e_id. Find the document by e2e_id in the Transfer API to get its transmission_uuid. Use the transmission_uuid in the A-Cube e-invoicing API of the country to read the status and the outcome from the government platform.
  1. Upload the file with your End-to-end ID. See Where the End-to-end ID comes from.
  2. GET /target-documents?e2e_id=<your-id> finds the document once Transfer has created it. GET /target-documents/download?e2e_id=<your-id> downloads its file. See Find a document by End-to-end ID.
  3. On a document sent to the destination, transmission_uuid is the document's identifier in the destination API. Use it there to read the document and its later outcome.

Each destination page names the API call.

Where the End-to-end ID comes from​

What you uploadSource of the End-to-end ID
A file with one invoice, through the REST APIThe e2e_id field of POST /uploads.
A CSV, through SFTP or the REST APIA column of your CSV that A-Cube configures on request. For an invoice on several rows, the value of its first row counts.
A ZIP, through SFTP or the REST APIAn index.csv file inside the ZIP, with the header file_name,e2e_id and one row for each file of the archive. A-Cube activates it on request.

POST /uploads refuses e2e_id with 422 for a CSV or ZIP file, signed or not: one ID cannot name several invoices.

An End-to-end ID has up to 255 printable ASCII characters, with no leading or trailing space. When your CSV has an End-to-end ID column, every invoice needs a valid value, and a value can appear on only one invoice of the file. Otherwise Transfer rejects the whole CSV with CSV_E2E_ID_INVALID and sends none of its invoices.

When the index is active, index.csv is UTF-8 and lists every file of the ZIP exactly once, with a valid End-to-end ID, and a value can appear on only one file. Otherwise Transfer rejects the whole ZIP and sends none of its files: for example when index.csv is missing, a file has no row, or a row names a file that is not in the ZIP. index.csv itself is not sent.

One ID, one document​

An End-to-end ID names one document in your account and is never reused. It is taken when Transfer creates the document, even if the destination rejects that document later. If the file fails before the document exists, the ID stays free.

  • POST /uploads returns 409 with type /errors/e2e_id_already_used when one of your documents already has the ID. Transfer does not store the file.
  • If two uploads carry the same ID before either document exists, for example the same CSV sent twice, Transfer sends only the first document. The second is not sent: it ends failed, with transmission_outcome error, the violation E2E_ID_ALREADY_USED and no e2e_id. Its upload becomes partial or failed.
  • The webhook for that refused document has status: "failure" and code: "E2E_ID_ALREADY_USED". It reports the refused send, not the document that owns the ID: do not mark that one as failed.

To send a corrected invoice after its document failed, give it a new End-to-end ID.

Where Transfer's job ends​

transmitted means that A-Cube's service for the destination accepted the document. What happens next, such as a tax authority rejection, does not change the Transfer status. See Statuses and where to see them for every status.

Environments​

Use sandbox for testing and production for real documents. A-Cube grants access to each environment separately.

  • SFTP uses one host for both environments. Add -sandbox to your username to select sandbox.
  • The REST API has one base URL for each environment.

Start with Onboarding and access to activate Transfer for your account, then send your first file with the Quickstart SFTP. Connection details are in the SFTP and REST API guides.