TOTVS Varejo Supermercados (Linha RMS)

Árvore de páginas

Versões comparadas

Versão antiga 15

changes.mady.by.user Usuário desconhecido (mirella.costa)

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Eduardo Cirilo Negreiros Guerra

Gravado em

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.
      • Módulo fiscal Mensal e 60i Mensal já implantados
      • Ambiente Zanthus atualizado (
    manager na versão 1.12.108.109 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 - No caminho C:\inetpub\wwwroot, crie pasta com nome RMS dentro da pasta RMS crie

    mais duas pastas com seguintes nomes:

    a pasta Conectores

    O conteúdo do webservice Zanthus, cole no caminho C:\inetpub\wwwroot\RMS\Conectores\Zanthus conforme o exemplo abaixo.

    Image Modified

    WebServices

    Dentro da pasta WebServices, crie pasta com nome SOAP.

    O conteúdo do webservice PDV, cole no caminho C:\inetpub\wwwroot\RMS\WebServices\SOAP\PDV, conforme o exemplo abaixo.

    Image Removed

    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


    4 - Se o Windows for 64 bits, é necessário alterar o campo de compatibilidade com aplicações 32 bits nas configurações avançadas do pool.

    Image Modified

    5 -  Clique com o botão direto na pasta Zanthus e selecione a opção para converter para aplicativo.

    Image Modified

    5

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

    Image Modified

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

    Image Removed

     

    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
    os parâmetros terminados em StatusLog devem estar como
    false
    0 em ambiente de produção para evitar overhead de processamento. Faça o mesmo procedimento do StatusLog no arquivo web.config também contido na pasta C:\inetpub\wwwroot\RMS\WebServices\SOAP\PDV). 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="

    UsaDepartamento

    DepartamentoInativo" value="

    false

     

    <add key="aspnet:UseTaskFriendlySynchronizationContext" value="true" />
    <add key="ConnectionString" value="Data Source=RMS;User Id=rms;Password=rms;" />
    <add key="InsereNFCeComMovimento" value="true" />
    <add key="AtivarLog" value="false" />
    <add key="CriticaNFCe" value="false" />

    Image Removed

    Configuração no RMS

    1

    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 Modified



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

    Image Modified



    3

    – Abra o arquivo web.config 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.

    - É 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

    digito

    dígito –

    Conteudo

    Conteúdo SSSSSS

    XXXXEPDV12

    XXXXIPDV12 = X Loja sem

    digito

    dígito –

    Conteudo 1

    Conteúdo 0;

    XXXXIPDV12

    XXXXAPDV12 = X Loja sem

    digito

    dígito –

    Conteudo 0

    Conteúdo “N”;

    XXXXAPDV12

    XXXXXXXPDP = X Loja sem

    digito – Conteudo “N”;

    dígito – Conteúdo SNNNNN0000NN

    XXXXXXXCRM

    XXXXXXXPDP

    = X Loja sem

    Digito – Conteudo SNNNNN0000NN

    dígito – Conteú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

     

    1


    – Execute o comando update ag1pdvpc set pdvc_flag = 'S'
    2
    – 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 Modified
    3
    – 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 Modified
    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 Modified
    Image Modified
    Image Modified
    Após a confirmação da segunda perna, o webservice remove os produtos referentes à chave enviada da tabela ag1pdvpd.
    Image Modified


    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"/>.