Nfe UniDANFe3

UNIMAKE SOFTWARES 999) perSub(Exporta:Linha, Rot:Pos,
UniDANFe verso 3.x

Manual de Utilizao do Software UniDANFe verso 3.x e de Integrao com Sistemas de ERP
2010
UniDANFe verso 3.x Tpicos deste documento
2010
Sobre o UniDANFe Utilizando o UniDANFe Carregando o UniDANFe sem passar parmetros Acessando a interface de configuraes do UniDANFe Acessando o Gerenciador de Licenas do UniDANFe Consultando a verso/release do UniDANFe Consultando e-mails a enviar/enviados/com erros Forando o envio de e-mails presos na caixa A enviar Carregando a tela de configurao de contas de e-mail (remetentes) Consultando uploads pendentes Gerando o DANFE atravs de parmetros da linha de comando Compatibilidade com verses anteriores Forando uma edio especfica (free ou plus) do UniDANFe Passando arquivos externos para serem anexados ao e-mail enviado ao destinatrio da NF-e Abreviando a linha de comando ao carregar o UniDANFe Exemplo de chamada ao UniDANFe pela linha de comando Executando o UniDANFe a partir de uma aplicao ERP XML Auxiliar Estrutura do XML Auxiliar Campos no previstos no XML Principal Configurando o UniDANFe Editando as Configuraes do UniDANFe Configurao Geral Impresso Margens Dados do Emitente Dados do Destinatrio Faturas/Duplicatas Transportador/Volumes Produtos/Servios ISSQN Dados Adicionais Canhoto Colunas dos Produtos Configurao Coluna Livre E-Mail Envio de E-mail Personalizao Opes de PDF Opes de FTP Opes de XML
Unimake Softwares Solues Corporativas
Pgina 2
UniDANFe verso 3.x

Ramos Especficos Medicamentos Veculos Novos Combustveis Armas de Fogo Sistema Informaes de Rodap Transferncias - Exportando e/ou Importando as Configuraes do UniDANFe Configurando as contas de remetentes e a manuteno de e-mails Remetentes Editando contas de remetentes Manuteno Configurando o envio de XML de cancelamento Configuraes de Segurana Configurando o DANFEmon Monitor do UniDANFe Imprimindo uma rgua para configurao mtrica dos campos Gerenciando licenas do UniDANFe Plus Base de dados e guarda das licenas Gerenciamento de e-mails Layout do arquivo XML Principal Perguntas freqentes Controle de atualizaes do software
2010
Pgina 3
UniDANFe verso 3.x Sobre o UniDANFe
2010
O UniDANFe foi desenvolvido pela Unimake Softwares para facilitar a impresso do documento auxiliar da Nota Fiscal Eletrnica, bem como seu envio por e-mail para o destinatrio das mercadorias. Diferentemente do UniNFe, o UniDANFe no um projeto open source. Ele apresentado aos programadores/usurios de sistemas ERP, emitentes de Nota Fiscal Eletrnica, em duas edies: UniDANFe Free de distribuio e utilizao gratuita, possui todas as funcionalidades j existentes na verso 1.0, trazendo mais algumas, contempladas nesse documento. UniDANFe Plus possui todas as funcionalidades do UniDANFe Free, acrescidas de outras funcionalidades. Essa edio no de distribuio e/ou utilizao gratuita como a edio Free. Para sua utilizao em ambiente de produo, cada emitente de Nota Fiscal Eletrnica dever adquirir uma licena de uso especfica para seu CNPJ, que vale por um ano, devendo ser renovada aps esse perodo para continuidade de utilizao da edio Plus. Em caso de emitentes com mais de um CNPJ, cada CNPJ dever adquirir sua licena correspondente. As funcionalidades extras dessa verso estaro destacadas nesse documento com o smbolo (Plus). O arquivo executvel do UniDANFe para as duas edies o mesmo unidanfe.exe. Sempre que for utilizado para emitir um DANFE, o UniDANFe procurar na pasta LIC pela licena correspondente ao CNPJ do emitente da NF-e. Se encontrar tal licena, se comportar como UniDANFe Plus. Caso contrrio, como UniDANFe Free. Essa implementao visa facilitar o trabalho de integrao dos sistemas ERP ao UniDANFe, conquanto os programadores no precisem se preocupar se o cliente/usurio de seu sistema ir adquirir ou no a licena Plus. No entanto, caso seja preciso forar a execuo do UniDANFe em uma edio especfica, basta adicionar o parmetro Edicao=<edio> linha de comando.
Exemplo: unidanfe.exe arquivo=12394234732743874.xml edio=Free
Pgina 4
UniDANFe verso 3.x Utilizando o UniDANFe
2010
O UniDANFe apresentado em forma de um arquivo executvel (unidanfe.exe) que deve ser executado diretamente pelo ERP do Usurio, passando alguns parmetros atravs da linha de comando. Existem vrias maneiras de carregar o UniDANFe, passando ou no parmetros na linha de comando. Em cada uma delas o comportamento do sistema diferente. As nomenclaturas da linha de comando so:
a) b) c) d) e) f) g) h) unidanfe.exe unidanfe.exe unidanfe.exe unidanfe.exe unidanfe.exe unidanfe.exe unidanfe.exe unidanfe.exe configurar=1 licenciar=1 versao=1 emails=1 envia_email=1 upload=1 Arquivo=<caminho e nome do XML principal> [lista de parmetros ..]
a) Carregando o UniDANFe sem passar parmetros

Ao carregar o UniDANFe sem passar parmetros na linha de comando, o painel de controle exibido. Atravs do painel de controle pode-se acessar todas as funes do UniDANFe, como sua documentao, configurao, gerenciador de licenas Plus, gerenciador dos e-mails gerados pelo UniDANFe e gerenciador dos uploads gerados pelo UniDANFe e que aguardam para serem enviados ao servidor FTP. Alm disso, pode-se tambm gerar o DANFE a partir da seleo de um arquivo XML, clicando no boto Gerar DANFE, conforme mostra a figura abaixo.
Tela do Painel de Controle do UniDANFe
Pgina 5
UniDANFe verso 3.x

b) Acessando a interface de configuraes do UniDANFe
2010
Ao carregar o UniDANFe com o parmetro configurar=1 a interface administrativa de configurao apresentada.
c) Acessando o Gerenciador de Licenas do UniDANFe

Ao carregar o UniDANFe com o parmetro licenciar=1 o gerenciador de licenas do UniDANFe Plus apresentado.
d) Consultando a verso/release do UniDANFe

Ao carregar o UniDANFe com o parmetro versao=1 o UniDANFe cria um arquivo com o nome verso.xml na mesma pasta onde estiver instalado, contendo a verso, release e compilao atual do UniDANFe.
e) Consultando e-mails a enviar, enviados ou com erros

Ao acessar a interface administrativa de e-mails, possvel ver os e-mails nas pastas A Enviar, Enviados e Com Erro. e.1) A Enviar
Ao gerar um e-mail para ser enviado ao destinatrio da NF-e, o UniDANFe o coloca na pasta A enviar. Concluda a operao do DANFE (impresso, gerao do e-mail, cpia do PDF ou XML para uma pasta local ou da rede, etc), o UniDANFe fechado de modo a liberar o sistema ERP que porventura estivesse preso por t-lo chamado. No mesmo momento, uma outra instncia do UniDANFe iniciada para disparar todos os e-mails da pasta A Enviar. Em caso de erro durante a tentativa de envio, a mensagem gerada gravada junto ao e-mail, e pode ser consultada pressionando-se o boto Erros. O UniDANFe faz at 50 tentativas de envio dos emails. Aps isso, ele move automaticamente a mensagem para a pasta Com Erros.
- O boto Anexos permite ver os anexos da mensagem selecionada;
Pgina 6
UniDANFe verso 3.x
2010
- O boto Editar permite editar a mensagem selecionada. Esse boto funciona apenas para mensagens nas pastas A enviar e Com erro. - O boto Excluir permite excluir a mensagem selecionada. - O boto Erros permite consultar os erros gerados nas tentativas de envio da mensagem selecionada; - O boto Enviar dispara o processo de envio das mensagens da pasta A enviar. - O boto Remetentes acessa a tela de configurao de contas de remetentes de e-mails.
e.2) Enviados
Aps o envio com sucesso da mensagem de e-mail, a mesma movida para a pasta Enviados, onde pode ser consultada posteriormente. As mensagens desta pasta ficam didaticamente separadas pelo ms e ano da emisso da NF-e para facilitar sua consulta e localizao.
- Os botes Anexos, Editar, Excluir e Erros possuem as funes descritas no item e.1; - O boto Reenviar permite reenviar a mensagem selecionada. Ao ser pressionado, a mensagem movida para a pasta A enviar, de onde pode ser enviada pressionando-se o boto Enviar daquela pasta.
Pgina 7
UniDANFe verso 3.x

e.3) Com Erro
2010
Aps 50 tentativas de envio sem sucesso, a mensagem de e-mail movida para a pasta Com Erros. Uma vez nessa pasta, o administrador do sistema pode ainda consultar os erros ocasionados durante as tentativas de envio e solucion-los. Para mover as mensagens dessa pasta para a pasta A enviar para nova tentativa de envio, basta pressionar o boto Reenviar.
f) forando o envio dos e-mails presos na caixa a enviar

Para forar o UniDANFe a enviar os e-mails presos na pasta A Enviar, basta pressionar o boto Enviar. Se uma instncia do UniDANFe j estiver enviando e-mails, outra no ser aberta, para evitar consumo de recursos da mquina.
g) Carregando a tela de configurao de contas de e-mail (remetentes)

possvel executar o UniDANFe para acessar diretamente a tela de cadastro de remetentes de e-mail. Para isso, basta passar o parmetro configurar_remetente=1 ao UniDANFe, na linha de comando.
Ex: unidanfe.exe configurar_remetente=1
Pgina 8
UniDANFe verso 3.x

h) Consultando uploads pendentes
2010
Atravs dessa tela possvel consultar os arquivos que aguardam para serem enviados ao servidor FTP. AO clicar em cada registro da grid as informaes do arquivo so exibidas logo abaixo, bem como a ltima mensagem de erro gerada durante a ltima tentativa de envio. Essas informaes sero teis para a configurao do sistema.
i) Gerando o DANFE Atravs de Parmetros da Linha de Comando

