Voltar para Central de ajuda
FT-EDI-QUALIFIED-GEN· v1.1.0De-para

Segmento qualificado sem qualificador: por que a mensagem não saiu

Segmentos como NAD, TAX, CUX (EDIFACT), N1 (X12) e E1EDKA1 (IDoc) só têm sentido com o qualificador. Quando o mapping gera um sem ele, o Lefia não envia e diz onde está a regra solta.

Atualizado em 04/10/2026

O que é um segmento qualificado



Alguns segmentos se repetem e o qualificador diz o papel de cada um: NAD+BY é o comprador, NAD+DP o local de entrega, TAX+7 o imposto, CUX+2 a moeda de referência. No X12 é o N101 do N1; no IDoc, o PARVW do E1EDKA1.

Sem o qualificador o parceiro não sabe o que o dado é — e rejeita o arquivo.

O que o Lefia faz



  • Na geração do mapping (assistente e "Sugerir"), nome, cidade e demais dados de um parceiro que vem numa lista (_Partner, to_Partner) ficam presos à instância do parceiro certo, pela função dele (AG → comprador, WE → entrega, RE → faturamento). Um campo que só cabe numa instância declarada pela mensagem (TAX+7, CUX+2) recebe o qualificador do catálogo.
  • Coleção maior que o segmento aceita: se a origem é uma lista (ex.: 18 condições de preço) e o grupo do destino aceita no máximo 5, a regra nasce para revisão, inativa. Escolha uma agregação (primeiro, juntar, somar) ou um filtro antes de ativar — o gate bloqueia a ativação sem isso.
  • No envio, se mesmo assim o mapping gerar um segmento qualificado sem o qualificador (mapping antigo ou editado à mão), o Lefia não envia. A mensagem fica em erro de mapping com o endereço de cada ocorrência (ex.: NAD.NAD01 ×1).
  • Qualificador que vem do próprio dado: no grupo do ajuste (AJT), o qualificador é o motivo do ajuste, um código da lista UNCL 4465 que vem da origem (pelo de-para). O texto do ajuste sai no FTX dentro desse grupo, nunca solto no cabeçalho. Se a origem não traz o motivo, o texto do ajuste não sai; se uma mensagem chega sem o motivo (ou sem de-para para ele), o ajuste dela não sai e o Lefia avisa, sem parar a mensagem.


Como corrigir



  1. Abra o mapping pela mensagem.
  2. Para cada regra apontada, ligue-a a uma instância: dê a ela o grupo do segmento (ex.: NAD+BY) e, se o dado vem de uma lista de parceiros, o filtro pela função do parceiro. O jeito mais rápido é Sugerir de novo — a geração já faz isso.
  3. Salve, ative e reprocesse a mensagem.


"Só obrigatórios"



No assistente, o modo Só obrigatórios agora leva o segmento obrigatório inteiro: o qualificador e o valor que forma par com ele (data do DTM, valor do MOA, preço do PRI). Antes vinha só o qualificador e o segmento saía vazio.

Histórico de versões

  • v1.1.0

    Sugerir de novo reescreve a instância inteira; parceiro da linha no NAD do LIN com nome; loopRoot na coleção (PR #1134); trava da linha com alarme agregado por passada, aviso de coleção deduplicado e exemplo medido (PR #1136). Release #1138.

    25/09/2026 · updated

  • v1.0.0

    Geração correta de segmento qualificado: atributo do array de parceiros herda a instância (NAD+BY/DP/IV no EDIFACT, N1 no X12, E1EDKA1 no IDoc); qualificador único vem do catálogo (TAX+7, CUX+2); coleção maior que o grupo nasce como regra candidata inativa e o gate bloqueia a ativação (collection_overflow); o motor recusa ocorrência de segmento qualificado sem qualificador e a mensagem para em erro de mapping com o endereço de cada ocorrência; "Só obrigatórios" leva o segmento inteiro (qualificador + par de valor). Caso de ouro SO 6: 0 erros no validador e no Stedi. Mapping antigo com NAD/TAX soltos para no motor até ser regerado.

    24/09/2026 · new