Skip to Content
v1.5Documentación oficial de la API LX CloudPos · estable en producción
V1WebhooksEventos disponibles

Eventos disponibles

hacienda.estado

Es el único evento publicado en v1. Se dispara cuando Hacienda resuelve un comprobante emitido vía API.

Cuándo se emite:

  • Comprobante aceptado → estado final positivo; el comprobante puede entregarse al cliente.
  • Comprobante rechazado → estado final negativo; debe consultarse el campo mensaje para conocer el motivo.

La implementación del receptor debe ser tolerante a eventos futuros desconocidos: la recepción de un evento no reconocido nunca debe provocar un fallo; basta con registrarlo en la bitácora y descartarlo.

if (evento.evento === 'hacienda.estado') { procesarEstadoHacienda(evento); } else { // Log y descartar — no fallar console.warn('Evento desconocido:', evento.evento); }

Eventos futuros (roadmap)

  • comprobante.emitido — al momento del POST del comprobante.
  • comprobante.anulado — al anular vía DELETE.
  • comprobante.error — cuando falla técnicamente el envío a Hacienda.

Importante: Estos nombres pueden cambiar antes del release. Aún no deben incorporarse de forma fija en el código.