Developers

Documentação do Mercado Shops

Confira todas as informações necessárias sobre as APIs Mercado Shops.

Documentação do

Última atualização em 15/03/2023

Emissão de nota fiscal de venda com cupom

Importante:

Esta funcionalidade é válida apenas aos descontos concedidos pelo vendedor no canal Mercado Shops.

Os vendedores podem gerar cupons de desconto em seu canal Mercado Shops para vendas diretas e/ou de carrinho. Para isso, eles devem pagar o valor total do cupom oferecido e deduzir este valor na Nota Fiscal (NF) para evitar a cobrança de impostos indevidos. No detalhe do pagamento da venda você verá o uso do cupom na transação. Conheça mais como criar, editar e excluir cupom de desconto.

Validar pagamento aprovado

Antes de consultar os descontos gerados por um cupom aplicados a determinados pagamentos de um pedido, você deve verificar se o detalhe do pagamento na order tem status: paid, e o pagamento status: approved.

Quando a venda for de carrinho de compras, considere:

A tag pack_order é gerada automaticamente para poder discriminar se o pedido está associado a um carrinho e não pode ser excluído pelo comprador ou vendedor.
O campo pack_id é o número do carrinho da order.

Identifique vendas com cupons para emissão da NF-e

Usando o(s) pagamento(s) de uma order, você pode verificar os valores do(s) cupom(ns) de desconto. Verifique fee_details para reconhecer o valor do desconto, desde que o campo fee_payer seja igual a collector e que type seja igual a coupon_fee. Para identificar o valor total do desconto para a NF você deve somar os valores com type: coupon_fee.

Nota:

Se a venda for de carrinho ou se a venda possuir mais de um pagamento, você deverá repetir essas etapas para cada pagamento realizado.

Exemplo de pagamento de uma order:

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

Resposta curta:

[…]
"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"
               }
           ]
       },
[…]

Próxima: Gestão de vendas.