WebServices
WebServices disponíveis no BrERP
O BrERP disponibiliza maneiras de acessar alguns dados através do WebService que podem ser consultadas acessando https://teste.brerp.com.br/ADInterface/services
São disponibilizadas através dos protocolos:
- SOAP
- RESTful
O protocolo SOAP é disponibilizado em duas versões:
- CompositeService
- ModelADService
ModelADService é nada mais que uma requisição de algum serviço especifico, seja a criação de um Parceiro de Negócios, Criação de Imagens, Busca por um determinado Documento, Ação de Documento ou até mesmo a Execução de um processo.
Os processos disponíveis estão listados abaixo
ModelADService: | |
---|---|
Endpoint address: http://teste.brerp.com.br/ADInterface/services/ModelADService WSDL : {http://idempiere.org/ADInterface/1_0}ModelADService Target namespace: http://idempiere.org/ADInterface/1_0 |
CompositeService é a junção de um ou mais ModelADService, provavelmente será o mais utilizado por sua aplicação, já que engloba todos os processos anteriores em apenas uma requisição.
CompositeService: | |
---|---|
Endpoint address: http://teste.brerp.com.br/ADInterface/services/compositeInterface WSDL : {http://idempiere.org/ADInterface/1_0}compositeInterface Target namespace: http://idempiere.org/ADInterface/1_0 |
Já o protocolo REST é disponibilizado em apenas um:
RESTful services: |
---|
Endpoint address: http://teste.brerp.com.br/ADInterface/services/rest WADL : http://teste.brerp.com.br/ADInterface/services/rest?_wadl |
Exemplos de utilização do SOAP
A DevCoffee Disponibiliza alguns exemplos de como utilizar os WebServices SOAP em seu Github em linguagens como
Configuração de um WebService
Model Oriented Web Service
Para qualquer uma das Requisições SOAP que deseja fazer, é necessário iniciar a configuração por um Serviço do tipo Model Oriented Web Service(2), pois esse será responsável pela busca ou inserção dos dados.
- Escolha um Nome e uma Chave de Busca que facilite a sua busca pela Requisição.
- O Tipo do Serviço
- Tipo da requisição (Opções disponíveis na Tabela).
- Qual tabela será utilizada na requisição
- Os campos que serão enviados por sua aplicação através do WebService.
- Os campos que serão retornados para sua aplicação.
- Perfis terão acesso a requisição.
Composite Interface
A requisição do tipo Composite entende e encaminha inúmeros comandos do tipo "Model", em outras palavras, ao usar esse tipo de requisição, você deve empacotar todas as requisições Model que desejar e enviá-las todas de uma vez.
A configuração do Composite é uma pouco mais simples, já que será a porta de entrada para as demais configurações:
- Nome e Chave de busca
- Tipo do serviço, que nesse caso será CompositeInterface
- Método, o qual será CompositeInterface_composite
- Será necessário informar quem terá acesso ao WebService