1673 Tarefas Servidor/Download Distribuicao XML NFSe
Esta tarefa realiza a consulta e o download dos XML's dos NFSe's destinados a empresa. Esta tarefa está listada em 1673_Tarefas_Servidor como Download e Distribuição XML NFSe's".
Atenção! Na configuração de execução desta tarefa, especialmente o tempo entre as consultas, não informe menor 10 segundos. A Sefaz bloqueia consultas em sequência!
Atenção! Podem ocorrer diversos problemas na execução desta tarefa, conforme limitações da Sefaz, logo sempre configure os dados de notificação por email em 1673_Tarefas_Servidor para ser notificado em caso de problemas.
Fluxo Principal
Para utilizar esta tarefa, será necessário a configuração de parâmetros de serviços, no recurso 1876_Configuracao_Servicos. Se você possui empresas matriz e filiais, lembre-de configurar o NSU para cada empresa.
Em 1876_Configuracao_Servicos, informe:
- Configuração do certificado a ser utilizada, conforme criado e configurado no recurso 1396_Configuracao_Certificado. Somente são aceitos certificados A1. Informe apenas o Identificador da configuração.
- Informe o identificador da empresa. Empresas com filiais, que compartilham o mesmo certificado, informe os identificadores das empresas separados por ;.
- Informe 0 para Homologação e 1 para Produção. Utilize Homologação somente com acompanhamento de um consultor da Touch Comp, pois a Sefaz disponibiliza para testes arquivos muito antigos, o que pode provocar erros.
- Informe o NSU inicial. Verifique a seção NSU para mais detalhes.
- Quantidade Máxima Requisições Periodo(qtd_max_requisicoes_periodo): ver seção Uso Indevido;
- Timeout entre Consultas(timeout_entre_consultas): ver seção Uso Indevido;
Após realizar as configurações, acesse o recurso 1673_Tarefas_Servidor e configure esta tarefa.
- Informe os identificadores das configurações de serviços criadas, separadas por ;. O sistema irá buscar cada configuração separadamente para realizar a checagem e o download dos XML's. Por exemplo, suponha que tenha criado as configurações de Identificadores 1(Empresa Matriz) e 5 (Empresa Filial), logo informe 1;5; na configuração da tarefa.
NSU
NSU significa Número Sequencial Único, que é atribuído a cada XML. Logo quando o sistema realiza o download, este download é realizado por pacotes. Na próxima execução, o ERP irá reralizar a próxima consulta de acordo com o último NSU armazenado.
Logo, caso utilize outro sistema para realizar esta consulta e download de XML's, verifique o último NSU capturado neste sistema e informe-o no campo NSU Inicial, para acelerar o processo de download de XML's, evitando baixar desnecessariamente XML's que já tenha realizado as devidas tratativas.
Para uma configuração para múltiplas empresas, você poderá informar:
- -1: Para buscar todos os documentos disponíveis, para todas as empresas configuradas. A partir da primeira execução, como o próximo item detalha, o NSU será automaticamente modificado para 0, uma vez que posteriormente, ele sempre irá partir do último NSU consultado. Ou seja, o -1 é considerado apenas uma em uma primeira execução, para que seja consultado o primeiro documento disponivel;
- 0: Parte do último NSU disponível. Normalmente você não irá configurar este valor, mas o próprio ERP irá informá-lo automaticamente a partir da primeira execução, demonstrando que atualmente, está sendo pesquisado a partir do último NSU.
- XXX: Um número inteiro que representa o último NSU, que o sistema deverá iniciar a busca por novos.
- id_empresa:-01;id_empresa2:-01; : Para informar um NSU diferente, conforme o identificador da empresa, informe o identificador da empresa em questão, dois pontos e o NSU de início.
Para exemplificar, suponha que está configurando as empresas com ids 1 e 5, e que ambas deseja buscar todos os documentos disponíveis. Neste caso o parametro empresa será:
1;5;
O parâmetro NSU será:
1:-1;5:-1;
Deste modo, em uma mesma configuração, será possível configurar n empresas, desde que utilize o mesmo certificado.
Uso Indevido
Quando se realiza várias consultas seguidas de NFSe destinadas, o servidor da Sefaz bloqueia gerando um erro de "Multiple requests". Esta é uma limitação da Sefaz.
Para evitar este tipo de problema, foram criados dois parâmetros:
- Numero Máximo de consultas: limita o numero máximo de consultas que serão realizados. Ao atingir esse número, o sistema interrompe e retorna no próximo ciclo de execução.
- Tempo entre consultas: define o tempo entre uma requisição e outra. Normalmente, somente este item resolve este problema, pois a Sefaz 'reclama' de varias requisições em sequência.