9:41📶 🔋 100%

Devoluções ML · Recebimento

Galpão Maringá · aguardando o produto voltar

🔄
📷
Bipar código / QR ou digitar ID código de barras, nº da venda, claim, envio ou rastreio
Aguardando recebimentotoque p/ ver

Bipar devolução

Aponte para o código de barras / QR da etiqueta

câmera (mockup)
Verifica em todos os IDs: nº venda · pack · claim · envio (47…) · rastreio (AP…BR e outros)
Toque para simular uma bipagem

Devoluções ML — Recebimento no Galpão

● 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.

✅ A API do ML permite (confirmado na doc)

  • POST
    Subir provas: /claims/{id}/attachments — ≤5MB, JPG/PNG/PDF
  • SRF2
    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.