Documentación Mercado Shops

Descubre toda la información que debes conocer sobre las APIs de Mercado Shops.
circulos azuis em degrade
Última actualización 15/03/2023

Facturación de ventas con cupones

Importante:
Esta funcionalidad aplica solo para descuentos cubiertos por el vendedor en el canal de Mercado Shops.

Los vendedores pueden generar cupones de descuento en su canal de Mercado Shops para ventas directas y/o de carrito. Para esto, deben cubrir el total del valor del cupón ofrecido y estar deducido en la factura que realice para evitar cobrar impuestos incorrectos. En el detalle del pago verás el uso del cupón en la transacción. Conoce más cómo crear, editar y eliminar cupón de descuento.


Validar pago aprobado

Antes de consultar los descuentos aplicados en determinados pagos de una orden, debes revisar que el detalle del pago en la orden tenga status: paid, y el pago con status: approved.


Cuando la venta sea mediante carrito de compras debes que tener en cuenta que:

  • El tag pack_order se genera automáticamente para poder discriminar si la orden está asociada a un carrito y no podrá ser borrado por el comprador o vendedor.
  • El campo pack_id muestra el número de carrito al que pertenece la orden.

Consultar cupones de descuentos para facturar

Utilizando el o los pagos de una orden, puedes consultar los cupones de descuento. Revisa el nodo de fee_details para reconocer el monto del descuento, siempre que el campo fee_payer sea igual a collector y que type sea igual a coupon_fee. Para conocer el valor total del descuento en la factura debes sumar los montos con type: coupon_feed.

Nota:
Si la venta es de carrito debes repetir estos pasos por cada pago realizado.

Ejemplo de pago de una orden:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadopago.com/v1/payments/15733180247

Respuesta resumida:

[…]
"fee_details": [
       {
           "amount": 13243.78,
           "fee_payer": "collector,
           "type": "coupon_fee"
       },
       {
           "amount": 8301.68,
           "fee_payer": "collector,
           "type": "application_fee"
       }
   ],
   "financing_type": null,
   "id": 15733180247,
   "installments": 1,
   "integrator_id": null,
   "internal_metadata": {
       "rule_engine": {
           "valid_promise": false,
           "with_promise": false,
           "rules": [
               {
                   "rule_id": 21000002955,
                   "rule_set": "processing_fee_and_release"
               }
           ]
       },
[…]

Siguiente: Gestión de ventas.