Cross Segmentos - Backoffice Linha RM - Gestão de Estoque, Compras e Faturamento - MAT - Importação/Exportação de Movimento via Webservice

 Tempo aproximado para leitura: 00:04:00min

Dúvida
Como realizar a Importação/Exportação de Movimento via Webservice utilizando protocolo SOAP?

Ambiente
Cross Segmentos - TOTVS BackOffice Linha RM - TOTVS Gestão de Estoque, Compras e Faturamento – Todas as versões.

Solução
Através do protocolo SOAP é possível realizar o consumo de Webservice utilizando o DataServer MovMovimentoTBCData para obter o XML de movimentos já contidos na base, além de incluir novos registros e/ou enviar alterações à registros já existentes.

Para implementação é necessário seguir as orientações abaixo:

1. Configure o Webservice conforme indicado no artigo: Cross Segmentos - Backoffice RM - Integração - Como Habilitar Webservice via RM Host.
2. Para testes e consumo de Webservice, recomendamos a ferramenta open source SoapUI. Faça o download clicando aqui. 
3. Crie um novo projeto no SoapUI informando o Nome e URL do webservice RM.
Exemplo: http://servidor.com:8051/wsDataServer/MEX?wsdl

Exportação de Movimentos:
1. Acesse Projects > Dataserver > RM_IwsDataServer > ReadRecord > clique com botão direito do mouse > New request.

2. A requisição será aberta com a estrutura necessária para consumo. Preencha as tags DataServerName (MovMovimentoTBCData), PrimaryKey (Código da Coligada e Identificador do Movimento) e Contexto (Código do Usuário, Código do Sistema e Código da Coligada), conforme exemplo a seguir e posteriormente clique no ícone submit, destacado abaixo:

3. Se o registro referente ao Identificador do Movimento (IDMOV) informado na tag PrimaryKey existir no banco de dados, será gerado o XML com os mesmos dados.

Importação de Movimentos:
1. Acesse Projects > Dataserver > RM_IwsDataServer > SaveRecord > clique com botão direito do mouse > New request.

2. A requisição será aberta com a estrutura necessária para consumo. Preencha as tags DataServerName (MovMovimentoTBCData) e Contexto (Código do Usuário, Código do Sistema e Código da Coligada).

Na tag XML , <![DATA[ ... ]]> informe o XML do movimento a ser importado com todos os campos devidamente preenchidos.

Utilize o XML retornado no método ReadRecord como base para a inclusão de novos movimentos.
Todos os campos incrementados sequencialmente deverão conter o valor fixo -1 (IDMOV, IDMOVRATCCU, IDMOVHIST, etc).

Posteriormente clique no ícone submit, destacado abaixo:

3. Se o registro for incluído com sucesso, será retornado o Código da Coligada (CODCOLIGADA) e Identificador do Movimento (IDMOV) criado.

Importante

• Antes de consumir Webservice deverá incluir a autenticação, seguindo as orientações do artigo: Linha RM - Integrações - WebService - Orientação para autenticação básica.
• Na importação de movimentos via Webservice serão consistidos todas as regras de parametrização do tipo de movimento, da mesma forma que a inclusão manual pelo sistema. Por isso o suporte não fornece exemplo de XML para inclusão de registros pelo SaveRecord. Recomendamos usar um movimento com as mesmas características do que deseja importar, previamente lido pelo ReadRecord.

Para saber mais informações sobre esse processo, clique aqui.