Enum TipoComprobanteApi

Identifica el tipo de comprobante electrónico a emitir. En el request se envía el nombre del enum; en el response, LX CloudPos devuelve el código numérico Hacienda equivalente.


enum TipoComprobanteApi {
  FacturaElectronica = "FacturaElectronica",     // mapea a tipo Hacienda "01"
  NotaDebito         = "NotaDebito",             // "02"
  NotaCredito        = "NotaCredito",            // "03"
  TiqueteElectronico = "TiqueteElectronico"      // "04"
}

Valor en `request`	Código Hacienda en `response`	Descripción
`FacturaElectronica`	`01`	Factura electrónica (FE) — requiere cliente identificado.
`NotaDebito`	`02`	Nota de débito (ND) — requiere referencia a un comprobante previo.
`NotaCredito`	`03`	Nota de crédito (NC) — requiere referencia a un comprobante previo.
`TiqueteElectronico`	`04`	Tiquete electrónico (TE) — cliente opcional.

La asimetría (string en el request, código en el response) es intencional: mantiene consistencia con el resto del ecosistema fiscal costarricense, que usa los códigos 01–04.

También se acepta el ordinal del enum (1 FE, 2 ND, 3 NC, 4 TE) por compatibilidad. Debe advertirse que ese ordinal no es el código de Hacienda y se presta a confusión, por lo que se recomienda utilizar siempre el nombre.

La factura electrónica de compra (08) no está en este enum: se emite por su propio endpoint, con su propio DTO.