Manual de configuração do Webservice Checkdoc
Introdução
O objetivo de configurar um Webservice para o CheckDoc é realizar uma análise AUTOMÁTICA do XML recebido do Sefaz e verificar no ERP Protheus® se as informações contidas nele estão corretas.
Será verificado:
- Abertura do HTML do Checkdoc por link no e-mail;
Como usar?
Após a configuração, será enviado automaticamente para o(s) e-mail(s) cadastrado(s) no parâmetro: ZZ_ECKDOC - Parâmetros com e-mails separados por (;)
Detalhamento dos Serviços / Observações
Atividades incluídas:
-
Viabilizar a abertura e exibição das informações registradas com base na execução, através do hyperlink que passa a ser formatado sob a chave que corresponde à uma das colunas do e-mail com as informações, da apuração checkdoc.
-
Agregar às informações do e-mail de divergência emitido pós apuração checkdoc.
Informações técnicas relevantes
Parâmetros envolvidos:
- ZZ_PATHWS - Parâmetro para registro do path no Protheus_Data, do webservice, onde serão gerados os arquivos.
Exemplo: \web\facile_checkdoc
- ZZ_DFWEBS - Parâmetro para registro da url do serviço HTTP/HTTPS do Protheus, direcionado à pasta onde estarão salvos os arquivos e que será utilizado para carga do arquivo em navegador web (browse).
Exemplo: http://192.168.200.171:8079/facile_checkdoc/
- ZZ_ECKDOC - Parâmetros com e-mails que irão receber, separados por (;)
Exemplo: compras@nomedaempresa.com.br;outroemail@nomedoemail.com.br
ATENÇÃO: É necessário que a funcionalidade HTTP do Protheus esteja configurada e em execução para o correto funcionamento dessa rotina.
Configuração do webservice Checkdoc
Appserver_FACILE.ini
Incluir no serviço Appserver.ini destinado ao FACILE XML-e (normalmente nomeado como appserver_Facile.ini, Appserver01...), na pasta do serviço do Facile XML-e, o job PTXJ005.
Ex. (em vermelho)
AppServer01:
;;Job Responsável pelo Workflow do Checkdoc
[PTXJ005]
MAIN=U_PTXJ005
ENVIRONMENT=FACILE
nparms=2
Parm1=01
Parm2=0101
;;Tag responsável por inicializar e controlar os jobs
[ONSTART]
JOBS=PTXJ001,PTXJ003,PTXJ008,PTXJ005
REFRESHRATE=4000
O que significa cada TAG?
ENVIRONMENT => Ambiente que o JOB será executado
MAIN => Nome do programa a ser chamado
nparms => Quantidade de parâmetro a serem utilizados
Parm1 => Informe o código da Empresa
Parm2 => Informe o código da Filial
REFRESHRATE => Intervalo de tempo, em segundos, para que o Job seja executado
Com base na execução da rotina JOB, integrante do FACILE XML-e, para apuração de divergências nos registros identificados, passa a ser formatado um arquivo contendo as informações da apuração.
Este arquivo é registrado em diretório específico ligado ao webservice – Protheus®.
Figura 01: Diretório Webservice
Ao receber o e-mail contendo as informações de divergência, passe-se a observar e ter a ação de click na coluna: Chave.
Ao clicar na informação, será aberto – em navegador WEB (browse), o arquivo contendo as informações apuradas.
Figura 02: Divergência encontrada
Ao clicar em um dos links abrirá sua consulta:
Figura 03: Consulta da divergência
Workflow de notificação Checkdoc
Resumo
- Enviar workflow com todas as chaves que estão com divergência no CheckDoc e ainda não foram corrigidas;
- Criar parâmetro para definir data inicial da busca.
Detalhamento dos Serviços
Atividades incluídas
- Possibilitar que os usuários envolvidos sejam constantemente lembrados dos problemas nas notas fiscais que precisam ser corrigidos
Informações técnicas / Relevantes
Parâmetros envolvidos:
- ZZ_CHKRETR - Parâmetro numérico informando a quantidade de dias será retrocedido para buscar as notas fiscais que continuam com falha no CheckDoc.
Exemplo: 30
Passo a passo
O workflow será enviado através do job PTXJ005, que hoje já é utilizado para realizar a primeira checagem do CheckDoc das notas fiscais baixadas do Sefaz.
Para desativar o envio do workflow basta configurar o parâmetro ZZ_CHKRETR com o valor 0 (zero).