Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Guia de Instalação e Testes da Integração RMS x Zanthus 360º

Produto:

 RMS

Versões:

 5681.1

V12

Ocorrência:

Criamos um passo-a-passo para a instalação e testes do projeto de integração RMS x Zanthus 360º.

Passo a passo:

Requisitos Mínimos:

    • Sistema Operacional Windows Server 2008, Windows 7 Professional ou superior.
    • IIS instalado.
    • Usuário logado para instalação deve ser administrador da máquina.
    • .NET Framework 4.5.
  • ODAC 12c Release 4 and Oracle Developer Tools for Visual Studio (12.1.0.2.4) instalado (INF0001_Guia_Instalação_Oracle_ODAC_ASP_NET) e configurado para acessar o banco de dados do cliente.
      • Pacote atualizado do PDV EXPORTAÇÃO (package PC_RMS_PDV_EXPORTACAO
    na versão 5.681.0047 ou superior
      • incluída nos SPs).
      • Pacote atualizado da tesouraria
    (PC_TES_VDT na versão 5.681. ou superior).
      • .
      • Módulo fiscal Mensal e 60i Mensal já implantados
      • Ambiente Zanthus atualizado (
    manager na versão 1.12.105.106 e CodFon do PDV na versão 1.X.X.273).
      • Conferir com a Zanthus a atualização mais recente).
      • Webservice do PDV Padrão instalado e configurado conforme o TDN (INF0003 Guia de Instalação e Testes da Integração Webservice PDV Padrão)
      • SOAPUI Opensource instalado (para efeitos de teste dos webservices).
      • Com a Zanthus, não temos integração CRM e Vendas Assistidas através de serviços. Para clientes em cloud, estes módulos não são integrados.

    ATENÇÃO - A máquina não deve conter o sistema RMS instalado na mesma, assim como não deve conter outras instâncias do oracle client instalada, caso exista, favor efetuar a desinstalação antes de prosseguir.

    Instalação dos webservices de integração:

    1 - Baixe o pacote de integração contendo

    os dois webservices (PDV e Zanthus) solicitando-os

    o webservices Zanthus e o webservice PDV Padrão solicitando-o à equipe TOTVS RMS.

    Se não existir a pasta RMS no C:\inetpub\wwwroot, crie a seguinte árvore de pastas.

    2 -

    Cole a pasta RMS

    No caminho C:\inetpub\wwwroot, crie pasta com nome RMS dentro da pasta RMS crie a pasta Conectores

    O conteúdo do webservice Zanthus, cole no caminho C:\inetpub\wwwroot

    conforme a imagem

    \RMS\Conectores\Zanthus conforme o exemplo abaixo.

    Image Removed

    Image Added

    3 - Abra o Pool de Aplicações, conforme a imagem abaixo. Certifique que existe um pool exclusivo no framework 4.0 ou 4.5.

    Image Modified

    3


    4 - Se o Windows for 64 bits, é necessário alterar o campo de compatibilidade com aplicações

    32bits

    32 bits nas configurações avançadas do pool.

    Image Modified

    4

    5 -  Clique com o botão direto na pasta Zanthus e

    seleciona

    selecione a opção para converter para aplicativo.

    Image Modified

    5  

    6 – Selecione o pool de aplicações parametrizado previamente.

    Image Removed

    6 – Faça o mesmo procedimento com a pasta PDV até ambas ficarem configuradas conforme a imagem abaixo.

    Image Removed

    Image Added


    Configuração dos webservices de integração


    1 – Abra o arquivo web.config contido na pasta C:\inetpub\wwwroot\RMS\Conectores\Zanthus e preencha as variáveis conforme abaixo (
    atenção: o parâmetro AtivarLog deve
    Atenção: os parâmetros terminados em StatusLog devem estar como
    false
    0 em ambiente de produção para evitar overhead de processamento
    ).

    Image Removed

    8 – O caminho abaixo deve conter o caminho do webservice de integração da Zanthus.

    Image Removed

    1 – Abra o
    . Faça o mesmo procedimento do StatusLog no arquivo web.config também contido na pasta C:\inetpub\wwwroot\RMS\WebServices\SOAP\PDV
    e preencha as variáveis conforme abaixo (atenção: o parâmetro AtivarLog deve estar como false em ambiente de produção para evitar overhead de processamento). Atenção: o campo Data Source deve conter o alias do banco de dados configurado no tnsnames da máquina.

    Image Removed

    10 – Para ser criado o arquivo TNSNAMES.ORA, insira as configurações do servidor e do banco de dados que deseja conectar.

    Image Removed

    11 – Se na Etapa de "Executar Verificações de Pré-Requisitos" apresentar o erro abaixo.

    Image Removed

    11 – Acesse o Caminho "ODTwithODAC121024\stage\cvu\cv\admin", abra o arquivo cvu_config como bloco de notas e altere o valor do campo CV_ASSUME_DISTID para 6.1, assim como a imagem abaixo. Salve o documento e refaça a instalação.

    Image Removed

    12 – Caso apresente algum erro fora o descrito acima, entre em contato com o suporte TOTVS RMS. Se a instalação for concluída com sucesso, reinicie a maquina e pronto, o "ODAC Oracle For ASP.NET" estará instalado com sucesso.

     

    ). Adicionar no campo Lojas as lojas que farão parte da exportação).

    <add key="aspnet:UseTaskFriendlySynchronizationContext" value="true" />
    <add key="AtivarLog" value="true" /><!--valores(true ou false); ativa o sistema de logs para as rotinas do webservice.-->
    <add key="UsaDepartamento" value="false" /><!--valores(true ou false); Informa se o cliente usa o conceito de departamento no RMS.-->
    <add key="QuantidadePaginacaoProdutos" value="1000" />
    <add key="QuantidadePaginacaoNotas" value="200" />
    <add key="TipoBandoDeDados" value="1" />
    <add key="TipoNota" value="1" />
    <add key="QuantidadePaginacaoRF" value="500" />
    <add key="DepartamentoInativo" value="999" />
    <add key="UsaCodigoInterno" value="false" />
    <add key="FormaDecomposicao" value="4"/>
    <add key="TipoDecomposicao" value="7"/>
    <add key="Lojas" value="2;3;4;5;7;10;12;24;28;29;31;34;35;36"/>

    <add key="UsaFabricacaoPropria" value="false"/>

    O departamento 999 deve ser cadastrado na Zanthus como INATIVOS. Se já existir um departamento para o envio dos produtos inativos, alterar o parâmetro DepartamentoInativo acima para conter o código do departamento na Zanthus.

    Image Added



    2 – O caminho abaixo deve conter o caminho do webservice de integração da Zanthus.

    Image Added



    3 - É importante garantir que a máquina onde será efetuada a exportação esteja com acesso livre no proxy/firewall para o caminho http://IP_WEBSERVICE_CONECTOR/RMS/Conectores/Zanthus/Servico/ServicoZanthus.svc?wsdl.

    Configuração no RMS


    – Cadastre os acessos abaixo.

    Tabela 45

    XXXXXXPDPE = X Loja sem dígito – Conteúdo SSSSSS

    XXXXIPDV12 = X Loja sem dígito – Conteúdo 0;

    XXXXAPDV12 = X Loja sem dígito – Conteúdo “N”;

    XXXXXXXPDP = X Loja sem dígito – Conteúdo SNNNNN0000NN

    XXXXXXXCRM = X Loja sem dígitoConteúdo é o código da loja X na Zanthus. Se o código de loja no RMS for o mesmo na Zanthus, preencher o conteúdo com o mesmo código de loja RMS.

    Tabela 30

    XXXXAPDV12 = X Loja sem digito – Conteudo IP WS RMS;
    Alterar (caso não esteja) o campo AG1PDVPD.PDV_FLAG para conter 50 caracteres (varchar2(50)).


    Instruções para o teste


    – Execute o comando update ag1pdvpc set pdvc_flag = 'S'
    – Todos os testes devem ser feitos com um número reduzido de produtos para otimizar os testes integrados. Para isso, remova os dados da tabela AG1PDVPD e faça carga de somente um produto, conforme imagem abaixo.
    Image Added
    – O processamento da carga pela Zanthus é feito de forma assíncrona. Durante a carga, são executados dois passos:
    a) O produto é enviado para a Zanthus e a Zanthus devolve uma chave. Essa chave é atualizada na tabela AG1PDVPD para os produtos que foram enviados e constam na Zanthus como pendente de processamento. Chamamos este primeiro processo de "primeira perna".
    Image Added
    b) Após o processamento da carga pela Zanthus, eles chamam o serviço ReceberConfirmacaoCadastro responsável por remover os produtos da chave processada da tabela AG1PDVPD. Chamamos este segundo processo de "segunda perna".
    É possível analisar se a Zanthus está executando este passo verificando os arquivos de log na pasta C:\RMS.WS.Logs conforme imagens abaixo.
    Image Added
    Image Added
    Image Added
    Após a confirmação da segunda perna, o webservice remove os produtos referentes à chave enviada da tabela ag1pdvpd.
    Image Added


    4 - Recomendações
    Com o apoio de um DBA, recomendamos a execução do rebuild dos seguintes índices do banco RMS.

    AG1WPDVX

    AA3CITEM

    AA2CESTQ

    AA3CCEAN

    AA1LINHP

    AA3CNVCC

    AA3CLSEC

    AG1PBACO

    AA1DITEM

    AA2CPREC

    AA3CPREC

    AG2PRCDS

    AA3CLSEC



    5 - Se o processo de exportação não está chegando na Zanthus:

    a) A versão da Zanthus não está condizente com o que foi estabelecido nos pré-requisitos ou foi alterada sem a homologação junto à RMS;



    6 - Para o processo de integração de cadastro ser realizado pelo VGPGPDVE ou VGPGAUTO, é necessário o cliente instalar o arquivo "Integração ZANTHUS - Cadastro Setup.exe" na mesma máquina onde foram configurados os WebServices enviado no pacote de integração WS RMS x Zanthus. A instalação é intuitiva e deve seguir o passo a passo do próprio aplicativo sem a necessidade de alterar quaisquer informações. O processo é executado de 1 em 1 minuto.

    a) Caso o Windows Service acima não seja instalado na mesma máquina dos webservices Conector e PDV Padrão, é necessário alterar o caminho de referência do Windows Service para o serviço do webservice Conector alterando o arquivo ".config" situado na pasta "Arquivo de Programas\TOTVS\Integração RMS x Zanthus - Cadastro" conforme imagem abaixo.

    Image Added



    7 - Se o processo de importação dos cupons não está chegando nas tabelas CAPCUPOM, AG1PDVCC, DETCUPOM, etc, verificar se as requisições estão chegando no Webservice Conectores seguindo os seguintes passos:

    a) Alterar a chave ReceberNFCeSATStatusLog no arquivo C:\inetpub\wwwroot\RMS\Conectores\Zanthus\web.config para conter valor 3 (conforme abaixo).

    <add key="ReceberNFCeSATStatusLog" value="3" />

    b) Alterar a chave EnviarNFCeSATStatusLog no arquivo C:\inetpub\wwwroot\RMS\WebServices\SOAP\PDV\web.config para conter valor 3 (conforme abaixo).

    <add key="EnviarNFCeSATStatusLog" value="3" />

    c) Apagar os logs gerados na pasta C:\RMS.WS.Logs.

    d) Se após um período de 10 minutos não forem criadas as pastas C:\RMS.WS.Logs\RMSServices\PDV\SOAP\EnviarNFCeSAT e C:\RMS.WS.Logs\Conectores\Zanthus\ReceberNFCeSAT, isso significa que o sistema da Zanthus não está conseguindo enviar as informações para o webservice da RMS.


    8 - Envio de Insumos KT/Cesta:

    Caso algum item não seja localizado na exportação de alterados, este será enviado no XML com EAN 999.
    No arquivo Web.config existe a TAG <add key="EnviaInsumoNaoEncontradoKTCesta" value="true"/>.
    Caso não deseje que este insumo seja enviado para a Zanthus, basta mudar a TAG para <add key="EnviaInsumoNaoEncontradoKTCesta" value="false"/>.

    ...