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