Essa a forma normal que os sistemas ERP usaro para gerar o DANFE. O UniDANFe deve ser executado com a passagem de alguns parmetros, que o orientaro como se comportar na gerao do DANFE. Cada parmetro descrito a seguir, e devem ser utilizados no formato parmetro=contedo, sem qualquer espao entre o parmetro, o sinal de igualdade e o contedo do mesmo. Parmetros cujo contedo possa conter espaos (ex: nome de pastas e/ou arquivos) devem estar entre aspas, no formato parmetro=contedo completo com espaos Arquivo (obrigatrio) Nome completo do arquivo XML principal gerado pelo ERP, incluindo todo o caminho para encontr-lo. Esse arquivo XML pode ser o arquivo j autorizado pela SEFAZ. Nesse caso, a informao da autorizao ser automaticamente impressa no DANFE no campo Informaes complementares. Arquivos XML no autorizados tambm podem ser utilizados. ArquivoAuxiliar (opcional) Nome completo do arquivo XML auxiliar, incluindo todo o caminho para encontr-lo. No XML auxiliar existem TAGS complementares para o UniDANFe, bem como algumas personalizaes. Se esse parmetro no for passado, o UniDANFe procurar, na mesma pasta do XML principal, um outro arquivo XML com o mesmo nome, acrescido apenas da string danfe ao final. Se encontrar tal arquivo, o usar como auxiliar, sem a necessidade de passar seu nome na linha de comando. Configuracao (opcional) Nome da configurao que ser utilizada para imprimir o DANFE. A partir da verso 2 do UniDANFe, toda sua configurao efetuada atravs de
Pgina 9
UniDANFe verso 3.x
2010
uma interface administrativa, no sendo mais necessrio passar mltiplos parmetros pela linha de comando. Se esse parmetro no for passado, o UniDANFe utilizar a configurao que estiver definida como padro, de acordo com o contedo da TAG <tpImp>. Email (opcional) E-mail do destinatrio da NF-e. Esse e-mail deve ser informado nos casos em que o UniDANFe configurado para enviar automaticamente e-mail com o DANFE e/ou com o XML anexados. O e-mail tambm pode ser gerado no XML auxiliar, ao invs de passado por parmetro, ou atravs das TAGs de uso livre, no prprio XML principal.. PastaConfiguracao (opcional) Pasta onde o UniDANFe deve ler/gravar suas configuraes. Deve ser informado o nome da pasta que ir abrigar as sub-pastas utilizadas pelo UniDANFe, como Dados, Lic, etc. Logotipo (opcional) - nome da imagem, incluindo seu caminho completo, que ser usada na impresso do DANFE. H um campo especfico da interface de configurao do UniDANFe para informar esse arquivo de imagem. No entanto, em alguns casos, deseja-se utilizar uma mesma configurao para mais de uma empresa/filial. Para esses casos, pode-se passar a imagem atravs da linha de comando, ou inform-la no XML auxiliar. Visualizar (opcional) - aceitando os valores 0 para falso ou 1 para verdadeiro; informa ao UniDANF se o DANFE gerado dever ser visualizado na tela do computador antes da impresso/envio por e-mail. Se informado, esse parmetro se sobrepe s configuraes efetuadas na interface administrativa do UniDANFe. Imprimir (opcional) aceitando os valores 0 para falso ou 1 para verdadeiro; informa ao UniDANFe se o DANFE deve ser impresso automaticamente ou no. Se informado, esse parmetro se sobrepe s configuraes efetuadas na interface administrativa do UniDANFe. Impressora (opcional) - aceitando os valores padrao", selecionar ou <nome completo da impressora>; se informado o valor padrao", o DANFE ser enviado para a impressora padro do computador; se informado selecionar, uma tela ser exibida ao usurio antes da impresso, para que este selecione a impressora correta; se informado o nome de uma impressora instalada, o UniDANFe enviar o DANFE para essa impressora. Copias (opcional) - aceitando qualquer valor acima de zero; informa ao UniDANFe quantas cpias devem ser impressas do DANFE gerado. SaidaErros (opcional) - aceitando os valores V para vdeo ou A para arquivo; define onde devem ser geradas as possveis mensagens de erro do sistema. til para os casos em que a impresso e envio por e-mail do DANFE seja configurada para ser executada automaticamente sem a interveno de usurios. Remetente (opcional) E-mail ou apelido do remetente de e-mail que deve ser utilizado para o envio do DANFE (ou XML) por e-mail. O remetente deve estar previamente cadastrado no sistema. Consulte a seo Configurando as Contas de Remetentes para maiores detalhes. possvel informar o remetente tambm no XML auxiliar ou nas TAGs de uso livre.
Pgina 10
UniDANFe verso 3.x
2010
Delete (opcional) Instrui o UniDANFe se este deve deletar (excluir) os arquivos XML envolvidos na gerao do DANFE aps o trmino do processo. Se passado o valor 1, os XMLs sero deletados no final. Qualquer outro valor instrui o UniDANFe a no deletar qualquer arquivo XML. Cancelada (opcional) Aceitando os valore 0 para falso ou 1 para verdadeiro, esse parmetro indica ao UniiDANFe se este deve imprimir a palavra CANCELADA no corpo do DANFE, na diagonal.
Exemplo: c:\unimake\uninfe\unidanfe.exe arquivo=\\meuservidor\c\pasta_xml\0102012.xml pastaconfiguracao=x:\unimake\uninfe logotipo=c:\imagens\logotipo_filial_001.jpg visualizar=0 imprimir=1
Compatibilidade com as verses anteriores Os parmetros que eram enviados ao UniDANFe v.1 ainda podem ser utilizados, para fins de compatibilizao com as integraes desse sistema. Quando informados, cada um desses parmetros se sobrepe configurao do UniDANFe efetuada atravs da interface administrativa. Assim, cada desenvolvedor de sistema ERP deve estar atento as linhas de programao de sua aplicao, de modo a evitar que o UniDANFe no se comporte como esperado ao configur-lo pela interface amigvel, em virtude de possveis discordncias com parmetros enviados pela linha de comando. Para maiores detalhes a respeito do funcionamento desses parmetros, clique aqui.
Forando Uma Edio Especfica do UniDANFe Caso tenha necessidade de executar o UniDANFe em uma edio especfica (Plus ou Free), voc pode adicionar o parmetro Edicao linha de comando.
Exemplo: unidanfe.exe arquivo=0100202020202.xml edio=Free
Passando arquivos externos para serem anexados ao e-mail enviado ao destinatrio da NF-e: Se precisar enviar outros arquivos anexados ao mesmo e-mail em que o DANFE enviado para o cliente, voc pode pass-los por parmetro, no mximo cinco, no seguinte formato:
Unidanfe.exe arquivo=12313123213.xml anexo1=c:\pasta\arquivo1.ext anexo2=y:\outro\xyxyxy.txt
Abreviando a Linha de Comando ao Carregar o UniDANFe Para economizar o espao de buffer da linha de comando, o integrador pode optar por utilizar os parmetros em sua forma abreviada. Assim, ao invs de fazer uma chamada ao UniDANFe dessa forma:
Pgina 11
UniDANFe verso 3.x

c:\unimake\uninfe\unidanfe.exe
Faa assim: c:\unimake\uninfe\unidanfe.exe arquivo=1232378213276.xml arquivoauxiliar=746647467474.xml email=nomedocliente@dominio.com a=1232378213276.xml au=746647467474.xml e=nomedocliente@dominio.com
2010
Tabela de Abreviao dos Parmetros Parmetro Abreviao Arquivo A ArquivoAuxiliar AU Anexo<n> X<n> Cancelada CC Copias P Configuracao C Delete DL Email E Edicao D Impressora I Imprimir M Logotipo L PastaConfiguracao PC Remetente R SaidaErros S Visualizar V
Pgina 12
UniDANFe verso 3.x

Exemplo de chamada ao UniDANFe pela linha de comando:
unidanfe.exe arquivo=c:\unimake\uninfe\nfe000100-nfe.xml arquivoauxiliar= c:\unimake\uninfe\ nfe000100danfe.xml configurao=PAISAGEM email=meucliente@dominio.com.br logotipo=c:\img\filial001.jpg arquivo=c:\unimake\uninfe\nfe000100-nfe.xml configurao=RETRATO arquivo=c:\unimake\uninfe\nfe000100-nfe.xml configurao=SEM_IPI a=c:\unimake\uninfe\nfe000100-nfe.xml e=meucliente@dominio.com r=meuemail@dominio.com arquivo=c:\unimake\uninfe\nfe000100-nfe.xml cancelada=1 delete=1
2010
unidanfe.exe unidanfe.exe unidanfe.exe unidanfe.exe
Pgina 13
UniDANFe verso 3.x Executando o UniDANFe a Partir de Uma Aplicao ERP

Exemplo de chamadas ao UniDANFe atravs de programao na linguagem Clipper:
2010
cComando = [c:\unimake\uninfe\unidanfe.exe arquivo=c:\unimake\uninfe\51080662675686000166550010000001041671821888nfe.xml arquivoauxiliar=c:\unimake\uninfe\51080662675686000166550010000001041671821888-nfedanfe.xml configurao=PAISAGEM] RUN(cComando)
Exemplo de chamadas ao UniDANFe atravs de programao na linguagem Harbour/xHarbour:

cComando = [c:\unimake\uninfe\unidanfe.exe arquivo=c:\unimake\uninfe\51080662675686000166550010000001041671821888nfe.xml arquivoauxiliar=c:\unimake\uninfe\51080662675686000166550010000001041671821888-nfedanfe.xml configurao=PAISAGEM] RUN(cComando)
Exemplo de chamadas ao UniDANFe atravs de programao na linguagem VB6:

Shell "UniDANFe.exe " arquivo="c:\FalcaoNfe\xml\enviado\200903\31090309252646000130550010000070860000008450-nfe.xml" configuracao=RETRATO ou Shell ("C:\unimake\uninfe\UniDANFe.exe arquivo=" & variavel_nome_da_nfe.xml & " arquivoauxiliar=" & variavel_com_nome_auxiliar & " configuracao=Paisagem")
Pgina 14
UniDANFe verso 3.x XML Auxiliar
2010
O XML principal, em sua verso atual, no contempla alguns campos que precisam ser impressos do DANFE, como Hora de Sada e CEP do Local de Entrega. Para suprimir essa deficincia, o UniDANFe busca essas informaes em um XML auxiliar. Esse arquivo XML auxiliar pode ter qualquer nome, sendo passado por parmetro no comando de chamada do UniDANFe, ou poder ter o nome padro de modo a ser encontrado automaticamente pelo UniDANFe. Nesse caso, Dever ter o mesmo nome do XML principal, acrescido da constante danfe antes da extenso do arquivo.
Exemplo: O arquivo XML Principal c:\nfe\nfe001245-procNFe.xml Nesse caso, o XML auxiliar dever ter o nome c:\nfe\nfe001245-procNFedanfe.xml para ser encontrado automaticamente pelo UniDANFe.
Importante observar que a gerao do XML auxiliar no obrigatria para a utilizao do UniDANFe.
Pgina 15
UniDANFe verso 3.x Estrutura do XML auxiliar

