Referência SAP para sell-in¶
Esta referência traduz o contrato público atual das edições
Community/Enterprise. O legado planning-* não é autoridade de mapeamento;
confirme a disponibilidade final na edição e no OpenAPI implantados.
Esta página complementa o contrato de sell-in. No SAP, sell-in é uma interpretação do ponto do fluxo comercial; não é o nome de uma única tabela. Antes de mapear, escolha se a ocorrência será reconhecida pelo faturamento ou pela saída física e use a mesma regra em todo o histórico.
Origens SAP próximas¶
| Evento escolhido | Tabelas SAP comuns | Data de referência possível | Quantidade possível |
|---|---|---|---|
| faturamento ao cliente | VBRK e VBRP |
data de faturamento FKDAT |
quantidade faturada FKIMG |
| entrega ou saída física | LIKP e LIPS |
data efetiva de saída de mercadoria WADAT_IST |
quantidade entregue LFIMG |
Não combine data de faturamento com quantidade de entrega na mesma série sem uma reconciliação explícita. Cancelamentos, devoluções e notas de crédito também precisam seguir a política definida para a fonte.
Mapeamento de campos¶
| OpsFactor | Campo SAP próximo | Observação |
|---|---|---|
documentId |
VBELN + POSNR do documento escolhido |
Identifica item de faturamento ou de entrega quando a carga é transacional |
referenceDate |
FKDAT ou WADAT_IST |
Escolher uma única semântica de data |
originLocationId |
centro WERKS e, se necessário, depósito LGORT |
A composição deve apontar para uma location OpsFactor existente |
destinationLocationId |
cliente ou recebedor, como KUNNR ou parceiro ship-to |
Definir qual parceiro representa o destino planejado |
materialId |
MATNR |
Preservar zeros à esquerda se fizerem parte do código integrado |
quantity |
FKIMG ou LFIMG |
Usar a quantidade coerente com o evento escolhido |
uomId |
unidade comercial ou de entrega correspondente | Mapear para uma unidade cadastrada e conversível |
totalValue |
NETWR ou valor reconciliado do documento |
Documentar bruto/líquido, moeda e tratamento de tributos |
O que colocar no documentId¶
Se cada item SAP for carregado separadamente, use uma composição estável como
0090012345-000010, preservando os zeros de VBELN e POSNR.
Se a extração já consolida os valores por dia, carregue uma única linha por data, origem, destino, material e unidade. Um exemplo é:
2026-05-31|CD-01|CLIENTE-07|MAT-001
Inclua unidade, canal ou outra dimensão no ID quando ela separar linhas. A regra completa está em Identificadores e periodicidade.
Transações SAP próximas¶
VF03: exibir documento de faturamento;VL03N: exibir entrega;- relatórios e aplicativos analíticos de faturamento ou entregas podem ser fontes melhores que leitura direta de tabelas no SAP S/4HANA.
Essas transações ajudam a reconciliar exemplos, mas não definem sozinhas o contrato de extração.
Volte a sell-in ou ao índice SAP.