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:- Você está emitindo NAD? Sim (tem regra mapeando algum field pra NAD[].)
- NAD[*].C080.C08001 está preenchido em todos os items? Não
- → 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.