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 completarse únicamente con un valor numérico entero. Nunca envíes el símbolo de porcentaje o caracteres especiales.| Campo | Tipo | Descripción | Observaciones |
items | Array | Lista de productos o servicios a cobrar | - |
items.title | String | Título del producto o servicio | - |
items.quantity | Integer | Cantidad de unidades | - |
items.unit_price | String | Precio unitario del producto sin IVA | - |
items.currency_id | String | Identificador de la moneda (COP para Colombia) | - |
taxes | Array | Lista de impuestos aplicables | Si 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.type | String | Tipo de impuesto (IVA) | - |
taxes.value | Integer | Monto del impuesto en valores absolutos | Debe ser un monto entero, no acepta decimales o caracteres especiales. Para productos exentos de IVA, asígnale un valor de 0. |
El
total_amount de la order debe incluir el IVA. Por ejemplo, si el precio del producto es 10.000 COP y el IVA es 500 COP, el total_amount debe ser 10.500 COP.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": "10500", "external_reference": "order_pro_123", "payer": { "email": "test_user_co@testuser.com" }, "items": [ { "title": "Mi producto", "unit_price": "10000", "quantity": 1, "unit_measure": "unit", "total_amount": "10000", "currency_id": "COP" } ], "taxes": [ { "type": "IVA", "value": 500 } ] }'