{"section":"tracks","requestedLocale":"pt","requestedSlug":"notificar-falha-de-entrega-na-shopee","locale":"pt","slug":"notificar-falha-de-entrega-na-shopee","path":"docs/pt/tracks/marketplace/integracao-shopee/notificar-falha-de-entrega-na-shopee.md","branch":"main","content":"Quando uma entrega na modalidade [Logística do vendedor](/pt/docs/tracks/logistica-do-vendedor-shopee) não pode ser concluída, a Shopee precisa ser notificada para que o comprador receba o estorno. Com o conector VTEX, essa notificação acontece automaticamente depois que você registra uma [nota fiscal de devolução](/pt/docs/tutorials/como-devolver-itens-do-pedido) no valor total do pedido no OMS.\n\n> ℹ️ Este fluxo se aplica apenas a pedidos da **Logística do vendedor**. Ele não está disponível para a modalidade [Shopee Full Logistics](/pt/docs/tracks/shopee-full-logistics).\n\n## Como notificar a falha de entrega\n\nO pedido precisa já ter sido faturado. Em seguida, faça uma **devolução total** no OMS seguindo os passos abaixo:\n\n1. No Admin VTEX, acesse **Pedidos > Todos os pedidos**, ou digite **Todos os pedidos** na barra de busca.\n2. Abra o pedido cuja entrega não pôde ser concluída.\n3. Siga o procedimento descrito em [Como devolver itens do pedido](/pt/docs/tutorials/como-devolver-itens-do-pedido) para devolver os itens e registrar a nota fiscal de devolução.\n4. Devolva **todos os itens** do pedido. A nota fiscal de devolução deve corresponder ao **valor total** do pedido, incluindo o frete.\n\n> ⚠️ A integração só notifica a Shopee quando a devolução é total. Se o valor da nota fiscal de devolução for menor que o valor total do pedido, a devolução é considerada parcial. Esse cenário não é suportado, e a Shopee não é notificada.\n\nSe você emitir mais de uma nota fiscal de devolução para o mesmo pedido, a soma dos valores deve ser igual ao valor total do pedido.\n\n## Notificar a falha de entrega via API\n\nOperações que registram a devolução pelo ERP ou por outro sistema de gestão também disparam a notificação automática à Shopee, desde que a nota fiscal de entrada seja lançada no OMS no valor total do pedido.\n\nUtilize o endpoint [Order Invoice Notification](https://developers.vtex.com/docs/api-reference/orders-api#post-/api/oms/pvt/orders/-orderId-/invoice):\n\n`POST /api/oms/pvt/orders/{orderId}/invoice`\n\nA nota fiscal deve ser registrada como nota de entrada, com `type: \"input\"`. A soma dos valores das notas fiscais de entrada precisa ser igual ao valor total do pedido, incluindo o frete. A mesma regra de devolução total descrita neste artigo se aplica.\n\n> ℹ️ Sempre que possível, registre a devolução pela página do pedido no Admin VTEX ou pela Orders API. Assim, o pedido permanece sincronizado na VTEX e a comunicação com a Shopee acontece automaticamente.\n\nSe a operação precisar informar a falha de entrega sem registrar a devolução no OMS, use o endpoint [Cancel Marketplace Delivery](https://developers.vtex.com/docs/api-reference/vtex-shopee-integration-api#post-/api/shopeeintegration/-accountName-/pub/orders/-mktplaceOrderId-/cancelDelivery):\n\n`POST /api/shopeeintegration/{accountName}/pub/orders/{mktplaceOrderId}/cancelDelivery`\n\nEsse caminho comunica à Shopee que a entrega não foi concluída, sem passar pelo fluxo de devolução do pedido na VTEX.\n\n## O que acontece depois da nota fiscal de devolução\n\nQuando a nota fiscal de devolução total é registrada no pedido, o conector identifica a devolução no OMS e notifica automaticamente a Shopee sobre a falha na entrega. Não é necessário notificar a devolução na Central do Vendedor da Shopee."}