New Shopee's Openapi Announcement (ID: 1575)
**Olá Desenvolvedores,
**Confira abaixo as atualizações da OpenAPI disponibilizadas nesta versão. Essas mudanças têm como objetivo aprimorar as funcionalidades, aumentar a flexibilidade e oferecer melhor suporte à integração.
**1. APIs de Pagamento adicionam o campo Pay Per Sale
****Contexto**Para oferecer suporte ao modelo de cobrança de publicidade CPS (Cost per Sale - Custo por Venda), a Shopee cobrará dos vendedores uma Taxa de Anúncios Pay Per Sale para pedidos concluídos que tenham sido atribuídos a anúncios.A taxa será calculada após a conclusão do pedido, com base no valor das vendas atribuídas aos anúncios e no ROI Alvo (Target ROI), e será descontada do valor em Escrow do vendedor.Para ajudar os desenvolvedores a identificar essa cobrança, o campo pay_per_sale será adicionado às APIs de Pagamento OpenAPI relevantes.
Escopo aplicávelID, MY, PH, SG, TH, VN, TW, BR
**Detalhes da atualização
**As APIs v2.payment.get_escrow_detail e v2.payment.get_escrow_detail_batch adicionarão ou atualizarão os seguintes campos de resposta para exibir a Taxa de Anúncios Pay Per Sale:
| Campo |
Tipo |
Descrição |
| order_income > pay_per_sale |
Novo campo de resposta |
Taxa de Anúncios Pay Per Sale no nível do pedido. Fórmula: Vendas do Pedido Concluído atribuídas aos anúncios / ROI Alvo. Este é um valor final, mas pode ser atualizado após uma devolução/reembolso ou cancelamento. |
| order_income > escrow_amount |
Alteração na descrição |
O valor de Escrow do pedido incluirá a dedução da Taxa de Anúncios Pay Per Sale. Este é um valor final, mas pode ser atualizado após uma devolução/reembolso ou cancelamento. |
*Observações:
*- A Taxa de Anúncios Pay Per Sale será registrada como um valor negativo em Fees & Charges (Taxas e Encargos) e será deduzida do valor de Escrow do vendedor.- Quando o valor de pay_per_sale for 0, a API continuará retornando o campo com o valor 0.- Os desenvolvedores devem atualizar o processamento das APIs de Pagamento, os cálculos de receita dos pedidos e a lógica de conciliação financeira de acordo com essa alteração.- Também é importante considerar as diferentes regras de atualização dos campos no nível do pedido e no nível do item após uma devolução/reembolso ou cancelamento.
API'S relacionadas- v2.payment.get_escrow_detail- v2.payment.get_escrow_detail_batch
A mudança ja está vigente e será necessário considerar o novo parâmetro o mais breve possível.
Announcement URL: https://open.shopee.com/announcements/1575
@junie-agent Please review the API changes described above. Focus ONLY on major updates such as adding new endpoints or removing/taking legacy APIs offline. You can safely ignore any other changes regarding request/response parameters or fields. Update the PHP code and create a new PR for review. Close issue if nothing changes applied.
New Shopee's Openapi Announcement (ID: 1575)
**Olá Desenvolvedores,
**Confira abaixo as atualizações da OpenAPI disponibilizadas nesta versão. Essas mudanças têm como objetivo aprimorar as funcionalidades, aumentar a flexibilidade e oferecer melhor suporte à integração.
**1. APIs de Pagamento adicionam o campo Pay Per Sale
****Contexto**Para oferecer suporte ao modelo de cobrança de publicidade CPS (Cost per Sale - Custo por Venda), a Shopee cobrará dos vendedores uma Taxa de Anúncios Pay Per Sale para pedidos concluídos que tenham sido atribuídos a anúncios.A taxa será calculada após a conclusão do pedido, com base no valor das vendas atribuídas aos anúncios e no ROI Alvo (Target ROI), e será descontada do valor em Escrow do vendedor.Para ajudar os desenvolvedores a identificar essa cobrança, o campo pay_per_sale será adicionado às APIs de Pagamento OpenAPI relevantes.
Escopo aplicávelID, MY, PH, SG, TH, VN, TW, BR
**Detalhes da atualização
**As APIs v2.payment.get_escrow_detail e v2.payment.get_escrow_detail_batch adicionarão ou atualizarão os seguintes campos de resposta para exibir a Taxa de Anúncios Pay Per Sale:
*Observações:
*- A Taxa de Anúncios Pay Per Sale será registrada como um valor negativo em Fees & Charges (Taxas e Encargos) e será deduzida do valor de Escrow do vendedor.- Quando o valor de pay_per_sale for 0, a API continuará retornando o campo com o valor 0.- Os desenvolvedores devem atualizar o processamento das APIs de Pagamento, os cálculos de receita dos pedidos e a lógica de conciliação financeira de acordo com essa alteração.- Também é importante considerar as diferentes regras de atualização dos campos no nível do pedido e no nível do item após uma devolução/reembolso ou cancelamento.
API'S relacionadas- v2.payment.get_escrow_detail- v2.payment.get_escrow_detail_batch
A mudança ja está vigente e será necessário considerar o novo parâmetro o mais breve possível.
Announcement URL: https://open.shopee.com/announcements/1575
@junie-agent Please review the API changes described above. Focus ONLY on major updates such as adding new endpoints or removing/taking legacy APIs offline. You can safely ignore any other changes regarding request/response parameters or fields. Update the PHP code and create a new PR for review. Close issue if nothing changes applied.