Como o "Sugerir IA" gera o mapeamento (compilador determinístico)

Como funciona (padrão atual)

O Sugerir IA agora roda por padrão no modo determinístico (compilador): a IA reconhece só o conceito de cada campo de origem (ex: "comprador", "data do documento", "quantidade pedida") e o compilador monta o destino correto direto da especificação (EDIFACT/X12/etc) — posição, qualifier e cardinalidade certos por construção, sem chutar.

Quando o formato/mensagem ainda não está coberto pelo compilador, o sistema cai automaticamente no modo clássico (a IA propõe o destino e o sistema corrige). Você não precisa fazer nada — é transparente.

O que esperar

Instantâneo — aparece a nota "Compilador determinístico: N regras de M campos". É normal.
Mais preciso e enxuto — só mapeia o que tem conceito reconhecido; não inventa. Campos sem conceito ficam de fora (você completa à mão). É de propósito: melhor mapear menos e correto do que muito e errado.
Parceiros e itens — parceiros num array (ex: SAP to_Partner) viram instâncias por papel (NAD+BY comprador, NAD+IV faturado…), inclusive por linha; itens viram LIN/PO1 com quantidade, preço e total.
Valores derivados — preço unitário = valor ÷ quantidade, contagem de linhas, etc. saem calculados.

Cobertura hoje

EDIFACT (faturas INVOIC, pedidos ORDERS): cobertura completa, validada com dados reais.
Outros formatos (X12, IDoc, NF-e): cobertura crescente — onde ainda falta, o modo clássico assume. Vamos ampliando.

Dicas

Funciona melhor quando os campos de origem já têm conceito anotado (Camada Semântica).
Conversões de valor (unidade, tipo de documento) evoluem aos poucos — se um código sair "cru", é só ajustar e o aprendizado fica.

Quantas vezes cada segmento sai

Quando a origem tem um valor só e o destino tem um segmento que se repete (ou o contrário), o compilador decide pela base de conhecimento: se o dado é do documento, de uma parte ou da linha, e onde ele está na origem e no destino. Dado do documento em segmento repetível do cabeçalho sai uma vez; dado do documento dentro da linha sai em cada linha; uma coleção que vai para um campo único sai só com soma ou pelo papel (comprador, pagador…). Se a base não permite decidir, o campo fica sem destino e o aviso do "Sugerir" diz quais e por quê — nenhuma regra ambígua é gerada. Para resolver, declare a altura do conceito na base ou mapeie à mão.

Aviso de remessa (DESADV) a partir da remessa do SAP

O aviso de remessa sai com a data de despacho (saída de mercadoria), a data de entrega prevista e a data do documento. Também sai o comprador, o recebedor da mercadoria (uma vez, no NAD+ST) e o transportador, se a remessa tiver um. Cada linha leva o material e a quantidade despachada. Se a saída de mercadoria ainda não foi feita, a data de despacho não sai: a remessa não tem a data real.

Unidade, nome do documento e data de despacho planejada

Cada quantidade sai com a unidade, convertida pela base de conhecimento (por exemplo, a unidade do SAP em peças vira PCE). No OData, qual campo é a unidade do SAP e qual é o código ISO vem da anotação do próprio $metadata do serviço, não do nome do campo. O aviso de remessa sai com o nome do documento (351, aviso de despacho). Se a saída de mercadoria ainda não foi feita, a data de despacho sai com a data planejada; quando há a data real, vale a real. No IDoc DESADV01, cada item da remessa vira uma linha (E1EDP09) com quantidade, unidade, número do item e material.

Integrações de entrada (EDI do parceiro → SAP)

No EDI, o mesmo segmento se repete com um código que diz o que é o valor: DTM+137 é a data do pedido e DTM+2 a data de entrega pedida; QTY+21 é a quantidade pedida; NAD+BY é o comprador. Quando a origem é EDIFACT, X12 ou IDoc, o compilador lê cada valor pelo seu código, com a base de conhecimento dizendo o que cada código significa naquela mensagem — a regra sai com um filtro pelo código (por exemplo, DTM[*] onde o qualificador é 137 → SalesOrderDate). A unidade da quantidade vem do mesmo QTY da quantidade. Código que a base não conhece não gera regra: o campo fica sem destino, com o aviso. Os avisos da geração (no Sugerir do editor e no fim do Criar com Mapeamento IA) aparecem no idioma da tela: cada um tem um código estável e a tela escreve a frase nesse idioma.

Parceiro da linha e embalagem (entrada)

Parceiro da linha. Quando uma linha do pedido traz um parceiro próprio (por exemplo, a entrega daquela linha vai para outro recebedor: NAD+DP dentro da linha no EDIFACT, N1*ST dentro do PO1 no X12), ele vai para o parceiro do item no SAP, com a mesma função que teria no cabeçalho (o recebedor vira WE). A linha que só repete o parceiro do cabeçalho não ganha parceiro próprio — o SAP já copia o do documento para os itens.
Embalagem do aviso de remessa (DESADV). O Lefia reconhece cada embalagem identificada pelo SSCC (PAC com PCI/GIN+BJ), com peso, volume e dimensões (MEA). A embalagem de resumo, sem SSCC, não conta como unidade, e a medida da remessa inteira não vai para uma embalagem.
O que a criação do documento aceita. Algumas partes de um documento SAP não podem ser criadas junto com ele. A criação da entrega de entrada, por exemplo, não recebe as unidades de manuseio: o Lefia não as coloca no documento enviado e o Sugerir mostra o aviso "navegação não aceita na criação", para o SAP não recusar a entrega inteira.
Criado depois do documento. Quando o serviço do SAP tem uma entidade própria para essa parte (a unidade de manuseio da entrega de entrada), o Lefia cria a entrega e, em seguida, cada unidade de manuseio ligada a ela pelo número que o SAP devolveu. O Sugerir avisa "criada depois do documento". Se o SAP recusar uma unidade, a mensagem fica em erro com o número da entrega e o motivo; Reprocessar cria só o que falta, sem criar a entrega de novo. Se o envio cair depois de a entrega sair e antes de o Lefia gravar a resposta, a mensagem para com o aviso para conferir no SAP antes de reprocessar.
Unidade de cada medida. O peso, o volume e as dimensões da embalagem levam a unidade que veio junto da mesma medida no arquivo (MEA), no campo de unidade que o próprio $metadata do SAP declara para aquele valor (peso → unidade do peso). A conversão do código (por exemplo, KGM → KG) vem da base de conhecimento.