¿Qué es un comprobante electrónico?
Un comprobante electrónico en Costa Rica es un documento digital (XML firmado) que:
- Representa una transacción comercial (venta, devolución, ajuste).
- Está validado por Hacienda.
- Tiene valor fiscal y legal equivalente a un documento impreso.
- Sigue el esquema oficial v4.4 (vigente desde 2023-06).
Por qué importa esto en la integración
- No puedes inventar números — la clave y el consecutivo siguen reglas estrictas.
- El XML debe estar firmado con un certificado P12 vigente del emisor.
- Hacienda valida estructura, montos, totales, IVA e identificación del receptor.
- Un comprobante rechazado no tiene valor fiscal — debes corregir y reemitir.
Componentes mínimos de un comprobante
| Componente | Quién lo provee |
|---|---|
| Emisor (datos del tenant) | Configurado en LX CloudPos |
| Receptor (cliente) | Tú lo envías (cliente.idCliente o detalle) |
| Detalle (líneas) | Tú lo envías (lineas[]) |
| Resumen (totales, impuestos) | LX CloudPos los calcula |
| Clave | LX CloudPos la genera |
| Consecutivo | LX CloudPos lo incrementa |
| Firma XAdES | LX CloudPos la aplica |
| Confirmación Hacienda | Hacienda la emite |