Árvore de páginas

Versões comparadas

Chave

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

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.

Dica
titleIntegrando Inventario

Abaixo iremos mostrar como configurar o Processo de Conferência de Venda no Protheus. Siga o Passo a Passo.

Cadastrando o Processo de Conferência.

Para integrarmos o Conferência primeiramente é necessário acessar o cadastro do Processo para verificar se o Conferência foi criado automaticamente no 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.

  1. No módulo 12(Controle de Lojas),

...

  1. no menu acesse  Atualizações/

...

  1. Smart Hub/ Cadastros/ Processos

...

  1. ;
  2. Verifique se o processo foi gerado conforme a documentação

...

  1. e imagem abaixo: DT Conciliador de movimentos da integração TVFR - Protheus Smart Hub
    Image Added














...

3- Aguarde a criação automática do cadastro de processo referente ao Conferência.  

4- Verifique se foi criado as Informações abaixo:

Processo: Conferência

Tabela: 

Chave: Conferência de Venda

Vinculando o Processo de Conferência

...

X Assinante Live

...

:

É necessário que o Assinante LIVE(RMICADASSI), esteja devidamente cadastrado:

  1. No módulo 12(Controle de Lojas),

...

  1. no menu acesse  Atualizações/

...

  1. Smart Hub/ Cadastros/

...

  1. Processos;

...

  1.  Com o assinante Live previamente cadastrado, posicione no assinante Live e clique em

...

  1. "Alterar";
  2. Na guia Assinantes x Processos, preencha os seguintes campos:

    Image Added

Processo:  ConferênciaCONFERENCIA
Ativo: Sim
Tipo Process: BuscaEnvio
Filiais Proc: Informe o código das filiais que deseja "Buscar o Processo" a conferência e gerar o arquivo conciliador;
Configuração: Preencha esta campo de acordo com a sua URL da API  Conferência API de Conferência de Venda, como mostra o exemplo abaixo:;

Bloco de código
titleConfiguração
linenumberstrue
{
	"url": "http://qacorplive.totvs.com.br/{{url_cliente}}/PracticoLive/LiveConnector/FacadeIntegracao.svc?wsdl",
	"operacao": "RecuperarMovimentacoesLCManterConciliadorLC_Integracao_Xml",
	"tagretorno": "<ArrayOfLC_ConsultaMovimento>"<LC_RetornoConciliador>",
	"dataInicial": "2022-12-01",
	"dataFinal": "2022-12-02",
	"diasParaRetroagir": 1,
	"documentoIddata_conferencia": "LC_ConsultaMovimento20230323",
	"hora_conferencia": "07:00",
	"ChaveUnidiretorio_query": "Chave\\AUTOCOM\\",
	"DataPeriododiretorio_resultado":"10/01/21"
}

Layout Envio: Preencha este campo de acordo com o exemplo abaixo: Lembrando que é permitido utilizar macro execuções no Layout abaixo, após o &.

 "\\AUTOCOM\\",
	"emails": [
		"[email protected]"
	]
}
TagDescrição
urlUrl de WSDL do TVFR (Obs: é a mesma das demais).
operacaoMétodo utilizado.
tagretornoTag de retorno.
dataInicial Data inicial utilizada para comparação dos dados.
dataFinal Data final utilizada para comparação dos dados.
diasParaRetroagir 

Dia para retroagir.
Exemplo:  se colocarmos 30 dias e hoje seja dia 
  com isso a conferencia será executada com data inicial de  e a data final será .

Informações
titleImportante

Importante: 
Existe uma regra de prioridade, caso as tag's dataInicial e dataFinal estejam preenchidas a tag diasParaRetroagir é ignorada, caso não exista nenhuma configuração de data (dataInicial, dataFinal e diasParaRetroagir) a conferência será executada retroagindo sempre 30 dias.

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;

code
Bloco de código
languagecpp
titleLayout Envio
linenumberstrue
&"<soapenv:Envelope xmlns:soapenv='http://schemas.xmlsoap.org/soap/envelope/' xmlns:liv='http://LiveConnector/'>
    <soapenv:Header/>
    <soapenv:Body>
        <liv:RecuperarMovimentacoesLCManterConciliadorLC_Integracao_Xml>
            <liv:codigoSistemaSatelite>" + self:oConfAssin['sistemasatelite'] + "</liv:codigoSistemaSatelite>
<liv:xmlIdentificacao><![CDATA[<?xml version='1.0' encoding='utf-8'?><LC_FiltroConsultaMovimento>
            <liv:xmlIdentificacao>
                <![CDATA[    <LC_TicketConciliador>
                                <LC_Identificacao>
                                    <Chave>" + self:cToken + "</Chave>
                                    <CodigoSistemaSatelite>" + self:oConfAssin['sistemasatelite'] + "</CodigoSistemaSatelite>
                                </LC_Identificacao>
                   <DataPeriodo>"+RmiSeTDtPrc(self:oConfProce)+"</DataPeriodo>             <Numero>" + self:oPublica['Ticket'] + "</Numero>
        <CodigoLoja>"+self:DePara('SM0',self:aArrayFil[self:nFil][2], 1, 0,.T.)+"</CodigoLoja>
     </LC_FiltroConsultaMovimento>]]>
     </liv:xmlIdentificacao>
<liv:acessToken>70b45297-83e0-41e9-a1c6-826556acde71</liv:acessToken>
<!--Optional:-->
<liv:tipoDocumento>0</liv:tipoDocumento>
</liv:RecuperarMovimentacoesLC_Integracao_Xml>
</soapenv:Body>
</soapenv:Envelope>"

Layout Publicação:  Layout que será utilizado para gerar a Publicação (tabela MHQ), especificamente o campo MHQ_MENSAG

Obs: Os campos abaixo são configuráveis conforme a sua necessidade após o &. Podendo incluir mais campos e chamada de funções para preenchimento.

Bloco de código
{
    "Chave": "&self:oRegistro:_Chave:Text",
    "Doc":   "&self:oRegistro:_Doc:Text",
    "Serie": "&self:oRegistro:_Serie:Text",
    "StatusTVFR": "&self:oRegistro:_StatusTVFR:Text",
    "Ticket": "&self:oRegistro:_Ticket:Text",
    "ValorBruto": "&self:oRegistro:_ValorBruto:Text",
    "ValorLiquido": "&self:oRegistro:_ValorLiquido:Text"
}

Exemplo da configuração do Processo Cliente no assinante Live:

Image Removed

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

Bloco de código
titleLayout Publi
linenumberstrue
{
}
Aviso

Para o correto funcionamento do processo de CONFERENCIA, é necessário ter ao menos mais 1 processo do tipo envio ativo para o LIVE


...


Dica
titleFluxo de integração

Após ter realizado as configurações acima, a integração do Conferência  CONFERENCIA seguirá o seguinte fluxo:

  • Com os serviços/jobs RMIPUBLICA, RMIDISTRIB e RMIENVIA configurados e ativos,
será gerado
  • serão geradas as publicações na tabela MHQ
.
  • :
  • Após a busca da publicação
sera realizado
  • será realizada a distribuição das publicações de
Conferência 
  • 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:
      Image Added

      Para mais informações acesse: Arquivos Conciliadores