Automati-Hub: como ele conecta o WinThor ao Ravion

Quando se fala em integrar o seu ERP com o da distribuidora, a pergunta que vem logo depois é: quem fica no meio? Os dois sistemas não foram feitos um para o outro. Alguém precisa traduzir o pedido de um para o formato do outro, conferir se está tudo certo antes de gravar e avisar, em língua de gente, quando algo dá errado.

No caso do WinThor e do Ravion, esse papel é do Automati-Hub, o parceiro de integração que liga os dois. Neste artigo você vai ver o que um hub de integração faz, o que exatamente o Automati-Hub faz nessa ligação, o que ele não faz e como acompanhar o trabalho dele pela tela do Ravion.

Em resumo: o Automati-Hub é a ponte entre o WinThor da distribuidora e o Ravion. Ele manda ao Ravion o saldo de cada filial do WinThor e, quando você clica em Enviar ao fornecedor, confere cada venda e cria os pedidos no WinThor pela API oficial da TOTVS, um por venda, registrando cada tentativa.

O que é um hub de integração

Um hub de integração é um serviço que fica entre dois sistemas e faz a conversa entre eles. Em vez de o seu ERP falar direto com o ERP do fornecedor, os dois falam com o hub, e ele cuida do resto: formato dos dados, regras de cada lado, tentativas e registros.

Isso tem três vantagens práticas:

• Cada sistema continua com as suas regras. O Ravion não precisa saber como o WinThor grava um pedido, e o WinThor não precisa saber como o Ravion reserva estoque.
• O erro tem endereço. Quando um pedido não entra, o hub recebe o motivo do WinThor e devolve isso de forma legível.
• Existe um registro de tudo. Cada envio fica guardado, com data, quem pediu e o resultado.

Se você está comparando esse modelo com outras formas de conectar sistemas, vale ler sobre hub de integração ou ERP completo. São coisas diferentes: aqui o hub não substitui o ERP de ninguém, ele liga dois ERPs.

O que o Automati-Hub faz entre o WinThor e o Ravion

O trabalho do Automati-Hub tem dois sentidos.

Saldo: do WinThor para o Ravion

O hub manda ao Ravion o estoque das filiais da distribuidora, filial por filial. Cada item vai com o código do produto no WinThor e a quantidade. Opcionalmente, vai também o custo na unidade do fornecedor e o SKU do produto no Ravion.

Do lado do Ravion, o saldo de cada filial entra no Estoque Drop ligado a ela. O código do WinThor encontra o produto pelo vínculo "código no fornecedor" do cadastro, e a quantidade é convertida pelo fator desse vínculo. Quando o envio traz a filial inteira, o que não veio fica zerado. Filial que ainda não foi ligada a um Estoque Drop não é descartada: o saldo fica guardado e entra assim que você ligar.

Há uma regra importante aqui: produto já cadastrado recebe do hub só o saldo e o custo. Nada mais do cadastro muda. E se o produto já tem custo vindo de uma nota de compra, vale o da nota até a próxima.

Pedido: do Ravion para o WinThor

Quando você clica em Enviar ao fornecedor numa compra da distribuidora, o Ravion manda ao hub o cabeçalho da compra e cada venda ligada a ela: produto, quantidade, código no WinThor, fator de conversão, custo e o CNPJ da filial compradora. Vai também a filial do WinThor que deve receber o pedido, quando o Estoque Drop da compra está ligado a uma.

O hub então:

1. Confere cada venda antes de enviar: código do produto no WinThor, custo, preço, estoque e configuração.
2. Cria no WinThor um pedido para cada venda, pela API oficial da TOTVS.
3. Devolve ao Ravion o resultado de cada venda, com o número do pedido no WinThor quando ele entra.

Como ler o resultado de cada envio

A janela de resultado no Ravion mostra cada venda num cartão, com uma situação:

• Enviada: o pedido foi criado no WinThor, com o número dele.
• Já estava no WinThor: a venda tinha entrado num envio anterior e não foi mandada de novo.
• Pendência: falta algo para a venda entrar, e a tela diz o quê.
• Recusada pelo WinThor: o WinThor não aceitou, e o motivo real aparece.
• Não enviada: houve uma falha no envio daquela venda.
• Aguardando confirmação: o hub ainda está confirmando se o pedido entrou.

Cada motivo vem com um bloco O que fazer, escrito para quem opera, não para o programador. A compra só passa a "enviada" quando todas as vendas estão no WinThor. Senão, continua em rascunho, e o próximo clique manda só as que faltam.

