Histórico da Página
Incluir Movimento através de XML Cupom Fiscal com Integração TOTVS Business Connect e SOAPUI
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 temos 3 menus. Nesse caso, será utilizado o RM_IwsDataServer. Ao expandi-lo temos algumas funções.
Uma delas é a SaveRecord é a utilizada para Salvar (incluir) o movimento no TOTVS Gestão de Estoque, Compras e Faturamento. Ao expandir SaveRecord, temos Request1.
Ao clicar duas vezes, é aberta a tela para informar o XML, nesse caso um XML Cupom Fiscal que terá as informações do cupom fiscal para inserir no movimento. Também é 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 inclusão, é necessário preencher de forma correta as tags utilizadas no processo. Segue abaixo as orientações:
- A tag <tot:DataServerName>?</tot:DataServerName> deve-se informar o Nome do Data Server
...
- ;
- Na tag <tot:XML>?</tot:XML>
...
- será
...
- incluso
...
- o
...
- XML,
...
- com
...
- tags
...
- informando
...
- os
...
- dados
...
- para
...
- que
...
- o
...
- sistema
...
- inclua
...
- o
...
- movimento.
...
- Entre
...
- o
...
- XML
...
- deve
...
- informar
...
- a
...
- tag
...
- <!
...
- [CDATA
...
- ]
...
- ]>.
...
- ;
- 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 inclusão
...
- ;
- Inserido o XML, com as tags do mesmo com dados coerentes com a base de dados, basta executar
...
- ;
- O SoapUI irá exibir uma mensagem informando se foi incluído ou se há alguma inconsistência. Se houver, a mesma deve ser corrigida para efetuar a inclusão
...
- ;
- Incluído com sucesso, basta acessar o banco de dados ou a própria aplicação para conferir o movimento foi gerado.
Exemplo de um esquema para Incluir Movimento a partir de XML Cupom Fiscal:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tot="http://www.totvs.com/">
...
< soapenv:Header/>
...
< soapenv:Body>
<tot:SaveRecord>
...
< !-Optional:->
...
< tot:DataServerName>MovCupomFiscalData</tot:DataServerName>
...
< !-Optional:->
...
< tot:XML><!
...
[CDATA
...
[<MovCupomFiscal>
...
<TCUPOMFISCAL>
...
< CODCOLIGADA>1</CODCOLIGADA>
...
< IDCUPOM>-1</IDCUPOM>
...
< PONTOVENDA>9</PONTOVENDA>
<CRO>2</CRO>
...
< NUMERO>80073</NUMERO>
<COO>80065</COO>
...
< DATAEMISSAO>2014-04-03T00:00:00</DATAEMISSAO>
...
< HORARIO>2014-04-03T00:00:00</HORARIO>
...
< CODCOLCFO>0</CODCOLCFO>
...
< CODCFO>00029869</CODCFO>
...
< VALORLIQUIDO>1.70</VALORLIQUIDO>
...
< DESCONTO>0.00</DESCONTO>
...
< ACRESCIMO>0.00</ACRESCIMO>
...
< VALORRECEBIDO>1.70</VALORRECEBIDO>
<CAIXA>3</CAIXA>
...
< IDREDUCAOZ>924</IDREDUCAOZ>
...
< CANCELADO>0</CANCELADO>
<STATUS>C</STATUS>
<TIPO>V</TIPO>
...
</TCUPOMFISCAL>
...
<TCUPOMFISCALITM>
...
< CODCOLIGADA>1</CODCOLIGADA>
...
< IDCUPOM>-1</IDCUPOM>
...
< NUMEROITEM>1</NUMEROITEM>
...
< IDPRD>110904</IDPRD>
...
< QUANTIDADE>1.000</QUANTIDADE>
...
< PRECOUNITARIO>1.700</PRECOUNITARIO>
...
< VALORBRUTO>1.70</VALORBRUTO>
<DESCONTO>0.00</DESCONTO>
...
< ACRESCIMO>0.00</ACRESCIMO>
...
< RATEIODESCONTO>0.00</RATEIODESCONTO>
...
< RATEIOACRESCIMO>0.00</RATEIOACRESCIMO>
...
< VALORLIQUIDO>1.70</VALORLIQUIDO>
...
< CANCELAMENTO>0.00</CANCELAMENTO>
...
< TRIBUTACAOECF>II</TRIBUTACAOECF>
<IDNAT>41</IDNAT>
...
< ALIQUOTA>0.00</ALIQUOTA>
<CST>040</CST>
...
< CANCELADO>0</CANCELADO>
<CODUND>UN</CODUND>
...
</TCUPOMFISCALITM>
...
<TCUPOMFISCALFIN>
...
< CODCOLIGADA>1</CODCOLIGADA>
...
< IDCUPOM>-1</IDCUPOM>
...
< NUMEROPARCELA>80733</NUMEROPARCELA>
...
< DEBITOCREDITO>C</DEBITOCREDITO>
<VALOR>1.70</VALOR>
...
< DATAVENCIMENTO>2013-11-01T00:00:00</DATAVENCIMENTO>
...
< IDFORMAPAGTO>1</IDFORMAPAGTO>
...
< CODCOLCXA>1</CODCOLCXA>
...
< CODCXA>CX-011</CODCXA>
...
</TCUPOMFISCALFIN>
</MovCupomFiscal>]]></tot:XML>
...
< !-Optional:->
<tot:Contexto>CODCOLIGADA=1;CODUSUARIO=mestre;CODSISTEMA=T</tot:Contexto>
</tot:SaveRecord>
...
< /soapenv:Body>
</soapenv:Envelope>
...
| Veja Também |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas