Consultar Estado

La emisión de comprobantes electrónicos con Factio y el SRI es siempre asíncrona. En el proceso de autorización, los tiempos de respuesta del SRI varían entre segundos y, en situaciones de alta carga, minutos o largas demoras intermitentes.

Polling (Consulta bajo demanda)

Puedes consultar el estado actual del comprobante en cualquier momento haciendo un request GET a /documents/{id}.

Petición

curl -X GET https://api.staging.factioapp.com/documents/doc_01HZ3K... \
  -H "X-API-Key: fct_test_TU_API_KEY_AQUI"

Respuesta del estado

Dependiendo del momento en que consultes, verás diferentes estados en el campo status. Un documento sigue típicamente el flujo: DRAFT ➔ SUBMITTED_TO_SRI ➔ AUTHORIZATION_PENDING ➔ AUTHORIZED o REJECTED. Ejemplo de un documento AUTHORIZED:

{
  "id": "doc_01HZ3K...",
  "status": "AUTHORIZED",
  "authorization_number": "1501202401179214673900110010010000000051234567812",
  "authorization_date": "2024-01-15T15:30:00Z",
  "document_type": "01",
  "total": "115.00",
  "artifacts": {
    "xml_url": "https://api.staging.factioapp.com/documents/doc_01HZ.../xml",
    "pdf_url": "https://api.staging.factioapp.com/documents/doc_01HZ.../ride"
  }
}

Una vez que el documento pasa a AUTHORIZED, Factio generará automáticamente las URLs de descarga del XML firmado oficial y la Representación Impresa (PDF).

Webhooks

Evita realizar “polling” constante y permite que Factio notifique activamente a tu sistema (ERP / CRM) enviando un POST request en el instante exacto en que tu documento alcance el estado final de AUTHORIZED o REJECTED. Consulta la sección de Webhooks para más detalles en la implementación y verificación de firmas de seguridad.

Introducción

Conceptos clave

Guías

Consultar Estado

Polling (Consulta bajo demanda)

Petición

Respuesta del estado

Webhooks

​Polling (Consulta bajo demanda)

​Petición

​Respuesta del estado

​Webhooks

Polling (Consulta bajo demanda)

Petición

Respuesta del estado

Webhooks