TOTVS Varejo Supermercados (Linha RMS)

Árvore de páginas

Versões comparadas

Versão antiga 18

changes.mady.by.user Rodrigo Amorim Ferreira da Palma

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, V12R12, V12R14, V12R15

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.291
    • 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 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 a pasta Conectores

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

Image Modified

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

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

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

1


– 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”;XXXXXXXPDP

dígito – Conteúdo SNNNNN0000NN

XXXXXXXCRM = 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)).
 1


Instruções para o teste

 


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