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 superiorincluí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.291Conferir 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. No pacote também conterá um arquivo chamado VGPGINTW e outro chamado regasm.exe. Copie os dois arquivos para a pasta EXE do contexto do servidor 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.
3 - Abra o Pool de Aplicações, conforme a imagem abaixo. Certifique que existe um pool exclusivo no framework 4.0 ou 4.5.
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.
5 - Clique com o botão direto na pasta Zanthus e selecione a opção para converter para aplicativo.
6 – Selecione o pool de aplicações parametrizado previamente.
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: os parâmetros terminados em StatusLog devem estar como 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="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.
2 – O caminho abaixo deve conter o caminho do webservice de integração da Zanthus.
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 dígito – Conteúdo SSSSSS
XXXXEPDV12 = X Loja sem dígito – Conteúdo 1;
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í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.
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".
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.
Após a confirmação da segunda perna, o webservice remove os produtos referentes à chave enviada da tabela ag1pdvpd.
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, podem ser algumas razões.:
a) O processo de integração não conseguiu criar o arquivo VGPGINTW.tlb no EXE do RMS por conta do framework 4.5 não estar instalado na máquina;b) 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 setup"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.
