Consulta, XML y RIDE

Todo lo que emites, sea del tipo que sea, vive bajo /v1/comprobantes.

El estado de uno

curl -s https://api-test.facto.lat/v1/comprobantes/$ID \
  -H "x-api-key: $LLAVE"

{
  "id": "42de1d6f-98d5-48b6-b81e-03e75c62b984",
  "claveAcceso": "1108202601099999999900110010010000000018190265919",
  "estado": "AUTORIZADO",
  "numeroComprobante": "001-001-000000001",
  "fechaEmision": "11/08/2026",
  "importeTotal": "115.00",
  "numeroAutorizacion": "1108202601099999999900110010010000000018190265919",
  "fechaAutorizacion": "2026-08-11T22:56:17.000Z",
  "mensajes": []
}

Los estados

Estado	Qué significa
FIRMADO	Generado y firmado; en cola hacia el SRI
ENVIANDO	En camino
RECIBIDA	El SRI aceptó procesarlo — todavía no es un veredicto
AUTORIZADO	Veredicto final: válido tributariamente
NO_AUTORIZADO	Veredicto final: rechazado — mensajes[] dice por qué y qué hacer
DEVUELTA	Rechazado en recepción — mensajes[] trae el motivo
FALLIDO	Fallo interno tras agotar reintentos; el operador lo reanuda

mensajes[] trae la respuesta del SRI textual más una guia con qué hacer y quién puede arreglarlo.

¿Perdiste el id? La clave de acceso siempre vuelve

La clave de acceso está impresa en el RIDE y toda consulta tiene su variante:

curl -s https://api-test.facto.lat/v1/comprobantes/clave-acceso/{los-49-digitos} \
  -H "x-api-key: $LLAVE"

El listado, para reconciliar

curl -s "https://api-test.facto.lat/v1/comprobantes?desde=01/08/2026&hasta=31/08/2026&estado=AUTORIZADO" \
  -H "x-api-key: $LLAVE"

Filtra por fechas, estado y tipo. La paginación va por cabeceras: X-Total-Count con el total y Link con las páginas siguiente y anterior. Es la herramienta para el cierre del mes: «todo lo de agosto que quedó autorizado».

XML y RIDE

curl -s https://api-test.facto.lat/v1/comprobantes/$ID/xml  -H "x-api-key: $LLAVE" -o comprobante.xml
curl -s https://api-test.facto.lat/v1/comprobantes/$ID/ride -H "x-api-key: $LLAVE" -o comprobante.pdf

El XML autorizado es el documento con validez tributaria — el que se archiva 7 años. El RIDE es su representación impresa. Ambos salen también por clave de acceso.

¿Logo en el RIDE? Se sube una vez por emisor:

curl -X PUT https://api-test.facto.lat/v1/emisores/0999999999001/logo \
  -H "x-api-key: $LLAVE" -F "logo=@mi-logo.png"

Relacionados

curl -s https://api-test.facto.lat/v1/comprobantes/$ID/relacionados \
  -H "x-api-key: $LLAVE"

Las notas de crédito y débito que corrigen a un comprobante, con su estado. La historia completa de una factura en una llamada.