O XML auxiliar deve ter a seguinte estrutura: 1
2010
<?xml version="1.0" encoding="UTF-8"?> <outrasInfDANFe> <horasaida>12:20</horasaida> <dSaiEnt>2010-05-20</dSaiEnt> <FoneEmitente>Fone: (11) 1234-1234 Fax: 1234-5678 DDG: 0800-80-8080</FoneEmitente> <nomefantasiadest>NOME FANTASIA DO DESTINATRIO</nomefantasiadest> <codigodest>01982 </codigodest> <emaildest>EMAIL DO DESTINATRIO</emaildest> <remetente>email ou apelido do remetente</remetente> <ceplocalentrega>12345123</ceplocalentrega> <nomelocalentrega>NOME ESTABELECIMENTO DO LOCAL DE ENTREGA</nomelocalentrega> <ceplocalretirada>12345123</ceplocalretirada> <nomelocalretirada> NOME ESTABELECIMENTO DO LOCAL DE ENTREGA </nomelocalretirada> <logotipo>c:\teste\imagem001.jpg</logotipo> <protocolonfe>23812738721372 de dd/mm/aaaa as hh:mm</protocolonfe> <copias>2</copias> <configuracao>RETRATO</configuracao> <textocanhoto>Recebemos de MINHA EMPRESA LTDA a Nota Fiscal 0101010 indicada ao lado</textocanhoto> <poweredby>Unimake Softwares</poweredby> <poweredsite>www.unimake.com.br</poweredsite> <produtos> <produto1> <colunalivre>300 KG</colunalivre> <infAdVeic>Nota Fiscal de Entrada: 01010101 Data: 01/01/2001 BLA BLA BLA</infAdVeic> </produto1> <produto2> <colunalivre>221 KG</colunalivre> <aux_cor>Verde</aux_cor> <aux_tamanho>P</aux_tamanho> <aux_outra_tag>Contedo de qualquer campo do cadastro do produto, ou da venda, etc</aux_outra_tag> <infAdVeic>Nota Fiscal de Entrada: 02020202 Data: 02/02/2002 BLA BLA BLA</infAdVeic> </produto2> </produtos> </outrasInfDANFe>
<horasaida> Hora da sada da mercadoria, para o transporte. Atualmente esse campo no existe na estrutura do XML principal. <dsaient> Data da sada da mercadoria, para o transporte. Atualmente esse campo j existe na estrutura do XML principal, contudo, em muitos casos no se tem essa data no momento da gerao da NF-e, mas apenas no momento da impresso da mesma. O valor dessa TAG no ser atualizado no XML principal, mas apenas impresso no DANFE. <FoneEmitente> Permite a informao de telefones do emitente de forma livre. As informaes dessa TAG, quando informadas, substituiro completamente a linha do telefone, no quadro Identificao do Emitente, no DANFE. Em contrapartida, possvel informar mais de um nmero, como por exemplo, telefone, celular, fax ou DDG. A antiga tag <foneDDG> permitia a informao de apenas um nmero de telefone. <nomefantasiadest> e <codigodest> - Como seus prprios nomes demonstram, servem para informar ao UniDANFe o nome de fantasia e o cdigo do destinatrio. Essas informaes, quando preenchidas, sero impressas no DANFE no campo Nome/Razo Social (do destinatrio), logo aps a razo social informada no XML principal, e tem a funo de facilitar
Com exceo das tags <?xml> e <outrasInfDanfe>, todas as outras so opcionais.
Pgina 16
UniDANFe verso 3.x
2010
ao transportador (entregador) a localizao dos estabelecimentos destinatrios, que raramente estampam o nome de fantasia em placas externas. <emaildest> - Email do destinatrio. Esse e-mail ser usado pelo UniDANFe para enviar e-mail ao destinatrio contendo o DANFE e/ou o XML principal, como anexo(s). <remetente> - Email ou apelido do remetente de e-mails. O contedo dessa TAG ser utilizado pelo UniDANFe para localizar o registro correspondente ao remetente desejado na tabela de remetentes cadastrados no sistema. O remetente deve estar previamente cadastrado no sistema. Consulte a seo Configurando as Contas de Remetentes para maiores detalhes. <ceplocalentrega> - Outro campo que no existe atualmente na estrutura do XML principal. O UniDANFe imprime o local de entrega no corpo do DANFE quando informado no XML principal. No entanto, para preenchimento do CEP, necessrio inform-lo no XML auxiliar. <nomelocalentrega> - Outro campo que no existe atualmente na estrutura do XML principal. O UniDANFe imprime o local de entrega no corpo do DANFE quando informado no XML principal. No entanto, para preenchimento do NOME, necessrio inform-lo no XML auxiliar. <ceplocalretirada> - Igualmente ao CEP do local de entrega, o UniDANFe imprime o local de retirada no corpo do DANFE quando informado no XML principal. No entanto, para preenchimento do CEP, necessrio inform-lo no XML auxiliar. <nomelocalretirada> - Igualmente ao CEP do local de entrega, o UniDANFe imprime o local de retirada no corpo do DANFE quando informado no XML principal. No entanto, para preenchimento do NOME, necessrio inform-lo no XML auxiliar. <protocolonfe> - Quando a NF-e estiver autorizada, o nmero do protocolo, bem como a data e a hora da autorizao podem ser passadas nessa TAG, e o UniDANFe a imprimir no campo correspondente, no DANFE.
Ex: <protocolonfe>01023132312312, em 11/08/2009 s 09:39</protocolonfe>
<produtos> - TAGS utilizadas para informaes complementares aos produtos. um recurso especial do UniDANFe para suprir necessidades que o XML auxiliar no contempla. Atravs dessas TAGS, possvel incluir uma coluna livre (Free) no DANFe, ou definir colunas especficas (Plus) iniciadas com o prefixo Aux_ para utilizao atravs das configuraes de colunas, presentes no UniDANFe Plus. <produto?> - Abre um grupo de TAGS de produtos. Deve ser aberta uma TAG de grupo de produtos para cada produto constante no XML auxiliar. O smbolo ? presente nessa TAG deve ser substitudo pelo mesmo nmero de seqncia presente na TAG de grupo <det nItem=?> do XML principal. <colunalivre>(Free) O contedo dessa TAG ser impresso na coluna correspondente do DANFE, desde que previamente configurado na interface amigvel do UniDANFe. utilizada para imprimir contedos do cadastro de produtos ou dos itens das vendas que no estejam presentes na estrutura do XML principal. Para maiores detalhes a respeito dessa configurao, consulte a seo Coluna Livre. Ateno: se voc estiver imprimindo DANFEs em ambiente de homologao, o UniDANFe se comporta como edio Plus e no imprime os dados da coluna livre. Para contornar isso, ao carregar o UniDANFe passe o parmetro indicando que quer utilizar especificamente a edio free.
Ex: unidanfe.exe arquivo=01010101.xml edio=free
Pgina 17
UniDANFe verso 3.x
2010
<aux_nnnnnn>(Plus) No UniDANFe v.3 Plus possvel configurar cada coluna que ser impressa no DANFE, bem como mudar sua posio, e inclusive remover colunas no utilizadas, como valor e alquota de IPI para empresas que no utilizem esse imposto, por exemplo. Tambm possvel adicionar novas colunas do DANFE. Nesse caso, podem ser adicionadas qualquer TAG do grupo <det> do XML principal, ou mesmo outras que no existam nesse XML principal. Por exemplo, para adicionar no DANFE, logo aps a descrio do produto uma coluna contendo a cor do mesmo, basta incluir a coluna <Aux_Cor> na configurao do UniDANFe, e gerar no XML auxiliar a mesma TAG com seu respectivo contedo, como pode ser visto no exemplo dado logo acima na estrutura do XML auxiliar, onde foram definidas as TAGS <Aux_Cor> e <Aux_Tamanho>. <infAdVeic>(Plus) Ao emitir DANFE de venda de veculos novos, possvel configurar o UniDANFe v.3 Plus para emitir a descrio complementar dos veculos logo abaixo da linha do produto com as informaes presentes nas TAGs especficas (grupo <veicProd>). No entanto, em havendo necessidade de destacar ali outras informaes adicionais no contempladas no conjunto de TAGs especficas, pode-se gerar o complemento da descrio nessa TAG <infAdVeic> no arquivo auxiliar, que a mesma ser adicionada descrio complementar, no ponto onde a mesma for inserida na interface de configurao do UniDANFe. <copias> Nmero de cpias (vias) em que o DANFE deve ser gerado/impresso; <configuracao> Configurao do UniDANFe que ser usada para a gerao/impresso do DANFE; <textocanhoto> - Redefinio do texto padro impresso no canhoto do DANFE. O texto que for definido nessa TAG ser impresso integralmente, sobrepondo-se ao padro atual do sistema.
Pgina 18
UniDANFe verso 3.x Campos no previstos no XML Principal
2010
Alm da utilizao do arquivo XML auxiliar, h a possibilidade de informar alguns campos no previstos no XML principal utilizando-se as TAGs de uso livre. Observe que a SEFAZ aceita no mximo 10 (dez) TAGs dessas no mesmo XML. Assim, fica a cargo do desenvolvedor escolher quais ir utilizar para melhor integrar seu ERP ao UniDANFe. As informaes que so previstas e que podem ser informadas nessa TAG so: Logotipo Logotipo do emitente de NF-e; Telefones_Emitente Telefones do emitente, para sair no quadro Identificao do Emitente. Utilizar quando se deseja imprimir mais de um nmero de telefone nesse quadro. Email_Destinatario E-mail do destinatrio da NF-e. Informar para automatizar processo de envio da NF-e e do XML para o destinatrio da NF-e. Remetente - Email ou apelido do remetente de e-mails. O contedo dessa TAG ser utilizado pelo UniDANFe para localizar o registro correspondente ao remetente desejado na tabela de remetentes cadastrados no sistema. O remetente deve estar previamente cadastrado no sistema. Consulte a seo Configurando as Contas de Remetentes para maiores detalhes. Nome_Fantasia_Destinatario Ao informar esse campo, o nome fantasia impresso no DANFE direita da razo social do destinatrio da NF-e. Codigo_Destinatario Ao informar esse campo, o cdigo impresso no DANFE direita da razo social do destinatrio da NF-e. Nome_Local_Entrega Nome do estabelecimento no local de entrega. Impresso no corpo do DANFE, juntamente ao endereo de entrega. Cep_Local_Entrega CEP do local de entrega. Impresso no corpo do DANFE, juntamente ao endereo de entrega. Nome_Local_Retirada Nome do estabelecimento no local de retirada. Impresso no corpo do DANFE, juntamente ao endereo de retirada. Cep_Local_Retirada CEP do local de retirada. Impresso no corpo do DANFE, juntamente ao endereo de retirada. Hora_Saida Hora de sada.
Protocolo_NFe Nmero do protocolo de autorizao da NF-e, juntamente com a data e hora da autorizao.
Exemplo da utilizao das TAGs de uso livre (obs: h um limite de utilizao, de 10 campos por XML fica a cargo do programador/emitente escolher quais campos vai utilizar): ...
<infAdic> <infCpl>xxxx xxx xxxxxxxx xxxxx xxxxx;xxxxx xxxx xxxx xxxxx</infCpl> <obsCont xCampo=Logotipo><xTexto>c:\imagens\logomarca.jpg</xTexto></obsCont> <obsCont xCampo=Email_Destinatario><xTexto>email@dominio.com.br</xTexto></obsCont> <obsCont xCampo=Remetente><xTexto>email@dominio.com.br</xTexto></obsCont> <obsCont xCampo=Remetente><xTexto>apelido do remetente</xTexto></obsCont>
Pgina 19
UniDANFe verso 3.x
2010
<obsCont xCampo=Telefones_Destinatario><xTexto>Fone: (nn) nnnn-nnnn Fax: nnnn-nnnn</xTexto></obsCont> <obsCont xCampo=Nome_Fantasia_Destinatario><xTexto>Nome de Fantasia</xTexto></obsCont> <obsCont xCampo=Codigo_Destinatario><xTexto>12345</xTexto></obsCont> <obsCont xCampo=Nome_Local_Entrega><xTexto>NOME DO ESTABELECIMENTO</xTexto></obsCont> <obsCont xCampo=Cep_Local_Entrega><xTexto>12345-123</xTexto></obsCont> <obsCont xCampo=Nome_Local_Retirada><xTexto>NOME DO ESTABELECIMENTO</xTexto></obsCont> <obsCont xCampo=Cep_Local_Retirada><xTexto>12345-123</xTexto></obsCont> <obsCont xCampo=Hora_Saida><xTexto>10:22</xTexto></obsCont> <obsCont xCampo=protocolo_nfe><xTexto>23123123213, em 11/08/2009 s 09:40</xTexto></obsCont> </infAdic>
...
Pgina 20
UniDANFe verso 3.x Configurando o UniDANFe

A partir da verso 2 o UniDANFe conta com uma interface amigvel de configurao.
2010
Para acessar essa interface, basta executar o UniDANFe (Free ou Plus) passando o comando Configurar=1 por parmetro, ou executar o UniDANFe partir do cone criado na rea de trabalho e no menu iniciar quando da instalao do mesmo.
Exemplo: c:\unimake\uninfe\unidanfe.exe configurar=1
Ao executar o comando acima, a seguinte interface ser exibida:
As opes de configurao Retrato ou Paisagem filtram os registros mostrados no grid, de acordo com a opo escolhida. O grid Configuraes exibe as configuraes includas anteriormente, tanto para orientao em Retrato quanto Paisagem. O boto Definir como padro permite que a configurao salientada seja definida como aquela que ser utilizada pelo UniDANFe caso o parmetro Configuracao=nnnn seja omitido. Note que h uma configurao padro para configuraes do tipo Retrato e uma para Paisagem. Assim, caso o parmetro Configuracao=nnnn seja omitido ao carregar o UniDANFe, o sistema buscar a configurao padro de acordo com a TAG <tpImp> do XML principal, que define o tipo de orientao do DANFE, sendo 1-Retrato e 2-Paisagem. O boto Duplicar permite que a configurao salientada seja duplicada, sendo criada uma exatamente igual com outro nome, de modo a ser alterada pelo usurio. Os botes Incluir, Alterar e Excluir respectivamente permitem incluir nova configurao, alterar ou excluir uma configurao existente. Note que o UniDANFe no permite que a configurao padro seja excluda.
Pgina 21
UniDANFe verso 3.x
2010
A opo Remetentes, no grupo E-mail, permite a incluso, alterao ou excluso de remetentes de e-mail. Nesse mesmo grupo, a opo Manuteno permite configurar a quantia de meses que os e-mails enviados e com erros devem ficar arquivados. Findo esse prazo, so automaticamente excludos. A opo Cancelamento permite configurar o envio de XML de cancelamento aos destinatrios de NF-e por e-mail, automaticamente. A opo Monitor permite configurar as aes que o DANFEmon Monitor do UniDANFe executar. As opes Exportar e Importar permitem exportar e importar as configuraes, tanto em retrato quanto paisagem. Podem ser usadas pela Software House do sistema ERP para manuteno da configurao em seus clientes.
Pgina 22
UniDANFe verso 3.x Editando as Configuraes do UniDANFe

