Developers

Última atualização em 04/09/2023

Emissão de nota fiscal de venda com cupom

Importante:

A funcionalidade de cupom do vendedor está disponível somente para o Brasil.

Os vendedores podem gerar cupons de desconto para vendas diretas e/ou de carrinho dentro do canal de Marketplace. Para isso, eles devem consultar 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 preencher os dados da NF-e corretamente .

Validar pagamento aprovado

Antes de consultar o desconto gerado por um cupom aplicado a determinado pagamento 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 em fee_details para reconhecer o valor do desconto, desde que o campo fee_payer seja igual ao 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"
               }
           ]
       },
[…]