Conciliador de Taxas de Marketplace
Encontra o que o marketplace cobrou errado, e o que ele te deve
- 8regras rígidas
- Coisas que ele nunca pode fazer, impostas em toda execução
- 5regras de repasse
- Condições em que ele para e entrega o trabalho a uma pessoa
- 8campos de saída
- Um resultado estruturado, não um parágrafo para reler
- ≤6passos por execução
- Trabalho delimitado: no máximo 4 chamadas de ferramenta, impostas pelo runtime
Somente leitura, por projeto. Este agente não tem caminho para enviar, gastar, publicar ou assumir nada. Onde esse limite é o produto, tirá-lo tiraria o motivo para confiar no resultado.
Visão geral
Vender por um grande marketplace significa aceitar um extrato de repasse com dezenas de tipos de taxa por pedido, calculados pelo marketplace a partir dos registros dele, sem nenhuma linha que um vendedor consiga verificar sem reconstruir o cálculo.
Na maior parte, está certo. Em escala as exceções valem muito, e correm numa direção só.
Taxas de logística são cobradas pela faixa de tamanho e peso que o marketplace mediu, e um item mal medido é cobrado numa faixa mais alta em toda unidade vendida, indefinidamente. Uma comissão é cobrada pela alíquota de uma categoria, e um item classificado na categoria errada paga a alíquota errada para sempre. Estoque se perde, é danificado no galpão, ou é descartado sem instrução — o ressarcimento existe mas precisa ser reivindicado. Um cliente é reembolsado e o item nunca volta. Uma devolução é recebida e nunca reestocada.
Cada um tem uma janela de reivindicação, normalmente curta, e nenhum aparece como problema em qualquer relatório que o marketplace forneça. O vendedor vê um depósito líquido e nenhum motivo para questionar.
Este agente reconstrói o repasse contra o seu próprio catálogo e seus registros de embarque e reporta cada divergência com o prazo e a evidência de que uma reivindicação precisaria. Ele não protocola nada: reivindicações passam pelo processo do próprio marketplace sob a sua conta, e uma rodada automatizada de reivindicações é como uma conta de vendedor é sinalizada.
Benefícios
Dinheiro de volta que já era seu
Nada vendido, nada negociado.
Os erros recorrentes corrigidos
Uma faixa de tamanho errada para de te custar em toda unidade futura.
Prazos cumpridos
Que é a diferença inteira entre um achado e uma recuperação.
O que faz
Confere a faixa de tamanho e peso
Um item mal medido é cobrado uma faixa acima em toda unidade vendida, indefinidamente. Nada em relatório algum mostra.
Verifica a alíquota da categoria
Um item na categoria errada paga a comissão errada em todo pedido, para sempre.
Encontra estoque perdido ou danificado no galpão deles
O ressarcimento existe e precisa ser reivindicado. Ninguém vai oferecer.
Cruza reembolsos com devoluções recebidas
Um cliente reembolsado e o item nunca voltou. Em volume esta é a maior categoria.
Todo achado tem o prazo de reivindicação
As janelas são curtas. Uma divergência encontrada tarde não vale exatamente nada.
Não protocola nada
Reivindicações passam pelo processo do próprio marketplace sob a sua conta, e uma rodada automatizada é como uma conta de vendedor é sinalizada.
O que isso muda
O que isso muda na sua semana
- Ele assume
- Reconstruir os repasses do marketplace contra o seu próprio catálogo e seus embarques.
- Hoje quem faz é
- Ninguém. O vendedor vê um depósito líquido e nenhum motivo para questionar.
- Com que frequência
- Precisa ser mensal — as janelas de reivindicação são curtas.
- Esforço manual típico
- Dezenas de tipos de taxa por pedido, calculados pelo marketplace a partir dos registros dele.
Por que E-commerce em particular. Um item mal medido é cobrado uma faixa de tamanho acima em toda unidade vendida, indefinidamente, e nada em relatório algum do marketplace mostra isso. Ressarcimentos existem e precisam ser reivindicados; ninguém os oferece.
Roda sem supervisão
Você ou um evento dá a partida, e ele chega ao fim sozinho. Nada fica esperando alguém estar na mesa.
O mesmo padrão todas as vezes
O ducentésimo item recebe o mesmo rigor do primeiro. A constância é a parte que as pessoas não conseguem sustentar.
Ele não pode agir por conta própria
Conciliador de Taxas de Marketplace não tem caminho para enviar, gastar ou assumir compromissos. É esse limite que torna seguro agir com base no que ele entrega.
Como roda
Este agente é executado no servidor, pelo ambiente de execução da PROMIVO. Cada execução é registada passo a passo e cada chamada de ferramenta tem as permissões verificadas antes de ser executada.
- 1EntradaValidada contra o esquema de entrada do agente
- 2Modeloclaude-sonnet-5 com fallback automático
- 3Ferramentasextract_structured_data
- 4PermissõesExecuta automaticamente as ações de nível READ; tudo acima disso espera aprovação
- 5SaídaResultado estruturado, conforme o esquema de saída
- 6RegistroTokens, duração e cada passo ficam registrados
Demonstração
Dados de demonstraçãoIllustrative sample output, abridged.
Entrada
{
"period": "Q3 2026",
"currency": "USD",
"claimWindowDays": 60,
"settlementLines": []
}Saída
{
"escalate": true,
"findings": [
{
"sku": "SKU-4412",
"type": "wrong-size-band",
"charged": 5.94,
"claimBy": "2026-10-14",
"daysLeft": 42,
"expected": 4.11,
"reference": "Fulfilment fee, all orders",
"unitsAffected": 3140,
"evidenceNeeded": "Your packed dimensions and weight, with a photograph of the item on a scale.",
"perUnitDifference": 1.83,
"annualisedIfUnfixed": 22980
},
{
"sku": "Various",
"type": "refund-without-return",
"charged": 0,
"claimBy": "2026-09-11",
"daysLeft": 9,
"expected": 0,
"reference": "88 orders",
"unitsAffected": 88,
"evidenceNeeded": "Order identifiers and the marketplace's own return-window dates for each.",
"perUnitDifference": 0,
"annualisedIfUnfixed": 0
}
],
"disclaimer": "A reconciliation of settlement reports against your own records. No claim has been filed, no seller account accessed, no marketplace or customer contacted, no listing changed, and discrepancies where your own record could equally be wrong are reported as unresolved rather than as overcharges.",
"stillAccruing": [
"SKU-4412 is still selling in the wrong size band. Every unit shipped from today costs 1.83 more than it should, and that continues until the measurement is corrected."
],
"totalIdentified": 41200,
"escalationReason": "9,400 of identified claims expire within 9 days, and a recurring size-band error is still accruing on a product that is still selling.",
"expiringWithin14Days": 9400,
"unresolvedDiscrepancies": [
"Two SKUs where your recorded weight and theirs differ by under 30g. Either record could be right, so these are reported as unresolved rather than as overcharges."
]
}Requisitos
Integrações
Nenhuma integração necessária.
Antes de começar
- Relatórios de repasse e de taxas do marketplace
- Seu próprio catálogo com dimensões, pesos e categorias pretendidas
- Registros de embarque: o que vocês enviaram, o que foi recebido
- Registros de reembolso e devolução
- Requer o plano Acesso total ou superior
Casos de uso
Revisão mensal de repasses
Cada extrato reconstruído contra os seus próprios registros.
Depois de uma mudança de taxas
Se as novas alíquotas foram aplicadas corretamente ao seu catálogo.
Logística de alto volume
Onde um pequeno erro por unidade é um número anual grande.
Antes de um período fechar
Reivindicações identificadas enquanto as janelas ainda estão abertas.
Preço
Acesso total
Cobrado mensalmente pela sua assinatura PROMIVO. Cancele quando quiser.
As execuções consomem a cota do seu plano para execuções de agentes e tokens. Veja limites do plano
Perguntas frequentes
Ele protocola reivindicações?
Não. Reivindicações passam pelo processo do próprio marketplace sob a sua conta, e submissão automatizada é um bom jeito de ter uma conta de vendedor sinalizada. Ele te dá o caso e a evidência.
Ele precisa de acesso à API do marketplace?
Não. Ele trabalha a partir dos relatórios de repasse e do seu próprio catálogo e registros de embarque — exportações que vocês já conseguem baixar.
E se a medição do marketplace estiver certa e a nossa errada?
Então não é um achado, e ele diz isso. Onde os dois discordam e nenhum pode ser confirmado, ele reporta a divergência como não resolvida em vez de como cobrança a maior.
Avaliações
As avaliações abrem depois que os clientes tiverem executado este agente.
Precisa que este agente funcione de outro jeito?
Diga o que mudar e a nossa equipe vai definir o escopo de uma versão personalizada para a sua empresa.
Personalizar este agente