Autenticação do TOTVS Protheus na Base (parte 2)

Após configurar o ambiente no Protheus e aplicar o patch necessário, é hora de autenticar o sistema na Base. Esse processo envolve alguns campos essenciais e garante que a comunicação entre os sistemas seja segura e estável.

1. Método de autenticação

   • A Base utiliza Basic Auth para se conectar ao Protheus.

2. URL do serviço

   • A URL deve apontar para o broker REST do Protheus, que expõe os endpoints da API.

   • Para localizar a URL correta, siga os passos:

     1. Acesse o Protheus Cloud.

     2. Em seguida, vá em Informações do Ambiente → Portas de Acesso.

     3. Depois, localize a porta do broker WS REST.

     4. Finalmente, combine a raiz do ambiente do cliente, a porta identificada e acrescente /REST.

   • Exemplo de URL:

     https://<ambiente>.winthor.cloudtotvs.com.br:111/rest

3. Usuário e senha

   • Em seguida, informe o login e a senha para acessar o broker REST.

   • Pode ser um usuário específico ou, alternativamente, o admin do Protheus.

4. Parâmetros adicionais

   • Além disso, é necessário configurar:

     • Depósito: indica o local de estoque que será utilizado para criar pedidos de venda.

     • TES (Tipo de Entrada e Saída): representa a natureza da operação, como entrada, saída ou transferência.

     • Séries: podem ser deixadas abertas, garantindo a comunicação correta com o Protheus.

5. Configurações opcionais

   • Você também pode escolher:

     • Encaminhar fatura/nota automaticamente, caso deseje automatizar o fluxo.

     • Exibir nota do TOTVS para visualizar o documento diretamente na Base.

   • Embora a sincronização de depósitos funcione normalmente, não há listagem automática; portanto, é possível baixar todos os depósitos disponíveis se necessário.

6. Fluxo de pedidos e notas

   • Após estabelecer a conexão, é possível:

     • Importar cadastros de produtos do Protheus para a Base.

     • Fazer a associação entre produtos do ERP e da Base.

   • Para os pedidos:

     • A Base utiliza a função Emitir Fatura quando o Protheus está integrado.

     • O sistema reconhece o número do URP, mantendo o pedido em processamento até que a nota seja autorizada no Protheus. Consequentemente, o XML da nota é capturado automaticamente.

7. Observações

   • Dessa forma, o fluxo garante que todas as informações entre Protheus e Base sejam sincronizadas de forma confiável.

   • Entretanto, em casos de rejeição de nota, o sistema mantém o histórico e aguarda a autorização do Protheus antes de finalizar o processo.

Além da integração padrão, se o seller já tiver APIs desenvolvidas no TOTVS, a Base pode aproveitar esses endpoints para criar uma integração customizada, reduzindo o tempo de implementação. O prazo estimado para esse tipo de desenvolvimento é de 1 a 2 semanas.