Grupo Configurao Geral
Opo Impresso
2010
Ao clicar em Incluir ou Alterar, o UniDANFe apresenta a seguinte tela de configurao:
Editando as configuraes do UniDANFe
Nome da Configurao Nome da configurao, que dever ser passado ao UniDANFe quando este for executado para a impresso do DANFE. Se informado um CNPJ (completo ou raiz), no formatado (sem pontos e barras), o UniDANFe usar essa configurao sempre que for carregado para gerar o DANFE de uma NF-e emitida pelo proprietrio desse CNPJ, desde que a configurao no tenha sido passada por parmetro. Exemplos: RETRATO, PAISAGEM, CONFIG1, 12345367000100 (CNPJ 12.345.367/0001-00 completo), 01234567 (raiz do CNPJ 12.345.367/0001-00), etc. Descrio Rpida descrio sobre a configurao. Imprimir o DANFE na Impressora Opes de seleo da impressora onde o DANFE impresso, podendo ser: Impressora padro O DANFE deve ser impresso na impressora padro definida no painel de controle do sistema operacional; Selecionar no momento da impresso O UniDANFe deve solicitar ao operador do computador, no momento da impresso, a impressora que ser utilizada; Impressora especfica O DANFE deve ser impresso em uma impressora especfica do computador ou da rede. Nesse caso, essa impressora deve ser informada no campo direita deste, que ser habilitado automaticamente quando essa opo for selecionada. Orientao orientao do DANFE, podendo ser Retrato ou Paisagem; Nmero de cpias nmero de cpias (vias) em que o DANFE ser impresso;
Pgina 23
UniDANFe verso 3.x
2010
Sada de Mensagens de Erros Define onde as mensagens de erro do sistema devero ser geradas, podendo ser Vdeo ou Arquivo. Nesse ltimo caso, havendo mensagens de erro, um arquivo ser gerado na mesma pasta e com o mesmo nome do XML principal, com a extenso .err. Posio de Impresso das Linhas de Avisos Legais Define onde as linhas de avisos legais referentes ao ambiente de homologao e emisso em contingncia sero impressas, podendo ser Corpo do DANFE ou Informaes Complementares. Cor do aviso de NF-e cancelada Cor com que ser impressa a palavra CANCELADA no corpo do DANFE quando for passado o parmetro cancelada=1. Para alterar a cor basta clicar no boto direita do campo. Visualizar a impresso Se marcado esse campo, o DANFE ser exibido na tela do computador onde foi gerado antes de ser impresso. Nesse caso, sua impresso dever ser disparada manualmente pelo operador; Imprimir automaticamente Se esse campo estiver marcado e o campo visualizar a impresso no, o DANFE ser impresso automaticamente na impressora definida no momento de sua gerao, salvo a impressora definida seja selecionar no momento da impresso; Gerenciar fila de impresso interna Quando marcado esse campo, o UniDANFe utilizar um sistema de semforos para impedir que duas instncias dele prprio envie dados para a impressora ao mesmo tempo. Utilize esse recurso quando tiver problemas ao imprimir DANFEs em mais de um computador ao mesmo tempo. Imprimir zeros esquerda do nmero da NF-e Quando marcado esse campo (padro), o UniDANFe imprimir o nmero da NF-e sempre com 9 dgitos, separados por pontos (exemplo: 000.001.273). Se desmarcado, os zeros esquerda sero ignorados (exemplo: 1.273).
Pgina 24
UniDANFe verso 3.x

Opo Margens
2010
Margens (superior, inferior, esquerda e direita) Possibilita que sejam efetuados ajustes na disposio do DANFE. Imprima a rgua para facilitar a configurao desses campos. Margem extra para impresso em formulrio de segurana (FS) Possibilita que seja configurada uma margem extra ao imprimir o DANFE em contingncia utilizando o formulrio de segurana (FS). FS-DA Possibilita que seja configurada uma margem extra ao imprimir o DANFE em contingncia utilizando o formulrio de segurana (FS-DA).
Pgina 25
UniDANFe verso 3.x

Opo Dados Emitente
2010
Logotipo do Emitente Imagem com a logomarca do emitente, que dever ser impressa no DANFE, no quadro Identificao do Emitente. Se tratar-se de imagem em formato retrato (altura maior que a largura), a mesma ser impressa alinhada esquerda no quadro de informaes do emitente, com as respectivas informaes (nome, endereo, etc) sua direita. Se a imagem estiver em formato paisagem (largura maior que a altura), o UniDANFe tentar disp-la alinhada ao topo do quadro, acima do texto. Se no houver espao suficiente para isso, a mesma ser impressa esquerda do texto. Nesse caso, a visualizao da imagem no muito boa, e para isso, o responsvel pelo ERP dever estar trabalhando com imagem que se adapte melhor ao caso. Preencher a identificao do emitente Se desmarcado esse campo o DANFE no preencher as informaes do emitente da NF-e no quadro Identificao do Emitente. Pode ser utilizada quando a imagem do logotipo da empresa emitente j contiver todas as informaes necessrias do emitente (nome, endereo, telefone, etc). Imprimir o Nome de Fantasia do Emitente Se desmarcado esse campo o UniDANFe no imprimir o nome de fantasia no quadro Identificao do Emitente. Imprimir texto Identificao do Emitente Se desmarcado esse campo o UniDANFe no imprimir o cabealho IDENTIFICAO DO EMITENTE no quadro correspondente. Imprimir o e-mail do emitente se marcado esse campo o UniDANFe imprimir o e-mail do emitente logo aps seu endereo/telefone. O e-mail do remetente deve ser previamente cadastrado na tela de configurao de remetentes. O critrio para escolha, em caso de mltiplas contas cadastradas o mesmo adotado para selecionar o remetente do envio do email. Se nenhum remetente for definido na linha de parmetros, no XML auxiliar ou nos campos extras do XML principal, o endereo da conta padro ser utilizado.
Pgina 26
UniDANFe verso 3.x

Opo Dados Destinatrio
2010
Imprimir o Cdigo do Destinatrio Se desmarcado esse campo o DANFE imprimir o cdigo do destinatrio logo aps sua razo social, desde que o mesmo tenha sido informado no XML auxiliar. Imprimir o Nome de Fantasia do Destinatrio Se desmarcado esse campo o DANFE imprimir o nome de fantasia do destinatrio logo aps sua razo social, desde que a mesmo tenha sido informada no XML auxiliar.
Pgina 27
UniDANFe verso 3.x

Opo Faturas/Duplicatas
2010
Imprimir o Quadro Fatura/Duplicatas O quadro com a discriminao da fatura / duplicatas deve ser impresso no DANFE? Sim imprime sempre, mesmo que no haja a informao; No no imprime nunca, mesmo que haja a informao; Automtico Imprime apenas quando houver a informao. Quando o quadro no impresso, o espao que sobra ser utilizado para aumentar o quadro Produtos/Servios. Imprimir Cabealhos Se marcado esse campo, o UniDANFe imprimir os cabealhos Fatura, Vencimento e Valor no quadro Fatura / Duplicata. Permitir que o UniDANFe (plus) redimensione a altura do quadro... se marcado esse campo, o UniDANFe (plus) redimensionar a altura do quadro Faturas/Duplicatas impresso do DANFE, diminuindo-o sempre que no for ocupado toda a rea disponvel, sendo o espao liberado adicionado ao quadro Produtos/Servios. O que imprimir quando o vencimento de uma fatura for igual data de emisso Data imprime a data do vencimento; A Vista imprime o texto A Vista; C/Apresent imprime o texto C/Apresent.
Pgina 28
UniDANFe verso 3.x

Opo Transportador/Volumes
2010
Nmero de Casas Decimais de Peso Bruto e Peso Lquido Nmero de casas decimais com que os campos peso bruto e peso lquido do DANFE devero ser exibidos. Tamanho da fonte da placa de veculo Permite alterar o tamanho da fonte do contedo desse campo.
Pgina 29
UniDANFe verso 3.x

Opo Produtos/Servios
2010
Tamanho da fonte do quadro Produtos/Servios Define o tamanho da fonte do contedo das informaes impressas nesse quadro. Anexar a origem dos produtos ao campo CST Se configurado esse campo, o cdigo da origem do produto ser adicionada ao valor do campo CST, na impresso. Pode ser impresso com ou sem a barra separadora /. Calcular automaticamente o nmero de casas decimais para a quantidade do produto Se marcado esse campo, o UniDANFe analisar em todos os produtos qual a quantidade mxima de casas decimais vlidas utilizadas, e aplicar esse nmero a todos os produtos da NF-e, como padro. Calcular automaticamente o nmero de casas decimais para o valor unitrio do produto Se marcado esse campo, o UniDANFe analisar em todos os produtos qual a quantidade mxima de casas decimais vlidas utilizadas, e aplicar esse nmero a todos os produtos da NF-e, como padro. Se esse nmero for inferior a 2, duas casas decimais sero exibidas. Incluir espao vertical extra antes dos locais de entrega e retirada Se marcado esse campo, uma linha em branco ser impressa antes das informaes dos locais de entrega e retirada, no corpo do DANFE.
Pgina 30
UniDANFe verso 3.x

Opo ISSQN
2010
Imprimir o Quadro Clculo do ISSQN O quadro com a discriminao do clculo do ISSQN deve ser impresso no DANFE? Sim imprime sempre, mesmo que no haja a informao; No no imprime nunca, mesmo que haja a informao; Automtico Imprime apenas quando houver a informao. Quando o quadro no impresso, o espao que sobra ser utilizado para aumentar o quadro Produtos/Servios.
Pgina 31
UniDANFe verso 3.x

Opo Dados Adicionais
2010
Altura do Quadro Informaes Complementares Define a altura, em milsimos de polegadas, do quadro mencionado. Largura do Quadro Reservado ao Fisco Define a largura, em milsimos de polegadas, do quadro mencionado.
DICA: Imprima uma rgua para facilitar a configurao desses dois campos.
Tamanho da fonte do quadro Informaes Complementares Define o tamanho da fonte do contedo das informaes impressas nesse quadro. Imprimir o contedo das TAGs de campo livre do contribuinte junto das informaes complementares- Se marcado esse campo, o UniDANFe imprimir o contedo das TAGs <obsCont> no quadro Informaes Complementares.
Pgina 32
UniDANFe verso 3.x

Opo Canhoto
2010
Posio do Canhoto da NF-e Posio onde o canhoto da NF-e dever ser impresso no DANFE, podendo ser Topo da pgina, Rodap da pgina, Automtico ou No imprimir. No caso de Automtico ser selecionado, o canhoto ser impresso sempre no rodap da pgina, salvo quando o DANFE estiver sendo emitido em contingncia. No caso de No imprimir, o canhoto omitido (apenas para orientao em retrato) e o espao que sobra utilizado para aumentar a altura do quadro Produtos/Servios. Imprimir o picote do canhoto a linha serrilhada que identifica o ponto de corte do canhoto do comprovante de entrega dos produtos deve ser impresso no DANFE? As opes so Sim, No ou Automtico. Nesse ltimo caso, o serrilhado ser impresso sempre, salvo quando emisso do DANFE em situao de contingncia. Texto do campo Identif. Recebedor opcionalmente possvel alterar o texto que impresso no quadro correspondente. Nmero de canhotos no mesmo DANFE define o nmero de vezes que o canhoto deve ser impresso no mesmo DANFE. Os valores aceitos so 1 (padro) e 2. Imprimir o Canhoto em Todas as Folhas do DANFE se marcado essa campo, o canhoto do DANFE ser impresso em todas pginas, e no apenas na primeira. Incluir os seguintes dados adicionais na declarao de recebimento indica quais informaes devem ser impressas junto declarao do recebimento da mercadoria, no canhoto da NF-e. Cdigo de Barras de Identificao da NF-e- Se marcados os campos desse grupo, um cdigo de barras ser impresso no canhoto do DANFE com a identificao da NF-e. Se marcado apenas o campo Imprimir... ser gerado cdigo de barras com o nmero da NF-e. Se marcado tambm o campo Incluir o CNPJ do Emitente na barra o referido CNPJ ser impresso no cdigo de barras tambm, no formato CCCCCCCCCCCCCCNNNNNN, onde CCCCs representam o CNPJ e NNN representam o nmero da NF-e, nessa ordem. Esse cdigo de barras de tamanho varivel, no sendo gerados zeros esquerda do nmero da NF-e.
Pgina 33
UniDANFe verso 3.x
2010
Grupo Coluna dos Produtos

