Impressão remota

Antes de serem iniciadas as parametrizações no Monitor e PrintServices, é pré-requisito que sejam efetuadas as devidas liberações nos Firewalls do ambiente Cloud e ambiente do Cliente.

Liberações no ambiente Cloud (responsabilidade da Senior TI)

Primeiramente é necessário solicitar a liberação no ambiente Cloud. Esta liberação se dará através do registro de um chamado no 0800Net para o produto Senior TI em nome do cliente que esta utilizando a rotina. Neste chamado, deverão ser repassadas as seguintes informações:

• IP/URL externo para acesso ao local onde o PrintService estará disponível;
• Quantidade de PrintServices que serão utilizados.

Após a liberação ter ocorrido, a Senior TI retorna no chamado as seguintes informações:

• Confirmação de que a liberação foi efetuada com sucesso (tanto para processos de entrada como de saída);
• IP/URL do ambiente Cloud onde esta disponibilizado o web service de impressão do eDocs;
• Porta Parametrização Monitor: é indicado o número de uma porta que será utilizada para parametrização do web service do eDocs no Monitor;
• Porta Parametrização PrintService: é indicado o número de uma porta que é utilizada para parametrização no PrintService (através do Configurador). É retornada a quantidade de portas de acordo com a quantidade de PrintServices que serão utilizados. Se na requisição do chamado tenha sido indicado que serão utilizados 3 PrintServices, então será efetuado o retorno de 3 portas para utilização (além da porta a ser utilizada pelo web service – parametrização no Monitor).

Liberações no ambiente do Cliente (responsabilidade da TI do cliente)

A liberação efetuada no ambiente do cliente deve ser realizada com base no IP e nas portas retornadas pela Senior TI através do chamado.

No ambiente do cliente deverão ser criadas regras no Firewall (tanto regras de entrada como de saída), garantindo que o servidor/computador onde cada PrintService será instalado tenha liberação de acesso ao IP e as mesmas portas liberadas no ambiente Cloud pela Senior TI.

A parametrização do Monitor é dividida em duas partes, pois há necessidade de serem efetuados procedimentos no PrintService primeiro, antes de serem efetuadas algumas parametrizações no Monitor. A parametrização destas configurações é de responsabilidade do cliente ou do consultor de implantação.

• Guia Geral da tela Configuração Geral:

Ativar impressão remota
Este parâmetro deve estar definido como Sim. Ele permite que o PrintService atualize automaticamente o endereço IP, permitindo realizar a impressão em localidades remotas que não possuam estrutura de IP fixo.

• Guia Integração da tela Configuração Geral:

Porta
Indica a porta na qual os web services do eDocs serão ativados no servidor onde o serviço é instanciado. Este campo deverá ser preenchido com o número da Porta Parametrização Monitor que foi retornada pela Senior TI no chamado que foi registrado.

• Item Web Service, da guia Integração da tela Configuração Geral:

Usuário e Senha
Nestes campos são definidas as credenciais (usuário e senha) que serão validadas nas requisições a serem efetuadas ao web service do eDocs. É obrigatório que cada empresa tenha um usuário diferente definido (esta validação já é efetuada pelo Monitor). Essa exigência é feita, pois é por meio do usuário definido na requisição que o serviço do eDocs define qual a empresa irá atender a requisição. Estas credenciais serão utilizadas para parametrização do PrintService.

• Item Impressão, da guia Filial da tela Configuração Geral:

Quantidade de tentativas de impressão (apenas comunicação)
Indica quantas tentativas serão realizadas de envio da impressão ao PrintService (tentativa de comunicação a partir do serviço eDocs – não aplicado a impressão manual via Monitor). Após ultrapassar a quantidade de tentativas, onde não tenha havido sucesso na comunicação, o sistema irá marcar a impressão como Falha. Caso seja informado o valor 0 (zero) neste campo, o sistema tenta recorrentemente realizar o envio e não marca como Falha. O valor padrão deste campo é 0 (zero), no entanto, quando é utilizado ambiente Cloud é extremamente indicado definir um limite de tentativas, pois em eventual problema no processo de impressão, poderá ocorrer sobrecarga no servidor do serviço do eDocs, pois o serviço tenta infinitamente enviar documentos pendentes para a impressão.

Ativar impressão em arquivo PDF
Este parâmetro deve estar definido como "N - Não". Ele só é utilizado caso seja utilizada a funcionalidade de impressão em PDF (tipo de impressão tratada em outro tópico específico). Se ele for definido como "S - Sim" e a funcionalidade de Impressão em PDF não estiver configurada, as impressões não serão realizadas.

• Item Impressão, da guia Empresas na tela Configuração de Empresa:

