Ejemplos por país

📄 Ciclo de facturación

Ciclo de vida de la emisión de facturas

Argentina tiene un sistema de facturación sincrónico: al emitir, FACTO solicita la autorización a ARCA (web service WSFE) en la misma llamada y la respuesta ya trae el resultado. Si ARCA autoriza, el comprobante queda aprobado con su CAE (Código de Autorización Electrónico); si lo rechaza, la respuesta trae el motivo.

Puede revisar el estado de un documento con GET /documents/{document_id} leyendo los campos que se indican en cada paso.

Consultar documento

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

1) Borrador

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

El documento está guardado sin autorizar: no tiene CAE. Puede ser un documento que aún no se emite o uno que ARCA rechazó (ver 2B).

2) Aprobado por la autoridad tributaria (ARCA)

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

ARCA autorizó el comprobante y el documento completó su ciclo; no se requiere ninguna acción adicional.

• cae: Código de Autorización Electrónico entregado por ARCA. También se imprime en el PDF junto al código QR.
• cae_expiration_date: fecha de vencimiento del CAE.
• En el listado GET /documents, el documento aprobado además muestra taxbureau_sending_status: 1 (enviado a ARCA).

Nota: en Argentina no existe el estado intermedio "emitido, pendiente de validación": la autorización llega en la misma respuesta de la emisión.

2B) Rechazado por la autoridad tributaria (ARCA)

Cuando ARCA rechaza el comprobante, la respuesta de la emisión trae el documento en borrador (document_status 0) con su document_id, y en result el status: 2 con el detalle de ARCA en 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. -"
    }
}

• Si ARCA rechaza la solicitud (por ejemplo, número no correlativo o punto de venta no habilitado), el error aparece como Error code: <código> - description : <descripción>.
• Si ARCA procesa la solicitud y rechaza el comprobante (Resultado R), cada observación aparece como Error: Code : <código> Description : <descripción>. Puede haber varias en el mismo mensaje.
• El comprobante no queda autorizado: no tiene CAE y ARCA no lo registra. En FACTO queda como borrador (document_status 0) con el document_id de la respuesta.
• Si envió document_number, el borrador conserva ese número.

Qué hacer: corrija el dato que indica ARCA y emita nuevamente el documento con un nuevo POST /documents. Si el rechazo fue por el número (10016), consulte en ARCA el último número autorizado para ese punto de venta y tipo de comprobante y envíe el siguiente en document_number. Los rechazos más frecuentes y cómo resolverlos están en Errores comunes.