Opo Configurao
Grid Tags/Colunas do DANFE Nesse grid aparecem todas as colunas que esto definidas para ser impressas no DANFE, na ordem em que nele aparecero. possvel alterar a ordem em que elas sero impressas, movendo-as para baixo ou para cima, de acordo com a necessidade. Alm disso, cada coluna pode ser configurada especificamente, alterando-se as informaes da Tag/Coluna que aparecem direita do grid, bastando selecionar no grid a coluna deseja e alterar suas informaes. Tambm possvel remover colunas desse grid selecionando-as e clicando em Excluir a TAG Selecionada, bem como possvel adicionar novas colunas fazendo uso do boto Incluir Nova TAG. Ao incluir nova TAG, podero ser utilizadas quaisquer TAGS do grupo <det> do XML principal, ou qualquer TAG que seja gerada no grupo de TAGS <produto> no XML auxiliar, desde que tenham sido geradas com o prefixo Aux_, como por exemplo <Aux_CorProduto> ou <Aux_TamanhoProduto>. Nome da Tag Nome da TAG do XML principal que ser impressa nessa coluna. No se preocupe com maisculas ou minsculas o sistema localizar a TAG correta, independente da forma como esse nome for digitado. Em caso de TAG do XML auxiliar, deve ser precedida pelo prefixo Aux_. Nesse campo somente so permitidos os caracteres de A a Z, os algarismos de 0 a 9 e o sinal de sublinhado;
Pgina 34
UniDANFe verso 3.x
2010
Cabealho da Coluna e 2 Linha do Cabealho Informaes que sero exibidas no DANFE, no cabealho de cada coluna. Podem ser informadas em duas linhas; Alinhamento define como o contedo dessas colunas deve ser alinhado no DANFE, podendo ser Esquerda, Centralizado ou Direita; Mscara de formatao define a mscara de formatao com que o contedo dessa coluna ser exibido no DANFE. Para exemplos de mscaras, clique no boto de ajuda (?) logo a seguir;
NOTA: Na edio 2.1 do UniDANFe era possvel configurar a fonte e tamanho da fonte com que os dados seriam impressos. partir da edio 2.2.0 essa opo deixou de existir, uma vez que esses detalhes foram normatizados pela SEFAZ. Quanto largura da coluna, o UniDANFe partir da verso 2.2.0 calcula-a automaticamente, maximizando a utilizao dos espaos horizontais.
Pgina 35
UniDANFe verso 3.x

Opo Coluna Livre
2010
No UniDANFe v.1 havia uma coluna extra no DANFE, chamada de pDesc. Essa coluna no existe mais no UniDANFe. Se houver necessidade de utiliz-la, bem como qualquer outra coluna adicional, dever ser utilizado o recurso de Coluna Livre do UniDANFe Free, que possibilita a incluso de uma coluna adicional ao DANFE, logo direita da descrio do produto. Para tanto, basta configurar corretamente os campos dessa tela e gerar no XML auxiliar, no grupo de TAGS <produto>, a TAG <colunalivre> contendo as informaes que devero ser impressas nessa coluna. Note que no possvel configurar ao mesmo tempo mais de uma coluna livre para o DANFE. Se houver essa necessidade, o emitente de NF-e dever adquirir uma licena do UniDANFe Plus. Veja como licenciar o UniDANFe Plus na seo Gerenciando licenas do UniDANFe Plus. Cabealho da Coluna - Informaes que sero exibidas no DANFE, no cabealho da coluna livre. Podem ser informadas duas linhas. Se nada for informado nesses dois campos, a coluna livre no ser impressa no DANFE, mesmo que existam informaes no XML auxiliar. Alinhamento define como o contedo dessa coluna deve ser alinhado no DANFE, podendo ser Esquerda, Centralizado ou Direita; Posio da Coluna no DANFE define a posio (ordem) em que a coluna livre aparecer no DANFE, na linha de produtos.
Pgina 36
UniDANFe verso 3.x

Grupo E-mail
2010
Nesse grupo possvel configurar como os e-mails sero enviados para o destinatrio da NF-e. Opo Envio de E-mail
Enviar o e-mail automaticamente Se esse campo estiver marcado e o e-mail do destinatrio for informado, o UniDANFe enviar um e-mail para o destinatrio da NFe automaticamente no momento da gerao do DANFE, contendo em anexo, opcionalmente, o prprio DANFE gerado e o arquivo XML principal. O campo seguinte define se o e-mail ser enviado Antes de visualizar/imprimir ou Aps de visualizar/imprimir. Anexar o DANFE Se marcado esse campo, a imagem do DANFE ser enviada junto com o email, como anexo. No UniDANFe Free esse anexo gerado em formato WMF e agrupado no formato DNF, sendo enviado um nico arquivo anexado com esse formato .dnf contendo todas as pginas do DANFE. Para abrir esse formato, o destinatrio dever utilizar o sistema DANFE View Free, disponibilizado gratuitamente para visualizao do DANFE. O link para download, bem como instrues vo descritos no prprio e-mail. No UniDANFe Plus o anexo gerado em formato PDF, sendo enviado um nico arquivo PDF contendo todas as pginas do DANFE. Anexar o arquivo XML principal Se marcado esse campo, o XML principal ser enviado junto com o e-mail, como anexo. Anexar o arquivo XML auxiliar Se marcado esse campo, o XML auxiliar, se houver, ser enviado junto com o e-mail, como anexo. Solicitar confirmao de leitura: se marcado esse campo, ser solicitado ao destinatrio do email que este envie de volta uma confirmao de leitura do e-mail, aps lido. Prioridade dos e-mails enviados: este campo define a prioridade dos e-mails enviados, podendo ser uma das opes: Alta, Normal ou Baixa.
Pgina 37
UniDANFe verso 3.x

Opo Personalizao
2010
Assunto do E-mail Assunto (subject) do e-mail. Podem ser utilizados os campos variveis na composio desse campo; Corpo do E-mail Texto que ser enviado no corpo do e-mail. Podem ser utilizados os campos variveis na composio desse campo; Campos variveis Recurso especial do UniDANFe que permite a personalizao do assunto e do texto do corpo do e-mail. Esses campos so digitados nos campos utilizando-se o delimitador # antes e depois do nome do campo. No momento do envio do e-mail, o UniDANFe substitui automaticamente todos os campos variveis pelo contedo correspondente. Exemplos: #nome_emitente#, #cnpj_emitente#, #numero_nota#, #chave_acesso#, etc.
Pgina 38
UniDANFe verso 3.x

Grupo Opes de PDF
2010
Atravs deste grupo possvel configurar o UniDANFe a gerar cpia do DANFE em formato PDF, alm de o instruir a efetuar backups desses arquivos PDF para uma pasta local ou da rede, e at mesmo para um servidor FTP. Opo Configurao
Salvar o DANFE em PDF em uma pasta local ou da rede se marcado esse campo, o UniDANFe gerar a imagem do DANFE em formato PDF, e o salvar em uma pasta do computador local ou da rede. Separar os arquivos PDF por ms na pasta local ou da rede se marcado esse campo, o UniDANFe Plus criar automaticamente sub-pastas separadoras por ms, dentro da pasta configurada para a gerao dos arquivos PDF, no formato AAAA-MM, onde AAAA o ano da emisso da NF-e, e MM o ms. Pasta local ou da rede onde o arquivo PDF deve ser salvo caminho completo, do disco local ou da rede, onde os arquivos PDF gerados pelo UniDANFe Plus sero gerados. Fazer o upload do PDF para um servidor FTP se marcado esse campo, o UniDANFe Plus enviar o arquivo PDF via FTP (File Transfer Protocol) para um servidor de internet, de modo que o emitente de NF-e possa criar em seu site links para que o destinatrio da NF-e possa fazer consultas on-line. Separar os arquivos PDF por ms na pasta remota se marcado esse campo, o UniDANFe Plus criar automaticamente sub-pastas separadoras por ms, dentro da pasta configurada para o envio dos arquivos PDF, no formato AAAA-MM, onde AAAA o ano da emisso da NF-e e MM o ms. Pasta do servidor FTP onde o PDF deve ser copiado caminho completo da pasta remota para onde os arquivos PDF gerados sero enviados. Configurao de FTP acessa a tela de configurao do servidor de FTP para onde os arquivos PDF gerados sero enviados.
Pgina 39
UniDANFe verso 3.x
2010
Como deve ser o nome do arquivo PDF - Opes disponveis: Chave de acesso da NF-e o nome do arquivo PDF ter o formato fffff.pdf, onde fffff o nmero da chave de acesso da NF-e; Nmero/Srie da NF-e o PDF ter o nome no formato nfe-nnnnnn-ss.pdf, onde nnnnnn o nmero da NF-e e SS a srie; e Igual ao nome do XML principal, onde o arquivo PDF ter exatamente o mesmo nome do arquivo XML, com a extenso .pdf. Impressora a ser utilizada na gerao do PDF: em alguns casos, mesmo a visualizao e impresso do DANFE serem geradas perfeitamente, o PDF gerado com certas deformaes (fonte, tamanho, margens, etc). Nesses casos, possvel selecionar outra impressora (outro driver de impressora, na realidade) para gerar o PDF. Para isso, basta selecionar uma impressora local ou da rede que esteja instalada nesse computador. No necessrio informar esse campo se no houver problemas na gerao do PDF, ou se a impressora a ser utilizada para gerar o PDF for a mesma que esteja sendo utilizada para imprimir o DANFE.
Configurao de FTP
Configurao do Servidor FTP IP, usurio, senha e configurao de modo passido da conta de FTP criada no servidor. Teste de Conexo de Upload atravs desta opo, aps informar os dados de conexo, com login e senha, possvel efetuar um teste de conexo (ping) e em seguida um teste de upload de um arquivo para o servidor FTP. Utilize esse recurso para configurar os dados de sua conta FTP.
Grupo Opes de XML

Atravs deste grupo possvel configurar o UniDANFe a efetuar backups do XML principal para uma pasta local ou da rede, e at mesmo para um servidor FTP.
Pgina 40
UniDANFe verso 3.x

Opo Configurao
2010
Salvar o arquivo XML em uma pasta local ou da rede - se marcado esse campo, o UniDANFe Plus salvar o arquivo XML principal em uma pasta do computador local ou da rede. Salvar tambm o arquivo auxiliar se marcado esse campo, o arquivo XML auxiliar tambm ser copiado para a pasta local ou da rede, juntamente ao arquivo XML principal. Separar os arquivos XML por ms na pasta local ou da rede se marcado esse campo, o UniDANFe Plus criar automaticamente sub-pastas separadoras por ms, dentro da pasta configurada para a cpia dos arquivos XML (principal e auxiliar), no formato AAAA-MM, onde AAAA o ano da emisso da NF-e, e MM o ms. Pasta local ou da rede onde os arquivos XML devem ser salvos caminho completo, do disco local ou da rede, onde os arquivos XMLs devem ser copiados. Fazer upload do XML para o servidor FTP se marcado esse campo, o UniDANFe Plus enviar o arquivo XML principal via FTP (File Transfer Protocol) para um servidor de internet, de modo que o emitente de NF-e possa criar em seu site links para que o destinatrio da NF-e possa fazer consultas on-line. Fazer upload tambm do XML auxiliar se marcado esse campo, o arquivo XML auxiliar ser igualmente enviado ao servidor FTP. Separar os arquivos XML por ms na pasta remota se marcado esse campo, o UniDANFe Plus criar automaticamente sub-pastas separadoras por ms, dentro da pasta configurada para o envio dos arquivos XML, no formato AAAA-MM, onde AAAA o ano da emisso da NF-e e MM o ms. Pasta do servidor FTP para onde os XMLs devem ser enviados caminho completo da pasta remota para onde os arquivos XML sero enviados. Como deve ser o nome do XML - Opes disponveis: Chave de acesso da NF-e o nome do arquivo XML salvo ter o formato fffff.pdf, onde fffff o nmero da chave de acesso da NF-e; Nmero/Srie da NF-e o XML salvo ter o nome no formato nfe-nnnnnn-ss.pdf,
Pgina 41
UniDANFe verso 3.x
2010
onde nnnnnn o nmero da NF-e e SS a srie; e Manter o nome original, onde o arquivo XML manter seu nome tal qual foi gerado pelo sistema ERP.
Pgina 42
UniDANFe verso 3.x

