MANUAL OPERACIONAL

PRINTER

MASTERSAF DFE - PRINTER

MANUAL OPERACIONAL

SUMRIO
Introduo ............................................................................................................................................................... 1
Printerconsole......................................................................................................................................................................................... 1
Printerservice .......................................................................................................................................................................................... 1

Fluxo da aplicao ao realizar uma impresso ........................................................................................................ 1

Instalao................................................................................................................................................................2
Parametrizao .......................................................................................................................................................4
Printerservice ......................................................................................................................................................................................... 4
Printerconsole........................................................................................................................................................................................ 5
Vrios valores para o mesmo filtro .................................................................................................................................................. 6
Quantidade de cpias por configurao de bandeja....................................................................................................................... 7
Filtros para printerconsole............................................................................................................................................................... 7
CNPJ............................................................................................................................................................................................ 7
CPF.............................................................................................................................................................................................. 7
Placa do veculo.......................................................................................................................................................................... 7
CFOP ........................................................................................................................................................................................... 8
Ordem de embarque .................................................................................................................................................................. 8
Srie ............................................................................................................................................................................................ 8
Usurio........................................................................................................................................................................................ 8
Intervalo de numerao.............................................................................................................................................................. 8
Contingncia............................................................................................................................................................................... 8
NF de Recebimento .................................................................................................................................................................... 8
NF-e Interestadual..................................................................................................................................................................... 8
Duas ou mais regras para a mesma impressora/bandeja .............................................................................................................. 9
Prioridades ....................................................................................................................................................................................... 9
Logotipo ..........................................................................................................................................................................................10
Utilizao de Documentos Customizados ...........................................................................................................................................10

Publicado em 30/09/2013

MANUAL OPERACIONAL

MASTERSAF DFE - PRINTER

INTRODUO
Este documento tem o objetivo de apresentar as funcionalidades do Printer DF-e V3, bem como a parametrizao e sua configurao.
O mdulo Printer DF-e V3 separado em duas partes principais: printerservice e printerconsole.

PRINTERCONSOLE
O printerconsole uma aplicao web para a configurao do printerservice, tem como principais objetivos:

Manter impressoras alvo e suas bandejas.

Estabelecer filtros para rotear requisies de impresso para determinadas impressoras ou bandejas.

Realizar upload de logotipos.

Pausar ou continuar o servio de impresso.

O servio do printerconsole serve somente para visualizar e efetuar a parametrizao do mdulo, sendo necessrio estar no ar somente
para quando estas aes forem executadas. Para que o printerconsole funcione corretamente, o printerservice deve estar iniciado.

PRINTERSERVICE
Printerservice uma aplicao para impresso de documentos fiscais, que recebe e processa as requisies de impresso enviadas
pelo integrador e as encaminha para a impressora de destino previamente configurada no printerconsole.

FLUXO DA APLICAO AO REALIZAR UMA IMPRESSO

Publicado em 30/09/2013

MANUAL OPERACIONAL

MASTERSAF DFE - PRINTER

INSTALAO
Para instalar o Printer DF-e V3, abra o arquivo executvel iniciar-instalador.bat, localizado na pasta \instalador localizada no diretrio do sistema Mastersaf DFE. necessrio instalar os mdulos printerservice e printerconsole.

Publicado em 30/09/2013

MANUAL OPERACIONAL

MASTERSAF DFE - PRINTER

Obs.: Neste exemplo o Printer DF-e V3 foi instalado em uma pasta fora da aplicao normal do Mastersaf DFE, sendo instalado
somente o Printer DF-e V3. Quando instalada a aplicao pela primeira vez, normalmente j marcado para realizar a instalao do
mesmo junto com os outros mdulos.
Para o correto funcionamento do mdulo, devem ser criadas duas variveis de ambiente:

PRINTER_SERVICE_URL
Com valor padro http://localhost:9090/printerservice, esta varivel utilizada pelo printerconsole na comunicao
com o printerservice e deve conter o valor da URL correspondente ao mesmo.

PRINTER_DIR
Esta varivel deve conter o diretrio onde o printerservice ira salvar a configurao das impressoras, buscar os arquivos
de configurao, gerar os arquivos de log, bem como gerar arquivos XML e PDF das notas impressas caso seja configurado para gerar os mesmos.

necessrio tambm a configurao do integrador, alterando no arquivo integrador/integrador.properties o parmetro

