● AO VIVO · Fase 1 (só leitura). A lista vem direto da API do ML — bipe uma etiqueta real e ache a devolução. Nenhuma escrita no ML.
🔄 O fluxo que você descreveu
1
Lista do que está voltando
Todas as devoluções com o produto a caminho (hoje 13). Atualiza sozinho — some quando recebida.
2
Funcionário bipa a etiqueta
Código de barras, QR ou digita qualquer ID. O sistema testa todos os tipos de ID até achar.
3
Não está na lista? Busca no ML
Se o código não bater com nenhuma em trânsito, consulta a API do ML e traz mesmo assim.
4
Ficha completa e organizada
Máximo de dados da devolução agrupados pra leitura rápida + ação de recebimento que alimenta o pipe.
🔑 Os IDs que a etiqueta pode trazer
2000…
Nº da venda (order/pack) — o número grande impresso
552…
Claim ID — a chave-raiz da devolução no ML
47…
Cód. envio Mercado Envios — o código de barras de cima
AP…BR
Rastreio Correios (etiqueta kraft) — ou códigos de outras transportadoras
MLB…
Cód. do anúncio — fallback extra
Como cada etiqueta usa um número diferente, a busca varre os 5 ao mesmo tempo. Bipou → achou, não importa a transportadora.
🎯 Destino: o produto vem mesmo pra você?
A API revela algo que a etiqueta esconde — pra onde o pacote vai:
🔵 Seu galpão (Maringá) — chega e você bipa🟢 CD do ML (Cajamar) — fica no ML, você não recebe
Dos 13 de hoje: 6 vêm pro seu galpão, 5 vão pro CD do ML, 2 são não-entrega voltando. O painel já avisa quais esperar de fato.
🆕 3 automações que você pediu (1, 4 e 7)
⏱️ 1
Cronômetro de contestação — cada ficha mostra até quando dá pra reclamar avaria (3 dias úteis no seu galpão, 60 no CD). Passou, o prejuízo é seu.
💸 4
Guardião do reembolso — soma o dinheiro já devolvido sem produto de volta (hoje R$ 1.461,71), mostra há quantos dias está aberto e, passando de 14 dias, abre "não recebido" no ML sozinho.
🔁 7
Reincidência do comprador — quantas compras/devoluções ele já teve. Dado real: 10 dos 13 são 1ª compra já devolvendo; NATHAN_AMARAL tem 3 compras (recorrente — trate bem).
Tudo com dado real dos 13 de hoje — histórico de cada comprador puxado da API do ML.
📸 Conferência com prova (novo)
1
Prova de chegada — antes de abrir
Fotos/vídeo do volume lacrado, do jeito que chegou. Trava: só abre depois de registrado.
2
Abrir e checar avaria
Conferente abre e marca: sem avaria ✔ ou com avaria ⚠.
3
Prova da avaria → ML
Fotos do dano. A IA sugere a mensagem; o conferente revisa e aprova.
4
Envio automático ao Mercado Livre
Ao aprovar, o app sobe as fotos e abre a reclamação de avaria sozinho.
Motivo oficial "produto chegou avariado" na revisão da devolução
msg
Mensagem + anexos juntos (ação send_attachments)
Ressalva: envio automático só vale para devolução que vem pro 🔵 seu galpão e tem revisão disponível na janela do ML. As 🟢 do CD o ML revisa sozinho — não há o que enviar.
📱 Mockup mobile clicável — abra uma ficha 🔵, registre as provas, marque avaria e teste o envio ao ML. Me diga o que muda.