Melhor Envio: situações do envio, rastreio e o que dá para fazer em cada uma

Todo envio criado pelo Melhor Envio tem uma situação, e é ela que manda em tudo: no que a lista mostra, no que cada botão deixa fazer e no que o sistema aceita gravar. Entender a situação resolve a maior parte das dúvidas dessa integração. O Melhor Envio aqui é cotação de frete, pagamento do frete e etiqueta. Ele não traz pedido de fora: o envio nasce dentro do ERP, do zero ou a partir de um pedido do próprio ERP.

AS ONZE SITUAÇÕES
A lista é fechada. São essas e não existe outra: Pendente, Pago, Etiqueta gerada, Postado, Entregue, Não entregue, Cancelado, Prazo de postagem expirado, Em cancelamento, Etiqueta suspensa e Entrega interrompida. É exatamente essa lista que aparece no filtro de situação da busca avançada, e você pode marcar mais de uma.

QUEM ESCREVE CADA SITUAÇÃO
Três o próprio ERP grava. Pendente, toda vez que o envio é salvo. Pago, quando o pagamento é concluído: o ERP grava a situação que o Melhor Envio devolveu no fechamento. Em cancelamento, quando você pede o cancelamento e o Melhor Envio aceita o pedido.
As outras oito chegam de fora. O Melhor Envio avisa o ERP a cada mudança da etiqueta, e é nesse aviso que vêm Etiqueta gerada, Postado, Entregue, Não entregue, Cancelado, Prazo de postagem expirado, Etiqueta suspensa e Entrega interrompida. O ERP não fica perguntando de tempos em tempos como está a etiqueta. Ele espera o aviso. Por isso a situação pode continuar a mesma na tela mesmo com a encomenda já andando: a tela mostra o último aviso recebido, não uma consulta feita agora.

O QUE VEM JUNTO COM O AVISO
No mesmo aviso chegam o protocolo, o código de rastreio da transportadora, o link de rastreio, o código de rastreio do lojista e as datas de etiqueta gerada, de postagem, de entrega, de cancelamento e de expiração. Nenhum desses campos é digitado e nenhum é buscado pelo ERP. Se um deles está vazio, é porque o aviso correspondente ainda não chegou. Quando existe link de rastreio, o código na lista vira link para ele; e a coluna de rastreio só aparece na lista quando pelo menos um envio da tela já tem código.
Três regras importam no dia a dia. Cancelado, Entregue e Prazo de postagem expirado são situações finais: depois delas o ERP ignora avisos posteriores, e o envio não volta atrás. Já Não entregue não é final, continua recebendo avisos e ainda pode virar Entregue. Enquanto o envio está Em cancelamento, só o aviso de cancelamento confirmado muda alguma coisa; qualquer outro aviso é ignorado. E aviso que chega com status pendente, ou com um status que o ERP não reconhece, não altera nada.

O QUE DÁ PARA FAZER EM CADA SITUAÇÃO
Visualizar: sempre.
Editar e excluir: a tela só libera enquanto o envio está Pendente. Fora disso o botão de editar não leva a lugar nenhum e o de excluir nem aparece na linha. A razão é simples: pago, o envio já existe do lado do Melhor Envio, e apagar aqui não desfaz nada lá. (Se a lista estiver desatualizada e você clicar mesmo assim, o aviso é "Não é possível excluir um envio após ele ser pago.".)
Pagar: só em Pendente. Em qualquer outra situação a recusa cita a situação atual, no formato "A situação atual do envio(Postado) não realiza pagamentos". O pagamento também pode falhar por saldo insuficiente na conta do Melhor Envio. Isso se resolve colocando saldo, e a recarga por Pix é feita pelo próprio ERP: a fonte de saldo explica como.
Imprimir etiqueta: disponível quando o envio está Pago ou com Etiqueta gerada. Não fica disponível em Postado, Cancelado nem Em cancelamento.
Cancelar: também só em Pago ou Etiqueta gerada. Depois de Postado o botão está lá, mas cinza, e não faz nada.

