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 de documento equivalente.#
Footer#
Especificación y definición de datos del Footer de la nota de ajuste de documento equivalente electrónico.
1 - 2 - 3. Referencia a Documento (NADE)
{
"DocumentReferences": [
{
"DocumentReferred": " SETT1092",//( 1 )
"IssueDate": "2019-09-20T00:00:00",//( 2 )
"Type": " InvoiceReference ",
"DocumentReferredCUFE": "b8e56cb103c14c56c51bd62e4917ab9d8d67fce0878fc275d8f22a91a7dd79786bcd8f6899eca5c179fb03850dd9035c"//( 3 )
} ]
}
<cac:BillingReference>
<cac:InvoiceDocumentReference>
<cbc:ID>SETT1092</cbc:ID><!-- ( 1 ) -->
<cbc:UUID schemeName="CUFE-SHA384">b8e56cb103c14c56c51bd62e4917ab9d8d67fce0878fc275d8f22a91a7dd79786bcd8f6899eca5c179fb03850dd9035c</cbc:UUID> <!-- ( 3 ) -->
<cbc:IssueDate>2019-09-20</cbc:IssueDate><!-- ( 2 ) -->
</cac:InvoiceDocumentReference>
</cac:BillingReference>
DocumentReferred: Prefijo + Número del DE.
DocumentReferredCUFE: CUDE del Documento Equivalente afectado.
Rechazo: Si no se reporta.
IssueDate: Fecha del DE referenciado.
Rechazo: Si fecha de Documento equivalente > CreditNote/cbc:IssueDate
1: 22 Caracteres
2: 22 Caracteres
3: 134 Caracteres
4. Notas (NADE)
{
"Notes": ["Lorem Ipsum is simply dummy text of the printing and typesetting industry. ...remain unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages."]
}
<cbc:Note> Lorem Ipsum is simply dummy text of the printing and typesetting industry. ...ectronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum.
</cbc:Note>
Notes: Información adicional: Texto libre, relativo al documento.
500 caracteres (4 líneas)
5. Código QR (NADE)
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 Equivalente)
FecDE: Fecha de emisión.
HorDE: Hora del documento equivalente 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 Equivalente sin puntos ni guiones, sin dígito de verificación.
ValDE: Valor del documento equivalente 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.
ValTolDE: Valor Total, con punto decimal, con decimales a dos (2) dígitos truncados, sin separadores de miles, ni símbolo pesos.
CUDE: Código único de documento equivalente.
QRCode: URL disponible por la DIAN - Ambiente Habilitación: https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=CUDE - Ambiente Producción: https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=CUDE
NA
NA
6. CUDE (NADE)
CUDE: Código Único de Documento Equivalente, generado por la plataforma SaphetyDoc.
<cbc:UUID
schemeID="2" schemeName="CUDE-SHA384">2588e4b62e48653d4518781a9156d12489a76e924dbdea03e239e3797bbd2ac2f5c34b23dc3b8de8cb292ebba2220288
</cbc:UUID>
NA
NA
7. Texto Estático (NADE)
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 (NADE)
{
"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 (NADE)
{
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
107. Total Impuesto (NADE)
{
"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 Equivalente. Los códigos de los impuestos están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/taxcategories
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 (NADE)
{
"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 (NADE)
{
"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 (NADE)
{
"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>
AllowancesTotalAmount (AllowanceTotalAmount): Descuento Total: Suma de todos los descuentos aplicados al total del documento equivalente.
Descuento = false AllowancesTotalAmount = AllowanceCharges.Amount → AllowanceCharges.
ChargeIndicator = False
ChargesTotalAmount (ChargeTotalAmount): Cargo Total: Suma de todos los cargos aplicados al total del documento equivalente.
Cargo = true ChargesTotalAmount = AllowanceCharges.Amount → AllowanceCharges.ChargeIndicator = True Los códigos de las razones de descuentos (allowancechargecodetypes) están disponibles en el método del WEB API de Saphety: AllowanceChargeCodeTypes.
13: 23 Dígitos incluidos separadores decimales
14: 23 Dígitos incluidos separadores decimales
15. Valor Total (NADE)
{
"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