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;
 
  /** Identificación (cédula) del receptor. Alternativa a idCliente: se busca en el
      tenant y, si no existe, se da de alta con los campos de abajo. */
  identificacion?: string | null;
 
  /** Tipo de identificación. Ver catálogo Hacienda. Obligatorio si se da de alta
      por identificación. */
  tipoIdentificacion?: 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

Campo	Tipo	Requerido	Descripción
`idCliente`	`number`	Uno de los dos	ID del cliente existente en el catálogo del tenant. Si está presente, los demás campos se ignoran.
`identificacion`	`string`	Uno de los dos	Cédula del receptor. Se busca en el tenant y, si no existe, se da de alta.
`tipoIdentificacion`	`string`	Si se da de alta	Tipo de identificación según catálogo Hacienda.
`nombre`	`string`	Si se da de alta	Razón social o nombre completo.
`correo`	`string`	Opcional	Email al que se enviará el comprobante automáticamente.
`telefono`	`string`	Opcional	Telé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. Si no existe, 400.

Modo B — Por identificación, con alta automática


{
  "identificacion": "3-101-123456",
  "tipoIdentificacion": "02",
  "nombre": "Comercializadora Ejemplo S.A.",
  "correo": "facturas@ejemplo.cr",
  "telefono": "22001100"
}

Es el modo previsto para integradores: no se requiere conocer los identificadores internos de LX CloudPos.

Si ya existe un cliente con esa identificación en el tenant, se reusa — no se duplica ni se actualizan sus datos. Su modificación se realiza desde el POS.
Si no existe, se da de alta con los datos enviados. tipoIdentificacion y nombre pasan a ser obligatorios; en su ausencia se devuelve un 400 que indica exactamente cuál falta.
El teléfono y el correo se validan y normalizan igual que en el POS. Un correo mal formado produce un 400, en lugar de un comprobante que Hacienda acepta y el cliente nunca recibe.
El cliente se crea con paga_timbre en falso. Si a ese cliente le corresponde timbre, debe ajustarse desde el POS: no es un valor que se asuma en un alta automática.