Prerrequisitos
Requisitos previos
- Los datos fiscales del emisor — el contribuyente que factura debe entregarlos para dar de alta el tenant: certificado P12, credenciales de Hacienda y actividades económicas. Sin ellos no puede emitirse ningún comprobante. Ver el detalle más abajo.
- Una API key activa — debe solicitarse al administrador de la cuenta LX CloudPos desde el módulo “Integraciones” del CRM.
- Conocimiento básico de HTTP y JSON — esta API es REST estándar.
- Capacidad de realizar peticiones HTTPS salientes desde la infraestructura del integrador.
- Un endpoint HTTPS público si se van a recibir webhooks (opcional pero recomendado).
- Conocer la lógica de Hacienda — al menos a nivel general (qué es una FE, un TE, una NC y una ND). Esta guía cubre lo necesario.
Datos que debe aportar el emisor
La facturación electrónica se realiza a nombre del contribuyente, con su identidad fiscal ante Hacienda. Esos datos son suyos y solo él puede entregarlos: LX CloudPos no puede generarlos ni sustituirlos. Se registran una sola vez, al dar de alta el tenant, y son condición para la primera emisión.
| Dato | Detalle |
|---|---|
| Certificado P12 | El certificado de firma digital que Hacienda emite a nombre del contribuyente, junto con su PIN. Con él se firma cada comprobante. |
| Credenciales del ATV | Usuario y contraseña del portal de Hacienda, con los que la plataforma envía los comprobantes y consulta su resolución. |
| Identificación del contribuyente | Cédula física o jurídica, y la razón social o el nombre con que figura ante Hacienda. |
| Actividades económicas | Las que el contribuyente tenga inscritas, indicando cuál es la principal. Determinan el codigoActividad con que se emite — ver Actividades. |
| Datos de contacto | Correo y teléfono del emisor, que se incluyen en el XML del comprobante. |
El registro se realiza desde el POS, no por la API: ninguno de estos datos viaja en los requests. Una vez configurados, su uso es automático — cada comprobante se firma y se envía con las credenciales del tenant, sin intervención del integrador.
El certificado vence. Cuando expira, toda emisión del tenant empieza a fallar con estado
error. El certificado renovado debe aportarse antes del vencimiento, y su gestión ante Hacienda es responsabilidad del emisor.
Lo que NO se requiere
- Enviar el certificado P12 en cada llamada — se registra una vez en el tenant y la API no lo recibe como parámetro.
- Implementar la firma XAdES — se aplica del lado de LX CloudPos, de forma transparente para el integrador.
- Conocimiento de XML — la API recibe y devuelve JSON.
- Acceso a base de datos — toda la operación se realiza vía REST.
Herramientas útiles
- cURL — para pruebas rápidas (incluido en macOS/Linux, de instalación sencilla en Windows).
- Postman / Insomnia — para colecciones de pruebas.
- httpie — alternativa a cURL más legible.
- jq — para procesar JSON en línea de comandos.
- ngrok / Cloudflare Tunnel — para exponer webhooks locales en desarrollo.