Esquema de la factura

Cada elemento del array que se envía a insertar facturas es un objeto factura. Esta página documenta todos sus campos: los obligatorios, los recomendados y los opcionales que Hosana almacena.

Los nombres de los campos respetan exactamente la nomenclatura de Jaremar (mezcla de español y abreviaturas heredadas del AS/400). Respeta mayúsculas y minúsculas tal cual aparecen aquí.

Campos obligatorios

Si falta cualquiera de estos, el batch se rechaza con 422 (validación de estructura).

Campo	Tipo	Descripción
`Nfactura`	string	Número único de la factura. Identifica la factura en todo el sistema.
`NumeroManifiesto`	string\|number	Manifiesto al que pertenece la factura.
`FechaFactura`	string	Fecha de la factura. Ver formatos de fecha y reglas de fecha.
`Almacen`	string	Código de bodega: `OAC`, `OAS` u `OAO`.
`Vendedorid`	string\|number	Identificador del vendedor.
`Clienteid`	string\|number	Identificador del cliente.
`Cliente`	string	Nombre del cliente.
`Total`	number	Importe total de la factura. Debe ser numérico y ≥ 0.
`LineasFactura`	array	Líneas de detalle. No puede estar vacío. Ver esquema de la línea.

Identificadores y numeración

Campo	Tipo	Descripción
`Id`	number\|null	Id interno de la factura en Jaremar (`jaremar_id`).
`NumeroFacturaLX`	string\|null	Número de factura en el sistema LX.
`NumeroPedido`	string\|null	Número de pedido asociado.

Fechas

Campo	Tipo	Descripción
`FechaVencimiento`	string\|null	Fecha de vencimiento (mismos formatos que `FechaFactura`).
`FechaLimImpre`	string\|null	Fecha límite de impresión.

Vendedor y cliente

Campo	Tipo	Descripción
`Vendedor`	string\|null	Nombre del vendedor.
`Rtn`	string\|null	RTN del cliente (registro tributario de Honduras).
`EntregarA`	string\|null	Nombre de quién recibe la entrega.

Dirección de entrega

Campo	Tipo	Descripción
`Depto`	string\|null	Departamento.
`Municipio`	string\|null	Municipio.
`Barrio`	string\|null	Barrio o colonia.
`Direccion`	string\|null	Dirección textual.
`Tel`	string\|null	Teléfono de contacto.
`Longitud`	string\|null	Longitud GPS.
`Latitud`	string\|null	Latitud GPS.
`NumeroRuta`	string\|null	Número de ruta de entrega (se recorta de espacios).

Datos fiscales (CAI / SAR)

Campo	Tipo	Descripción
`Cai`	string\|null	Código de Autorización de Impresión (SAR).
`Rinicial`	string\|null	Rango fiscal inicial.
`Rfinal`	string\|null	Rango fiscal final.
`TipoFactura`	string\|null	Tipo de factura.
`EstadoFactura`	number	Estado de la factura en Jaremar (default `1`).
`DirCasaMatriz`	string\|null	Dirección de la casa matriz.
`DirSucursal`	string\|null	Dirección de la sucursal.

Pago

Campo	Tipo	Descripción
`TipoPago`	string\|null	Tipo de pago (contado/crédito, etc.).
`DiasCred`	number	Días de crédito (default `0`).

Importes e impuestos

Honduras aplica ISV del 15% (general) y 18% (cervezas, alcohol, cigarrillos). El payload separa los importes en gravados, exentos y exonerados. Todos son numéricos y, si se omiten, se asumen 0.

Gravado

Campo	Descripción
`ImporteGrabado`	Importe gravado base.
`ImporteGravado_Desc`	Descuento sobre el gravado.
`ImporteGravado_ISV15`	Gravado sujeto a ISV 15%.
`ImporteGravado_ISV18`	Gravado sujeto a ISV 18%.
`ImporteGravado_Total`	Total gravado.
`Isv15`	Monto de ISV al 15%.
`Isv18`	Monto de ISV al 18%.

Exento

Campo	Descripción
`ImporteExcento`	Importe exento base.
`ImporteExento_Desc`	Descuento sobre el exento.
`ImporteExento_ISV15`	Exento (referencia ISV 15%).
`ImporteExento_ISV18`	Exento (referencia ISV 18%).
`ImporteExento_Total`	Total exento.

Exonerado

Campo	Descripción
`ImporteExonerado`	Importe exonerado base.
`ImporteExonerado_Desc`	Descuento sobre el exonerado.
`ImporteExonerado_ISV15`	Exonerado (referencia ISV 15%).
`ImporteExonerado_ISV18`	Exonerado (referencia ISV 18%).
`ImporteExonerado_Total`	Total exonerado.

Descuentos

Campo	Descripción
`DescuentosRebajas`	Descuentos y rebajas aplicados.