Principais pontos
- A edição do SAP, sua versão e o cenário ativado determinam quais interfaces podem ser efetivamente utilizadas.
- O mapeamento deve associar cada evento a um sistema mestre, uma transformação, um resultado de negócio e uma regra de reprocessamento.
- IDoc e API definem as trocas; o middleware pode transportar, transformar e monitorar essas mensagens.
- Orientação Generix: nenhum fluxo deve ser aceito sem evidência do resultado de negócio no SAP e no WMS, inclusive após o reprocessamento.
- A homologação abrange exceções de negócio, duplicidades, indisponibilidades e responsabilidades de operação e suporte.
Comece definindo o sistema mestre de cada dado
O sistema mestre é a aplicação autorizada a criar ou alterar um dado para uma finalidade definida; uma cópia sincronizada não adquire essa autoridade. Portanto, a integração entre WMS e SAP começa pela distribuição explícita de responsabilidades, não pela escolha de um protocolo.
Escopo SAP: edição, versão e cenário de integração efetivamente disponíveis
Documente o ambiente antes de iniciar o mapeamento: SAP ECC, SAP S/4HANA on-premise, Cloud Private ou Cloud Public, versão instalada, escopo ativado e extensões existentes. A Generix recomenda verificar cada interface nesse ambiente: uma disponibilidade documentada para Cloud Public não comprova sua disponibilidade no ECC, nem o contrário.
O cenário SAP 1ZQ de integração com um armazém externo, com verificação indicada em 19/10/2026, descreve trocas por APIs SOAP assíncronas no Cloud Public. Nesse cenário, o SAP concentra, entre outras funções, os processos comerciais e a gestão quantitativa; o WMS de terceiros executa as movimentações físicas e lógicas do armazém.
Responsabilidades por dado: cadastro mestre, decisões de gestão e execução física
Atribua um responsável aos materiais, unidades de medida, lotes, status de qualidade, documentos e ajustes. Especifique quem decide, quem executa e quem valida. Diferencie, em especial, endereço físico de armazenagem, depósito SAP, quantidade disponível e quantidade valorizada: esses conceitos não representam um estoque único e intercambiável.
A análise das responsabilidades do WMS e do ERP complementa essa definição sem substituir a matriz do projeto. Para a terminologia geral, consulte a definição detalhada de WMS; este guia aborda o contrato de integração e sua validação.
Mapeie os fluxos SAP-WMS em uma matriz
O mapeamento dos fluxos SAP-WMS descreve a correspondência entre dados de origem e destino, suas transformações e os efeitos esperados. A Generix recomenda associar cada linha a uma evidência de negócio e a uma regra de reprocessamento antes de desenvolver ou configurar a interface.
A matriz a seguir é um modelo a ser preenchido, não um catálogo de conectores com disponibilidade garantida. Os serviços de armazém citados constam no catálogo SAP Delivery Management, edição Cloud Public 2608, com verificação indicada em 19/10/2026. Sua ativação, suas restrições e sua cobertura devem ser confirmadas no ambiente de destino.
| Objeto ou evento |
Sistema mestre e responsável pela validação |
Origem → destino |
Gatilho e frequência |
Chaves e campos a mapear |
Interface candidata e edição SAP |
Resultado de negócio e confirmação esperada |
Regra de rejeição e reprocessamento |
| Materiais e unidades de medida |
SAP para o cadastro mestre definido; responsável pelos dados |
SAP → WMS |
Carga inicial e, depois, atualizações conforme o mecanismo disponível |
Material, unidade básica, conversões, atributos logísticos |
Cloud Public 2608: leitura via Product (Version 2), conforme as entidades; ECC e outras edições: interface a verificar |
Material disponível para uso no WMS; status de integração e validação das conversões |
Rejeição explícita de cadastros inconsistentes; reprocessamento após correção |
| Remessa de saída e confirmação |
SAP para a remessa; WMS para a execução; responsáveis pela expedição e pelo SAP |
SAP → WMS → SAP |
Criação ou liberação conforme o cenário, seguida do evento de execução |
Remessa, item, material, quantidade, unidade, lote, destino |
Cloud Public 1ZQ: Warehouse Shipping Order – Send to Warehouse (B2B); Warehouse Shipping Advice – Receive from Warehouse (B2B) |
Documento apto à execução no WMS; remessa e movimentação esperadas no SAP; resultado correlacionado |
Verificar o status do documento antes do reprocessamento; impedir um segundo lançamento |
| Remessa de entrada ou previsão de recebimento e recebimento |
SAP para o documento; WMS para o realizado; responsáveis pelo recebimento e pelo SAP |
SAP → WMS → SAP |
Distribuição do documento, seguida do recebimento conforme o cenário |
Remessa, item, fornecedor, material, quantidade, unidade, lote, status |
Cloud Public 1ZQ: Warehouse Stock Transfer Shipment Advice – Send to Warehouse (B2B); Warehouse Stock Transfer Receipt Advice – Receive from Warehouse (B2B) |
Previsão de recebimento reconhecida; recebimento e entrada de mercadorias conciliados |
Tratar recebimentos parciais e referências ausentes; reprocessar após verificar o realizado |
| Movimentação que afeta uma dimensão de estoque no SAP |
WMS para o evento físico; SAP para o lançamento; responsável pelo estoque |
WMS → SAP |
Evento relevante; frequência aprovada conforme a necessidade e a capacidade |
Evento, material, quantidade, unidade, depósito, lote, categoria de estoque |
Cloud Public 2608: API_MATERIAL_DOCUMENT, se adequada e desde que a operação ainda não tenha sido lançada por uma confirmação |
Documento de material esperado e retorno de sua referência |
Impedir dois caminhos de lançamento para a mesma operação; conciliar antes do reprocessamento |
| Contagens e divergências |
WMS para a contagem; responsável pelo inventário para a validação; SAP para o ajuste aprovado |
WMS → SAP; retorno da decisão |
Contagem concluída, seguida de validação por usuário autorizado |
Documento, item, exercício, material, lote, quantidade, unidade, motivo |
Cloud Public 2608: API_PHYSICAL_INVENTORY_DOC_SRV; operações a selecionar separadamente |
Contagem registrada; ajuste aprovado separadamente e rastreável |
Diferenciar contagem zero, ausente e rejeitada; reprocessar conforme o status e as autorizações |
Contrato de integração: campos obrigatórios, transformações, frequência e evidência
No método proposto, cada linha remete a uma especificação versionada: campos obrigatórios, valores permitidos, conversões, arredondamentos, tratamento de valores ausentes, ordem dos eventos e compatibilidade de versões. Defina a frequência conforme a necessidade do negócio e a capacidade real, sem impor um padrão único de “tempo real”. Se o cenário executa remessas, não transmita sistematicamente os pedidos comerciais sem tratamento.
Escolha as mensagens padrão e defina onde ficará a mediação
A escolha de uma interface depende do objeto de negócio, do sentido da troca e da edição do SAP. IDoc, API e middleware não são três alternativas equivalentes: o middleware é uma camada de mediação que pode processar trocas por IDoc ou API.
IDoc e API: verifique as funções cobertas, o sentido e a versão
Para um IDoc, verifique o tipo de mensagem, o tipo básico, os segmentos, as extensões e os status utilizados. Para uma API, confira as operações, o sentido de entrada ou saída do ponto de vista do SAP, o protocolo, o modo síncrono ou assíncrono e o status de descontinuação. A Generix recomenda manter essas referências na documentação de arquitetura.
O catálogo SAP de APIs de produto, edição 2608, com verificação indicada em 19/10/2026, recomenda Product (Version 2), em OData V4, para as entidades que não sejam os textos explicitamente mantidos em Product Master (A2X). Portanto, não estenda o uso de API_PRODUCT_SRV a todo o cadastro mestre.
No 1ZQ, Warehouse Intermediate Update – Receive from Warehouse (B2B) é uma atualização intermediária, não uma confirmação universal de separação. Da mesma forma, a expressão Stock Transfer não permite estender um serviço a todas as movimentações internas.
Conexão direta ou middleware: compare operação, transformações e capacidade de evolução
- Conexão direta: adequada quando os contratos de integração são compatíveis e as aplicações oferecem os controles, logs e mecanismos de reprocessamento necessários; as evoluções continuam exigindo coordenação entre elas.
- Mediação: útil para centralizar conversões, roteamento e monitoramento; acrescenta uma plataforma a operar e responsabilidades a distribuir.
O guia de trocas por EDI e API aprofunda essa distinção. Não duplique regras de negócio em várias camadas.
Planeje rejeições e reprocessamentos antes da primeira troca
Uma interface confiável precisa distinguir transporte bem-sucedido de processamento de negócio bem-sucedido. Uma mensagem aceita por um gateway, entregue ao middleware ou recebida via HTTP não comprova que a remessa, o recebimento ou a movimentação esperada exista no SAP e no WMS.
Confirmação técnica, resultado de negócio e conciliação de documentos
Defina, para cada fluxo, a confirmação disponível, o resultado de negócio a verificar e o procedimento de conciliação. Relacione o identificador da mensagem, o evento, o documento e o item; preserve os status, os erros e os registros de data e hora. A Generix recomenda caracterizar os estados “recebido”, “em processamento”, “rejeitado” e “concluído”, sem confundi-los.
A documentação Material Documents — Read, Create, edição 2608, descreve API_MATERIAL_DOCUMENT para consultar, criar e estornar documentos de material. Se uma confirmação de remessa já efetua o lançamento da operação, impeça seu segundo registro por esse serviço.
Idempotência, sequenciamento e retomada após indisponibilidade
A idempotência garante que o reprocessamento de um mesmo evento não produza um efeito de negócio adicional. Preveja uma chave estável, a identificação do resultado já registrado e o histórico das tentativas. A documentação SAP sobre a qualidade de serviço Exactly Once, com verificação indicada em 19/10/2026, explicita condições que dependem do emissor, da mediação e do receptor: o middleware, sozinho, não basta.
A recomendação é documentar a ordem exigida por documento, a retenção das mensagens, a autoridade para autorizar reprocessamentos e o tratamento das mensagens acumuladas. Se uma confirmação se perder, procure primeiro o resultado de negócio. Para incidentes já identificados em produção, o guia de diagnóstico de divergências entre ERP e WMS aborda a investigação após o incidente.
Estruture uma homologação que comprove os resultados nos dois sistemas
A homologação da interface é uma validação reproduzível das trocas e de seus efeitos de negócio, com dados, etapas e resultados esperados previamente definidos. Ela deve comprovar o funcionamento normal, as exceções e a retomada, não apenas a conformidade da mensagem.
Roteiro de teste reutilizável e massas de dados de negócio
A Generix recomenda utilizar o mesmo modelo de roteiro para cada cenário. A estrutura proposta inclui os seguintes campos, que devem ser preenchidos antes da execução:
- Identificação e fluxo: referência do teste, versão do mapeamento e escopo SAP-WMS.
- Pré-condições e massa de dados: documentos, status, referências, unidades e autorizações necessários.
- Etapas: ações de negócio, envio, processamento, falha simulada e eventual retomada.
- Mensagem e correlação: conteúdo relevante, chave de negócio e identificadores técnicos.
- Resultados e evidências: estados esperados em cada sistema, documentos, logs e capturas de tela.
- Defeito, responsável e decisão: divergência identificada, correção, reteste e aceite.
Exceções funcionais, falhas e critérios de aceite
- Conversões de unidades e arredondamentos; lotes e fracionamento; qualidade e bloqueio.
- Recebimentos ou expedições parciais, saldos pendentes, alterações e cancelamentos conforme o estágio de execução.
- Contagem zero e divergência: diferenciar a transmissão do resultado da autorização de ajuste.
- Mensagem duplicada ou fora de ordem, confirmação perdida, indisponibilidade e retomada.
- Carga, autorizações e testes de regressão após alterações no mapeamento.
A documentação das operações de inventário SAP, edição 2608, diferencia, em especial, a contagem do lançamento das diferenças. Submeta à aprovação do projeto os limites de tempo de processamento, carga e prazo para eliminar o acúmulo de mensagens, sem inventar valores padrão. O aceite exige resultado de negócio comprovado, ausência de lançamentos em duplicidade e rejeições controladas.
Valide a interface com todos os envolvidos na execução
A entrada em produção da interface exige um aceite conjunto das áreas de negócio e de tecnologia. O contrato deve especificar como um evento validado se torna utilizável pelas equipes de ERP, armazém, transporte, fornecedores e operadores logísticos, sem criar versões contraditórias da mesma operação.
Decisão de entrada em produção e responsabilidades de operação e suporte
A Generix recomenda anexar ao termo de aceite a matriz aprovada, os roteiros executados, os defeitos remanescentes e os procedimentos de reprocessamento. Nomeie os responsáveis por SAP, WMS, integração e operação e suporte: diagnóstico, correção de dados, autorização de reprocessamento, monitoramento e escalonamento precisam ter responsáveis definidos.
A decisão tratada aqui diz respeito à interface, não a toda a virada operacional da unidade. Verifique também o acesso aos logs, a retenção das evidências e a gestão das evoluções. Os roteiros SAP 1ZQ orientam a inclusão das etapas específicas do projeto: sua execução isolada, portanto, não cobre toda a configuração do ambiente.
Coordene SAP, Generix WMS e parceiros sem recriar silos
Um evento compartilhado deve manter sua referência, seu status e seu significado até chegar aos destinatários autorizados. O artigo sobre a coordenação entre WMS e TMS aprofunda essa extensão para o transporte.
O Generix WMS oferece APIs de integração e faz parte de um portfólio integrado que inclui WMS, TMS e OMS. Essa opção permite avaliar a coordenação da execução em torno do SAP, sem exigir sua substituição nem presumir compatibilidade com todas as suas versões. Se houver necessidade de mediação, o escopo da plataforma TradeXpress Infinity para integração entre aplicações e entre empresas também pode ser avaliado.
Na preparação de uma interface entre SAP e armazém, a edição do SAP, os fluxos prioritários e os casos de homologação são as informações a apresentar à equipe da Generix pelo formulário da página Generix WMS, para delimitar o escopo da integração, as configurações e as eventuais adaptações.
Em resumo
- A matriz se torna o contrato comum entre os responsáveis por SAP, WMS, integração e operação e suporte.
- As interfaces candidatas devem ser confirmadas objeto por objeto na versão do SAP efetivamente implantada.
- A conciliação de documentos e a idempotência tornam o reprocessamento seguro, sem multiplicar os efeitos de negócio.
- Cada alteração no mapeamento exige testes de regressão e retenção das evidências.
- Uma execução colaborativa depende de eventos validados e interpretados de forma consistente por todos os destinatários.