Agrupar vias em um único PDF
Se este parâmetro estiver configurado como "S - Sim", o eDocs agrupará todas as páginas de um mesmo documento e suas vias adicionais em um único arquivo antes de encaminhá-lo para a impressora, gerando assim um arquivo com X vias do mesmo documento, de acordo com a quantidade informada no parâmetro Quantidade vias.

O PrintService é instalado no ambiente do cliente. A instalação do mesmo é de responsabilidade do cliente ou consultor de implantação.

As parametrizações são efetuadas no Configurador (Configurador da instância que possui o componente PrintService instalado). Estas parametrizações devem ser realizadas para cada PrintService que utiliza a impressão remota. As parametrizações são efetuadas na guia Print Service do Configurador:

• Impressora Local: deve ser definida a impressora padrão do PrintService. Em um ambiente onde não serão utilizados filtros de impressão, todas as requisições de impressão recebidas por este PrintService serão enviadas para esta impressora.

• Porta: neste campo é definido o número da Porta em que o serviço do PrintService que receberá as requisições a partir do servidor do eDocs que está instalado em Cloud. A porta definida neste campo deve ser obrigatoriamente a porta definida pela Senior TI para utilização do PrintService e que foi liberada no Firewall do Cliente para entrada e saída.
• Ativar impressão remota: este parâmetro deve estar marcado para ativar a funcionalidade de impressão remota no PrintService. Quando este parâmetro está marcado, os campos disponibilizados na guia Configuração de URL estarão disponíveis para alteração, bem como será possível acionar a guia Opções da Internet e acionar o botão Atualizar;
• Guia Sincronização de endereços: nesta guia estão disponíveis as parametrizações necessárias para definir a comunicação do PrintService com o web service do eDocs (que está disponibilizado no ambiente Cloud);
• Guia Configuração de URL: nesta guia são definidos todo os parâmetros para comunicação do PrintService com o web service do eDocs;
• Guia Opções da Internet: nesta guia estão disponibilizadas parametrizações referente a utilização de Proxy, caso o ambiente onde o PrintService esteja instalado (ambiente do cliente) possua um controle de acesso à internet através de um Proxy. Por padrão, o PrintService não utiliza Proxy.
• URL impressão: este campo deve ser preenchido com o endereço do web service de impressão disponibilizado pelo eDocs no padrão: http://<IP_repassado_pela_Senior_TI>:<porta_repassada_pela_Senior_TI>/Sde/Impressao. O parâmetro < IP_repassado_pela_Senior_TI > deve ser preenchido com o nome/IP do disponibilizado pela Senior TI para configuração no Monitor. O parâmetro <porta_repassada_pela_Senior_TI> deve ser preenchido com o número da porta definida no campo Porta da tela Configuração Geral (que efetivamente é a mesma porta liberada pela Senior TI paa utilização no Monitor). Se, por exemplo, a Senior TI indicar o IP 201.10.125.47 e a porta de parametrização do Monitor como 10874, teremos a URL definida da seguinte forma: http://201.10.125.47:10874/Sde/Impressao.

