Calcular impuestos manualmente

1 min

La siguiente documentación de API permite utilizar el servicio de cálculo de impuestos sobre una operación, fuera del circuito de cálculo impositivo de SUGA con costo de servicio

Calcular Impuestos

Calcular los impuestos asociados a una operación para un Agrupador.

POST

https://{operator-base-url}.sugaway.io/p/taxes/calculate

Path Parameters

operator-base-urlStringrequired
Description
Identificador del operador asignado por SUGA

Header Parameters

x-api-keystringrequired
Description
API Key del operador.
x-access-tokenstringrequired
Description
Token de acceso del operador.
x-suga-entitystringrequired
Description
ID del comercio relacionado a la operación. Para poder calcular los impuestos este comercio debe estar pre-creado en la plataforma.

Body Parameters

operationOriginstringrequired
Description
Punto de ingreso de la transacción sobre la que se calcularán los impuestos. Valores Admitidos: *internal: Operaciones que fueron cursadas a través de SUGA *external: Operaciones que fueron cursadas a través de sistemas externos.
operationActionstringrequired
Description
Indica el tipo de acción que se está realizando sobre el cupon. Valores admitidos: *transaction: se utiliza para indicar que la operación se está pagando al comercio. *refund: se utiliza para indicar la devolución de una operación ya pagada al comercio.
couponstring
Description
En el caso de que la transacción se haya cursado a través de SUGA (internal), se debe indicar el ID del cupón en la plataforma
couponDataobject
Description
En caso de que la transacción se haya cursado fuera de SUGA (external), se deben indicar los datos correspondientes a la operación.
- totalnumberrequired
  Description
  Total de la operación
- currencystringrequired
  Description
  Moneda de la operación. Formato ISO-4217 Alfanumérico. Ejemplo: ARS, USD
- descriptionstring
  Description
  Descripción de la operación
- referencestringrequired
  Description
  Referencia de la operación.
- sourceReferencestringrequired
  Description
  Tipo de medio de pago utilizado en la operación. Se debe utilizar el esquema de códigos definidos en https://www.sugaway.dev/listado-de-medios-de-pago
- sourceActionstring
  Description
  Indica el sentido financiero de la operación originante: *cashin: Dinero entrante al subcomercio *cashout: Dinero saliendo del subcomercio Si no se indica, por defecto es una operación de cashin
- creatednumberrequired
  Description
  Fecha original de la operación
- customerobject
  Description
  Datos del originador de la operación
  - namestringrequired
  - identificationstringrequired
  - countrystring
  - statestring
  - citystring
transactionsarray
Description
Array con las transacciones (objetos) asociadas a la operación
transactions.$object
Description
Objecto con los datos de cada transacción dentro del array transactions
- typestringrequired
  Description
  Tipo de transacción: *Service: Costo de servicio o arancel *Financial: Costo financiero de la operación *Payment: Importe del pago. En caso de enviar, sobre-escribe el importe del cupon y se considera el mismo para el cálculo de impuestos
- totalstringrequired
  Description
  Importe de la transacción relacionada al cupón.
- currencystringrequired
  Description
  Moneda de la transacción relacionada al cupón

curl

curl --location --globoff 'https://{operator-base-url}.sugaway.io/p/taxes/calculate/{operator-base-url}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "operationOrigin": "String",
  "operationAction": "String",
  "coupon": "String",
  "couponData": {
    "total": "",
    "currency": "",
    "reference": "",
    "sourceReference": "",
    "created": "",
    "customer": {
      "name": "",
      "identification": ""
    }
  },
  "transactions": "Array",
  "transactions.$": {
    "type": "",
    "total": ""
  }
}'

javascript

var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({
   "operationOrigin": "String",
   "operationAction": "String",
   "coupon": "String",
   "couponData": {
      "total": "",
      "currency": "",
      "reference": "",
      "sourceReference": "",
      "created": "",
      "customer": {
         "name": "",
         "identification": ""
      }
   },
   "transactions": "Array",
   "transactions.$": {
      "type": "",
      "total": ""
   }
});

var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("https://{operator-base-url}.sugaway.io/p/taxes/calculate/{operator-base-url}", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

python

import requests
import json

url = "https://{operator-base-url}.sugaway.io/p/taxes/calculate/{operator-base-url}"

payload = json.dumps({
   "operationOrigin": "String",
   "operationAction": "String",
   "coupon": "String",
   "couponData": {
      "total": "",
      "currency": "",
      "reference": "",
      "sourceReference": "",
      "created": "",
      "customer": {
         "name": "",
         "identification": ""
      }
   },
   "transactions": "Array",
   "transactions.$": {
      "type": "",
      "total": ""
   }
})
headers = {
   'Accept': 'application/json',
   'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

200

{
    "result": true,
    "data": {
        "total": 10.5,
        "taxes": [
            {
                "name": "arg.iva.ret",
                "description": "República Argentina - Retención IVA",
                "base": 100,
                "total": 10.5,
                "currency": "ARS",
                "metadata": {
                    "documentId": "0251003134727507"
                },
                "certificate": "https://utils.mobbex.com/taxes/comerciodepruebas/arg.iva.ret/0251003134727507" // Si el impuesto posee certificado, se indica en esta URL
            }
        ]
    }
}