O que é?
A Service Layer é a camada de integração do SAP Business One baseada em serviços REST. Quando habilitada no ContractPlus, determinados processos passam a utilizar esse modelo de comunicação com o SAP, proporcionando maior flexibilidade e alinhamento com as integrações modernas da plataforma.
Importante: após habilitar ou desabilitar a Service Layer, é necessário reiniciar o Add-on para que a configuração seja aplicada.
Como configurar
Para habilitar a utilização da Service Layer:
- Acesse ContractPlus → Configuração → Parâmetros Gerais → Contract Web.
- Localize a seção Service Layer.
- Marque a opção Utilizar Service Layer.
- Informe a URL da Service Layer correspondente ao ambiente utilizado.
Ambientes locais
https://localhost:50000/b1s/v2
Ambientes HANA
https://hanab1:50000/b1s/v2
Observação: a porta utilizada pode variar conforme a configuração da infraestrutura ou das permissões de rede do ambiente.
Exportação automática de requisições com falha
Recomenda-se habilitar também a opção Exportar requisição com falha.
Ao ativar essa funcionalidade, será necessário informar um diretório onde serão armazenados os arquivos gerados quando ocorrer alguma falha durante a comunicação com a Service Layer.
Nesses casos, o ContractPlus exportará automaticamente os artefatos da requisição, como arquivos JSON e HTML, facilitando a análise e o diagnóstico de problemas pela equipe técnica.
Salvando a configuração
Após concluir a configuração:
- Clique em Atualizar, localizado no rodapé da tela de Parâmetros Gerais.
- Feche completamente o ContractPlus Add-on.
- Abra novamente o Add-on para que a nova configuração seja carregada.
Atenção: as alterações relacionadas à Service Layer somente entram em vigor após a reinicialização do Add-on.
Boas práticas
- Utilize sempre a URL correspondente ao ambiente em que o ContractPlus está sendo executado.
- Mantenha habilitada a opção Exportar requisição com falha em ambientes de homologação e desenvolvimento para facilitar análises e suporte.
- Sempre que alterar a configuração da Service Layer (habilitar, desabilitar ou modificar a URL), reinicie o Add-on antes de executar qualquer processo que utilize essa integração.