• Usuário e Senha: estes campos devem ser preenchidos com as credenciais parametrizadas nos campos Usuário e Senha na tela Configuração de Empresa. As credenciais variam de acordo com a empresa cadastrada, estão é importante tomar cuidado para definir as credenciais corretas. Em uma parametrização de impressão remota, o usuário obrigatoriamente será no padrão usuário@domínio.com.
• Descrição do Print Service (auxilia na identificação durante a configuração no Monitor: neste campo é possível dar um nome amigável ao Print Service. Este nome aparece no Monitor, ao lado do nome das impressoras que estão sendo disponibilizadas por cada PrintService.
• Identificador (GUID): Globally Unique Identifier (GUID), é um identificador hexadecimal gerado para garantir que o PrintService seja reconhecido pelo serviço do eDocs e possa haver comunicação entre estes componentes. Esse identificador é único por instalação e não pode ser editado.
• Atualizar: este botão tem a funcionalidade de enviar ao serviço do eDocs o registro do PrintService para ser selecionado no Monitor. Após a ativação da rotina, é indicado o acionamento deste botão, para que o registro do PrintService seja enviado ao serviço do eDocs e esteja disponível no Monitor. Mais informações sobre o registro e exclusão de impressora poderá ser identificado no tópico Registro e exclusão de Impressoras na lista de seleção de impressoras.

• Configuração > Filial > aba Filial > aba <Documento_Eletrônico> (onde <Documento_Eletrônico> é cada tipo de documento gerenciado pelo DE – NF-e, NFS-e, CT-e, MDF-e, NFC-e, CF-e).

Para exemplificar a parametrização, é utilizado como exemplo a parametrização para NF-e (guia NF-e).

DANFE automático: define se será impresso o DANFE da NF-e automaticamente após a NF-e ter sido autorizada (em ambiente normal ou em contingência). Caso o parâmetro seja definido como Não, as impressões devem ser solicitadas através do Monitor (botão Imprimir);

URL serviço de impressão
Neste campo deve ser selecionado um PrintService que foi previamente registrado no eDocs, através do botão Atualizar do Configurador. Este PrintService é o utilizado por padrão pela filial para envio de impressão do documento que está sendo parametrizado. Caso nenhum registro seja encontrado para seleção, verifique os tópicos Verificando o acesso ao web service de impressão e Registro e exclusão de impressoras na lista de seleção de impressoras, para identificar qual o problema no registro do PrintService e suas respectivas impressoras.

Template

Para definir qual será o template utilizado na geração dos documentos auxiliares (tanto na geração do PDF para ser efetuado o download pelo Monitor, quanto na geração do PDF que será enviado ao PrintService ou enviado por e-mail), basta acessar Configurações > Filiais > selecionar a aba Documento Eletrônico desejado (NF-e, NFS-e, CT-e, MDF-e, NFC-e, CF-e ou GNRE) > Impressão > Campo Templates > Configurar.

Se a Senior TI indicar o IP 201.10.125.47 e a porta de parametrização do Monitor como 10874 durante o processo de liberação, teremos a URL a ser utilizada no Navegador Web definida da seguinte forma: http://201.10.125.47:10874/Sde/Impressao?WSDL.

Quando houve a comunicação do Monitor ou do Serviço do eDocs com o PrintService e tenha sido enviada a requisição de impressão ao PrintService corretamente, o registro é marcado como Documento eletrônico enviado para impressão () (ou o equivalente para impressão em contingência ). Na imagem abaixo é possível verificar este indicativo em destaque na coluna D.

Se a comunicação com o PrintService não tenha sido realizada com sucesso, o registro ficará como Pendente de impressão (), caso o campo Quantidade de tentativas de impressão (apenas comunicação) esteja definido como 0 (zero), ou como Falha de impressão (), caso o parâmetro Quantidade de tentativas de impressão (apenas comunicação) esteja definido com um valor maior que 0 (zero), e todas as tentativas de comunicação já tenham sido esgotadas.

Eventuais erros de comunicação entre o serviço do eDocs e o PrintService para processo de reimpressão ou impressão automática, estarão registrados no log “Sde.log”, indicando problemas de impressão do documento.

O botão Imprimir, presente no Monitor, faz com que o Monitor envie uma requisição de impressão diretamente para o PrintService. Para confirmar a comunicação com o PrintService, pode ser solicitada a impressão através do botão Imprimir.

Caso ocorra um erro de comunicação do Monitor com o PrintService, é gerada uma mensagem ao usuário indicando que não foi possível enviar o documento para impressão (Exemplo: Não foi possível imprimir a NFe número 302205 (sequência 1749). Verifique o arquivo de log para maiores informações.). Neste caso, o motivo de não ter havido a comunicação será registrado no log.

Se a comunicação com o PrintService não ocorra com sucesso:

• Verifique se o PrintService está iniciado no ambiente do Cliente

Para verificar se o serviço do PrintService está iniciado, pode ser utilizado o Configurador ou o Console de Serviços do Windows (services.msc). No console, o nome do serviço é Senior Documentos Eletrônicos PrintService - <Instância_Instalação> (onde <Instância_Instalação> é o nome dado a instalação no momento que o sistema foi instalado).

No Log do PrintService também é possível identificar se ele foi iniciado com sucesso. Se a inicialização ocorreu com sucesso, será possível encontrar este trecho no log (data e hora irão variar de acordo com a data e hora de inicialização do serviço):

2016-06-15 13:41:17,332 [5] WARN Senior.SapiensNfe.Processos.Sistema.Aplicacao - Aplicação inicializada
2016-06-15 13:41:17,999 [5] WARN Senior.SapiensNfe.Processos.Service.Impressao.ImpressaoControlador - Serviço escutando no endereço: net.tcp://PCCliente:10587/Impressao.
2016-06-15 13:41:18,089 [5] WARN Senior.SapiensNfe.PrintServer.MainService - Serviço iniciado

Onde:
PCCliente: é o nome do computador onde o PrintService está instalado no ambiente do cliente;
10587: é a porta parametrizada no Configurador (porta que o PrintService utilizará para receber requisições oriundas do ambiente Cloud).

• Verifique se o PrintService está respondendo a partir do ambiente Cloud

Podem ser utilizadas as informações presentes no tópico Garantindo comunicação do ambiente Cloud com o PrintService disponível neste documento para avaliar se, a partir do ambiente Cloud, está sendo possível efetuar a comunicação com o PrintService que está instalado no ambiente do Cliente.

• Verifique se a parametrização do PrintService está correta no Monitor para a Filial que está solicitando impressão

Em casos onde o serviço PrintService estiver respondendo corretamente (inclusive no teste via telnet), mas ao ser solicitada a impressão pelo Monitor seja gerada mensagem de erro de comunicação, é necessário identificar as parametrizações presentes no Monitor para comunicação da Filial com o PrintService. No caso da impressão remota, pode ter havido a alteração do endereço de comunicação com o PrintService instalado no Cliente, desta forma, se faz necessária a atualização do registro do PrintService no eDocs (veja o tópico Registro do PrintService para mais informações sobre este processo).

Conforme informado no tópico Avaliar se a comunicação com o PrintService ocorreu com sucesso, quando houve a comunicação do Monitor com o PrintService e tenha sido enviada a requisição de impressão ao PrintService corretamente, o registro é marcado como Documento eletrônico enviado para impressão ().

A partir deste momento a responsabilidade de enviar a impressão para a impressora é do serviço do PrintService.

Eventuais erros de envio da impressão a partir do PrintService para a Impressora serão registrados no Log PrintService.log. Quando o nível de log definido no PrintService for WARN, só serão registradas mensagens da inicialização do serviço do PrintService ou mensagens de erro da execução da rotina de impressão.

Muitos erros ocorrem porque, no momento em que o PrintService se comunica com a impressora, ela não esta disponível. Neste caso, no Log PrintService.log é possível encontrar uma mensagem de erro indicando este problema.

Para um maior detalhamento dos processos executados pelo PrintService, é necessário alterar o nível de log do mesmo para DEBUG (alteração efetuada através do Configurador). A partir desta alteração, é possível identificar detalhes nos processos executados pelo componente PrintService.

Tendo em vista o processo de impressão como um todo, para comprovar de que o PrintService está enviando corretamente a requisição de impressão para a impressora, poderão ser adotados os procedimentos:

• Defina o nível do log do PrintService como Debug.

Antes de definir o log como DEBUG, convém efetuar a limpeza dos logs, para garantir que os logs a serem avaliados são atuais. Para isso, o serviço do PrintService deve estar parado. Lembrando que a alteração do log é efetuada pelo Configurador e só terá efeito após a reinicialização do serviço do PrintService.

• Coloque a impressora que irá receber a impressão em Pausa (no ambiente do Cliente);

Este processo é executado através do console de administração de impressoras do Windows do computador/servidor onde o PrintService está instalado. Para isso, acesse o menu Impressora do console e selecione a opção Pausar Impressora.

• Solicite a impressão de um documento pelo Monitor do sistema no ambiente Cloud

Neste caso, tem-se como pré-requisito que a comunicação do Monitor com o PrintService está ocorrendo corretamente. Caso contrário, é necessário avaliar as informações presentes no tópico Avaliar se a comunicação com o PrintService ocorreu com sucesso presente neste arquivo.

A solicitação de impressão ocorrerá através do acionamento do botão Imprimir das telas do Monitor. Para exemplificar o processo, utilizaremos a solicitação de impressão de um DANFE de NF-e através da tela Emissão de NF-e.

Ao solicitar a impressão, o Monitor retornará a mensagem Documento eletrônico enviado para impressão.

Para exemplificar o processo, teremos como exemplo a solicitação de impressão do DANFE da NF-e número “302167” (chave: 42151280680093000181553290003021671227036836).

• Verifique os registros no Log PrintService.log no ambiente do Cliente

No Log PrintService.log é possível encontrar as seguintes informações, conforme imagem abaixo

No trecho destacado em vermelho, é possível identificar a inicialização do processo de impressão pelo PrintService, no entanto, neste momento (às 16:55:46), o PrintService ainda não possuía nenhum arquivo pendente em sua fila para encaminhar a impressão para impressora.

No trecho destacado em verde, é possível identificar uma nova a inicialização do processo de impressão pelo PrintService (o processo é executado a cada 30 segundos, por padrão), no entanto, neste momento o PrintService já possui a solicitação de impressão do DANFE da NF-e 302167 em sua fila. Com isso, é possível identificar que a impressão foi enviada para a impressora Brother DPC-116C.

• Consulte o console da Impressora para verificar as impressões pendentes.

Ao verificar o console da Impressora (O que está sendo impresso), é possível identificar que a solicitação de impressão chegou à impressora (pelo menos no Spooler de impressão do Windows). Conforme imagem abaixo:

Quando temos o registro da solicitação de impressão no console da impressora, temos a garantia de que todo o processo executado pelo eDocs está correto, sendo de inteira responsabilidade do sistema operacional Windows e da infraestrutura do cliente garantir que o documento seja efetivamente impresso na impressora. Caso não seja identificada a solicitação de impressão no console da impressora, é necessário avaliar em qual ponto da comunicação Monitor/Serviço de eDocs > PrintService > Impressora está ocorrendo o problema, com base nos procedimentos indicados anteriormente neste documento.