Assunto

Produto:

TOTVS Gestão de Estoque, Compra e Faturamento

Versões:

11.82 e Superiores

Ocorrência:

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

Ambiente:

Importação/Exportação de Produto

Passo a passo:

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


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



Deverá ser criada uma Request na Operation ReadRecord, 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ágina já editada e uma nova janela será aberta. Preencher nas tags abaixo, os valores:

    • <tot:DataServerName> EstPrdDataBr </tot:DataServerName>
    • <tot:PrimaryKey>CODCOLIGADA;IDPRD</tot:PrimaryKey>

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


Após o preenchimento, clique em “Submit” (Play verde) para executar a leitura do registro. Caso esteja corretamente preenchido, será aberta uma nota tela com o XML do produto.

Criação do Projeto no SoapUI

Para importação do Produto, deverá copiar todo o XML gerado no passo de exportação.

O XML deve ser copiado de <![CDATA[<EstPrdBR > até </EstPrdBR>]]>


Após a cópia, deverá ser criada uma nova Request na Operation SaveRecord, respeintando a configuração:

  • 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


Feita a configuração das propriedades, será carregada a tela onde deverá informar os dados a serem importados.

  • <tot:DataServerName> EstPrdDataBr </tot:DataServerName>
  • <tot:XML>XML DO PRODUTO A SER IMPORTADO</tot:XML>

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

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

  1. Para criação de um novo registro (Produto), obrigatoriamente deverá alterar o campo IDPRD para o valor -1. Caso tente importar utilizando um IDPRD fixo, o sistema irá tentar ATUALIZAR o registro em questão e não importar.
  2. O IDPRD não está contido apenas no grupo TPRODUTO, ele é listado em todas as tabelas filhas da TPRODUTO (TPrdFil, TPrdCompl, dentre outras).
  3. Além da alteração do IDPRD, vale salientar que também deve-se alterar o CODIGOPRD (Código do Produto). Caso altere apenas o IDPRD o RM retornará erro informando que o produto com o código X já existe.


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

Caso o produto seja incluído com sucesso, o SoapUI retornará as chaves do DataServer. No caso do produto, retornará CODCOLIGADA e IDPRD.

Está feito! Basta acessar o RM e visualizar o produto que foi 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)