url_printer (valor padro url_printer=http://127.0.0.1:9090/printerservice) apontando para a porta correspondente em que o printerservice foi configurado para rodar.
Aps a instalao, o printerservice deve ser executado para que crie no diretrio parametrizado na varivel de ambiente PRINTER_DIR
a estrutura e arquivos necessrios para seu funcionamento. Realizar tambm a parametrizao do modulo exposta neste manual no
item Parametrizao.
O mdulo Printer DF-e V3 pode ser executado de duas maneiras: via executvel (arquivo iniciar-printerservice.bat e iniciar-printerconsole.bat em ambientes Windows e pelos arquivos iniciar-printerservice.sh e iniciar-printerconsole.sh em ambiente Linux), que
so gerados pelo prprio instalador do produto. O mdulo em questo tambm pode ser executado via servio do Windows, um detalhamento maior sobre a instalao dos mdulos do DFE V3 como servio do Windows pode ser encontrado no manual Mastersaf DFE
Servio do Windows disponvel no Contact Center.

Publicado em 30/09/2013

MANUAL OPERACIONAL

MASTERSAF DFE - PRINTER

PARAMETRIZAO
PRINTERSERVICE
As configuraes referentes ao printerservice so realizadas no arquivo config.properties que, aps a instalao, se encontra em
\config\config.properties).
Os seguintes atributos constam neste arquivo de configurao:

HTTP.port: porta onde o servio ficar disponvel.

ignorarImpressao: se true, apenas roteia as requisies para impressoras mas no imprime os documentos. (til quando
s se quer gerar PDF ou XML)

exportarPdf: se true, exporta PDF da impresso no diretrio \data\pdfs.

exportarXml: se true, exporta o XML do documento fiscal no diretrio \data\xmls.

tentativasImpressaoEmCasoDeErro: numero de tentativas de impresso de uma requisio em caso de erro.

intervaloEmSegundosEntreTentativas: intervalo em segundos entre cada tentativa de impresso com erro.

maxRequestsPerMinute: nmero mximo de pginas por minuto (calibrar de acordo com a capacidade das impressoras
alvo). Se <=0, vai enviar p/ impressora assim que finalizar a ltima impresso.

resequenceTimeoutMilliseconds: tempo mximo a esperar por requisies at que a fila de requisies esteja em ordem
e completa

diretorioDacteCustomizado: diretrio onde se encontram os documentos customizados referentes ao DACTE para impresso.

diretorioDanfeCustomizado: diretrio onde se encontram os documentos customizados referentes ao DANFE para impresso.

impressaoParalela: se true, permite que documentos possam ser impressos simultaneamente.

empresa: Gerao PDF/XML em uma estrutura de pastas diferentes da padro, separadas por empresa.

diretorioGravacaoPDF/diretorioGravacaoXML: diretrios onde sero gravados os arquivos PDF/XML separados em pastas

por empresa.

Os parmetros devem ser preenchidos conforme comentrios contidos no prprio arquivo de configurao config.properties.
Configuraes referentes aos arquivos de log do printerservice so realizadas no arquivo \config\logback.xml.
Para alterar o nvel de log deve ser alterada a linha <root level="info"> com o nvel de log desejado.

Descrio dos nveis de log:

FATAL: utiliza-se para mensagens crticos do sistema, geralmente aps guardar a mensagem o programa abortar.
ERROR: utiliza-se em mensagens de erro da aplicao que se deseja guardar, estes eventos afetam ao programa, mas o
deixam seguir funcionando, como por exemplo, que algum parmetro de configurao no correto e se carrega o parmetro por defeito.
WARN: utiliza-se para mensagens de alerta sobre eventos que se deseja manter Constancia, mas que no afetam ao correto funcionamento do programa.
INFO: utiliza-se para mensagens similares ao modo "verbose" em outras aplicaes.
DEBUG: utiliza-se para escrever mensagens de depurao. Este nvel no deve estar ativado quando a aplicao se
encontre em produo.
TRACE: utiliza-se para mostrar mensagens com um maior nvel de detalhe que debug.
Observao: O valor nvel de log padro da instalao info.
O arquivo printers.xml armazena a configurao das impressoras, bandejas e filtros enviados pelo printerconsole e salvos neste
arquivo pelo printerservice.

Publicado em 30/09/2013

MANUAL OPERACIONAL

MASTERSAF DFE - PRINTER

PRINTERCONSOLE
A parte de interface do printerconsole destinada para realizar parametrizaes pode ser acessada pelo navegador no endereo:
http://localhost:3000/printerconsole/. Para que seja possvel acessar a mesma a aplicao printerservice deve estar rodando.

Para adicionar uma nova impressora clique em Inclui.

Logo aps uma tela exibida para escolher a impressora.

Selecione a impressora desejada e clique em Ok.

Obs.: Somente as impressoras disponveis na mquina onde o mdulo Printer DF-e V3 esta sendo executado so listadas.
Publicado em 30/09/2013

MANUAL OPERACIONAL

MASTERSAF DFE - PRINTER

Com a impressora adicionada deve-se incluir uma bandeja para a mesma, e se necessrio adicionar filtros para a impressora.

Obs.: Para adicionar um filtro especfico, clique na caixa de seleo e informe um valor.

VRIOS VALORES PARA O MESMO FILTRO

Para informar mais de uma combinao em um determinado filtro o usurio deve separar os valores com vrgula.
Exemplo:
Srie

10, 20, 30

Usurio

Usurio1, Usurio2

Contingncia

2,5

Desta forma o usurio pode criar regras com mais combinaes, como no exemplo.
Publicado em 30/09/2013

MANUAL OPERACIONAL

MASTERSAF DFE - PRINTER

