Histórico da Página
O TOTVS Business Connect (TBC) contém Web Services que podem ser acessados por outros aplicativos para integração com a Linha RM.
Através de uma ferramenta SOAP, (Simple Object Access Protocol) que é padrão universal utilizado para a troca de mensagens entre as aplicações consumidoras e o Web Service, nesse caso SoapUI, esses WebServices são consumidos e testados.
Para iniciar o processo é preciso verificar se os serviços web do TBC estão disponíveis, através do link http://localhost/TOTVSBusinessConnect/ no navegador.
Um dos serviços é o DataServer, que disponibiliza acesso direto aos objetos de negócio RM (DataServer).
No SoapUI, ao criar um projeto, em Initial WSDL informar o WSDL do Data Server.
Ao clicar em Ok, um projeto será criado na ferramenta. No projeto há 3 Menus. Nesse caso será utilizado o RM_IwsDataServer. Ao expandi-lo temos algumas funções.
Uma delas é a ReadRecord, utilizada para ler dados da base e montar o XML, nesse caso o de Cupom Fiscal.
Ao expandir ReadRecord, temos Request1. Ao clicar duas vezes, é aberta a tela para informar os dados a serem lidos, já existente na base de dados.
É necessário que em Request Properties seja preenchidos os values do Property Username e Passoword, com usuário e senha, assim a ferramenta irá conseguir autenticar o usuário da operação.
Para efetuar a leitura dos dados, é necessário preencher de forma correta as tags utilizadas no processo que são:
- A tag <tot:DataServerName>?</tot:DataServerName> deve-se informar o nome do Data Server.
- Na <tot:PrimaryKey>?</tot:PrimaryKey> deve-se informar o Código da Coligada e o Identificador do Cupom Fiscal a ter sua informações copiadas.
- Na tag <tot:Contexto>?</tot:Contexto> será informado o Código da Coligada, Usuário e o Código do Sistema que serão utilizados para realizar a leitura.
- Após preencher as tags, com dados coerentes com a base de dados, basta executar. O SoapUI irá exibir o esquema com o XML do Cupom Fiscal ou se há alguma inconsistência. Se houver, a mesma deve ser corrigida para efetuar a leitura e montagem do XML. Pode-se incluir um novo movimento, utilizado esse XML. Exemplo de um esquema para ler dados da base e montar o XML Cupom Fiscal:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tot="http://www.totvs.com/">
< soapenv:Header/>
< soapenv:Body>
< tot:ReadRecord>
< !-Optional:->
< tot:DataServerName>MovCupomFiscalData</tot:DataServerName>
< !-Optional:->
< tot:PrimaryKey>1;202508</tot:PrimaryKey>
<!-Optional:->
< tot:Contexto>CODCOLIGADA=1;CODUSUARIO=mestre;CODSISTEMA=T</tot:Contexto>
</tot:ReadRecord>
< /soapenv:Body>
</soapenv:Envelope>