Todos os artigos
help.categories.mapping

O que significa "campo obrigatório do destino não preenchido"

Quando o sistema mostra warning sobre campo obrigatório do destino, está apontando um gap REAL no mapping — não ruído.

Atualizado em 5/25/2026

O que é



Ao abrir "Ver saída do mapping", o sistema mostra warnings tipo:

Campo obrigatório do destino não preenchido: NAD[*].C080.C08001. Sem este valor, o parceiro EDI rejeita a mensagem.

Por que aparece



O catálogo do destino (ex: INVOIC_D01B EDIFACT) declara que NAD[*].C080.C08001 (Party Name 1) é obrigatório quando o segmento NAD é emitido. O sistema verifica:

  1. Você está emitindo NAD? Sim (tem regra mapeando algum field pra NAD[].)
  2. NAD[*].C080.C08001 está preenchido em todos os items? Não
  3. → emite warning legítimo


Quando NÃO aparece (parent-segment guard)



O sistema não emite warning quando:
  • O segmento pai não é emitido pelo mapping (operador não mapeou nada pra NAD → silêncio sobre NAD.X)
  • Variantes opcionais não usadas (FTX_7, FTX_8 — só warna se você emitiu FTX_7)
  • Envelopes auto-gerados pelo serializer (UNH/UNT em EDIFACT, ISA/IEA em X12, EDI_DC40 em IDoc — você não precisa mapear, o serializer preenche)


Como resolver



Adicione uma regra de mapeamento que preencha o campo do destino apontado pelo warning. O source_field pode ser qualquer field do payload de origem (header scalar ou item-level loop) — depende do contexto semântico.

Format-agnostic



A lógica funciona para EDIFACT, X12, IDoc, NFe e FHIR sem regex específico de cada formato.
O que significa "campo obrigatório do destino não preenchido" · Lefia Help