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

FacturaApiClienteDto

Identifica al receptor del comprobante. Es obligatorio para FE, NC y ND; opcional para TE.

interface FacturaApiClienteDto { /** ID del cliente existente. Si se proporciona, los demás campos se ignoran. */ idCliente?: number | null; /** Tipo de identificación. Ver catálogo Hacienda. Usado solo si idCliente=null. */ tipoIdentificacion?: string | null; /** Número de cédula/identificación. */ identificacion?: string | null; /** Razón social o nombre completo. */ nombre?: string | null; /** Email para enviar el comprobante automáticamente. */ correo?: string | null; /** Teléfono con código país. */ telefono?: string | null; }

Campos

CampoTipoRequeridoDescripción
idClientenumberRecomendadoID del cliente existente en el catálogo del tenant. Si está presente, los demás campos se ignoran.
tipoIdentificacionstringOpcionalTipo de identificación según catálogo Hacienda. Se usa solo cuando idCliente es null.
identificacionstringOpcionalNúmero de cédula o identificación del receptor.
nombrestringOpcionalRazón social o nombre completo.
correostringOpcionalEmail al que se enviará el comprobante automáticamente.
telefonostringOpcionalTeléfono con código de país.

Modos de uso

Modo A — Cliente existente (recomendado)

{ "idCliente": 42 }

LX CloudPos busca el cliente por ID en el catálogo del tenant.

Modo B — Cliente ad hoc (no implementado en v1)

⚠ Actualmente solo se soportan clientes existentes. Para crear un cliente nuevo, usá la API de catálogo (disponible en una versión futura).