Grupo Ramos Especficos
2010
Permite configuraes especficas para cada ramo de atividades, de acordo com a nomenclatura prpria do SEFAZ. Opo Medicamentos
Em caso de DANFE de medicamentos, possvel configurar no UniDANFe quais informaes dos produtos devem ser impressas logo abaixo a descrio do produto, na mesma coluna. O UniDANFe imprimir apenas os campos que estiverem marcados. No exemplo acima, apenas a data de fabricao do produto no ser impressa.
Pgina 43
UniDANFe verso 3.x

Opo Veculos Novos
2010
Em caso de DANFE de veculos novos, possvel configurar no UniDANFe quais informaes dos produtos devem ser impressas logo abaixo a descrio do produto, na mesma coluna. O UniDANFe imprimir apenas as TAGs que estiverem configuradas no campo detalhamento. Gerar detalhamento automtico para veculos novos Se marcado esse campo, e se houver, no XML principal, a informao das TAGs especficas para veculos novos, as mesmas sero impressas no DANFE, de acordo com a formatao contida no campo detalhamento. Posio do detalhamento Posio, aps a impresso da linha do produto, onde o detalhamento deve ser impresso no DANFE, podendo ser Antes das informaes adicionais do produto ou Aps as informaes adicionais do produto. Detalhamento Formatao da descrio especfica do veculo novo. Para adicionar TAGs, basta clicar no boto correspondente presente no grupo TAGs disponveis e em seguida, colar o contedo da rea de transferncia (clipboard) no campo detalhamento, na posio desejada. Adicionar rtulos Se esse campo estiver marcado, ao clicar nos botes correspondentes s TAGs, alm do nome da TAG, o UniDANFe coloca na rea de transferncia tambm uma breve descrio sobre a TAG. Informaes adicionais Alm das TAGs presentes no arquivo XML principal, possvel incluir outras informaes no previstas juntamente ao detalhamento do veculo novo. Para tanto, basta adicionar a TAG <infAdVeic> no arquivo XML auxiliar, no grupo <produtos>. Para maiores informaes, consulte a seo XML auxiliar.
Pgina 44
UniDANFe verso 3.x
2010
Opes Combustveis e Armas de Fogo Buscamos parceiros para desenvolvimento das rotinas especficas para esses ramos de atividades. Caso tenha interesse em colaborar com o projeto queira por favor entrar em contato atravs do endereo unimake@unimake.com.br
Pgina 45
UniDANFe verso 3.x

Grupo Sistema
Opo Informaes de Rodap
2010
possvel personalizar o texto que impresso no rodap do DANFE. Para isso, basta informlo nessa aba.
Pgina 46
UniDANFe verso 3.x
2010
Configurando as Contas de Remetentes e a manuteno de E-mails

Grupo E-mail
Opo Remetentes
possvel configurar mltiplas contas de remetentes de e-mail. O UniDANFe, ao enviar um email, utilizar algumas regras de seleo do remetente, a seguir: 1. Utilizar a conta cujo campo apelido ou email seja igual ao contedo do campo Remetente passado por parmetro na chamada do programa, ao informado na TAG respectiva do arquivo XML auxiliar. 2. Se no satisfeita a regra acima, o UniDANFe utilizar a conta de remetente cujo campo apelido seja igual ao CNPJ do emitente da NF-e em questo. Com esse recurso, pode-se automatizar a escolha dos remetentes para cada emitente, bastando que o CNPJ do mesmo seja informado no campo apelido. 3. Se nenhuma das regras anteriores for satisfeita, o UniDANFe utilizar a conta de remetente padro. O boto Definir como Padro seta a conta selecionada como padro para o envio de e-mails. Os botes Incluir, Alterar e Excluir possibilitam a edio/manipulao de contas de remetentes.
Pgina 47
UniDANFe verso 3.x

Editando Contas de Remetentes
2010
Apelido/Id apelido do remetente de e-mails. Pode ser informado nesse campo qualquer texto que se deseje, como no exemplo acima, ou ainda informar o CNPJ de um emitente de NF-e, para que essa conta de remetente seja automaticamente selecionada quando do envio de e-mails gerados por esse emitente. Os demais campos so auto-explicveis, e devem ser configurados pelo administrador da conta de e-mail correspondente.
Pgina 48
UniDANFe verso 3.x

Opo Manuteno
2010
Permite configurar a manuteno (limpeza) automtica dos e-mails enviados e com erros. Para que o UniDANFe no realize automaticamente a limpeza, configure a opo desejada com o valor 999.
Pgina 49
UniDANFe verso 3.x Configurando o envio de XML de cancelamento
2010
O UniDANFe possibilita o envio, por e-mail, do arquivo XML de cancelamento de NF-e aos respectivos destinatrios. Para tanto, a tela de configurao acima deve ser preenchida. As opes so: Enviar e-mail para o destinatrio automaticamente ao abrir um XML de cancelamento se marcado esse campo, o UniDANFe enviar um e-mail ao destinatrio da NF-e informando do cancelamento da mesma. necessrio que o e-mail do destinatrio seja passado por parmetro no carregamento do UniDANFe para que o envio possa ser efetuado. Anexar o arquivo XML de cancelamento: se marcado esse campo, o XML de cancelamento ser enviado em anexo ao e-mail. Solicitar confirmao de leitura: se marcado esse campo, ser solicitado ao destinatrio do email que este envie de volta uma confirmao de leitura do e-mail. Prioridade dos e-mails enviados: este campo define a prioridade dos e-mails enviados, podendo ser uma das opes: Alta, Normal ou Baixa. Assunto do E-mail Assunto (subject) do e-mail. Podem ser utilizados os campos variveis na composio desse campo; Corpo do E-mail Texto que ser enviado no corpo do e-mail. Podem ser utilizados os campos variveis na composio desse campo; Campos variveis Recurso especial do UniDANFe que permite a personalizao do assunto e do texto do corpo do e-mail. Esses campos so digitados nos campos utilizando-se o delimitador # antes e depois do nome do campo. No momento do envio do e-mail, o UniDANFe substitui automaticamente todos os campos variveis pelo contedo correspondente. Exemplos: #nome_emitente#, #cnpj_emitente#, #numero_nota#, #chave_acesso#, etc.
Pgina 50
UniDANFe verso 3.x
2010
O envio do XML de cancelamento somente se dar atravs de e-mail. No h a impresso de qualquer documento. Para que funcione, necessrio que os seguintes parmetros sejam passados ao UniDANFe no momento do carregamento: Arquivo (obrigatrio) Nome completo do arquivo XML de cancelamento da NF-e, incluindo todo o caminho para encontr-lo. Email (obrigatriol) E-mail do destinatrio da NF-e. PastaConfiguracao (opcional) Pasta onde o UniDANFe deve ler/gravar suas configuraes. Deve ser informado o nome da pasta que ir abrigar as sub-pastas utilizadas pelo UniDANFe, como Dados, Lic, etc. Remetente (opcional) E-mail ou apelido do remetente de e-mail que deve ser utilizado para o envio do DANFE (ou XML) por e-mail. O remetente deve estar previamente cadastrado no sistema. Consulte a seo Configurando as Contas de Remetentes para maiores detalhes. possvel informar o remetente tambm no XML auxiliar ou nas TAGs de uso livre.
O formato de chamada ao UniDANFe, nesse caso, semelhante ao formato para impresso do DANFE.
Exemplo: unidanfe.exe arquivo=c:\novas\canc_00023992342944.xml email=destinatario@dominio.com
Pgina 51
UniDANFe verso 3.x Configurando o DANFEmon Monitor do UniDANFe

Grupo Monitor
Opo Configurar
2010
A partir da verso 2.3.1, o UniDANFe conta com o componente DANFEmon Monitor do UniDANFe. Suas principais funes so a de monitorar uma pasta do HD espera de arquivos XML para imprimir/gerar DANFE automaticamente, fazer backup dos arquivos de configurao do UniDANFe e atualizar automaticamente o UniDANFe e ele prprio, atravs do Autoupdate. Cada uma dessas opes podem ser utilizadas individualmente, no sendo necessrio usar todos os recursos simulteneamente.
Pgina 52
UniDANFe verso 3.x Configuraes de Segurana
2010
Bloquear a impresso e o envio de DANFE sem protocolo de autorizao se desmarcado esse campo, e se o nmero do protocolo de autorizao de uso da NF-e no existir no XML passado ao UniDANFe, este permite apenas que o DANFE seja visualizado, mas no faz sua impresso, envio por e-mail ou upload. Solicitar senha para acessar as configuraes do sistema se marcado esse campo, sempre que o usurio tentar acessar a tela de configurao do sistema, dever antes digitar a senha do administrador. Administrador do Sistema campos com informaes do administrador do sistema. E-mail endereo eletrnico do administrador do sistema, para onde ser enviada o lembrete da senha quando solicitado. Senha Senha do administrador, que dever ser digitada no momento do acesso tela de configurao, desde que o campo Solicitar senha... esteja marcado. Tela de Entrada da Senha
Essa a tela que ser mostrada ao usurio quando este tentar acessar a tela de configurao do sistema.
Pgina 53
UniDANFe verso 3.x Exportando e/ou Importando as Configuraes do UniDANFe

Grupo Transferncias
Opo Exportar
2010
possvel exportar as configuraes do UniDANFe. Esse recurso til quando uma empresa de softwares quer, por exemplo, manter uma cpia da configurao de seus clientes, ou quando quer criar uma configurao nova em seu ambiente de testes para posteriormente enviar ao cliente. Tambm til para enviar configuraes para outros programadores auxiliarem em testes de rotinas. possvel selecionar quais configuraes devem ser exportadas, podendo variar de uma, duas, etc., ou todas. Aps a exportao, um nico arquivo no formato XML gerado na pasta TMP onde o UniDANFe estiver instalado. O nome desse arquivo definido automaticamente pelo UniDANFe, sendo:
unidanfe_config.xml se mais de uma configurao foi exportada ou unidanfe_xxxxx.xml se apenas uma configurao foi selecionada, sendo que xxxxx equivale ao nome da configurao exportada (ex: unidanfe_retrato.xml).
Pgina 54
UniDANFe verso 3.x

Opo Importar
2010
Para importar configuraes anteriormente exportadas pelo UniDANFe, basta selecionar o arquivo XML que contm a importao e clicar no boto Importar.
Pgina 55
UniDANFe verso 3.x Imprimindo uma Rgua para Configurao dos Campos
2010
Para configurar corretamente a largura de todos os campos da linha de detalhe dos produtos do DANFE, bem como a altura dessa mesma linha, necessrio que seja impressa, na mesma impressora onde o DANFE ir ser emitido, a rgua auxiliar, contendo mtricas horizontais e verticais. Para tanto, basta clicar em qualquer dos botes Imprimir Rgua que aparecem nas diversas abas da tela de configuraes do UniDANFe, ou executar o mesmo passando o parmetro Regua=1.
Exemplo: c:\Unimake\UniNFE\Unidanfe.Exe Regua=1
Nesse caso, aps ser questionar qual impressora deve ser usada na impresso, o UniDANFe gera e imprime uma rgua parecida com a imagem abaixo:
Exemplo parcial de rgua auxiliar gerada pelo UniDANFe
Pgina 56
UniDANFe verso 3.x Gerenciando Licenas do UniDANFe Plus
2010
Cada emitente de NF-e que pretenda utilizar o UniDANFe Plus para imprimir ou enviar por email a seus clientes o DANFE, deve adquirir a licena correspondente. Caso um mesmo sistema ERP integrado emita, em uma s instalao de seu sistema e/ou do UniDANFe Plus, NF-es de diversos emitentes, como por exemplo as diversas filiais de uma mesma empresa instalada em uma rede de computadores, deve adquirir uma licena especfica para cada CNPJ emitente. Para tanto, basta acessar o site http://www.unidanfe.com.br ou executar a interface de licenciamento do UniDANFe Plus, chamando esse sistema com o parmetro Licenciar=1.
Exemplo: c:\Unimake\UniNFE\Unidanfe.Exe Licenciar=1
Interface de Licenciamento
Nessa tela estaro relacionados todos os CNPJs j licenciados, bem como a razo social do emitente. Cada licena , na realidade, um arquivo especfico que contm as informaes do CNPJ licenciado, e estar disponvel na pasta LIC imediatamente abaixo da pasta onde o UniDANFe estiver instalado.
Exemplo: c:\unimake\uninfe\lic
Se houver a necessidade de utilizao do UniDANFe Plus simultaneamente em diversos computadores/redes para a emisso de NF-e para um mesmo CNPJ no necessrio adquirir vrias licenas. O arquivo de licena pode ser copiado livremente para cada computador que far a emisso, sem restries. No entanto, note que um arquivo de licena s funcionar para emitir DANFE emitido pelo CNPJ especfico para o qual foi criado, no sendo possvel sua transferncia.
Pgina 57
UniDANFe verso 3.x
2010
Para acessar o site e adquirir a licena do UniDANFe Plus, basta clicar no boto Comprar outra licena. Aps a aquisio da licena e respectiva baixa efetuada pelo setor financeiro da Unimake, o arquivo contendo a licena para o CNPJ licenciado ser arquivado em nosso servidor de internet, e um e-mail ser enviado para o cliente com o link para download. Em caso de perda desse arquivo, o mesmo pode ser instalado novamente atravs do anexo e instrues contidas no e-mail original enviado pela Unimake. Se esse e-mail j houver se perdido, possvel solicitar o reenvio do arquivo de licena atravs do site http://www.unimake.com.br/loja - na seo Gerenciar licenas. Esse reenvio ser efetuado sem qualquer nus para o cliente. Quando a licena estiver prxima de seu vencimento ser necessrio renov-la. Para tanto, basta utilizar a opo Renovar a licena posicionada. Ateno s seguintes legendas: Licenas em vigor exibe todas as licenas instaladas e que ainda se encontram em vigor. *** arquivo corrompido *** - indica que o arquivo de licena correspondente est corrompido. Nesse caso ser necessrio reinstalar a licena. Licenas da verso 2.x - exibe as licenas do UniDANFe verso 2.x instaladas nessa pasta, mas que no podem ser usadas com a verso 3.x. Se houver necessidade em migrar o software ser necessrio migrar tambm as licenas da verso 2.x. Para conhecer a poltica de migrao e como proceder, basta acessar o endereo: http://www.unimake.com.br/loja/politica_migracao_produto3.php
Pgina 58
UniDANFe verso 3.x Base de Dados e Licenas
2010
As tabelas de dados do UniDANFe que guardam todas as configuraes desse sistema ficam armazenadas na sub-pasta Dados, dentro da mesma pasta onde o UniDANFe estiver instalado.
Exemplo: c:\unimake\uninfe\dados
Tambm as licenas do UniDANFe Plus ficam nessa pasta, na sub-pasta Lic.

