Conectando o SAP S/4HANA Cloud

A conexão com o SAP S/4HANA Cloud usa um usuário de comunicação com senha, criado pelo administrador do SAP. O que decide se a leitura funciona é a liberação de cada serviço: no SAP, cada API é um serviço próprio, habilitado por um Communication Arrangement.

Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.

Antes de começar

• A integração cobre o SAP S/4HANA Cloud (Public Edition).
• Peça ao administrador do SAP:
  • o endereço do tenant — pode ser o mesmo que você usa no navegador, como my123456.s4hana.cloud.sap; a Toca ajusta para o endereço de API automaticamente;
  • um Communication User com senha, dedicado à integração;
  • um Communication Arrangement para cada cenário que a Toca vai ler — financeiro, vendas, compras. Serviço sem arrangement não existe para a API. Para o caminho de criação do Communication System, do Communication User e dos arrangements no painel, confirme na documentação oficial da SAP.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card SAP S/4HANA Cloud e clique no botão de conexão.
3. Preencha os três campos:
   • Endereço do tenant — ex.: my123456.s4hana.cloud.sap.
   • Usuário de comunicação — o Communication User criado pelo administrador.
   • Senha — a senha desse usuário.
4. Salve. O card fica marcado como conectado.

O que a Toca acessa

Com a conexão ativa, a Toca lê faturas, pedidos de venda e de compra, clientes, fornecedores, estoque e lançamentos financeiros — conforme os serviços que a empresa liberou por Communication Arrangement. A integração é somente leitura: a Toca não cria, não altera e não exclui nada no SAP.

Manutenção da conexão

A conexão usa o usuário de comunicação e a senha informados no card: se o administrador trocar a senha ou desativar o usuário, atualize o card em Configurações → Integrações. Se um Communication Arrangement for removido, as consultas daquele cenário param de responder até ele ser recriado — o card continua conectado, porque a credencial segue válida.

Problemas comuns

• Um tipo de consulta não responde, outros funcionam — quase sempre é Communication Arrangement faltando para aquele cenário, não erro da Toca: sem o arrangement, o serviço não existe no tenant. Peça ao administrador a liberação do cenário.
• Erro de autenticação logo após conectar — confira o usuário de comunicação e a senha. Login de usuário comum do SAP não serve: precisa ser um Communication User.
• Endereço não aceito — use o endereço do tenant, como my123456.s4hana.cloud.sap. Pode colar o endereço da interface: a Toca acrescenta o ajuste de API que falta.