Recursos para IA

Consideraciones sobre el IVA en Colombia

El IVA (Impuesto al Valor Agregado) es una carga fiscal que recae sobre la venta de productos o la prestación de servicios dentro del territorio colombiano.

Algunos productos y servicios están excluidos del IVA y otros tienen tarifas reducidas. En la actualidad, la tarifa general de este impuesto es del 19%.

Impuestos en pagos online

Para procesar el IVA correctamente, puedes enviar el monto neto (unit_price) e IVA (taxes) al momento de crear la order a través del endpoint Crear orderAPI.

El parámetro taxes.value debe enviarse como una cadena que represente un monto entero. No envíes el símbolo de porcentaje, decimales ni caracteres especiales.
CampoTipoDescripciónObservaciones
itemsArrayLista de productos o servicios a cobrar-
items.titleStringTítulo del producto o servicio-
items.quantityIntegerCantidad de unidades-
items.unit_priceStringPrecio unitario del producto sin IVA-
taxesArrayLista de impuestos aplicablesSi no se envía ningún valor, se considera por defecto que debe aplicarse una reducción del 19% sobre el monto total de la transacción, correspondiente al IVA general.
taxes.typeStringTipo de impuesto (IVA)-
taxes.valueStringMonto del impuesto en valores absolutosDebe enviarse como una cadena que represente un monto entero. Para productos exentos de IVA, asígnale el valor "0".
El total_amount de la order siempre es la suma de items[].unit_price × items[].quantity y no incluye taxes[].value. Por ejemplo, si el precio del producto es 10.000 COP y el IVA es 500 COP, el total_amount sigue siendo 10.000 COP; el IVA se informa por separado en el 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": "Mi producto",
      "unit_price": "10000",
      "quantity": 1
    }
  ],
  "taxes": [
    {
      "type": "IVA",
      "value": "500"
    }
  ]
}'