Exemplo: c:\unimake\uninfe\lic
possvel alterar a pasta onde a base de dados e as licenas so gravadas, passando o parmetro PastaConfiguracao=<caminho completo> pela linha de comando. Note que deve ser passada a pasta que receber as sub-pastas Dados e Lic, alm de outras.
Exemplo: c:\unimake\uninfe\unidanfe.exe arquivo=2321387239821739128.xml PastaConfiguracao=c:\OutraPasta
de responsabilidade do usurio do UniDANFe providenciar sistema de cpia de segurana (backup) de todo contedo dessa pasta, bem como sua regular execuo. Em nenhum momento a Unimake Softwares ser responsabilizada por qualquer perda dessas informaes, por qualquer motivo que seja. Para facilitar o trabalho de Backups, sugerimos a utilizao do utilitrio DANFE Mon, que realiza tarefas automaticamente em conjunto com o UniDANFe.
Pgina 59
UniDANFe verso 3.x Gerenciando E-mails
2010
Interface de gerenciamento de e-mails
O UniDANFe possibilita o gerenciamento dos e-mails gerados por ele. Para acessar a interface de gerenciamento, acesse o painel de controle do UniDANFe e clique no boto E-mails. Ao gerar um e-mail, o UniDANFe o coloca na pasta A Enviar, e tenta envi-lo imediatamente. Em obtendo sucesso, o transfere para a pasta Enviados. Em caso de falha, o mesmo permanecer ainda na pasta A Enviar at que 50 tentativas de envio sejam realizadas. Aps as tentativas, em caso de insucesso, a mensagem movida para a pasta Com Erro, e o UniDANFe no mais tentar envi-la. As opes dessa interface so: Anexos Consulta os anexos do e-mail. Editar Acessa a tela de edio da mensagem, permitindo alterar os campos Destinatrios, Assunto e Corpo do Texto. Excluir Exclui a mensagem. Erros consulta os erros ocorridos em todas as tentativas de envio. Essa opo pode ser consultada enquanto a mensagem ainda est na pasta A enviar, para saber o motivo de a mesma no ter sado ainda dessa pasta, ou quando a mensagem estiver na pasta Com erro. Ao adentrar pasta Enviados, o histrico de erros da mensagem automaticamente excludo. Enviar Inicia o processo de tentativa de envio dos e-mails da pasta A Enviar. Esse boto, nas abas Enviados e Com erro chama-se Reenviar. Nesses casos, sua funo mover a mensagem posicionada, da pasta Com erro ou Enviados para a pasta A enviar, limpando todo o histrico de erros de tentativas anteriores. Remetentes Acessa a tela de cadastro e configurao dos remetentes de e-mail.
Pgina 60
UniDANFe verso 3.x Layout Do Arquivo XML Principal
2010
O layout do arquivo XML Principal deve ser retirado do Manual de Integrao da NF-e na verso que est em vigor. O manual se encontra no portal da nota fiscal eletrnica. Portal da Nota Fiscal Eletrnica: www.nfe.fazenda.gov.br
Pgina 61
UniDANFe verso 3.x Perguntas Freqentes
2010
Qual arquivo XML devo passar ao UniDANFe? Quando em ambiente de produo, deve-se passar ao UniDANFe o arquivo de distribuio da NF-e, que o arquivo XML que possui ao final de seu nome a string -procnfe.xml. Esse o arquivo que contm as informaes do protocolo de autorizao da NF-e e, portanto, o mesmo que deve ser enviado ao UniDANFe para que este, por sua vez, o envie ao destinatrio atravs de e-mail ou gravando-o em algum servidor de internet via FTP. O que preciso para que o UniDANFe imprima o nmero do protocolo de autorizao de uso? Para que o nmero do protocolo de autorizao de uso seja impresso no DANFE, basta enviar
para o UniDANFe o arquivo XML de distribuio (aquele que termina com procNfe.xml) - esse XML j tem em seu interior as informaes do protocolo e o UniDANFe as imprimir no campo correspondente automaticamente.
Como posso configurar o UniDANFe com margens menores? O UniDANFe possui, em sua configurao, opo para configurar as margens esquerda, direita, superior e inferior do impresso (clique aqui para consultar). Quais os formatos de arquivo de imagem que podem ser utilizados para imprimir o logotipo do emitente no DANFE? So permitidos os formatos BMP, GIF, JPG e TIF. Por que a imagem do logotipo do emitente no impressa do DANFE se ela est definida corretamente nas configuraes? Primeiramente verifique se ela pertence aos formatos permitidos. Caso seja um dos formatos descritos acima, tente abrir o arquivo de imagem com o Paint do Windows e salv-lo novamente. Por razes que desconhecemos, algumas imagens no todas gravadas utilizando-se o Adobe Photoshop ou o Corel Draw ficam com esse problema. Como forar uma quebra de linha (CR+LF) na descrio do produto ou nos campos de informaes complementares? Para forar uma quebra de linha nesses campos basta usar o caractere ponto-e-vrgula ; no ponto onde se deseja a quebra do texto. Existe alguma configurao de computador exigida para executar o UniDANFe? A nica limitao conhecida at o momento com relao configurao de pontos por polegada (ppp) do vdeo. Testes mostraram que arquivos PDF gerados em computadores configurados com valores diferentes de 96ppp (ex: 120ppp) ficam distorcidos. Nesse caso, basta retornar a configurao para 96ppp. Por que h uma edio paga do UniDANFe? Desde o incio a Unimake Softwares criou e tem mantido o projeto UniDANFe, de livre distribuio e utilizao. Esse projeto continua em sua verso Free. Com a implantao do UniDANFe Plus, espera-se um retorno a mdio prazo que possibilite a Unimake dedicar mais tempo ao projeto UniDANFe (Free e Plus), viabilizando-o para a grande comunidade de programadores de nosso pas, implementando as modificaes necessrias impostas pelo SEFAZ ou operacionais, bem como aperfeioando-o e prestando a manuteno de suas rotinas.
Pgina 62
UniDANFe verso 3.x
2010
Os Desenvolvedores Empresas ou Autnomos devero adquirir licenas do UniDANFe Plus para integrarem seus sistemas ERP ele? No. As empresas de desenvolvimento de sistemas ERP e/ou programadores autnomos no necessitam adquirir licenas para implementar a integrao entre o UniDANFe Plus e seus sistemas, nem para efetuar testes de emisso. O UniDANFe Plus no exige licenciamento para emisso de DANFEs em ambiente de homologao (testes). Assim, basta gravar a TAG <tpAmb> do XML principal com o contedo 2 para utiliz-lo sem necessidade de licenciamentos.
Exemplo: <tbAmb>2</tpAmb>
Vale lembrar que os DANFEs emitidos nessa condio no tm validade legal, e que em seu impresso ter a observao Ambiente de Homologao Este documento no tem valor fiscal. possvel instalar a mesma licena do UniDANFe Plus em mais de um computador e/ou rede ao mesmo tempo? Sim. O UniDANFe Plus possui licenciamento para cada CNPJ emitente de NF-e. No entanto, no h qualquer limitao quanto ao nmero de computadores que possam emitir NF-e simultaneamente. Para tanto, basta copiar a licena que fica na sub-pasta Lic da pasta onde a configurao do UniDANFe estiver gravada. Importante destacar que no possvel utilizar uma licena gerada para um CNPJ emitente de NF-e para gerar o DANFE de outro CNPJ/CPF. possvel utilizar uma mesma instalao do UniDANFe para gerar DANFEs emitidos por empresas diferentes? Sim. No h qualquer limitao com relao ao nmero de empresas que utilizam uma mesma instalao do UniDANFe. Todas podem utilizar-se da mesma configurao no UniDANFe, ou ter as suas configuraes especficas. No segundo caso, basta passar o parmetro configuracao=xxxxx ao UniDANFe no momento de sua execuo para informar ao mesmo qual deve ser a configurao utilizada. Tambm possvel automatizar o processo de seleo da configurao correta. Para isso, basta que ao criar as configuraes individuais para cada empresa utilize-se o CNPJ dessa empresa, sem os pontos e traos, no campo Nome da Configurao. Nesse caso, o UniDANFe selecionar automaticamente a configurao baseado no CNPJ do emitente da NF-e em processamento. Com relao s licenas da edio Plus, todas elas devem ser instaladas na mesma pasta LIC sem qualquer prejuzo ao funcionamento do sistema. As configuraes do UniDANFe verso 2.x sero automaticamente importadas para a verso 3.x ? Sim. No haver qualquer perda de informaes na migrao da verso 2.x para a verso 3.x. Ateno ao fato de que, ao instalar a verso 3.x, as configuraes sero convertidas para essa nova verso, no sendo possvel reverte-las verso 2.x novamente. Assim, recomendamos que seja realizado um backup antes da atualizao, de modo a se precaver de possveis problemas futuros. Dessa forma, em havendo problemas na migrao, as informaes da verso anterior podem ser consultadas para a criao na nova verso.
Pgina 63
UniDANFe verso 3.x
2010
Como imprimir o DANFE automaticamente sem abrir a tela de visualizao do DANFE? Na configurao do UniDANFe, grupo Configurao Geral, opo Impresso, desmarque o campo Visualizar a impresso e marque o campo Imprimir automaticamente. Voc pode tambm instruir o UniDANFe a fazer isso atravs dos parmetros passados na linha de comando.
Ex: unidanfe.exe arquivo=1234567890.xml visualizar=0 imprimir=1
possvel enviar o e-mail para o destinatrio da NF-e mesmo utilizando-se a edio Free do UniDANFe? Sim. Ambas as edies do UniDANFe enviam a imagem do DANFE e o XML da NF-e por e-mail ao destinatrio, desde que configurado corretamente para isso. Contudo, h que se considerar que a edio Free do UniDANFe envia a imagem do DANFE no formato DNF que pode ser aberto e visualizado utilizando-se o DANFE View Free ou Plus, enquanto que a edio Plus a envia no formato PDF que pode ser aberto e visualizado utilizando-se o Acrobat Reader ou qualquer outro sistema similar. Para conhecer todas as diferenas das edies Free e Plus do UniDANFe queira por favor consultar o site http://www.unidanfe.com.br. Como enviar e-mails automaticamente pelo UniDANFe sem abrir a tela de visualizao do DANFE? Siga os passos: a) Na configurao do UniDANFe, grupo Configurao Geral, opo Impresso, desmarque o campo Visualizar a impresso; b) Na mesma configurao, grupo E-mail, opo Envio de e-mail, marque o campo Enviar e-mail automaticamente. c) Escolha uma das trs formas de passar o endereo eletrnico do destinatrio para o UniDANFe: Atravs da linha de comando, ao carregar o UniDANFe (veja como) Atravs de uma TAG no XML Auxiliar (veja como) Atravs de uma TAG no XML Principal (veja como) Como funciona o envio de e-mails pelo UniDANFe? Sempre que o UniDANFe estiver configurado para enviar e-mails automaticamente, e o endereo de e-mail do destinatrio for informado, um e-mail com o texto e anexos configurados ser criado e colocado na pasta A Enviar. Aps concluir todos os processos envolvidos na gerao do DANFE (impresso, gerao do e-mail, cpia do XML e/ou PDF em uma pasta local ou da rede, envio para FTP, etc.), a instncia atual do unidanfe.exe que estiver sendo executada encerrada, liberando o aplicativo chamador (ERP), ao mesmo tempo em que uma nova instncia do unidanfe.exe criada em background, para enviar todos os e-mails da pasta A Enviar. Se j houver uma instncia criada anteriormente e enviando e-mails, a nova instncia no ser criada, ficando apenas uma enviando e-mails, para no esgotar os recursos do computador. Caso algum problema acontea durante o envio do e-mail (conexo SMTP, falha na internet, etc.), um contador interno de erros incrementado no e-mail, e a mensagem do erro gravada, podendo ser consultada pelo boto Erros da interface de gerenciamento dos e-mails disponvel no painel de controle do UniDANFe. Aps 50 tentativas fracassadas de envio, o e-mail automaticamente movido para a pasta Com Erros, onde
Pgina 64
UniDANFe verso 3.x
2010
permanecer at que seja excluda pelo administrador do sistema, ou at que seja movida novamente para a pasta A Enviar, ao executada quando se seleciona a mensagem desejada e clica-se no boto Reenviar. Aps o UniDANFe ser fechado, o mesmo permanece em execuo por mais algum tempo em background, podendo ser visto no Gerenciador de Tarefas do Windows. O que ele est fazendo? Enviando e-mails. Consulte o item Como funciona o envio de e-mails pelo UniDANFe acima para maiores informaes. Os e-mails gerados pelo UniDANFe ficam presos na pasta A Enviar. Mesmo clicando no boto Enviar eles no so enviados. Qual o problema? Isso acontece pelo fato de o UniDANFe no conseguir enviar. Para descobrir o motivo, clique em alguma das mensagens presas nessa pasta e em seguida clique no boto Erros. Ser possvel conhecer a mensagem de erro gerada no momento da tentativa de envio do e-mail.
Por que os e-mails gerados pelo UniDANFe esto indo parar na pasta Com erros? Sempre que um novo e-mail criado, o UniDANFe faz cinqenta tentativas de envios. Se todas elas resultarem em erro, ele automaticamente move esse e-mail para a pasta Com erros para que o administrador do sistema possa tomar as providncias cabveis. Aps corrigir o problema, pasta selecionar as mensagens dessa pasta e clicar no boto Reenviar e as mesmas voltam pasta A Enviar Como enviar e-mails para mais de um destinatrio simultaneamente? Em todos as formas de informar ao UniDANFe qual o e-mail do destinatrio, para se informar mais de um endereo basta pass-los ao UniDANFe de uma s vez separados por um ponto-evrgula. Como enviar e-mail com informaes de cancelamento de NF-e para o destinatrio? H trs formas de fazer isso: 1) enviar ao destinatrio a imagem do DANFE em formato PDF/DNF com a inscrio CANCELADA no corpo do mesmo, 2) enviar a imagem do DANFE e junto enviar o XML de cancelamento em anexo, ou 3) enviar apenas o XML de cancelamento. Em nenhum dos casos o XML da NF-e enviado junto ao e-mail, anexado. Todas as formas exigem que alguns parmetros adicionais sejam passados na linha de comando, na chamada ao UniDANFe, conforme segue: 1) Enviando a imagem do DANFE com a inscrio CANCELADA impressa no corpo:
unidanfe.exe arquivo=nome-do-xml-da-nfe.xml cancelada=1 email=emaildestinatario@dominio.com
2) Enviando a imagem do DANFE e o XML de cancelamento em anexo:

