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:
cantidad × unit_price, redondeado.- Menos el descuento.
discount_amountse resta tal cual.discount_percentagese 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:
- El IVA de cada línea es el IVA de su valor con IVA, redondeado; su
ventaGravadaes el valor con IVA menos ese IVA. - 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 suventaGravada, y la línea con IVA no cambia. montoDescues el descuento con IVA menos su IVA redondeado.precioUniesunit_price / 1.13a 6 decimales cuandocantidad × precio − montoDescu, redondeado, da laventaGravada; si no,(ventaGravada + montoDescu) / cantidada 8 decimales.totalGravadaysubTotalsuman lasventaGravada;totalDescusuma losmontoDescu; el IVA detributos(código20) es el del paso 2;montoTotalOperacionestotalGravadamás ese IVA;totalPagaresmontoTotalOperacionmenosivaRete.
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 |