Tezora

Montos y totales

Todo monto de la API incluye el IVA: unit_price del producto y de la línea, discount_amount, payments[].amount y, en la respuesta, lines[].unit_price, lines[].discount, lines[].total, totals.subtotal, totals.discount y totals.total. totals.vat es el IVA contenido en esos montos.

La regla es la misma en la Factura, en el Crédito Fiscal y en las notas de crédito y de débito. El documento firmado del Crédito Fiscal y de las notas declara sus montos sin IVA, como piden sus esquemas; esos montos están en document.summary y en el JSON del documento, no en lines ni en totals. En una nota, cada línea gravada lleva el IVA de su propio monto y la última gravada lo que queda del IVA de la nota, de modo que las líneas suman totals.total.

Los redondeos son al centavo, con la mitad hacia arriba (0.005 pasa a 0.01), salvo indicación contraria. El IVA de un monto X es X × 13 / 113.

Línea con IVA

La línea se calcula igual en la Factura y en el Crédito Fiscal:

  1. cantidad × unit_price, redondeado.
  2. Menos el descuento. discount_amount se resta tal cual. discount_percentage se aplica al resultado del paso 1 y se redondea una sola vez por línea: 100 unidades de 0.05 con 10 % descuentan 0.50, no 1.00.

El resultado es lines[].total; la suma de las líneas es totals.total.

Factura (01)

Campo Valor
precioUni unit_price
montoDescu Descuento con IVA
ventaGravada Línea con IVA
ivaItem IVA de la línea a 8 decimales, sin redondear
totalGravada, totalDescu Suma de líneas y de descuentos
totalIva IVA de totalGravada, redondeado una vez; no la suma de los IVA de línea
montoTotalOperacion, totalPagar totalGravada

Crédito Fiscal (03)

El CCF declara montos sin IVA y el impuesto una sola vez, en tributos, a partir de la misma línea con IVA:

  1. El IVA de cada línea es el IVA de su valor con IVA, redondeado; su ventaGravada es el valor con IVA menos ese IVA.
  2. El IVA del documento es el IVA de la suma de las líneas con IVA, redondeado una vez. Si los IVA de línea suman otra cifra, la diferencia se reparte de a un centavo: el faltante va a las líneas redondeadas más hacia abajo y el sobrante sale de las redondeadas más hacia arriba (redondeo = IVA redondeado menos valor × 13 / 113; a igual redondeo, primero la línea anterior). Cada centavo de IVA que sube en una línea baja su ventaGravada, y la línea con IVA no cambia.
  3. montoDescu es el descuento con IVA menos su IVA redondeado.
  4. precioUni es unit_price / 1.13 a 6 decimales cuando cantidad × precio − montoDescu, redondeado, da la ventaGravada; si no, (ventaGravada + montoDescu) / cantidad a 8 decimales.
  5. totalGravada y subTotal suman las ventaGravada; totalDescu suma los montoDescu; el IVA de tributos (código 20) es el del paso 2; montoTotalOperacion es totalGravada más ese IVA; totalPagar es montoTotalOperacion menos ivaRete.

El paso 2 evita que una venta de muchas líneas acumule más del centavo de diferencia que admite el Manual Funcional de Hacienda. En totals, vat es el IVA del documento. Las líneas exentas o no sujetas no llevan IVA: su valor va en ventaExenta o ventaNoSuj, con su descuento sin deducción.

Ejemplo con porcentaje

Dos galones a 12.50 con 10 % de descuento: línea con IVA 25.00, descuento 2.50, total 22.50. Un - indica un campo que el documento no lleva.

Campo del documento firmado Factura (01) Crédito Fiscal (03)
cuerpoDocumento.0.precioUni 12.50 11.061947
cuerpoDocumento.0.montoDescu 2.50 2.21
cuerpoDocumento.0.ventaGravada 22.50 19.91
resumen.totalGravada 22.50 19.91
resumen.totalDescu 2.50 2.21
resumen.totalIva 2.59 -
resumen.tributos.0.valor - 2.59
resumen.montoTotalOperacion 22.50 22.50

Ejemplo con monto y un centavo repartido

Al galón del primer flujo se suma una caja de conos.

{
  "code": "CON-WAF-12",
  "description": "Caja de 12 conos de waffle",
  "unit_price": "4.69",
  "item_type": "goods",
  "unit_of_measure": "59",
  "tax_treatment": "taxed"
}
{
  "dte_type": "03",
  "customer": { "document_type": "36", "document_number": "06140101011011" },
  "reference": "PEDIDO-1044",
  "operation_condition": "credit",
  "credit_days": 30,
  "lines": [
    { "product": "CON-WAF-12", "quantity": "7", "discount_amount": "1.41" },
    { "product": "HEL-GAL-01", "quantity": "1", "discount_percentage": "10" }
  ],
  "payments": [{ "method_code": "13", "amount": "42.67" }]
}

Los conos valen 7 × 4.69 = 32.83 menos 1.41, 31.42 con IVA; el galón, 12.50 menos 10 %, 11.25. Los IVA de línea son 3.61 (exacto 3.6147) y 1.29 (exacto 1.2942), 4.90 en total, mientras el IVA de 42.67 es 4.91. El centavo faltante va a los conos: su IVA queda en 3.62 y su ventaGravada en 27.80, no 27.81.

Campo del documento firmado Factura (01) Crédito Fiscal (03)
cuerpoDocumento.0.precioUni 4.69 4.150442
cuerpoDocumento.0.montoDescu 1.41 1.25
cuerpoDocumento.0.ventaGravada 31.42 27.80
cuerpoDocumento.1.precioUni 12.50 11.07
cuerpoDocumento.1.montoDescu 1.25 1.11
cuerpoDocumento.1.ventaGravada 11.25 9.96
resumen.totalGravada 42.67 37.76
resumen.totalDescu 2.66 2.36
resumen.totalIva 4.91 -
resumen.tributos.0.valor - 4.91
resumen.montoTotalOperacion 42.67 42.67

En el galón, 11.061947 − 1.11 da 9.95 y no 9.96, por lo que su precioUni es (9.96 + 1.11) / 1 = 11.07. En la Factura, ivaItem es 3.61469027 y 1.29424779, y totalIva es 4.91.

Retención del 1 %

En un CCF a un agente de retención de IVA, Tezora calcula el 1 % sobre el precio sin IVA cuando esa base alcanza 100.00 y lo informa en totals.vat_withheld; en otro caso es 0.00. Los payments suman el total menos la retención: un CCF de 150.00 sin IVA tiene total 169.50, retención 1.50 y pagos por 168.00. Una diferencia responde 422 payments_do_not_match con ambas sumas en errors.payments. Un vat_withheld enviado por el integrador se ignora.

Conciliación

document.summary es el resumen del documento firmado, sin recalcular, y es la cifra de conciliación. Las notas traen su propio summary. GET /sales?updated_since=… incluye las ventas anteriores cuyo documento o notas cambiaron desde ese instante.

summary Documento firmado
total_non_subject, total_exempt, total_taxable totalNoSuj, totalExenta, totalGravada
total_discount totalDescu
subtotal subTotal (en las notas, subTotalVentas)
vat tributos de código 20; en la Factura, totalIva
vat_withheld ivaRete
total_operation montoTotalOperacion
total_to_pay totalPagar