Esquema de la línea

Cada factura lleva un arreglo LineasFactura con sus líneas de detalle. No puede estar vacío. Esta página documenta cada campo de la línea y la lógica de conversión entre cajas y unidades, que es clave para que las cantidades cuadren con las devoluciones.

Campos obligatorios

Si falta cualquiera de estos en una línea, el batch se rechaza con 422.

Campo	Tipo	Descripción
`NumeroLinea`	number\|string	Número de línea dentro de la factura.
`ProductoId`	string	Identificador del producto.
`ProductoDesc`	string	Descripción del producto.
`Total`	number	Importe total de la línea.

Identificadores

Campo	Tipo	Descripción
`Id`	number\|null	Id de la línea en Jaremar (`jaremar_line_id`).
`InvoiceId`	number\|null	Id de la factura en Jaremar al que pertenece la línea.

Producto

Campo	Tipo	Descripción
`TipoProducto`	string\|null	Tipo de producto (p. ej. `CJ` para caja, `UN` para unidad).
`UniVenta`	string\|null	Unidad de venta.

Cantidades y conversión

Aquí está la parte delicada. Jaremar maneja productos que se venden por caja y productos que se venden por unidad/fracción, y el FactorConversion relaciona ambos.

Campo	Tipo	Descripción
`CantidadCaja`	number	Cantidad en cajas.
`CantidadFracciones`	number	Cantidad en fracciones/unidades.
`CantidadDecimal`	number	Cantidad con decimales (si aplica).
`CantidadUnidadMinVenta`	number	Cantidad en la unidad mínima de venta.
`FactorConversion`	number	Cuántas fracciones contiene una caja. Mínimo efectivo: `1`.

Para productos por caja (CJ), Jaremar normalmente envía CantidadFracciones: 0 y CantidadCaja > 0. En ese caso, Hosana deriva las fracciones disponibles para devolución así:

quantity_fractions = CantidadCaja × FactorConversion

Por eso es importante enviar un FactorConversion correcto en productos por caja: de él depende que las cantidades de devolución cuadren. Si no se envía, se asume 1.

Precios y costos

Campo	Tipo	Descripción
`Costo`	number	Costo unitario.
`Precio`	number	Precio unitario.
`PrecioUnidadMinVenta`	number	Precio en la unidad mínima de venta.

Importes de la línea

Campo	Tipo	Descripción
`Subtotal`	number	Subtotal de la línea.
`Descuento`	number	Descuento sobre la línea.
`PorcentajeDescuento`	number	Porcentaje de descuento.
`Impuesto`	number	Impuesto de la línea (ISV 15%).
`PorcentajeImpuesto`	number	Porcentaje de impuesto.
`Impuesto18`	number	Impuesto al 18%.
`Total`	number	(Obligatorio) Total de la línea.

Logística

Campo	Tipo	Descripción
`Peso`	number	Peso de la línea.
`Volumen`	number	Volumen de la línea.

Ejemplo de línea de producto por caja

Línea real de una factura de Jaremar: un producto vendido por caja (UniVenta: "CJ").

{
  "Id": 3001008,
  "InvoiceId": 700102,
  "NumeroLinea": 1,
  "ProductoId": "50470402",
  "ProductoDesc": "CENTELLABARRA ROSADO 400GX3X4",
  "TipoProducto": "A",
  "UniVenta": "CJ",
  "CantidadCaja": 1.0,
  "CantidadFracciones": 0.0,
  "FactorConversion": 12,
  "Precio": 180.0,
  "PrecioUnidadMinVenta": 15.0,
  "Subtotal": 180.0,
  "Descuento": 0.0,
  "Impuesto": 27.0,
  "PorcentajeImpuesto": 15.0,
  "Total": 207.0,
  "Peso": 4.83
}

Como es por caja (CantidadCaja: 1, CantidadFracciones: 0), Hosana registra 1 × 12 = 12 fracciones disponibles para devolución.