Gestão EDI: conexões EDI e configuração de parceiros

Conecte um varejista por uma plataforma EDI em um único assistente, mapeie seus documentos sem código e acompanhe cada transmissão em linguagem clara.

A gestão EDI fica em Integration → EDI e tem quatro páginas que trabalham juntas: Conexões (uma linha por varejista + conta de plataforma), Mappings (como cada tipo de documento é traduzido), Tabelas de códigos (as listas de consulta usadas pelos mappings) e Transmissões (cada documento enviado ou recebido). Todas as plataformas usam o mesmo assistente, a mesma visão de detalhes, a mesma ferramenta de mapping e o mesmo formato de erro em linguagem clara. Os tipos de documento que você pode ativar incluem 850 Pedido de compra, 855 Confirmação de pedido, 856 ASN, 940 / 945 documentos de expedição de armazém, 846 Aviso de estoque, 947 Ajuste de estoque, 943 / 944 transferências de estoque, 810 Fatura, 210 Fatura de frete, 204 Cotação de carga e 214 Status de remessa.

Etapa 1: Abra o assistente de conexão e escolha a plataforma#

1. Abra Integration → EDI → Conexões (/integration/edi/connections) e clique em «+ Nova conexão». O mesmo assistente de cinco etapas abre para todas as plataformas: 1 Plataforma → 2 Credenciais → 3 Testar conexão → 4 Mapping / modelo → 5 Prévia de exemplo.
2. Escolha a plataforma EDI (conector) e preencha o nome da conexão e o código do varejista — por exemplo WALMART. Digite o código diretamente; os mesmos códigos são usados em todo o Docklify.
3. Marque os tipos de documento que esta conexão vai usar. Entrada significa varejista → Docklify; saída, Docklify → varejista. Cada tipo ativado deve receber um mapping na etapa 4.
4. Deixe o Modo de teste e o Modo de exemplo ativados durante a configuração: assim a conexão pode ser criada, testada e pré-visualizada com documentos de exemplo antes de os documentos reais fluírem.

Etapa 2: Insira as credenciais e defina os alertas de falha#

• O formulário de credenciais é gerado a partir da lista de campos da própria plataforma — você só vê os campos que ela realmente precisa. Campos secretos são senhas e nunca são exibidos de volta.
• Os alertas de falha são definidos na mesma etapa: alertar após N falhas consecutivas (padrão 3) e pausa automática após N falhas consecutivas (padrão 10), para que uma conexão quebrada pare de bater na plataforma em vez de falhar para sempre.
• Notificações: a notificação no app vem ativada por padrão; a por e-mail, desativada. Ative o e-mail se a equipe que acompanha esse varejista não fica no Docklify o dia todo.

Etapa 3: Teste a conexão#

1. Clique em «Criar e testar conexão». O Docklify cria a conexão e executa o teste na hora: você verá «Teste de conexão aprovado» com a latência, ou uma falha em linguagem clara — o que aconteceu e o que fazer em seguida, nunca um stack trace.
2. Quando o teste obtém um documento de exemplo, ele é mostrado no assistente e passa por uma verificação de mapping. Se a verificação listar problemas, corrija-os na etapa 4 / na ferramenta de Mapping e teste novamente antes de ativar a conexão.

Etapa 4: Vincule um mapping ou clone um modelo#

• Para cada tipo ativado, vincule um mapping existente ou clone um modelo da biblioteca. Ao clicar em Concluir, o modelo clonado vira um mapping real desta conexão.
• Você também pode deixar um tipo «sem mapping ainda» e concluir — mas as transmissões desse tipo falharão até que um mapping seja vinculado em Integration → EDI → Mappings, então vincule antes de os documentos reais chegarem.

Etapa 5: Execute uma prévia com um exemplo e conclua#

1. Escolha o tipo de documento para a prévia e cole um documento de exemplo (JSON) na caixa de exemplo.
2. Clique em «Executar prévia». Cada campo mapeado retorna com seu destino, o valor de origem, a cadeia de funções aplicada, o valor de saída e, quando algo falha, o motivo em linguagem clara.
3. Quando todos os campos passarem, clique em Concluir. Se um campo falhar, corrija o mapping na ferramenta de Mapping e execute de novo — não conclua com uma prévia falhando na esperança de dar certo.

No dia a dia: gerencie as conexões pela lista e pelos detalhes#

