Guía de Integración a Nivel Global (Footer)#
Información de impuestos, retenciones, descuentos y totales a nivel global de una Nota de Ajuste.#
Footer#
Especificación y definición de datos del Footer de la Nota de Ajuste al documento Soporte en Adquisiciones efectuadas a sujetos no obligados a Facturar.
1 - 2 - 3. Referencia (NADS)
{
"DocumentReferred": "SETT999",//( 1 )
"IssueDate": "2022-01-10T00:00:00",//( 2 )
"Type": "InvoiceReference",
"DocumentReferredCUFE":"b8e56cb103c14c56c51bd62e4917ab9d8d67fce0878fc275d8f22a91a7dd79786bcd8f6899eca5c179fb03850dd9035c"//( 3 )
}
<cac:BillingReference>
<cac:InvoiceDocumentReference>
<cbc:ID> SETT999</cbc:ID><!-- ( 1 ) -->
<cbc:UUID schemeName="CUFE-SHA384"> b8e56cb103c14c56c51bd62e4917ab9d8d67fce0878fc275d8f22a91a7dd79786bcd8f6899eca5c179fb03850dd9035c</cbc:UUID> <!-- ( 2 ) -->
<cbc:IssueDate>2022-01-10</cbc:IssueDate><!-- ( 3 ) -->
</cac:InvoiceDocumentReference>
</cac:BillingReference>
DocumentReferred: Prefijo + Número del Documento Soporte.
IssueDate: Fecha de generación del Documento Soporte.
Type: Debe ser “InvoiceReference”, para mayor información: docrefenrencetypes.
DocumentReferredCUFE: CUDS del documento soporte.
Nota: El documento soporte que se referencia debe existir o generada previamente a la Nota de ajuste, tener en cuenta el tipo de operación.
21: 22 Caracteres
22: 22 Caracteres
23: 134 Caracteres
4. Notas (NADS)
{
"Notes": ["Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book."]
}
<cbc:Note> Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book.
</cbc:Note>
Notes (Note): Información adicional: Texto libre, relativo al documento.
560 caracteres
5. Código QR (NADS)
Código QR viene de sistema (Preconfigurado en la plataforma SaphetyDoc).
NumDS: Número del documento electrónico. (prefijo concatenado con el número del Documento Soporte)
FecDS: Fecha de emisión.
HorDS: Hora del documento soporte incluyendo (UTC–05:00).
NumSNO: Número de Identificación del SNO sin puntos ni guiones, sin dígito de verificación.
NITABS: Número del NIT del ABS del Documento Soporte sin puntos ni guiones, sin dígito de verificación.
ValDS: Valor del documento soporte sin Impuestos, con punto decimal, con decimales a dos (2) dígitos truncados, sin separadores de miles, ni símbolo pesos.
ValIva: Valor impuesto 01 - IVA, con punto decimal, con decimales a dos (2) dígitos truncados, sin separadores de miles, ni símbolo pesos. Si no está referenciado el impuesto 01 – IVA este valor se representa con 0.00.
ValTolDS: Valor Total, con punto decimal, con decimales a dos (2) dígitos truncados, sin separadores de miles, ni símbolo pesos.
CUDS: Código único de documento soporte.
QRCode: URL disponible por la DIAN - Ambiente Habilitación: https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=CUDS - Ambiente Producción: https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=CUDS.
NA
NA
6. CUDS (NADS)
CUDS generado por la plataforma SaphetyDoc.
<cbc:UUID
schemeID="2" schemeName="CUDS-SHA384">2588e4b62e48653d4518781a9156d12489a76e924dbdea03e239e3797bbd2ac2f5c34b23dc3b8de8cb292ebba2220288
</cbc:UUID>
NA
NA
7. Texto Estático (NADS)
Texto Estático - Información sobre el Proveedor tecnológico: Apellidos y nombre o razón social y Número de Identificación Tributaria -NIT, del fabricante del Proveedor tecnológico.
NA
NA
NA
8. Subtotal Base Gravable (NADS)
{
"Total": {
"GrossAmount": "100000.00",
"TotalBillableAmount": "119000.00",
"PayableAmount": "119000.00",
"TaxableAmount": "100000.00",
"AllowancesTotalAmount": "0.00",
"ChargesTotalAmount": "0.00",
"PrePaidTotalAmount": "0.00"
}
//Nota: Recuerde que los excluidos de IVA No hacen parte de la base no gravable.
}
<cac:LegalMonetaryTotal>
<cbc:LineExtensionAmount currencyID="COP">100000.00 </cbc:LineExtensionAmount>
<cbc:TaxExclusiveAmount currencyID="COP">100000.00 </cbc:TaxExclusiveAmount>
<cbc:TaxInclusiveAmount currencyID="COP">119000.00 </cbc:TaxInclusiveAmount>
<cbc:AllowanceTotalAmount currencyID="COP">0.00 </cbc:AllowanceTotalAmount>
<cbc:ChargeTotalAmount currencyID="COP">0.00 </cbc:ChargeTotalAmount>
<cbc:PrepaidAmount currencyID="COP">0.00</cbc:PrepaidAmount>
<cbc:PayableAmount currencyID="COP">119000.00</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
TaxInclusiveAmount (TaxableAmount): base gravable / es la sumatoria de la base para calcular los impuestos gravables o exentos.
Formula: TaxableAmount = ∑(TaxSubTotals. TaxableAmount).
Si a nivel de línea existen productos o servicios excluidos de IVA “ExcludeVat = true” estos no se deben sumar en la base gravable TaxInclusiveAmount (TaxableAmount).
23 dígitos incluidos separadores decimales
9. Subtotal Base No Gravable (NADS)
{
Lines[{
"ExcludeVat": "true"
}]
//Nota: Recuerde que los excluidos de IVA hacen parte de la base no gravable.
}
<cac:LegalMonetaryTotal>
<cbc:LineExtensionAmount currencyID="COP">100000.00 </cbc:LineExtensionAmount>
<cbc:TaxExclusiveAmount currencyID="COP">0.00 </cbc:TaxExclusiveAmount>
<cbc:TaxInclusiveAmount currencyID="COP">119000.00 </cbc:TaxInclusiveAmount>
<cbc:AllowanceTotalAmount currencyID="COP">0.00 </cbc:AllowanceTotalAmount>
<cbc:ChargeTotalAmount currencyID="COP">0.00 </cbc:ChargeTotalAmount>
<cbc:PrepaidAmount currencyID="COP">0.00</cbc:PrepaidAmount>
<cbc:PayableAmount currencyID="COP">119000.00</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
TaxExclusiveAmount: (“Total.TaxableAmount” – “Total.GrossAmount”) base no gravable / la sumatoria del campo “Line.NetAmount” de la línea para los productos o servicios excluidos de impuesto, cuando a nivel de línea existe el parámetro “ExcludeVat = true” que es el resultado del total.
Formula: TaxExclusiveAmount = ∑( line.netamount).
Si a nivel de línea se indica el campo “ExcludeVat”: “true”, TaxExclusiveAmount = Total.TaxableAmount” – “Total.GrossAmount
NA
10. Total Impuesto (NADS)
{
"TaxSubTotals": [
{
"TaxCategory": "IVA",
"TaxPercentage": "19.00",
"TaxableAmount": "100000.00",
"TaxAmount": "19000.00"
}
],
"TaxTotals": [
{
"TaxCategory": "IVA",
"TaxAmount": "19000.00"
}
]
}
<cac:TaxTotal>
<cbc:TaxAmount currencyID="COP">19000.00</cbc:TaxAmount>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="COP">485000.00</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="COP">92150.00</cbc:TaxAmount>
<cbc:Percent>19.00</cbc:Percent>
<cac:TaxCategory>
<cbc:Percent>19.00</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>01</cbc:ID>
<cbc:Name>IVA</cbc:Name>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
TaxAmount: Valor del tributo.
TaxCategory: El código de impuesto permitido por la DIAN para Documento Soporte es 01 – IVA.
Formula: Total Impuestos=∑ (TaxTotals.TaxAmount) Sumatoria de todos los impuestos a nivel global de la factura.
23 dígitos incluidos separadores decimales
11. Total mas Impuesto (NADS)
{
"Total": {
"GrossAmount": "100000.00",
"TotalBillableAmount": "119000.00",
"PayableAmount": "119000.00",
"TaxableAmount": "100000.00",
"AllowancesTotalAmount": "0.00",
"ChargesTotalAmount": "0.00",
"PrePaidTotalAmount": "0.00"
}
}
<cac:LegalMonetaryTotal>
<cbc:LineExtensionAmount currencyID="COP">0.00</cbc:LineExtensionAmount>
<cbc:TaxExclusiveAmount currencyID="COP">0.00</cbc:TaxExclusiveAmount>
<cbc:TaxInclusiveAmount currencyID="COP">119000.00</cbc:TaxInclusiveAmount>
<cbc:AllowanceTotalAmount currencyID="COP">0.00</cbc:AllowanceTotalAmount>
<cbc:ChargeTotalAmount currencyID="COP">0.00</cbc:ChargeTotalAmount>
<cbc:PrepaidAmount currencyID="COP">0.00</cbc:PrepaidAmount>
<cbc:PayableAmount currencyID="COP">0.00</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
TotalBillableAmount (TaxInclusiveAmount): Total de Valor Bruto más tributos.
Formula: TotalBillableAmount = GrossAmount + TaxTotals.TaxAmount
23 dígitos incluidos separadores decimales
12. Anticipo (NADS)
{
"PrepaidPayments": [
{
"PaidDate": "2022-01-01",
"PaidAmount": "0.00"
}
],
"Total": {
"GrossAmount": "100000.00",
"TotalBillableAmount": "119000.00",
"PayableAmount": "119000.00",
"TaxableAmount": "100000.00",
"AllowancesTotalAmount": "0.00",
"ChargesTotalAmount": "0.00",
"PrePaidTotalAmount": "0.00"
}
}
<cac:PrepaidPayment>
<cbc:ID>12979375-cd3f-4eff-a8ca-a9a15435cca8</cbc:ID>
<cbc:PaidAmount currencyID="COP">0.00</cbc:PaidAmount>
<cbc:PaidDate>2022-01-01</cbc:PaidDate>
</cac:PrepaidPayment>
<cac:LegalMonetaryTotal>
<cbc:LineExtensionAmount currencyID="COP">100000.00</cbc:LineExtensionAmount>
<cbc:TaxExclusiveAmount currencyID="COP">100000.00</cbc:TaxExclusiveAmount>
<cbc:TaxInclusiveAmount currencyID="COP">119000.00</cbc:TaxInclusiveAmount>
<cbc:AllowanceTotalAmount currencyID="COP">0.00 </cbc:AllowanceTotalAmount>
<cbc:ChargeTotalAmount currencyID="COP">0.00 </cbc:ChargeTotalAmount>
<cbc:PrepaidAmount currencyID="COP">0.00</cbc:PrepaidAmount>
<cbc:PayableAmount currencyID="COP">119000.00</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
PrePaidTotalAmount (PrepaidAmount): El Valor del Anticipo Total es igual a la suma de todos los anticipos o prepagos globales aplicados al total de la factura.
PayableAmount (PayableAmount): Para el Valor a Pagar de Factura no descontar los anticipos, este es igual a la Suma de Valor Bruto más tributos - Valor del Descuento Total + Valor del Cargo Total Total.
23 dígitos incluidos separadores decimales
13 - 14. Descuentos y Recargos (NADS)
{
"AllowanceCharges": [
{
"ChargeIndicator": "false",
"BaseAmount": "100000.00",
"ReasonCode": "00 ",
"Reason": "Discount",
"Amount": "0.00",
"Percentage": "0",
"SequenceIndicator": "1"
},
{
"ChargeIndicator": "true",
"BaseAmount": "100000.00",
"ReasonCode": "00",
"Reason": "fletes",
"Amount": "0.00",
"Percentage": "0.00",
"SequenceIndicator": "2"
}
],
"Total": {
"GrossAmount": "100000.00",
"TotalBillableAmount": "119000.00",
"PayableAmount": "119000.00",
"TaxableAmount": "100000.00",
"AllowancesTotalAmount": "0.00", //(13)
"ChargesTotalAmount": "0.00", //(14)
"PrePaidTotalAmount": "0.00"
}
}
<cac:AllowanceCharge>
<cbc:ChargeIndicator>false</cbc:ChargeIndicator>
<cbc:AllowanceChargeReasonCode>00</cbc:AllowanceChargeReasonCode>
<cbc:AllowanceChargeReason>Discount</cbc:AllowanceChargeReason>
<cbc:MultiplierFactorNumeric>0.00</cbc:MultiplierFactorNumeric>
<cbc:SequenceNumeric>1</cbc:SequenceNumeric>
<cbc:Amount currencyID="COP">0.00</cbc:Amount>
<cbc:BaseAmount currencyID="COP">0.00</cbc:BaseAmount>
</cac:AllowanceCharge>
<cac:AllowanceCharge>
<cbc:ChargeIndicator>true</cbc:ChargeIndicator>
<cbc:AllowanceChargeReasonCode>00</cbc:AllowanceChargeReasonCode>
<cbc:AllowanceChargeReason>fletes</cbc:AllowanceChargeReason>
<cbc:MultiplierFactorNumeric>0.00</cbc:MultiplierFactorNumeric>
<cbc:SequenceNumeric>2</cbc:SequenceNumeric>
<cbc:Amount currencyID="COP">0.00</cbc:Amount>
<cbc:BaseAmount currencyID="COP">0.00</cbc:BaseAmount>
</cac:AllowanceCharge>
<cac:LegalMonetaryTotal>
<cbc:LineExtensionAmount currencyID="COP">0.00</cbc:LineExtensionAmount>
<cbc:TaxExclusiveAmount currencyID="COP">0.00</cbc:TaxExclusiveAmount>
<cbc:TaxInclusiveAmount currencyID="COP">119000.00</cbc:TaxInclusiveAmount>
<cbc:AllowanceTotalAmount currencyID="COP">0.00</cbc:AllowanceTotalAmount> <!-- ( 13 ) -->
<cbc:ChargeTotalAmount currencyID="COP">0.00</cbc:ChargeTotalAmount> <!-- ( 14 ) -->
<cbc:PrepaidAmount currencyID="COP">0.00</cbc:PrepaidAmount>
<cbc:PayableAmount currencyID="COP">119000.00</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
Descuento = false
AllowancesTotalAmount = AllowanceCharges.Amount → AllowanceCharges.ChargeIndicator = False
Cargo = true
ChargesTotalAmount = AllowanceCharges.Amount → AllowanceCharges.ChargeIndicator = True
Códigos de razones de descuentos allowancechargecodetypes están disponibles en el método WEB API de Saphety: AllowanceChargeCodeTypes.
13: 23 Dígitos incluidos separadores decimales
14: 23 Dígitos incluidos separadores decimales
15. Valor Total (NADS)
{
"Total": {
"GrossAmount": "0.00",
"TotalBillableAmount": "119000.00",
"PayableAmount": "119000.00",
"TaxableAmount": "0.00",
"AllowancesTotalAmount": "0.00",
"ChargesTotalAmount": "0.00",
"PrePaidTotalAmount": "0.00"
}
}
<cac:LegalMonetaryTotal>
<cbc:LineExtensionAmount currencyID="COP">0.00</cbc:LineExtensionAmount>
<cbc:TaxExclusiveAmount currencyID="COP">0.00</cbc:TaxExclusiveAmount>
<cbc:TaxInclusiveAmount currencyID="COP">119000.00</cbc:TaxInclusiveAmount>
<cbc:AllowanceTotalAmount currencyID="COP">0.00</cbc:AllowanceTotalAmount>
<cbc:ChargeTotalAmount currencyID="COP">0.00</cbc:ChargeTotalAmount>
<cbc:PrepaidAmount currencyID="COP">0.00</cbc:PrepaidAmount>
<cbc:PayableAmount currencyID="COP">119000.00</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
PayableAmount (PayableAmount): Valor total del documento.
Valor total de ítems (incluyendo cargos y descuentos a nivel de ítems) + valor tributos + valor cargos.
Formula: Valor a pagar Total (PayableAmount) = Total de Valor Bruto más tributos (TotalBillableAmount) – Descuentos Globales (AllowancesTotalAmount) + Cargos globales (ChargesTotalAmount).
23 dígitos incluidos separadores decimales