Ver código fonte para 1673 Tarefas Servidor/Download Distribuicao XML CTe

[[1673_Tarefas_Servidor]]

Esta tarefa realiza a consulta e o download dos XML's dos CTE's destinados a empresa, conforme o papel da empresa nestes CTe's. Esta tarefa está listada em [[1673_Tarefas_Servidor]] como Download e Distribuição XML CTe's".

Consulte a nota técnica da Sefaz para entendimento e também para limitações de uso. 

'''Atenção!''' Na configuração de execução desta tarefa, nunca informe tempos inferiores a 60 minutos, para que não seja bloqueado pela Sefaz. 

'''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]]. Você deve realizar uma configuração para cada empresa que irá utilizar esta tarefa para a realização de download de XML's, pois cada empresa pode possuir detalhes e certificados digitais diferentes.

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.
* Considerar Empresa Destinatário: Informe o valor 1, se deseja considerar os CTe's que empresa seja destinatario. 
* Considerar Empresa Remetente: Informe o valor 1, se deseja considerar os CTe's que empresa seja recebedor. 
* Considerar Empresa Expedidor: Informe o valor 1, se deseja considerar os CTe's que empresa seja expedidor. 
* Considerar Empresa Recebedor: Informe o valor 1, se deseja considerar os CTe's que empresa seja recebedor. 
* Considerar Empresa Tomador: Informe o valor 1, se deseja considerar os CTe's que empresa seja tomador. 

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/CTe. Logo quando o sistema realiza o download, este download é realizado por pacotes, 50 XML's por vez, onde o sistema armazena e envia a Sefaz sempre em uma próxima execução, 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.

== Problemas e Soluções e Limitações ==
=== Limitações de Uso ===
* A Sefaz somente permite o download de CTE's dos últimos 3 meses;
* Somente é permitido a consulta de novos CTE's, com o invervalo mínimo de 1 hora;
* Os XML's são enviados pela Sefaz estadual para a Sefaz Federal, ambiente nacional. Logo este envio pode demorar, principalmente se a Sefaz do Estado do Emissor do XML enfrentar problemas. Caso não encontre o CTe, aguarde algumas horas ou até se possível alguns dias para que Sefaz estadual sincronize os documentos e o Touch Comp ERP consiga realizar o download dos mesmos.