RETENCIONES#
Las retenciones definidas por la DIAN son:
Retención sobre el IVA
Retención sobre Renta
A continuación, se relacionan los campos para informar las retenciones de Documento Soporte a nivel de línea:#
1. WithholdingTaxCategory (RETENCIONES)
Invoice.Lines.WithholdingTaxSubTotals.WithholdingTaxCategory
/Invoice/cac:InvoiceLine/cac:WithholdingTaxTotal/cac:TaxSubtotal/cac:TaxCategory
El emisor auto-retenedor debe utilizar este grupo para informar las autoretenciones que práctica.
Identificador de las retenciones, el listado de los tipos de withholdingtaxes están disponibles en el método del WEB API de Saphety: WithHoldingTaxes.
2. TaxPercentage (RETENCIONES)
Invoice.Lines.WithholdingTaxSubTotals.TaxPercentage
/Invoice/cac:InvoiceLine/cac:WithholdingTaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:Percent
Tarifa de la retención, porcentaje a aplicar.
3. TaxableAmount (RETENCIONES)
Invoice.Lines.WithholdingTaxSubTotals.TaxableAmount
/Invoice/cac:InvoiceLine/cac:WithholdingTaxTotal/cac:TaxSubtotal/cbc:TaxableAmount
Base Imponible sobre la que se calcula el valor de la retención.
Nota: Cuando la retención es ReteIVA (05) la base tributable es el monto tributo IVA
4. TaxAmount (RETENCIONES)
Invoice.Lines.WithholdingTaxSubTotals.TaxAmount
/Invoice/cac:InvoiceLine/cac:WithholdingTaxTotal/cac:TaxSubtotal/cbc:TaxAmount
Formula
Valor de la retención de la línea (WithholdingTaxSubTotals.TaxAmount) = Porcentaje de la tarifa de la retención (WithholdingTaxSubTotals.TaxPercentage) * Base Imponible sobre la que se calcula el valor de la retención (WithholdingTaxSubTotals.TaxableAmount)IVA
5. WithholdingTaxCategory (RETENCIONES)
Invoice.Lines.WithholdingTaxTotals.WithholdingTaxCategory
/Invoice/cac:InvoiceLine/cac:WithholdingTaxTotal/cac:TaxSubtotal/cac:TaxCategory
Identificador de las retenciones, el listado de los tipos de withholdingtaxes están disponibles en el método del WEB API de Saphety: WithHoldingTaxes.
6. TaxAmount (RETENCIONES)
Invoice.Lines.WithholdingTaxTotals.TaxAmount
/Invoice/cac:InvoiceLine/cac:WithholdingTaxTotal/cac:TaxSubtotal/cbc:TaxAmount
Formula:
Valor Total de la retención a nivel de línea Invoice.Lines.WithholdingTaxSubTotals.TaxTotals.TaxAmount = Sumatoria de todos los valores de todo los tipos de retenciones a nivel de línea ∑( Invoice.Lines.WithholdingTaxSubTotals.TaxSubTotals.TaxAmount).
A continuación, se relacionan los campos para informar las retenciones a nivel global de Documento Soporte:#
1. WithholdingTaxCategory (RETENCIONES)
Invoice.WithholdingTaxSubTotals.WithholdingTaxCategory
/Invoice/cac:WithholdingTaxTotal/cac:TaxSubtotal/cac:TaxCategory
El emisor auto-retenendor debe utilizar este grupo para informar las autoretenciones que práctica.
Identificador de las retenciones, el listado de los tipos de withholdingtaxes están disponibles en el método del WEB API de Saphety: WithHoldingTaxes.
2. TaxPercentage (RETENCIONES)
Invoice.WithholdingTaxSubTotals.TaxPercentage
/Invoice/cac:WithholdingTaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:Percent
Tarifa de la retención, porcentaje a aplicar.
3. TaxableAmount (RETENCIONES)
Invoice.WithholdingTaxSubTotals.TaxableAmount
/Invoice/cac:WithholdingTaxTotal/cac:TaxSubtotal/cbc:TaxableAmount
Base Imponible sobre la que se calcula el valor de la retención.
Nota: Cuando la retención es ReteIVA (05) la base tributable es el monto tributo IVA
4. TaxAmount (RETENCIONES)
Invoice.WithholdingTaxSubTotals.TaxAmount
/Invoice/cac:WithholdingTaxTotal/cac:TaxSubtotal/cbc:TaxAmount
Formula
Valor Total de la retención global WithholdingTaxSubTotals.TaxTotals.TaxAmount= Sumatoria de todos los valores de todo los tipos de retenciones a nivel global ∑(WithholdingTaxSubTotals.TaxSubTotals.TaxAmount)
5. WithholdingTaxCategory (RETENCIONES)
Invoice.WithholdingTaxTotals.WithholdingTaxCategory
/Invoice/cac:WithholdingTaxTotal/cac:TaxSubtotal/cac:TaxCategory
Identificador de las retenciones, el listado de los tipos de withholdingtaxes están disponibles en el método del WEB API de Saphety: WithHoldingTaxes.
6. TaxAmount (RETENCIONES)
Invoice.WithholdingTaxTotals.TaxAmount
/Invoice/cac:WithholdingTaxTotal/cbc:TaxAmount
Formula:
Valor Total de la retención global WithholdingTaxSubTotals.TaxTotals.TaxAmount= Sumatoria de todos los valores de todo los tipos de retenciones a nivel global ∑(WithholdingTaxSubTotals.TaxSubTotals.TaxAmount).
DTO RETENCIONES#
JSON (DTO) - RETENCIONES
{
"Currency": "COP",
"SeriePrefix": "SEDS",
"SerieNumber": "984000001",
"IssueDate": "2023-11-27T12:12:12",
"DueDate": "2023-11-27T12:12:12",
"DeliveryDate": "2023-11-27T12:12:12",
"OperationType": "10",
"CorrelationDocumentId": "POSTMAN-{{$timestamp}}",
"SerieExternalKey": "{{serieexternalkeyDS}}",
"PaymentMeans": [
{
"Code": "20",
"Mean": "1",
"DueDate": "2023-11-27"
}
],
"CustomerParty": {
"Identification": {
"DocumentNumber": "{{nit}}",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "{{digitoverificacion}}"
}
},
"SupplierParty": {
"LegalType": "Legal",
"Email": "correo@sovos.com",
"TaxScheme": "ZZ",
"ResponsabilityTypes": [
"R-99-PN"
],
"Identification": {
"DocumentNumber": "{{nit}}",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "{{digitoverificacion}}"
},
"Name": "Saphety Transacciones Electrónicas S.A.S",
"Address": {
"DepartmentCode": "11",
"CityCode": "11001",
"AddressLine": "Calle 97a No. 9 - 45",
"Country": "CO",
"PostalCode": "000000"
}
},
"Lines": [
{
"Number": "1",
"Quantity": "1",
"QuantityUnitOfMeasure": "NAR",
"TaxSubTotals": [
{
"TaxCategory": "01",
"TaxPercentage": "19.00",
"TaxableAmount": "100000.00",
"TaxAmount": "19000.00"
}
],
"TaxTotals": [
{
"TaxCategory": "01",
"TaxAmount": "19000.00",
"RoundingAmount": "0.00"
}
],
"WithholdingTaxSubTotals": [
{ /*Seccion para informar Subtotal de retenciones de RETEIVA a nivel de linea*/
"WithholdingTaxCategory": "06", /*Campo para informar Subtotal de retenciones de RETEIVA a nivel de linea*/
"TaxPercentage": "1", /*Campo para informar Subtotal de retenciones de RETEIVA a nivel de linea*/
"TaxableAmount": "115000", /*Campo para informar Subtotal de retenciones de RETEIVA a nivel de linea*/
"TaxAmount": "1150" /*Campo para informar Subtotal de retenciones de RETEIVA a nivel de linea*/
},
{ /*Seccion para informar Subtotal de retenciones de RETERENTA a nivel de linea*/
"WithholdingTaxCategory": "05", /*Campo para informar Subtotal de retenciones de RETERENTA a nivel de linea*/
"TaxPercentage": "1", /*Campo para informar Subtotal de retenciones de RETERENTA a nivel de linea*/
"TaxableAmount": "115000", /*Campo para informar Subtotal de retenciones de RETERENTA a nivel de linea*/
"TaxAmount": "1150" /*Campo para informar Subtotal de retenciones de RETERENTA a nivel de linea*/
}
],
"WithholdingTaxTotals": [
{ /*Seccion para informar Total de retenciones de RETERENTA a nivel de linea*/
"WithholdingTaxCategory": "06", /*Campo para informar Total de retenciones de RETERENTA a nivel de linea*/
"TaxAmount": "1150.00" /*Campo para informar Total de retenciones de RETERENTA a nivel de linea*/
},
{
"WithholdingTaxCategory": "05", /*Campo para informar Total de retenciones de RETEIVA a nivel de linea*/
"TaxAmount": "1150.00" /*Campo para informar Total de retenciones de RETEIVA a nivel de linea*/
}
],
"UnitPrice": "100000.00",
"GrossAmount": "100000.00",
"NetAmount": "100000.00",
"Item": {
"Gtin": "xxxxx",
"Description": "Servicio 1"
},
"InvoicePeriod": {
"From": "2023-11-27",
"DescriptionCode": "1"
}
}
],
"TaxSubTotals": [
{
"TaxCategory": "01",
"TaxPercentage": "19.00",
"TaxableAmount": "100000.00",
"TaxAmount": "19000.00"
}
],
"TaxTotals": [
{
"TaxCategory": "01",
"TaxAmount": "19000.00",
"RoundingAmount": "0.00"
}
],
"Total": {
"GrossAmount": "100000.00",
"TotalBillableAmount": "119000.00",
"PayableAmount": "119000.00",
"TaxableAmount": "100000.00"
},
"WithholdingTaxSubTotals": [
{ /*Seccion para informar Subtotal de retenciones de RETEIVA a nivel de linea*/
"WithholdingTaxCategory": "06", /*Campo para informar Subtotal de retenciones de RETEIVA a nivel de linea*/
"TaxPercentage": "1", /*Campo para informar Subtotal de retenciones de RETEIVA a nivel de linea*/
"TaxableAmount": "115000", /*Campo para informar Subtotal de retenciones de RETEIVA a nivel de linea*/
"TaxAmount": "1150" /*Campo para informar Subtotal de retenciones de RETEIVA a nivel de linea*/
},
{ /*Seccion para informar Subtotal de retenciones de RETERENTA a nivel de linea*/
"WithholdingTaxCategory": "05", /*Campo para informar Subtotal de retenciones de RETERENTA a nivel de linea*/
"TaxPercentage": "1", /*Campo para informar Subtotal de retenciones de RETERENTA a nivel de linea*/
"TaxableAmount": "115000", /*Campo para informar Subtotal de retenciones de RETERENTA a nivel de linea*/
"TaxAmount": "1150" /*Campo para informar Subtotal de retenciones de RETERENTA a nivel de linea*/
}
],
"WithholdingTaxTotals": [
{ /*Seccion para informar Total de retenciones de RETERENTA a nivel de linea*/
"WithholdingTaxCategory": "06", /*Campo para informar Total de retenciones de RETERENTA a nivel de linea*/
"TaxAmount": "1150.00" /*Campo para informar Total de retenciones de RETERENTA a nivel de linea*/
},
{
"WithholdingTaxCategory": "05", /*Campo para informar Total de retenciones de RETEIVA a nivel de linea*/
"TaxAmount": "1150.00" /*Campo para informar Total de retenciones de RETEIVA a nivel de linea*/
}
],
"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. It has survived not only five centuries, but also the leap into electronic 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."
]
}