CARGOS Y DESCUENTOS A NIVEL GLOBAL#
Grupo de campos para información relacionada con un cargo, se puede dar el caso que, por una diferencia entre la mercancía recibida y la cantidad cobrada, por una penalización debida a un retraso en la entrega o simplemente como consecuencia de un acuerdo comercial.
1. ChargeIndicator (Cargos y descuentos globales)
Invoice.AllowanceCharges.ChargeIndicator
/Invoice/cac:AllowanceCharge/cbc:ChargeIndicator
Para indicar que el elemento es un Cargo 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.
Para indicar que el elemento es un Descuento se debe enviar el valor False, el descuento es un crédito descuenta el valor de la factura y se debe reportar en el AllowancesTotalAmount del Total.
2. BaseAmount (Cargos y descuentos globales)
Invoice.AllowanceCharges.BaseAmount
/Invoice/cac:AllowanceCharge/cbc:BaseAmount
Valor base para calcular el Cargo o Descuento, debe ser positivo mayor que cero y para Descuentos no puede ser superior al valor total de la factura.
3. Reason (Cargos y descuentos globales)
Invoice.AllowanceCharges.Reason
/Invoice/cac:AllowanceCharge/cbc:AllowanceChargeReason
Razón (texto): Texto libre y Opcional para informar de la razón del Cargo o Descuento.
3. ReasonCode (Cargos y descuentos globales)
Invoice.AllowanceCharges.ReasonCode
/Invoice/cac:AllowanceCharge/cbc:AllowanceChargeReasonCode
Los códigos de los Cargo o Descuento ReasonCode están disponibles en el método del WEB API de Saphety: ReasonCode.
5. Amount (Cargos y descuentos 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).
Formula Descuento:
Valor total del descuento línea (Amount) = Valor Base línea (BaseAmount) * Porcentaje del descuento (Percentage).
6. Percentage (Cargos y descuentos globales)
Invoice.AllowanceCharges.Percentage
/Invoice/cac:AllowanceCharge/cbc:MultiplierFactorNumeric
Porcentaje del Cargo o Descuento a aplicar.
7. SequenceIndicator (Cargos y descuentos 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)
8.2 AllowancesTotalAmount (descuentos globales)
Invoice.Total.AllowancesTotalAmount
/Invoice/cac:LegalMonetaryTotal/cbc:AllowanceTotalAmount
El Valor del Descuento Total es igual a la suma de todos los descuentos globales aplicados al total de la factura.
Formula:
Descuentos Totales (AllowancesTotalAmount) = ∑ Valor total del descuento 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 CARGOS Y DESCUENTOS A NIVEL GLOBAL#
JSON (DTO) - CARGOS Y DESCUENTOS
{
"Currency": "COP",
"SeriePrefix": "SETP",
"SerieNumber": "990040412",
"IssueDate": "2023-11-27T12:12:12",
"DueDate": "2023-11-27T12:12:12",
"DeliveryDate": "2023-11-27T12:12:12",
"CorrelationDocumentId": "POSTMAN-{{$timestamp}}",
"SerieExternalKey": "{{serieexternalkeyFV}}",
"IssuerParty": {
"Identification": {
"DocumentNumber": "{{nit}}",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "{{digitoverificacion}}"
}
},
"OperationType": "10",
"PaymentMeans": [
{
"Code": "20",
"Mean": "1",
"DueDate": "2023-11-27"
}
],
"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.333",
"QuantityUnitOfMeasure": "NAR",
"TaxSubTotals": [
{
"TaxCategory": "01",
"TaxPercentage": "19.00",
"TaxableAmount": "115000.00",
"TaxAmount": "21850.00"
}
],
"TaxTotals": [
{
"TaxCategory": "01",
"TaxAmount": "21850.00",
"RoundingAmount": "0.00"
}
],
"UnitPrice": "115000.00",
"GrossAmount": "115000.00",
"NetAmount": "115000.00",
"Item": {
"Gtin": "987654321",
"Description": "Descripcion del producto o servicio"
}
}
],
"TaxSubTotals": [
{
"TaxCategory": "01",
"TaxPercentage": "19.00",
"TaxableAmount": "115000.00",
"TaxAmount": "21850.00"
}
],
"TaxTotals": [
{
"TaxCategory": "01",
"TaxAmount": "21850.00",
"RoundingAmount": "0.00"
}
],
"AllowanceCharges": [ /*Sección para informar Descuentos y Cargos*/
{ /*Sección para informar Cargos*/
"ChargeIndicator": "true", /*Campo igual a true indica un Cargo*/
"BaseAmount": "115000.00", /*Campo Cargo*/
"ReasonCode": "02", /*Campo Descuento*/
"Reason": "Cargo", /*Campo Cargo*/
"Amount": "11500.00", /*Campo Cargo*/
"Percentage": "10", /*Campo Cargo*/
"SequenceIndicator": "1" /*Campo Cargo*/
},
{ /*Sección para informar Descuentos*/
"ChargeIndicator": "false", /*Campo igual a Fase indica un Descuento*/
"BaseAmount": "115000.00", /*Campo Descuento*/
"ReasonCode": "00", /*Campo Descuento*/
"Reason": "Descuento no condicionado", /*Campo Descuento*/
"Amount": "11500.00", /*Campo Descuento*/
"Percentage": "0", /*Campo Cargo*/
"SequenceIndicator": "2" /*Campo Descuento*/
}
],
"Total": {
"GrossAmount": "115000.00",
"TotalBillableAmount": "136850.00",
"PayableAmount": "136850.00",
"TaxableAmount": "115000.00",
"AllowancesTotalAmount": "11500.00", /*Campo Descuento*/
"ChargesTotalAmount": "11500.00" /*Campo Cargo*/
}
}