O que o Automati-Hub não faz

Saber os limites do hub evita expectativa errada:

• Não decide o que comprar. Quem monta a compra é o Ravion, a partir das vendas que reservaram o Estoque Drop.
• Não acessa o banco do Ravion. Tudo de que ele precisa vai no envio. As observações internas da venda não saem do Ravion.
• Não reescreve o cadastro dos seus produtos. Do hub vêm só o saldo, o custo e, quando você manda o SKU, o vínculo do código.
• Não manda compras de outros fornecedores ao WinThor. Só as do fornecedor que você configurou como a distribuidora.
• Não despacha ao seu cliente. A mercadoria vem para o seu CD, e quem expede é você.

Segurança: chave, permissões e registros

A conversa entre o Ravion e o hub é protegida por uma chave. Ela fica guardada cifrada no Ravion e não volta para a tela depois de salva. O hub usa a mesma chave para mandar o estoque ao Ravion: envio sem a chave certa é recusado.

Do lado das pessoas, a configuração da integração (endereço do hub, chave e fornecedor) fica com o administrador. O envio das compras fica com os papéis de gestão e de operação. E toda tentativa de envio, com sucesso ou não, vai para a auditoria do Ravion, com quem fez e o resultado.

Se você quer um roteiro para avaliar qualquer integração desse tipo, não só esta, veja o que avaliar numa integração por API com o ERP do fornecedor.

Como acompanhar o hub pela tela do Ravion

A tela Integrações › WinThor reúne o que você precisa para saber se está tudo bem:

• Testar conexão: o hub confere, só lendo, o próprio hub, o banco do WinThor, a API oficial da TOTVS e o Ravion. Nada é enviado.
• Estoques do WinThor: cada filial recebida, quantos códigos vieram, quantos com saldo, quando chegou o último envio e o Estoque Drop ligado.
• Últimos envios: as tentativas registradas pelo hub, da mais recente para a mais antiga, com a compra, a venda, o resultado e o número do pedido no WinThor.

Depois que o pedido entra, o hub acompanha a situação dele no WinThor: liberado, pendente, bloqueado, faturado ou cancelado. Assim você sabe em que pé está cada pedido sem ligar para a distribuidora.

Como o Ravion ajuda

O Automati-Hub é a ponte; o Ravion é o que fica de cada lado dela na sua operação. O Estoque Drop recebe o saldo das filiais e publica nos anúncios só o que pode ser vendido. As compras se montam sozinhas a partir das vendas, e o botão Enviar ao fornecedor entrega ao hub tudo o que ele precisa, sem ninguém redigitar código ou quantidade.

Quando algo não entra, você não precisa abrir chamado para descobrir o motivo: ele aparece na tela, venda a venda, com o que fazer. A visão geral da ligação, com o que preparar antes, está em integração WinThor e e-commerce. A integração com o WinThor via Automati-Hub está no plano Enterprise.

Perguntas frequentes

O Automati-Hub é um produto da TOTVS?

Não. O Automati-Hub é o parceiro de integração que liga o WinThor ao Ravion. Os pedidos que ele cria no WinThor usam a API oficial da TOTVS.

Preciso instalar alguma coisa no Ravion para usar o Automati-Hub?

Não. A ligação é configurada pelo administrador na tela Integrações › WinThor, com o endereço do hub, a chave e o fornecedor que representa a distribuidora. O endereço e a chave são informados pelo parceiro de integração.

O hub pode criar o mesmo pedido duas vezes?

Não. O hub não envia a mesma venda duas vezes. Se você clicar de novo depois de uma recusa ou de uma demora, só as vendas que ainda não estão no WinThor são enviadas.

Dá para testar sem criar pedidos de verdade?

Sim. O teste de conexão só lê os sistemas. E quando o hub está em simulação, o resultado mostra as vendas como prontas para enviar, sem criar nada no WinThor e sem mudar a compra no Ravion.

Como sei quando chegou o último saldo do WinThor?

A tela Integrações › WinThor mostra, para cada filial, a data e a hora do último envio do hub, quantos códigos vieram e quantos têm saldo. O histórico do Estoque Drop registra cada troca de saldo com a origem Automati-Hub.

Conclusão

O Automati-Hub é a peça que faz o WinThor da distribuidora e o Ravion trabalharem juntos: saldo de um lado, pedido do outro, com cada passo registrado. Entender o papel dele ajuda a configurar certo e a resolver rápido quando algo não entra. Para avaliar a integração na sua operação, fale com a equipe.