FacturaCompraApiEmisorDto

Identifica al proveedor — quien fiscalmente figura como emisor del comprobante, aunque su generación y su envío a Hacienda los realice el integrador.


interface FacturaCompraApiEmisorDto {
  /** ID del proveedor existente en el catálogo del tenant. Si se proporciona,
      los demás campos se ignoran. */
  idEmisor?: number | null;
 
  /** Identificación (cédula) del proveedor. Alternativa a idEmisor: 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;
 
  /** Nombre. Obligatorio si se da de alta por identificación. */
  nombre?: string | null;
 
  /** Apellidos (persona física). */
  apellidos?: string | null;
 
  /** Nombre comercial, si aplica. */
  nombreComercial?: string | null;
 
  /** Email del proveedor. */
  correo?: string | null;
 
  /** Teléfono con código país. */
  telefono?: string | null;
 
  /** Código de actividad económica del proveedor. Solo se usa al darlo de alta:
      va al CodigoActividadEmisor del XML. En un proveedor ya existente no se
      cambia por acá — se edita desde el POS. */
  codigoActividadEmisor?: string | null;
}

Campos

Campo	Tipo	Requerido	Descripción
`idEmisor`	`number`	Uno de los dos	ID del proveedor 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 proveedor. 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	Nombre del proveedor.
`apellidos`	`string`	Opcional	Apellidos, cuando es persona física.
`nombreComercial`	`string`	Opcional	Nombre comercial, si aplica.
`correo`	`string`	Opcional	Email del proveedor.
`telefono`	`string`	Opcional	Teléfono con código de país.
`codigoActividadEmisor`	`string`	Opcional	Actividad económica del proveedor. Solo se usa al darlo de alta.

Modos de uso

Modo A — Proveedor existente (recomendado)


{ "idEmisor": 15 }

Igual que cliente.idCliente en ventas (ver FacturaApiClienteDto): busca por ID en el catálogo del tenant. Si no existe, 400.

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


{
  "identificacion": "1-0234-0567",
  "tipoIdentificacion": "01",
  "nombre": "Juan",
  "apellidos": "Pérez Solano",
  "correo": "juan.perez@correo.cr",
  "telefono": "88001122",
  "codigoActividadEmisor": "011101"
}

Si ya existe un proveedor con esa identificación en el tenant, se reusa — no se duplica ni se actualizan sus datos.
Si no existe, se da de alta. tipoIdentificacion y nombre pasan a ser obligatorios; sin ellos, 400.
El teléfono y el correo se validan y normalizan igual que en el POS. Un formato inválido es 400.
Hacienda valida la identificación del proveedor de forma independiente. Que el alta se complete en LX CloudPos no garantiza que Hacienda la reconozca: si la cédula no existe en su padrón, el comprobante resulta rechazado.