PAGAR JÁ GERA A ETIQUETA
Não existe passo separado de gerar etiqueta. Assim que o pagamento é concluído, o ERP já pede a geração ao Melhor Envio na sequência. Por isso, se você mandar imprimir logo depois de pagar e aparecer "Aguarde alguns instantes para imprimir a etiqueta.", não é erro nem falha de configuração: a etiqueta ainda está sendo preparada do lado do Melhor Envio. Espere e tente de novo. A situação Etiqueta gerada, aliás, só é gravada quando o aviso de geração chega.

CANCELAR NÃO DEPENDE SÓ DO ERP
Antes de cancelar, o ERP pergunta ao Melhor Envio se aquela etiqueta pode ser cancelada. Se a resposta for não, você recebe "Não é possível cancelar a etiqueta, para mais detalhes entre em contato com Melhor Envio.". Esse não é do parceiro, não do ERP, e o suporte do ERP não tem como reverter. O caminho é falar com o Melhor Envio.
Se o pedido for aceito, o envio não vai direto para Cancelado. Ele fica Em cancelamento, com o retorno "Sua etiqueta esta sendo cancelada pelo Melhor Envio.", e só vira Cancelado quando a confirmação chegar. Envio parado em Em cancelamento é exatamente isso: pedido aceito, confirmação ainda não recebida.

O HISTÓRICO DA TELA DE VISUALIZAÇÃO
Na visualização do envio há um card Histórico com a linha do tempo das etapas e, logo abaixo, o link "Ver histórico completo", que abre a tabela com as colunas Situação, Protocolo e Cadastrado em. Esse histórico só ganha uma linha nova quando algo mudou de verdade: situação, protocolo, código de rastreio da transportadora, código de rastreio do lojista, link de rastreio ou uma das datas de etiqueta gerada, postagem, entrega, cancelamento e expiração. Aviso repetido, com os mesmos dados, é descartado. Então histórico curto não é histórico perdido, é repetição descartada.

SUMIRAM MEUS ENVIOS
Quase sempre é o período. O formulário da busca avançada já vem preenchido com o primeiro e o último dia do mês corrente. No momento em que você clica em Buscar na busca avançada, esse período vai junto e tudo que foi cadastrado fora do mês fica de fora do resultado. Nada foi apagado. Limpe ou amplie as datas.
Vale saber também que esse período olha a data de cadastro do envio no ERP, não a data em que a encomenda foi postada.

OS FILTROS DISPONÍVEIS
Na busca avançada: código, transportadora, destinatário (nome ou documento), período, situação, protocolo de envio e código de rastreio da transportadora. A busca simples do topo procura pelo protocolo e pelo destinatário (nome ou documento). Um detalhe que economiza tempo: na busca avançada, protocolo e código de rastreio são comparados por igualdade, então valor pela metade não encontra nada; já o campo destinatário e a busca simples aceitam parte do texto.

O QUE COSTUMA DAR ERRADO
"Integrei e a situação não muda." O ERP espera o aviso do Melhor Envio. Enquanto ele não chega, a tela fica na última situação conhecida. Não há botão de sincronizar.
"Paguei e não veio o rastreio." O código e o link de rastreio vêm no aviso do Melhor Envio, não no pagamento. Até lá os campos ficam vazios.
"A etiqueta não imprime." Se a mensagem for a de aguardar alguns instantes, é preparo. Se o botão nem responde, confira a situação: em Postado, Cancelado e Em cancelamento a impressão não fica disponível.
"Não consigo editar nem excluir." Só em Pendente. Depois de pago, não.
"Pedi cancelamento e continua Em cancelamento." Falta a confirmação do Melhor Envio chegar.
"O envio consta Entregue mas continuou andando." Entregue é situação final para o ERP; ele não regrava depois disso.
"Sumiram os envios." Período da busca avançada.

O QUE É DO ERP E NÃO SE EXPLICA AQUI
Cliente, fornecedor, produto e cidade usados no envio são cadastros do ERP: dentro do Melhor Envio essas telas caem nos controllers do próprio ERP, com as mesmas regras e permissões de sempre. Pedido e venda também são do ERP. Esta fonte responde só pela situação do envio e pelo que ela libera ou bloqueia.