unidanfe.exe arquivo=nome-do-xml-da-nfe.xml anexo1=nome-do-xml-de-cancelamento.xml cancelada=1 email=emaildestinatario@dominio.com
3) Enviando apenas o XML de cancelamento como anexo:

Unidanfe.exe arquivo=nome-do-xml-de-cancelamento.xml email=emaildestinatario@dominio.com
Pgina 65
UniDANFe verso 3.x
2010
O arquivo PDF gerado pelo UniDANFe aparece deformado ou desconfigurado, mesmo quando a impresso do DANFE sai perfeita. Como resolver? Esse problema ocasionado por incompatibilidade com o driver da impressora usada no momento da gerao do PDF, geralmente drivers instalados partir da biblioteca do Windows. Para resolver, tente um dos seguintes recursos: 1. Remova a impressora e baixe o driver original da mesma, direto do site do fabricante, e proceda sua reinstalao; 2. Utilize outro driver de impressora para gerar o PDF. Veja como na seo Opes de PDF, quadro Resoluo de problemas.
Perdi o arquivo de licena do UniDANFe. Como devo proceder? possvel solicitar o reenvio da licena perdida. Para tanto visite o site http://www.unimake.com.br/loja e faa seu login. Logo aps acesse a seo Gerenciar licenas e localize a licena que deseja seja reenviada, clicando a seguir na opo Reenvieme correspondente.
Pgina 66
UniDANFe verso 3.x Controle de Atualizaes do Software
2010
Na tabela abaixo esto contempladas as ltimas modificaes efetuadas nesse sistema, em ordem cronolgica. Data Verso Histrico
01/03/2010 01/04/2010 3.0.1 3.0.2 Lanamento da verso. Criado configurao para alterar o tamanho da fonte da placa do veculo, no quadro Transportador / Volumes... Criado configurao para imprimir o canhoto em todas as folhas do DANFE. Criado opo para imprimir cdigo de barras com identificao da NF-e (CNPJ+Nmero) no canhoto do DANFE. Painel de Controle: criado opo de gerenciamento/visualizao dos arquivos presos na pasta Upload, permitindo ver a mensagem de erro gerada no momento da tentativa de envio anterior. Configurao de FTP: criado boto com opo para testar a conexo (ping) com o servidor FTP, e para testar o upload de um arquivo de teste. Impresso/gerao de PDF do DANFE retrato e paisagem: foram corrigidos alguns descritivos de campos que eram impressos truncados. Configurao do quadro Fatura / Duplicata: criado opo para que o UniDANFe Plus no redimensione a altura do quadro para reaproveitamento de espaos no ocupados. Quadro Transportador/Volumes criado sistema interno de distribuio dos campos quantidade, espcie, marca, peso bruto e peso liquido proporcionalmente rea ocupada por casa um deles, de modo a maximizar as informaes impressas. Em caso de necessidade, o sistema adiciona automaticamente uma linha extra aos campos. Criado configurao para escolher quais informaes adicionais devem ser impressas na declarao de recebimento, no canhoto do DANFE. Alterada a forma de abertura do arquivo de licena, passando a abrir sempre em modo Somente leitura. Criado configurao para solicitar confirmao de leitura de e-mails enviados. Criado configurao para selecionar a prioridade dos e-mails enviados: alta, normal ou baixa. Atualizao da verso Corrigido bug na consulta aos anexos dos e-mails enviados/a enviar/com erros. Cadastro de contas de e-mail: retirado obrigatoriedade em informar a senha da conta em virtude de haver contas sem senhas em intranets Criado configurao para definir o texto do campo Identificao e assinatura do recebedor Criado configurao para selecionar o nmero de canhotos que devem sem impressos no mesmo DANFE. Default=1 Corrigidos bugs na gerao do DANFE com colunas adicionais (plus). Criado sistema de envio de XML de cancelamento por e-mail. Criado configurao para imprimir o e-mail do remetente no quadro Identificao do Emitente. Default=Sim Configurao de remetentes de e-mail: criado campo Endereo de resposta para configurar o endereo para o qual as respostas aos e-mails emitidos devam ser direcionadas. Criada TAG <dSaiEnt> no XML auxiliar para informao da data da sada/entrada. Criado opo para imprimir a palavra CANCELADA no corpo do DANFE, na diagonal. Criado opo para configurar a cor com que a palavra CANCELADA ser impressa do DANFE. Default=Cinza Tela de Gerenciamento de Licenas: includo visualizao de arquivos de licenas corrompidos, e de arquivos de licenas da verso 2.x Corrigido descrio de anexos no e-mail enviado pelo UniDANFe, quando se tratar de arquivos externos. Criado opo para gerar margem extra ao imprimir DANFE em formulrios de segurana (FS e FS-DA), de modo a no sobrepor o selo. Novas perguntas/respostas adicionadas seo Perguntas Freqentes
13/04/2010 20/04/2010
3.0.3 3.0.4
20/04/2010 29/04/2010 03/05/2010
3.0.5 3.0.6 3.0.7
13/05/2010
3.0.8
04/06/2010
3.0.9
Pgina 67
UniDANFe verso 3.x

21/06/2010 3.0.10
2010
Corrigido a mscara de formatao da Inscrio Estadual da Bahia. Corrigido bug no envio de XML de cancelamento, que fazia com que alguns XMLs no fossem reconhecidos pelo sistema. Criada opo de segurana para solicitar senha de acesso tela de configurao do sistema. Criada opo de segurana para impedir a impresso e/ou envio do DANFE sem o protocolo de autorizao.
Pgina 68

Nfe UniDANFe3

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Nfe UniDANFe3

Uploaded by

Copyright:

Available Formats

UNIMAKE SOFTWARES 999) perSub(Exporta:Linha, Rot:Pos,

UniDANFe verso 3.x

UniDANFe verso 3.x Tpicos deste documento

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x Sobre o UniDANFe

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x Utilizando o UniDANFe

a) Carregando o UniDANFe sem passar parmetros

Tela do Painel de Controle do UniDANFe

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x

Ao carregar o UniDANFe com o parmetro configurar=1 a interface administrativa de configurao apresentada.

c) Acessando o Gerenciador de Licenas do UniDANFe

d) Consultando a verso/release do UniDANFe

e) Consultando e-mails a enviar, enviados ou com erros

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x

f) forando o envio dos e-mails presos na caixa a enviar

g) Carregando a tela de configurao de contas de e-mail (remetentes)

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x

i) Gerando o DANFE Atravs de Parmetros da Linha de Comando

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x

unidanfe.exe unidanfe.exe unidanfe.exe unidanfe.exe

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x Executando o UniDANFe a Partir de Uma Aplicao ERP

cComando = [c:\unimake\uninfe\unidanfe.exe arquivo=c:\unimake\uninfe\51080662675686000166550010000001041671821888nfe.xml arquivoauxiliar=c:\unimake\uninfe\51080662675686000166550010000001041671821888-nfedanfe.xml configurao=PAISAGEM] RUN(cComando)

Exemplo de chamadas ao UniDANFe atravs de programao na linguagem Harbour/xHarbour:

Exemplo de chamadas ao UniDANFe atravs de programao na linguagem VB6:

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x XML Auxiliar

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x Estrutura do XML auxiliar

Com exceo das tags <?xml> e <outrasInfDanfe>, todas as outras so opcionais.

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x Campos no previstos no XML Principal

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x Configurando o UniDANFe

Ao executar o comando acima, a seguinte interface ser exibida:

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x

Unimake Softwares Solues Corporativas

UniDANFe verso 3.x Editando as Configuraes do UniDANFe

Ao clicar em Incluir ou Alterar, o UniDANFe apresenta a seguinte tela de configurao:

Editando as configuraes do UniDANFe

Unimake Softwares Solues Corporativas