Consultar comprobante

GET /api/v1/facturas/{clave}

Devuelve el estado actual de un comprobante por su clave numérica de 50 dígitos. Usalo para hacer polling del estadoHacienda cuando no tengás webhooks configurados, o para reconciliar tu sistema contra LX CloudPos.

Autenticación

Atributo	Valor
Scope requerido	`facturas:read`
Idempotente	Sí (todos los `GET` lo son)

Path params

Parámetro	Tipo	Descripción
`clave`	`string`	Clave numérica Hacienda de 50 dígitos.

Ejemplo


curl https://api.lxsyscr.com/api/v1/facturas/50615012600310112345600100001010000000123456789012 \
  -H "X-Api-Key: $LXS_API_KEY"

Respuestas

`200 OK`


{
  "clave": "50615012600310112345600100001010000000123456789012",
  "numeroConsecutivo": "00100001010000000123",
  "tipoDocumento": "01",
  "estadoHacienda": "aceptado",
  "totalComprobante": 169.50,
  "moneda": "USD",
  "fechaEmision": "2026-05-15T15:32:11Z"
}

`404 Not Found`

La clave no existe en el tenant de esta API key. Causas comunes:

Error tipográfico en la clave.
La clave pertenece a otro tenant (recordá el aislamiento por tenant).
El comprobante fue eliminado físicamente (caso raro).