Assunto

Produto:

TOTVS Gestão de Estoque, Compra e Faturamento

Versões:

A partir da 11.50

Ocorrência:

Importação/Exportação de Movimento via WebService

Ambiente:

Importação/Exportação de Movimento

Passo a passo:

Este documento tem por finalidade ensinar como realizar a Exportação / Importação de movimento via WebService. Será utilizado o aplicativo SoapUI para consumo do WebService do RM.


    Definição do Processo

    Procedimentos para exportar o XML de um movimento da base RM através do SoapUI. Utilizado para criar o layout do XML a ser utilizado no conceito ou importação via WebService, uma vez que a parametrização do tipo de movimento define quais campos deverão existir neste XML, e podem existir XML's distintos entre os tipos de movimento diferentes.

    Configuração do WS (Webservice) RM

    Executar o documento: http://tdn.totvs.com/x/HoFXBQ

    Obs.: Acessando a página do Webservice RM (Orientado no link acima), clicar no link “wsDataServer/MEX?wsdl” e copiar o endereço desta página, este será utilizado na criação do projeto no SoapUI.(Exemplo: http://localhost:8052/wsDataServer/MEX?wsdl) 

    Criação do Projeto no SoapUI

    Acessar o aplicativo SoapUi (Disponível na web gratuitamente http://www.soapui.org/)

    Solicitar um novo Projeto e informar:

      • Nome do Projeto
      • O link WSDL copiado anteriormente na configuração do WS RM


    Será criado um projeto com as opções do print abaixo, onde deverão ser definidas as propriedades listadas:

      • Name = Nome da Janela/página do ReadRecord para o projeto
      • Encoding = UTF-8
      • Username = Usuário do sistema RM
      • Password = Senha do usuário do sistema RM


    Dê um duplo clique na páquina já editada e a “janela” grifada será aberta. Preencher nas tags abaixo, os valores:

      • <tot:DataServerName>MovMovimentoTBCData</tot:DataServerName>
      • <tot:PrimaryKey>CODCOLIGADA;IDMOV</tot:PrimaryKey>

      • <tot:Contexto>CODCOLIGADA=1;CODUSUARIO=mestre;CODSISTEMA=T</tot:Contexto>


    Para realizar o teste, clicar no ícone “Submit” (Play verde) conforme demonstra o print acima. Neste momento, o sistema irá gerar o XLS e XML do movimento pesquisado, sendo este a base para a criação de novos XML’s de Importação de movimento via SoapUI ou WebService

    Obs.: O Arquivo tem início no marcador “<MovMovimento>” e final no marcador “</MovMovimento>”. Entre estes marcadores estão os XLS e o XML do movimento pesquisado, que servirá como base para os movimentos que serão incluídos a partir do WebService/Conceito.

    Obs.2: Para importação, deverá copiar toda o conteúdo do retorno, desde:

    <![DATA[

    até

    ]]>


    Definição do Processo

    Procedimentos para importar XML de um movimento na base RM através do SoapUI.

    Criação do Projeto no SoapUI

    Já com o Projeto criado para Exportação, utilizaremos o método SaveRecord para importação.

    Configuração do SaveRecord: 

    • Name = Nome da Janela/página do SaveRecord para o projeto
    • Encoding = UTF-8
    • Username = Usuário do sistema RM
    • Password = Senha do usuário do sistema RM

    Ao clicar duas vezes sobre o Request 1 do SaveRecord, será aberta a tela central onde deverá ser informado os dados: 

    • <tot:DataServerName>MovMovimentoTBCData</tot:DataServerName>
    • <tot:XML>XML DO MOVIMENTO A SER IMPORTADO</tot:XML>

    • <tot:Contexto>CODCOLIGADA=1;CODUSUARIO=mestre;CODSISTEMA=T</tot:Contexto>


    Após preencher os dados, deverá se atentar aos detalhes:

    1. - Para criação de um novo registro (Movimento), obrigatoriamente deverá alterar o campo IDMOV para o valor -1. Caso tente importar utilizando um IDMOV fixo, o sistema irá tentar ATUALIZAR o registro em questão e não importar.
    2. - Além do IDMOV, a regra número 1, também vale para os campos sequenciais como (IDMOVRATCCU, IDMOVHST e etc).


    Feita a alteração no XML, para realizar o teste, clique no ícone “Submit” (Play verde) conforme demonstra o print abaixo. Neste momento, o SoapUI abrirá uma nova tela para consultar o retorno da ação:


    Caso o movimento seja incluído com sucesso, o SoapUI retornará as chaves do DataServer. No caso do movimento, retornará CODCOLIGADA e IDMOV conforme print acima.

    Está feito! Basta acessar o RM e visualizar o movimento incluído!


    Observações:

    Para mais informações:



     Consulte o WikiHelp TOTVS


       COMUNIDADE  R@Materiais e Suprimentos


    Canais de Atendimento:

    Abertura de Chamados Através do Portal Totvs www.suporte.totvs.com.br

    Telefônico: 4003-0015 Escolhendo as opções 2 – (Software), 2 – (Suporte Técnico), 3 – (RM), 5 – (Materiais)