Guía de Integración a Nivel Global (Footer)#
Información de impuestos, retenciones, descuentos y totales a nivel global de un documento soporte.#
Footer#
Especificación y definición de datos del Footer del documento Soporte en Adquisiciones efectuadas a sujetos no obligados a Facturar.
1. Notas (DS)
{
"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
2. Código QR (DS)
Código QR viene de sistema (Se genera en la plataforma SaphetyDoc Con la informacion del XML-UBL).
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
3. CUDS (DS)
CUDS: Código Único de Documento Soporte, generado por la plataforma SaphetyDoc.
<cbc:UUID
schemeID="2" schemeName="CUDS-SHA384">2588e4b62e48653d4518781a9156d12489a76e924dbdea03e239e3797bbd2ac2f5c34b23dc3b8de8cb292ebba2220288
</cbc:UUID>
NA
NA
4. Texto Estático (DS)
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
5. Subtotal Base Gravable (DS)
{
"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
6. Subtotal Base No Gravable (DS)
{
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
7. Total Impuesto (DS)
{
"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
8. Total mas Impuesto (DS)
{
"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
9. Anticipo (DS)
{
"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
10 - 11. Descuentos y Recargos (DS)
{
"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", //(10)
"ChargesTotalAmount": "0.00", //(11)
"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> <!-- ( 10 ) -->
<cbc:ChargeTotalAmount currencyID="COP">0.00</cbc:ChargeTotalAmount> <!-- ( 11 ) -->
<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
10: 23 Dígitos incluidos separadores decimales
11: 23 Dígitos incluidos separadores decimales
12. Valor Total (DS)
{
"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