EDI com o varejista

Liga a sua empresa ao grande varejista pela VAN (Neogrid e similares). O pedido dele entra sozinho a cada 15 minutos e vira pedido de venda; o aviso de embarque e a fatura voltam para ele pelo mesmo caminho.

Crie o canal: o varejista, o GLN da sua empresa, o GLN dele, o endereço SFTP da VAN, o usuário e a senha (guardados cifrados; a senha nunca volta para a tela) e as pastas de entrada e de saída. Sem credencial ainda, escolha "VAN simulada" para ensaiar.

O aviso de embarque só sai da expedição conferida (caixas com SSCC batendo com o pedido). A fatura só sai de nota autorizada. As duas ficam na lista de mensagens e seguem para a VAN no próximo ciclo; a confirmação do varejista muda a situação para Confirmada.

Peça ao provedor da VAN o endereço SFTP, o usuário, a senha ou a chave privada e a impressão digital da chave do servidor (SHA256:… ou a linha do known_hosts). Cadastre tudo no canal. A chave do servidor é obrigatória: confira com o provedor e nunca copie a que aparece na primeira conexão sem conferir. A chave privada é opcional e substitui a senha (formato OpenSSH ou PKCS#8, sem frase-senha). Se a chave do servidor não bater, o hub de integrações mostra "a VAN não aceitou a conexão".

Cada arquivo de pedido que chega pela VAN, ou que é colado na tela, tem um limite de tamanho: 5 MB por padrão. Acima dele o arquivo é recusado sem ser aberto: a mensagem aparece como recusada com o tamanho e o limite, e a recusa volta ao varejista. Peça ao varejista para dividir o pedido em arquivos menores. Se a sua operação precisa de arquivos maiores, ajuste o limite em Parâmetros (EDI.TETO_BYTES, em bytes).

O pedido com algum GTIN sem de-para não entra pela metade: fica em "Pendências de de-para" com a lista dos GTIN. Diga qual variação (cor e tamanho) é cada GTIN e clique em "Processar de novo" — o pedido entra inteiro. A grade fechada do item continua valendo.

Ao alterar o canal, deixe a senha e a chave privada em branco para manter as que já estão guardadas. Elas nunca voltam para a tela; para trocar, digite a nova.

Um link para esta tela com o número de um documento (o pedido do varejista, o intercâmbio UNB, a mensagem UNH ou o número do pedido criado) mostra só as mensagens daquele documento. O filtro aparece acima da lista, com o botão "Ver todas" para voltar à lista inteira. O retorno de recebimento do varejista (CONTRL) aparece como "Retorno lido".

Se a VAN não responder por mais de dois ciclos (30 minutos), o hub de integrações mostra o aviso. Sem credencial, o canal pode rodar no modo "VAN simulada", para ensaiar o fluxo sem falar com ninguém — a tela diz que é simulada.

Logo depois de excluir, a barra de Desfazer aparece por 15 segundos. Passou o tempo, o canal fica em "Canais na lixeira", embaixo da lista de canais: clique em Restaurar e ele volta a recolher no próximo ciclo. As mensagens do canal nunca são apagadas.

A VAN tem de ser um endereço público na internet, o que o provedor da VAN informa. Endereço da rede interna (localhost, 10.x, 172.16 a 172.31, 192.168.x, 169.254.x) é recusado: uma conexão para lá sairia do Tenka e voltaria para dentro.

Na troca simulada não existe varejista do outro lado: a confirmação de recebimento e a resposta do pedido são marcadas como enviadas assim que o pedido colado entra, com a frase de que nada saiu da empresa. Na troca real elas saem pela pasta de envio no ciclo de 15 minutos.

Pergunte "quais pedidos EDI estão com GTIN sem de-para?". A resposta traz cada pedido com o número do varejista, o canal e os códigos que faltam, e o caminho até esta tela para dizer a variação de cada código. Sem pedido travado, a resposta diz que não há pendência.