Recursos para IA

Considerações sobre o IVA na Colômbia

O IVA (Imposto sobre o Valor Agregado) é um encargo fiscal que incide sobre a venda de produtos ou a prestação de serviços dentro do território colombiano.

Determinados produtos e serviços são isentos do IVA, enquanto outros podem contar com tarifas reduzidas. Atualmente, a tarifa padrão deste imposto é de 19%.

Impostos em pagamentos online

Para processar corretamente o IVA, é possível enviar o valor líquido (unit_price) e o IVA (taxes) no momento de criar a order através do endpoint Criar orderAPI.

O parâmetro taxes.value deve ser enviado como uma string que represente um valor inteiro. Não envie o símbolo de porcentagem, decimais ou caracteres especiais.
CampoTipoDescriçãoObservações
itemsArrayLista de produtos ou serviços a cobrar-
items.titleStringTítulo do produto ou serviço-
items.quantityIntegerQuantidade de unidades-
items.unit_priceStringPreço unitário do produto sem IVA-
taxesArrayLista de impostos aplicáveisSe nenhum valor for enviado, será considerada por padrão uma redução de 19% sobre o valor total da transação, correspondente ao IVA geral.
taxes.typeStringTipo de imposto (IVA)-
taxes.valueStringValor do imposto em valores absolutosDeve ser enviado como uma string que represente um valor inteiro. Para produtos isentos de IVA, defina-o como "0".
O total_amount da order é sempre a soma de items[].unit_price × items[].quantity e não inclui taxes[].value. Por exemplo, se o preço do produto é 10.000 COP e o IVA é 500 COP, o total_amount continua sendo 10.000 COP; o IVA é informado separadamente no array taxes.
curl
curl -X POST \
    -H 'accept: application/json' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer ENV_ACCESS_TOKEN' \
    -H 'X-Idempotency-Key: UNIQUE_KEY' \
    'https://api.mercadopago.com/v1/orders' \
    -d '{
  "type": "online",
  "processing_mode": "manual",
  "total_amount": "10000",
  "external_reference": "order_pro_123",
  "payer": {
    "email": "test_payer@example.com"
  },
  "items": [
    {
      "title": "Meu produto",
      "unit_price": "10000",
      "quantity": 1
    }
  ],
  "taxes": [
    {
      "type": "IVA",
      "value": "500"
    }
  ]
}'