Examples by country

📄 Invoicing lifecycle

Invoice issuance lifecycle

Argentina has a synchronous invoicing system: when you issue a document, FACTO requests its authorization from ARCA (WSFE web service) in the same call, and the response already includes the result. If ARCA authorizes it, the document is approved with its CAE (Electronic Authorization Code); if ARCA rejects it, the response includes the reason.

You can check the status of a document with GET /documents/{document_id}, reading the fields shown in each step.

Get document

• Endpoint: https://apifacto.com/v1/documents/{document_id}

1) Draft

{
    "header": {
        "document_status": 0
    }
}

The document is saved but not authorized: it has no CAE. It may be a document that has not been issued yet or one that ARCA rejected (see 2B).

2) Approved by the tax authority (ARCA)

{
    "header": {
        "document_status": 1,
        "taxbureau_validation_status": 3,
        "cae": "86123456789012",
        "cae_expiration_date": "YYYY-MM-DD"
    }
}

ARCA authorized the document and its lifecycle is complete; no further action is required.

• cae: Electronic Authorization Code issued by ARCA. It is also printed on the PDF next to the QR code.
• cae_expiration_date: CAE expiration date.
• In the GET /documents list, an approved document also shows taxbureau_sending_status: 1 (sent to ARCA).

Note: Argentina has no intermediate "issued, pending validation" status: the authorization arrives in the same response as the issuance.

2B) Rejected by the tax authority (ARCA)

When ARCA rejects the document, the issuance response returns the draft document (document_status 0) with its document_id, and result has status: 2 with the ARCA details in error_message:

{
    "document_id": 786,
    "header": {
        "document_number": 99998,
        "document_status": 0
    },
    "result": {
        "status": 2,
        "error_message": "Document generated but could not be sent to the Tax bureau - Error code: 10016 - description : El numero o fecha del comprobante no se corresponde con el proximo a autorizar. Consultar metodo FECompUltimoAutorizado. -"
    }
}

• If ARCA rejects the request (for example, a non-sequential number or a point of sale that is not enabled), the error appears as Error code: <code> - description : <description>.
• If ARCA processes the request and rejects the document (Result R), each observation appears as Error: Code : <code> Description : <description>. There may be several in the same message.
• The document is not authorized: it has no CAE and ARCA does not register it. In FACTO it remains as a draft (document_status 0) with the document_id from the response.
• If you sent document_number, the draft keeps that number.

What to do: fix the data indicated by ARCA and issue the document again with a new POST /documents. If the rejection was due to the number (10016), look up in ARCA the last authorized number for that point of sale and document type and send the next one in document_number. The most frequent rejections and how to solve them are listed in Common errors.