• A lista mostra, por conexão: plataforma, varejista, tipos ativos, modo (com selos de Teste / Exemplo quando ativos) e status. As ações da linha são Testar, Detalhes e Excluir — excluir uma conexão apaga também as credenciais.
• O interruptor de uma conexão a pausa ou retoma sem apagar nada — use-o quando um varejista pedir para parar os envios por um tempo.
• Detalhes abre o painel da conexão: Saúde (últimas 24h) com taxa de sucesso e falhas consecutivas — Saudável, Degradado (o limite de alerta foi atingido) ou Pausado — além da configuração de alerta / pausa, do último teste e das transmissões recentes com botões Tentar novamente e Reexecutar.

Mappings: traduza documentos sem escrever código#

1. Abra Integration → EDI → Mappings (/integration/edi/mappings). Comece em «+ Novo mapping» ou abra a aba Biblioteca de modelos e clone um modelo que já sirva para sua plataforma e tipo de documento.
2. No editor, nomeie o mapping, escolha o tipo de documento e a direção, e monte as linhas: clique ou arraste um campo de origem para uma linha, defina o campo de destino (Canonical) e encadeie funções — ou use uma constante, uma consulta em tabela de códigos e uma condição opcional — até a linha produzir o valor certo.
3. Teste com um exemplo no editor e depois Ative. A ativação é bloqueada enquanto campos obrigatórios estiverem sem mapeamento — o editor lista exatamente quais faltam.
4. Cada salvamento cria uma nova versão. Versões abre o histórico: compare duas versões lado a lado (linhas adicionadas / removidas / alteradas) ou reverta — reverter abre aquela versão no editor, e você a testa antes de ativar, como qualquer alteração.

Tabelas de códigos: as listas que os mappings usam#

• Abra Integration → EDI → Tabelas de códigos (/integration/edi/code-tables) e clique em «+ Nova tabela». Dê um nome em minúsculas_com_underscores — por exemplo upc_to_sku, uom_map ou carrier_map — e um rótulo claro.
• Edite as entradas como pares simples: De (o valor que o varejista envia) → Para (o valor que o Docklify usa), mais uma nota opcional. Tabelas típicas traduzem códigos ship-to do varejista, unidades de medida e códigos de transportadora — a operação as mantém aqui, sem código.
• Valores De duplicados são destacados em vermelho — corrija-os antes de salvar, porque um De só pode apontar para um Para. Para listas longas, use Importar CSV (cole linhas de,para,nota, uma por linha; duplicadas são ignoradas) e Exportar CSV para baixar a tabela.
• Salvar uma tabela cria uma nova versão dela. Os mappings referenciam a tabela junto com sua versão, então editar uma tabela aqui não altera silenciosamente mappings já ativos.

Transmissões: acompanhe cada documento e corrija o que falhou#

• Abra Integration → EDI → Transmissões (/integration/edi/transmissions). Filtre por status, tipo de documento ou direção, ou pesquise pelo número de negócio / id externo. Os status são claros: Recebido, Mapeado, Concluído, Falhou, Duplicado, Morto e ACK pendente.
• Abra os Detalhes de uma transmissão para ver o documento original como chegou e sua forma Canônica após o mapping, junto com status e ACK — esse par é o primeiro a conferir quando um parceiro diz que um documento «está estranho».
• Os erros são escritos para pessoas: um título, o que aconteceu e o que fazer em seguida. Se o erro pode ser tentado de novo, a linha mostra o selo «Pode tentar novamente» e o botão Tentar novamente. Erros que tentar de novo não resolve — falhas de autenticação, erros de mapping — não mostram botão: corrija primeiro as credenciais ou o mapping e depois use Reexecutar para rodar o documento original de novo (disponível para transmissões com Falha e Mortas).

Recursos do Docklify usados neste artigo#

• Assistente EDI de cinco etapas: plataforma, credenciais, teste, mapping / modelo, prévia — Integration → EDI → Conexões → + Nova conexão (/integration/edi/connections)
• Detalhes da conexão: saúde de 24h, falhas consecutivas, configuração de alerta / pausa e transmissões recentes — Integration → EDI → Conexões → Detalhes
• Editor de mapping sem código com biblioteca de modelos, teste com exemplo, histórico de versões, comparação e reversão — Integration → EDI → Mappings (/integration/edi/mappings)
• Tabelas de códigos com versões, verificação de duplicados e importação / exportação CSV — Integration → EDI → Tabelas de códigos (/integration/edi/code-tables)
• Registro de transmissões com erros em linguagem clara, nova tentativa e reexecução — Integration → EDI → Transmissões (/integration/edi/transmissions)