Instâncias qualificadas: parceiros e segmentos repetidos (NAD+BY, MOA+203)

O que são instâncias qualificadas

Em EDIFACT/X12 o MESMO segmento se repete várias vezes, distinguido por um código (qualifier):

• NAD+BY = comprador · NAD+IV = faturado · NAD+PE = pagador · NAD+ST = entrega
• MOA+203 = valor da linha · MOA+77 = total da fatura
• RFF+ON = nº do pedido · DTM+137 = data da fatura

O Lefia gera essas instâncias automaticamente a partir do SAP. Você não precisa criar uma regra por parceiro à mão.

Parceiros (NAD) — vêm de um array no SAP

O SAP entrega os parceiros num array to_Partner[*], cada um com um PartnerFunction (AG = sold-to, RE = bill-to, RG = payer, WE = ship-to, LF = vendor). Ao clicar Sugerir IA, o Lefia lê esse array e cria:

• AG → NAD+BY (comprador) · RE → NAD+IV (faturado) · RG → NAD+PE (pagador) · WE → NAD+ST (entrega) · LF → NAD+SU (fornecedor)

Você reconhece uma regra qualificada pelo chip verde ⌖ (ex: ⌖ NAD+PE) ao lado da transformação. O mapa de códigos é editável (admin) caso sua empresa use funções de parceiro customizadas.

Itens (LIN) — cada linha com seus sub-segmentos

Cada linha de item pode ter os seus próprios segmentos repetidos: MOA+203 (valor da linha), QTY+47 (quantidade), RFF+ON (referência). O Lefia também gera isso por linha — você vê os sub-segmentos aninhados sob cada LIN no editor.

⚠️ Faltou parceiro no resultado? (causa nº 1)

Se o EDIFACT saiu com só 1 NAD ou sem alguns parceiros, quase sempre é porque os parceiros não vieram do SAP — a query não expandiu o to_Partner.

O que fazer: rode o Teste de conexão da integração. Ele puxa o documento com todas as navegações expandidas ($expand=to_Partner), e a próxima mensagem traz os parceiros. Vale pra OData V2 e V4. Depois, rode Sugerir IA de novo — os NAD+BY/IV/PE aparecem.

Se o to_Partner já está no payload mas os NADs não saem, é a regra que falta: o Sugerir IA as gera; mensagens fora do padrão SAP podem precisar de ajuste manual no código do parceiro.