Selecionar impressora

As parametrizações no Monitor são efetuadas em diversos pontos:

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

Porta
Indica a porta na qual os web services do eDocs são ativados no servidor onde o serviço é instanciado. A porta definida neste campo será utilizada para o restante da parametrização. A porta padrão é 8989.

• Guia Integração da tela Configuração de Empresa:

Usuário e Senha
Localizados na seção Web Service da tela, 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 é através do usuário definido na requisição que o serviço do eDocs define qual a empresa irá atender a requisição.

• Guia Filial da tela Configuração de Filial:

Ativar seleção de impressora
Localizado na seção Impressão da tela, este parâmetro deve estar definido como Sim. A partir deste momento, a filial permite a seleção de impressora.

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

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.

As parametrizações são efetuadas no Configurador do eDocs (Configurador da instância que possui o componente PrintService instalado). Estas parametrizações devem ser realizadas para cada PrintService que disponibiliza a funcionalidade de seleção de impressora, ou seja, cada PrintService que envia a lista de impressoras que pode ser selecionada no momento do acionamento do botão Imprimir do Monitor. As parametrizações são efetuadas na guia Print Service do Configurador:

• Campo Porta: nele é definido o número da Porta em que o serviço do PrintService receberá as requisições no computador/servidor onde ele está instalado. A Porta deve estar liberada para comunicação externa por eventual Firewall ou Antivirus, e nenhum outro aplicativo poderá utilizar esta porta. A porta padrão é 1024;
• Campo Ativar seleção de impressora: este parâmetro deve estar marcado para ativar a funcionalidade no PrintService. Quando este parâmetro está marcado, os campos disponibilizados dentro da guia Configuração de URL são habilitados para alteração, bem como a guia Opções da Internet e acionar o botão Atualizar;
• Botão Atualizar: este botão tem a funcionalidade de enviar ao serviço do eDocs a lista de impressoras disponíveis no PrintService para serem selecionadas no Monitor. Após a ativação da rotina, é indicado o acionamento deste botão, para que a listagem das impressoras seja enviada ao serviço do eDocs e esteja disponível no Monitor. Mais informações sobre o registro e exclusão de impressoras pode ser identificado no tópico Registro e exclusão de Impressoras na lista de seleção de impressoras.
• 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;
• 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 possua um controle de acesso à internet através de um Proxy. Por padrão, o PrintService não utiliza Proxy.
• Campo 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://<servidor>:<porta>/Sde/Impressao. O parâmetro <servidor> deve ser preenchido com o nome/IP do servidor onde o eDocs está instalado. O parâmetro <porta> deve ser preenchido com o número da porta definida no campo Porta da tela Configuração Geral. Levando em consideração uma instalação do serviço do eDocs efetuada no computador PCBNU00006, utilizando a parametrização da porta 8989, teremos a URL definida da seguinte forma: http://PCBNU00006:8989/Sde/Impressao.

• Campos Usuário e Senha: estes campos devem ser preenchidos com as credenciais parametrizadas nos campos Usuário e Senha da tela Configuração de Empresa. As credenciais variam de acordo com a empresa cadastrada, estão é importante tomar cuidado para definir as credenciais corretas.
• Campo 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.
• Campo 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.

Se o serviço do eDocs está instalado no computador PCBNU00006 e foi parametrizada a porta 8989 para o web service, então o endereço de acesso a ser definido no navegador será: http://pcbnu00006:8989/Sde/Impressao?WSDL.

Em um processo de impressão através da seleção da impressora, não há comunicação do serviço do eDocs com o PrintService, pois o acionamento do botão Imprimir faz com que o Monitor encaminhe a requisição diretamente ao PrintService.

Quando houve a comunicação do 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.

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, lembrando de selecionar uma Impressora através da tela de seleção de impressora, pois é esta a funcionalidade em foco.

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 escolhido na tela de seleção de impressora está iniciado.

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://servidor:1024/Impressao.
2016-06-15 13:41:18,089 [5] WARN Senior.SapiensNfe.PrintServer.MainService - Serviço iniciado

Onde:
servidor: é o nome do servidor onde o PrintService está instalado;
1024: é a porta parametrizada no Configurador (porta que o PrintService utilizará para receber requisições).

• Verifique se o PrintService está respondendo.

Um teste simples que pode ser efetuado para garantir que o PrintService esteja respondendo as requisições, é executar uma conexão telnet ao PrintService.

Se tivermos como exemplo um PrintService sendo executado na porta 1024 de um servidor que tenha o nome de PCBNU00006, nosso comando telnet será: telnet PCBNU00006 1024. O comando pode ser executado a partir do Prompt de Comando do Windows (cmd.exe).

Abaixo segue imagem de exemplo do resultado do teste quando há um problema de comunicação com o PrintService:

Abaixo segue imagem de exemplo do resultado do teste quando a conexão com o PrintService foi realizada com sucesso:

É possível notar que, quando a comunicação é estabelecida com sucesso, o retorno do teste em telnet será a tela sem nenhuma mensagem, apenas com um cursor piscando no canto superior esquerdo.

O teste via telnet também pode ser utilizado para garantir a comunicação com o PrintService que esteja sendo executado em um computador/servidor diferente do computador/servidor onde o Monitor ou o Serviço do eDocs estão instalados. Neste caso, a partir do comutador/servidor onde o serviço do eDocs esteja instalado (Exemplo: SERVIDORSENIOR) é executada uma conexão telnet apontando para o computador/servidor onde o PrintService está instalado (Exemplo: SERVIDORIMPRESSAO). A porta do PrintService é a 1024. O comando telnet será executado a partir do servidor SERVIDORSENIOR com a seguinte sintaxe telnet SERVIDORIMPRESSAO 1024.

• Verifique se a parametrização do PrintService está correta para utilização da rotina de seleção de impressora.

Em casos em que 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, verifique:

• Se há necessidade de atualizar o registro do PrintService através do botão Atualizar do Configurador (mais informações, verifique o tópico Registro e exclusão de Impressoras na lista de seleção de impressoras) (qualquer alteração em parametrização ou ambiente – exemplo: IP do computador onde o PrintService está instalado – exige a atualização do registro do PrintService);
• Avaliar se a atualização do registro das impressoras é efetuada com sucesso (mais informações, verificar o tópico Registro e exclusão de Impressoras na lista de seleção de impressoras)
• Se há algum bloqueio de comunicação entre o computador onde o Monitor está instalado e o computador onde o PrintService selecionado para a impressão está selecionado.

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

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, utilizando a funcionalidade de seleção de impressora.

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

A solicitação de impressão ocorre 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 guia Notas Fiscais da tela de emissão de NF-e.

Ao solicitar a impressão, o Monitor retorna 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

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