FacturaCompraApiLineaDto

Línea de detalle de una factura de compra. A diferencia de ventas, el catálogo detrás es producto_factura_compra — separado del catálogo de inventario que usa POST /facturas.

Campos

Campo	Tipo	Requerido	Descripción
`idProducto`	`number`	Uno de los dos caminos	ID en el catálogo de factura de compra. No es el catálogo de inventario de Ventas.
`descripcion`	`string`	Si no hay `idProducto`	Descripción de la línea. Da de alta el ítem en el catálogo de compra.
`codigoCabys`	`string`	Si no hay `idProducto`	Código CAByS de 13 dígitos. Ver Códigos CAByS.
`unidadMedida`	`string`	Opcional	Unidad de medida Hacienda. Default `"Unid"`.
`cantidad`	`number`	Sí	Cantidad mayor que `0`.
`precioUnitario`	`number`	Opcional	Precio en la moneda del documento. Si la línea viene por `idProducto` y se omite, usa el del catálogo de compra.
`numeroVin`	`string`	Opcional	Número de VIN, para líneas que lo requieran.
`numeroRegistro`	`string`	Opcional	Número de registro sanitario o equivalente.
`codigoPresentacion`	`string`	Opcional	Código de presentación del producto.


interface FacturaCompraApiLineaDto {
  /** ID del producto en el catálogo de factura de compra (producto_factura_compra).
      NO es el catálogo de inventario de Ventas. Alternativa: descripcion + codigoCabys. */
  idProducto?: number | null;
 
  /** Obligatoria si no mandás idProducto. Da de alta la línea en el catálogo de compra. */
  descripcion?: string | null;
 
  /** Obligatorio si no mandás idProducto. Código CAByS de 13 dígitos. */
  codigoCabys?: string | null;
 
  /** Unidad de medida Hacienda. Default "Unid". */
  unidadMedida?: string | null;
 
  /** OBLIGATORIO. Cantidad > 0. */
  cantidad: number;
 
  /** Precio unitario en moneda del documento. Si viene por idProducto y se omite,
      usa el del catálogo de compra. */
  precioUnitario?: number | null;
 
  numeroVin?: string | null;
  numeroRegistro?: string | null;
  codigoPresentacion?: string | null;
}

Reglas

Cada línea va por uno de dos caminos: idProducto o descripcion + codigoCabys.
Al enviar descripcion + codigoCabys sin idProducto, la línea se da de alta en producto_factura_compra. Antes de crearla se busca por nombre exacto, de modo que facturar el mismo insumo todos los meses no llena el catálogo de duplicados.
La línea no admite IVA, descuento ni exoneración: no dispone de esos campos, porque la factura de compra es de tarifa 0% exenta.

Ejemplos

Línea del catálogo de compra


{ "idProducto": 8, "cantidad": 100 }

Línea ad-hoc (se da de alta)


{
  "descripcion": "Café en fruta",
  "codigoCabys": "8511200000100",
  "unidadMedida": "Kg",
  "cantidad": 250,
  "precioUnitario": 450.00
}