QUANTIDADE DE CPIAS POR CONFIGURAO DE BANDEJA
Foi adicionado um parmetro para gerenciar a quantidade de cpias impressa das impresses.

Importante: Quando o cliente optar por utilizar o Printer NF-e o controle de quantidade de cpias ser feito pelo parmetro
Nmero de cpias no Printer NF-e, ou seja, o parmetro numero de cpias de DANFE no Portal Mastersaf NF-e ser ignorado.
As notas em contingncias DPEC, FS e FS-DA so impressas em no mnimo duas vias, conforme manual do contribuinte.

FILTROS PARA PRINTERCONSOLE

Todos os filtros podem ser utilizados de forma independente ou em conjunto, desta forma o emissor poder criar uma regra simples
(com um item do critrio, exemplo - CNPJ), ou at mesmo outras que exija maior complexidade (com alguns critrios, exemplo Serie +
Usurio + Contingncia DPEC 4).
Obs.: Caso na requisio de impresso seja enviado, o nome de uma impressora em especifico, os filtros de impresso
so ignorados.

CNPJ
Para utilizar o CNPJ do emitente como regra para impresso do DANFE, informe na regra o CNPJ sem mscara e com 14 dgitos.
Exemplo: 99999999999999.

CPF
Para utilizar o CPF do emitente como regra para impresso do DANFE, informe na regra o CPF sem mscara e com 11 dgitos.
Exemplo: 99999999999.

Placa do veculo
Para utilizar placa do veculo trator ou rebocador, informe placa sem mscara e com formato AAA1234.
Publicado em 30/09/2013

MANUAL OPERACIONAL

MASTERSAF DFE - PRINTER

CFOP

Para utilizar CPOF como regra de impresso, informe o CFOP do primeiro item da NF-e sem mscara e com formato numrico com
tamanho 4, exemplo 1234.

Ordem de embarque
Para utilizar ordem de embarque como regra de impresso, informe se disponvel do layout de envio, este campo do tipo caractere e
sua dimenso mxima de 50 posies.

Srie
Para utilizar Srie como regra de impresso, informe a Srie do documento fiscal sem mscara e com formato numrico com tamanho 3.
Exemplo: 001.

Usurio
No critrio de impresso usurio, informe exatamente o usuarioemitente informado no arquivo TXT de integrao.

Intervalo de numerao
O intervalo de numerao deve ser separados por vrgulas.
Exemplo: 0001,1000. Isso significa que todas as NF-e que estiverem no intervalo de 0001 1000 sero impressas por esta regra.

Contingncia
Caso utilize bandeja especfica para contingncia, altere deve alterao o parmetro bandeja para correta, e parmetro Contingncia para tipo de emisso, que deve utilizar na regra em questo. Veja abaixo lista de tipo de emisso vlidos para contingncia:

2 Contingncia FS;

3 Contingncia SCAN;

4 Contingncia DPEC;

5 Contingncia FS-DA;

0 Todas Contingncias (caso o utilize a mesma regra de impresso para todas as contingncias)

O parmetro para contingncia deve ser adicionado e inserir o valor numrico no campo correspondente.

NF de Recebimento
Para somente imprimir notas de recebimento, informe S como valor do filtro.

NF-e Interestadual
Para somente imprimir notas Interestaduais, informe S como valor do filtro.

Publicado em 30/09/2013

MANUAL OPERACIONAL

MASTERSAF DFE - PRINTER

DUAS OU MAIS REGRAS PARA A MESMA IMPRESSORA/BANDEJA

O Printer permite que uma impressora/bandeja seja alvo de vrias combinaes de filtros, desta forma o cliente pode adicionar varias
regras de impresso para a mesma bandeja.

PRIORIDADES
Este tabela um critrio de desempate entre as bandejas, para alterar a ordem utilize os botes com setas. til para quando duas
bandejas tem um filtro similar, neste caso levado em considerao para desempate qual das bandejas tem o melhor filtro em uma
escala de pontuao considerando os campos na ordem em que se encontram configurados.

Obs.: O parmetro com maior prioridade o primeiro da lista.

Publicado em 30/09/2013

MANUAL OPERACIONAL

MASTERSAF DFE - PRINTER

LOGOTIPO

Nesta tela o usurio seleciona e carrega as imagens que contem os logotipos das empresas para impresso nos documentos fiscais.
Importante: O formato do nome do arquivo/imagem deve conter o CNPJ.PNG.
Exemplo: 00910509000171.jpg

UTILIZAO DE DOCUMENTOS CUSTOMIZADOS

Para utilizao de arquivos customizados para gerao dos documentos fiscais, deve-se alterar o arquivo printerservice\config\config.properties, indicando o diretrio onde os arquivos compilados (.jasper) se encontram seguindo o padro que consta nas instrues
do prprio arquivo de configurao.
Obs.: A nomenclatura dos arquivos compilados disponibilizados no deve ser alterada, pois a aplicao busca exatamente os mesmos nomes de arquivo ao executar uma impresso ou gerar um pdf.

Publicado em 30/09/2013

10