Esta funcionalidade foi criada para auxiliar na necessidade de conferência de cupons/vendas e notas fiscais de entrada e saída que são integradas pelo TVFR com o Protheus.
IMPORTANTE!
Esta funcionalidade é exclusiva para clientes que utilizam o LIVE. As configurações abaixo devem ser realizadas corretamente para a geração dos arquivos CVS do Conciliador, assim como os serviços/jobs RMIPUBLICA, RMIDISTRIB e RMIENVIA devem estar configurados e iniciados. Para mais informações acesse: 2- Serviços
Observações gerais:
- A conferencia é executada entre 00:00 ás 01:00;
- Os arquivos são enviados por email, para os emails informados na tag "email" no Layout Envio;
- Caso o consolidado não esteja sendo enviado junto ao corpo do e-mail, verifique se os arquivos estão presentes no diretório mencionado. Caso o erro persista procure a equipe do suporte e encaminhe o arquivo logloja;
- Para que os arquivos conciliadores sejam gerados, os serviços/jobs RMIENVIA, RMIDISTRIB, RMIBUSCA precisam estar iniciados e não apresentar erros;
- É necessário que estejam ativos um Processo(RMICADPROC) de "Envio" e "Busca" para gerar os registros na tabela MHQ;
- Caso seja necessário executar novamente a conferência basta "limpar" a tag data_conferencia ou retroagir a data presente.
Cadastrando o Processo de Conferência:
Ao acessar a rotina de cadastro de Processos(RMICADPROC) a CONFERÊNCIA será criada automaticamente.
- No módulo 12(Controle de Lojas), no menu acesse Atualizações/ Smart Hub/ Cadastros/ Processos;
- Verifique se o processo foi gerado conforme a documentação e imagem abaixo: DT Conciliador de movimentos da integração TVFR - Protheus Smart Hub
Vinculando o Processo de Conferência X Assinante Live:
É necessário que o Assinante LIVE(RMICADASSI), esteja devidamente cadastrado:
- No módulo 12(Controle de Lojas), no menu acesse Atualizações/ Smart Hub/ Cadastros/ Processos;
- Com o assinante Live previamente cadastrado, posicione no assinante Live e clique em "Alterar";
- Na guia Assinantes x Processos, preencha os seguintes campos:
Processo: CONFERENCIA
Ativo: Sim
Tipo Process: Envio
Filiais Proc: Informe o código das filiais que deseja "Buscar" a conferência e gerar o arquivo conciliador;
Configuração: Preencha esta campo de acordo com a sua URL da API de Conferência de Venda, como mostra o exemplo abaixo;
{ "url": "{{url_cliente}}/PracticoLive/LiveConnector/FacadeIntegracao.svc?wsdl", "operacao": "ManterConciliadorLC_Integracao_Xml", "tagretorno": "<LC_RetornoConciliador>", "dataInicial": "2022-12-01", "dataFinal": "2022-12-02", "diasParaRetroagir": 1, "data_conferencia": "20230323", "hora_conferencia": "07:00", "diretorio_query": "\\AUTOCOM\\", "diretorio_resultado": "\\AUTOCOM\\", "emails": [ "[email protected]" ] }
Tag | Descrição |
---|---|
url | Url de WSDL do TVFR (Obs: é a mesma das demais). |
operacao | Método utilizado. |
tagretorno | Tag de retorno. |
dataInicial | Data inicial utilizada para comparação dos dados. |
dataFinal | Data final utilizada para comparação dos dados. |
diasParaRetroagir | Dia para retroagir. Importante Importante: |
diretorio_query | Diretório onde será salvo o arquivo QueryConsolidadoConciliador.sql esse é o arquivo de query executado para a geração dos resultados consolidados que são entregues no corpo do e-mail. |
diretorio_resultado | Diretório onde será salvo os arquivos de resulados. Obs: os arquivos também são disponibilizados por e-mail, porem precisam ser salvos. apenas um arquivo é salvo, de tal modo que a cada dia o arquivo é substituído. |
emails | Lista de e-mails que receberão o resultado do conciliador, para que esses e-mail sejam disparados e necessário que a configuração de e-mail do Protheus esteja previamente feita. |
hora_conferencia | Hora, no formato 12:00, que irá definir a hora inicial para execução do conciliador. |
Layout Envio: Preencha esta campo de acordo com a sua URL da API de Conferência de Venda, como mostra o exemplo abaixo;
&"<soapenv:Envelope xmlns:soapenv='http://schemas.xmlsoap.org/soap/envelope/' xmlns:liv='http://LiveConnector/'> <soapenv:Header/> <soapenv:Body> <liv:ManterConciliadorLC_Integracao_Xml> <liv:codigoSistemaSatelite>" + self:oConfAssin['sistemasatelite'] + "</liv:codigoSistemaSatelite> <liv:xmlIdentificacao> <![CDATA[ <LC_TicketConciliador> <LC_Identificacao> <Chave>" + self:cToken + "</Chave> <CodigoSistemaSatelite>" + self:oConfAssin['sistemasatelite'] + "</CodigoSistemaSatelite> </LC_Identificacao> <Numero>" + self:oPublica['Ticket'] + "</Numero> <DataFim>" + self:oPublica['DataFinal'] + "</DataFim> <DataInicio>" + self:oPublica['DataInicial'] + "</DataInicio> </LC_TicketConciliador> ]]> </liv:xmlIdentificacao> </liv:ManterConciliadorLC_Integracao_Xml> </soapenv:Body> </soapenv:Envelope>"
Layout Publi: Preencha esta campo de acordo com a sua URL da API de Conferência de Venda, como mostra o exemplo abaixo:
Observação: Necessário a inclusão de chaves vazias no layout de publicação.
{ }
Para o correto funcionamento do processo de CONFERENCIA, é necessário ter ao menos mais 1 processo do tipo envio ativo para o LIVE.
Fluxo de integração
Após ter realizado as configurações acima, a integração do CONFERENCIA seguirá o seguinte fluxo:
- Com os serviços/jobs RMIPUBLICA, RMIDISTRIB e RMIENVIA configurados e ativos, serão geradas as publicações na tabela MHQ:
- Após a busca da publicação será realizada a distribuição das publicações de CONFERENCIA para o Assinante LIVE na tabela MHR:
- Após o processamento do Protheus e do Connector serão criados os arquivos resultadocomparacao e saltonumeracao no diretório informado nas tags diretorio_query e diretorio_resultado.
- Por default os arquivos são gerados na pasta autocom:
Para mais informações acesse: Arquivos Conciliadores
- Por default os arquivos são gerados na pasta autocom: