Skip to Content
v1.0Documentación oficial de la API LX CloudPos · estable en producción
V1FundamentosBienvenida

Bienvenida

La API REST de LX CloudPos te permite emitir comprobantes electrónicos válidos en Costa Rica (Factura Electrónica, Tiquete Electrónico, Notas de Crédito y Débito) directamente desde tu sistema, sin tener que ingresar al POS web ni gestionar la integración con Hacienda manualmente.

La API se encarga, transparentemente, de:

  • 🔢 Generar la clave de 50 dígitos y el consecutivo según el algoritmo oficial.
  • 📄 Construir el XML v4.4 conforme al esquema actual de Hacienda CR.
  • ✍ Firmar el XML con tu certificado XAdES y credenciales registradas.
  • Enviar a Hacienda, manejar reintentos y procesar el callback.
  • 📨 Notificarte por webhook cuando el estado final llegue (aceptado/rechazado).
  • 💾 Almacenar PDF y XML firmado para descarga posterior.
  • 📧 Enviar el comprobante al correo del cliente automáticamente o bajo demanda.

💡 Tu responsabilidad se reduce a: armar el cuerpo JSON con los datos del comprobante, hacer un POST, y procesar el webhook cuando llegue.