Uma Integração, Cinco Pontos de Sincronização: Como o YARDtwin Comunica com o SAP

Qualquer conversa sobre integração SAP acaba sempre nas mesmas três perguntas. Exactamente quando é que cada mensagem é disparada? O que é que ela contém? E o que vê o utilizador SAP quando ela chega? As listas de funcionalidades não respondem a essas perguntas — por isso criámos um vídeo que não faz outra coisa.

O vídeo reproduz uma entrega real — uma carga a granel, pesada à entrada com 18 500 kg e à saída com 13 500 kg — e acompanha-a através da fronteira SAP–YARDtwin, troca a troca. Cinco pontos de sincronização, cada um mostrado de três formas: o momento no pátio que o desencadeia, a mensagem na ligação e a vista SAP onde ela chega.

Sincronização 1 — SAP abre a conversa

A entrega de entrada é a única mensagem que o SAP envia primeiro. Quando é criada em S/4HANA, o seu middleware — SAP CPI no vídeo — capta-a e publica um corpo JSON no webhook HTTPS do YARDtwin, assinado com um segredo partilhado. Número de entrega, centro, material, cinco mil quilos planeados: tudo o que o pátio precisa, sem qualquer digitação.

Do lado do YARDtwin, a reserva constrói-se automaticamente. A entrega aparece no registo de integração e no planeamento com o material e a quantidade planeada já preenchidos. Ninguém re-digita uma entrega, por isso ninguém a digita de forma errada.

Sincronizações 2 e 3 — o pátio reporta, sem intervenção manual

A partir daqui a direcção inverte-se: o YARDtwin responde a partir da portaria e do cais, e ninguém num escritório digita uma transacção.

• Sincronização 2 — registo da unidade de transporte. Disparada no momento em que o operador de portaria autoriza a entrada. Hora de check-in, cais, peso bruto na balança rodoviária — e um bloco nativo SAP que o seu CPI mapeia directamente. O SAP responde com a referência da UT; o utilizador EWM vê uma unidade de transporte chegada ao ponto de controlo, com o peso bruto já no registo.
• Sincronização 3 — confirmação da tarefa de armazém. Disparada quando a descarga termina. Contém campos que um consultor EWM reconhece de imediato: número de armazém, tarefa, ordem, bin de destino. No monitor de armazém, a tarefa passa a confirmada — stock na zona de recepção de mercadorias, exactamente como o pátio reportou.

Sincronização 4 — a entrada de mercadorias aguarda a balança rodoviária

Esta é a mensagem para a qual a integração existe, e aquela que o YARDtwin retém deliberadamente. A descarga termina — e nada é lançado. Só a pesagem de saída assinada liberta a entrada de mercadorias, transportando o peso líquido calculado na balança: 5 000,000 kg como quantidade na unidade de entrada, tipo de movimento 101, com o registo completo da balança rodoviária incluído como evidência. O SAP lança-a e responde com o número do documento de material.

Sincronização 5 — fechar o ciclo

À saída do camião, a mensagem de saída de pátio transporta a hora de partida, o tempo de rotação, o peso líquido verificado e o hash de assinatura electrónica da autorização de saída. O SAP regista a saída no ponto de controlo e a entrega fica completa. Cinco trocas — um fluxo documental limpo, com o rasto de auditoria a acompanhar o camião.

O que isto vale

• Sem re-digitação, em nenhuma direcção. O SAP cria a reserva; o pátio envia as confirmações. Os dois sistemas deixam de ser reconciliados por uma pessoa com dois ecrãs.
• O SAP mantém-se como sistema de registo — e recebe registos melhores. Quantidades pesadas, timestamps contemporâneos e evidências de assinatura ficam associados aos documentos que o SAP já detém.
• Eventos que o SAP nunca teve. Chegada à portaria, leituras da balança rodoviária, progresso da descarga e saída não existem em nenhum ambiente SAP standard. Agora chegam como mensagens estruturadas em vez de telefonemas.
• Plataforma standard, não um projecto. Cada mensagem é JSON sobre HTTPS, assinado com HMAC, entregue ao seu CPI ou middleware — a sua equipa de integração mapeia-o nos IDoc e BAPI que já utiliza. E cada troca é visível no registo de mensagens SAP do YARDtwin, para que qualquer conversa de suporte parta da mesma evidência.

3 sincronizações: a forma de entrada mais ligeira

Nem todos os sites utilizam o SAP EWM para gestão de pátio — e se o SAP não gerir o seu pátio, três dessas mensagens não têm destino útil. Para esse cenário, o YARDtwin executa a mesma integração num formato de 3 sincronizações: o YARDtwin é responsável por todo o pátio, e apenas duas mensagens cruzam a fronteira — a entrega de entrada a descer e a receção de mercadorias a subir.

O ponto importante é que o modo de 3 sincronizações não é um segundo produto nem uma integração separada. São os mesmos cinco interruptores com três deles desligados. Comece com a entrega de entrada e a receção de mercadorias — o primeiro passo de menor risco — e se posteriormente ativar os processos de pátio do EWM, crescer para os cinco completos é uma alteração de configuração, não uma reimplementação.

Configurado para o seu negócio, interruptor a interruptor

Cada ponto de sincronização é um interruptor independente por site, desligado por defeito. Um administrador de site escolhe uma predefinição de um clique — 3 sincronizações geridas pelo pátio ou 5 sincronizações integradas com EWM — ou define uma combinação personalizada por site. As implementações multi-planta encaminham cada planta SAP para o seu próprio site YARDtwin, e o reenvio de uma entrega é seguro por conceção: um reenvio idêntico não altera nada.

Esta é a mesma filosofia do resto da plataforma — checklists de portão, regras de balança rodoviária, modos Smart Slots e regras de cais são todos configuração por site e não código. Para uma visão geral do que pode personalizar sem necessidade de um programador, consulte Personalizar o YARDtwin para o seu negócio; para a arquitetura de integração em detalhe, consulte a nossa página de integração SAP.