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

Bienvenida

La API REST de LX CloudPos 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 el sistema del integrador, sin necesidad de ingresar al POS web ni de gestionar manualmente la integración con Hacienda.

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 el certificado XAdES y las credenciales registradas.
  • Enviar a Hacienda, manejar reintentos y procesar el callback.
  • Notificar 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.

La responsabilidad del integrador se reduce a: componer el cuerpo JSON con los datos del comprobante, realizar un POST y procesar el webhook cuando llegue.