A Generix nomeia Jimmy Anidjar como Presidente não executivo do Conselho de Administração Veja o comunicado de imprensa

Pesquisa
Armazém, Novidades

Como integrar um WMS ao SAP: mapeamento de fluxos e plano de homologação

Integrar um WMS ao SAP exige definir os dados mestres, os documentos trocados e as confirmações entre a gestão e a execução física. A Generix recomenda validar, antes da entrada em produção, uma matriz de fluxos e um roteiro de homologação que comprovem o resultado de negócio em cada sistema, inclusive após rejeições ou reprocessamentos.

Published on 18 Novembro 2026 25 min to read
Artigo
Gros plan sur un feuillard d’acier tendu autour d’une palette de cartons, évoquant la précision requise pour fiabiliser l’interface entre un WMS et SAP.

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.

Perguntas frequentes

Como conectar WMS, TMS e ERP sem desenvolvimento sob medida?

Comece por contratos de dados comuns e, depois, verifique as interfaces padrão disponíveis e a necessidade de mediação. A Generix recomenda submeter as trocas a uma homologação conjunta que comprove seus efeitos em cada aplicação. Interfaces reutilizáveis podem reduzir os desenvolvimentos específicos; elas não eliminam o mapeamento, a configuração, os testes nem as adaptações próprias do projeto.

É possível conectar um WMS de terceiros ao SAP S/4HANA?

Sim, nos cenários documentados e compatíveis com a edição utilizada. Para SAP S/4HANA Cloud Public, o cenário 1ZQ descreve uma integração com WMS de terceiros por APIs SOAP assíncronas. Essa disponibilidade não deve ser extrapolada para todas as edições, versões e funções: cada fluxo precisa ser confirmado no ambiente de destino e confrontado com as capacidades do WMS.

Quais dados devem ser trocados entre SAP e WMS?

O escopo geralmente inclui materiais e unidades de medida, documentos de entrada e saída, confirmações, movimentações relevantes para o SAP e resultados de inventário. Diferencie o pedido comercial, a remessa enviada para execução e a confirmação da operação. No cenário 1ZQ, as trocas de execução se apoiam, entre outros documentos, nas remessas; portanto, transmitir sistematicamente todos os pedidos sem tratamento não é uma regra.

É melhor usar IDoc ou API para integrar SAP e WMS?

Não existe uma resposta universal: parta da edição do SAP, dos objetos de negócio, das operações necessárias e das interfaces publicadas. Uma API pode ser SOAP e assíncrona, como no cenário Cloud Public 1ZQ; ela não é necessariamente REST ou síncrona. O middleware é uma escolha complementar de arquitetura para transportar, transformar ou monitorar essas trocas.

Qual sistema deve ser o mestre do estoque: SAP ou WMS?

Distribua a responsabilidade por dado e finalidade, em vez de definir um único mestre do “estoque”. O cenário 1ZQ atribui, entre outras funções, os processos comerciais e a gestão quantitativa ao SAP, e a execução das movimentações físicas e lógicas ao WMS de terceiros. O contrato deve especificar as regras de validação; uma cópia sincronizada não se torna uma fonte autônoma de decisão.

Como reprocessar uma mensagem SAP-WMS sem gerar duplicidade?

Mantenha uma chave de negócio estável, verifique se o resultado já foi registrado e autorize o reprocessamento por um procedimento rastreável. Se a confirmação se perder, confira o documento de destino antes de qualquer novo lançamento. A garantia de processamento único depende dos mecanismos do emissor, do receptor e da mediação; a presença de um middleware, por si só, não a assegura.

Quais testes executar antes de colocar uma interface SAP-WMS em produção?

Teste unidades e arredondamentos, lotes, qualidade, operações parciais, cancelamentos, inventários, duplicidades, mensagens fora de ordem, confirmações perdidas e interrupções de rede. Para cada caso, defina um resultado de negócio e preserve sua evidência tanto no SAP quanto no WMS. Acrescente aos roteiros padrão os testes específicos do projeto e repita os testes de regressão após alterações no mapeamento; submeta os critérios de tempo de processamento e carga à aprovação.

É necessário sincronizar com o SAP todas as movimentações internas do WMS?

Não, a replicação sistemática não deve ser imposta como princípio. Diferencie uma transferência entre endereços de armazenagem de um evento que modifica uma dimensão de estoque gerenciada no SAP, como o depósito ou a categoria de estoque. O mapeamento deve especificar os eventos necessários à gestão, sua granularidade e sua evidência de processamento, sem tratar toda movimentação física como um lançamento no ERP.

Summarize with AI — Get a personalized summary in one click
An optimized prompt is prefilled for each AI engine. Generated results may differ from the original content.

Procurar mais recursos

bottom-cta-background-1
data-power-cta

Pronto para otimizar o fluxo de mercadorias + dados em sua cadeia de suprimentos?

Trabalhe com nossa equipe para criar sua pilha ideal de software de cadeia de suprimentos e adaptá-la às suas necessidades comerciais exclusivas.