PROPINAS#
Grupo de campos para registrar los montos de propina recibidos al momento de emitir la factura.
1. ChargeIndicator (Cargos globales)
Invoice.AllowanceCharges.ChargeIndicator
/Invoice/cac:AllowanceCharge/cbc:ChargeIndicator
Para indicar que el elemento es un Cargo de Propina se debe enviar el valor true, Cargo es un Débito aumenta el valor de la factura y se debe reportar en el ChargesTotalAmount del Total.
2. BaseAmount (Cargos globales)
Invoice.AllowanceCharges.BaseAmount
/Invoice/cac:AllowanceCharge/cbc:BaseAmount
Valor base para calcular el Cargo, debe ser positivo mayor que cero.
3. Reason (Cargos globales)
Invoice.AllowanceCharges.Reason
/Invoice/cac:AllowanceCharge/cbc:AllowanceChargeReason
Razón (texto): Texto libre y Opcional para informar de la razón del Cargo en este caso la Propina.
3. ReasonCode (Cargos globales)
Invoice.AllowanceCharges.ReasonCode
/Invoice/cac:AllowanceCharge/cbc:AllowanceChargeReasonCode
Los códigos de los Cargo ReasonCode están disponibles en el método del WEB API de Saphety: ReasonCode.
5. Amount (Cargos globales)
Invoice.AllowanceCharges.Amount
/Invoice/cac:AllowanceCharge/cbc:Amount
Formula Cargo:
Valor total del cargo global (Amount) = Valor Base global (BaseAmount) * Porcentaje del cargo global (Percentage).
6. Percentage (Cargos globales)
Invoice.AllowanceCharges.Percentage
/Invoice/cac:AllowanceCharge/cbc:MultiplierFactorNumeric
Porcentaje del Cargo a aplicar.
7. SequenceIndicator (Cargos globales)
Invoice.AllowanceCharges.SequenceIndicator
/Invoice/cac:AllowanceCharge/cbc:ID
Empieza con “1”, los números utilizados en los diferentes grupos deben ser consecutivos.
8.1 ChargesTotalAmount (Cargos globales)
Invoice.Total.ChargesTotalAmount
/Invoice/cac:LegalMonetaryTotal/cbc:ChargeTotalAmount
El Valor del Cargo Total es igual a la suma de todos los cargos globales aplicados al total de la factura.
Formula:
Cargos Totales (ChargesTotalAmount) = ∑ Valor total del cargo global (Amount)
9. PayableAmount (Cargos y descuentos globales)
Invoice.Total.PayableAmount
/Invoice/cac:LegalMonetaryTotal/cbc:PayableAmount/
Formula:
Valor a pagar Total (PayableAmount) = GrossAmount Global + TaxableAmout Global + Valor total del cargo Global - Valor total del descuento Global.
DTO PROPINAS#
JSON (DTO) - PROPINAS
{
"Currency": "COP",
"SeriePrefix": "SETP",
"SerieNumber": "990053546",
"IssueDate": "2025-08-25T12:12:12",
"DueDate": "2025-08-25T12:12:12",
"DeliveryDate": "2025-08-25T12:12:12",
"CorrelationDocumentId": "POSTMAN-{{$timestamp}}",
"SerieExternalKey": "{{serieexternalkeyFV}}",
"IssuerParty": {
"Identification": {
"DocumentNumber": "{{nit}}",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "{{digitoverificacion}}"
}
},
"PaymentMeans": [
{
"Code": "20",
"Mean": "1",
"DueDate": "2025-08-25"
}
],
"CustomerParty": {
"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"
}
},
"Lines": [
{
"Number": "1",
"Quantity": "1",
"QuantityUnitOfMeasure": "NAR",
"TaxSubTotals": [
{
"TaxCategory": "01",
"TaxPercentage": "19.00",
"TaxableAmount": "115000.00",
"TaxAmount": "21850.00"
}
],
"TaxTotals": [
{
"TaxCategory": "01",
"TaxAmount": "21850.00"
}
],
"UnitPrice": "115000.00",
"GrossAmount": "115000.00",
"NetAmount": "115000.00",
"Item": {
"Gtin": "987654321",
"Description": "Descripcion del producto o servicio"
}
}
],
"AllowanceCharges": [ /*Sección para informar recargo de propina*/
{ /*Sección para informar recargo de propina*/
"ChargeIndicator": "true", /*Campo igual a true indica recargo de propina*/
"BaseAmount": "115000.00", /*Campo de la base para calcular recargo de propina*/
"ReasonCode": "03", /*Campo de la razon del recargo de propina*/
"Reason": "Cargo", /*Campo libre para describir recargo de propina*/
"Amount": "11500.00", /*Campo del valor del recargo de propina*/
"Percentage": "10", /*Campo porcentaje del recargo de propina*/
"SequenceIndicator": "1" /*Campo indicador de secuencia de los recargos*/
}
/*
les indicamos que será responsabilidad del facturador electrónico la forma correcta de determinar la manera correcta
de informar las propinas teniendo en cuenta la normatividad vigente, aquellos requisitos derivados o conexos de la
factura electrónica de venta y la contabilidad interna llevada a cabo por el facturador. Por ello, le suministramos
los siguientes elementos de carácter legal relevantes para que sea el consultante quien analice los efectos jurídicos
de su caso particular y así determinar la aplicabilidad de las normas, así como las obligaciones tributarias que de
ella se deriven:
- Artículo 512-9 del Estatuto Tributario
- Ley 1935 de 2028
- Oficio DIAN 904106 – int 664 del 23 mayo de 2022
- Oficio DIAN 008004 del 04 de abril de 2019
- Oficio DIAN 902560 – int 375 del 25 de mayo de 2022
*/
],
"TaxSubTotals": [
{
"TaxCategory": "01",
"TaxPercentage": "19.00",
"TaxableAmount": "115000.00",
"TaxAmount": "21850.00"
}
],
"TaxTotals": [
{
"TaxCategory": "01",
"TaxAmount": "21850.00"
}
],
"Total": {
"GrossAmount": "115000.00",
"TotalBillableAmount": "136850.00",
"PayableAmount": "148350.00", /*se debe sumar el valor del recargo de propina al valor a pagar*/
"TaxableAmount": "115000.00",
"ChargesTotalAmount": "11500.00" /*Campo para informar el total del recargo de propina*/
}
}
Important
Les indicamos que será responsabilidad del facturador electrónico la forma correcta de determinar la manera correcta de informar las propinas teniendo en cuenta la normatividad vigente, aquellos requisitos derivados o conexos de la factura electrónica de venta y la contabilidad interna llevada a cabo por el facturador. Por ello, le suministramos los siguientes elementos de carácter legal relevantes para que sea el consultante quien analice los efectos jurídicos de su caso particular y así determinar la aplicabilidad de las normas, así como las obligaciones tributarias que de ella se deriven:
Artículo 512-9 del Estatuto Tributario.
Ley 1935 de 2028.
Oficio DIAN 904106 – int 664 del 23 mayo de 2022.
Oficio DIAN 008004 del 04 de abril de 2019.
Oficio DIAN 902560 – int 375 del 25 de mayo de 2022.