UniDANFE/Integrando o UniDANFE ao ERP/Gerar documento auxiliar

Gerar, Imprimir e Distribuir os Documentos Auxiliares

Essa é a forma normal que os sistemas ERP usarão para gerar o Documento Auxiliar (DANFE, o DACTE, etc). O UniDANFE deve ser executado com a passagem de alguns parâmetros que o orientarão como se comportar.

Cada parâmetro é descrito a seguir, e devem ser utilizados no formato parametro=conteúdo, sem qualquer espaço entre o parâmetro, o sinal de igualdade e o conteúdo do mesmo. Os parâmetros cujo conteúdo possa conter espaços (ex: nome de pastas e/ou arquivos) devem estar entre aspas, no formato parametro=“conteúdo completo com espaços”.

Cada parâmetro pode ser usado em sua forma abreviada, que é apresentada entre chaves {}. Recomenda-se usá-los dessa forma para que a linha de comando fique menor. Por exemplo, use: unidanfe.exe a=”c:\nfe\minhanota.xml” no lugar de unidanfe.exe arquivo=”c:\nfe\minhanota.xml”

Imprimir (opcional) – {m} – aceita os valores “0” para falso” ou “1” para verdadeiro; informa ao UniDANFE se o DANFE, DACTE ou CC-e deve ser impresso automaticamente ou não. Se informado, esse parâmetro se sobrepõe às configurações efetuadas no painel de controle do UniDANFE. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” v=0 m=1 // imprimir sem visualizar Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” v=1 m=0 // visualizar sem imprimir Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” v=0 m=0 // envia e-mail sem visualizar ou imprimir Impressora (opcional) – {i} – aceita os valores “padrao", “selecionar” ou “<nome completo da impressora>”; se informado o valor “padrao", o impresso será enviado para a impressora padrão do computador; se informado “selecionar”, uma tela será exibida ao usuário antes da impressão, para que este selecione a impressora correta; se informado o nome de uma impressora instalada, o UniDANFE imprimirá o documento desejado nessa impressora. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” i=“\\SERVER\HPLASERJET1001” Copias (opcional) – {p} – aceita qualquer valor acima de zero; informa ao UniDANFE quantas cópias devem ser impressas do documento gerado. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” v=0 i=1 p=3 // imprimir 3 cópias, sem visualizar Buffer (opcional) – {p} – aceita qualquer valor acima de zero; informa ao UniDANFE quantas cópias devem ser impressas do documento gerado. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” v=0 i=1 p=3 // imprimir 3 cópias, sem visualizar PastaPDF (Plus) (opcional) – {pp} – Informa ao UniDANFE a pasta onde devem ser gravados os arquivos PDF com a imagem do DANFE, DACTE, DAMDFE ou CC-e gerados automaticamente pelo sistema, quando para isso configurado. Esse parâmetro sobrepõe a pasta definida na configuração do UniDANFE. A pasta informada nesse parâmetro deve existir previamente. O nome do pdf será criado respeitando-se as regras definidas na configuração do UniDANFE. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” pp=“c:\meus_pdfs” NomePDF (Plus) (opcional) – {np} – Instrui o UniDANFE como deve ser o nome do arquivo PDF com a imagem do DANFE, DACTE ou CC-e gerado automaticamente pelo sistema, quando para isso configurado. Esse parâmetro sobrepõe a regra de construção do nome definida na configuração do UniDANFE. Pode ser passado apenas o nome ou o nome incluindo o caminho completo (pastas). Nesse caso, o caminho (pasta) já deve existir previamente. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” np=“c:\meus_pdfs\01010101010.pdf” ImagemAdicional (opcional) – {ia} – Nome completo, incluindo o caminho, de uma imagem para ser impressa no rodapé da seção “DADOS ADICIONAIS”, dentro do quadro “Informações Complementares”. Válido apenas para impressão do DANFE de NF-e em orientação RETRATO. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” ia=“c:\imagens\info.bmp” AlturaImagemAdicional (opcional) – {iaa} – Altura, em milésimos de polegadas, com que a imagem adicional vai ser impressa. Essa altura será adicionada ao quadro “Dados Adicionais”. Se omitido, o valor padrão 1000 (aproximadamente 25mm) é assumido. Válido apenas para impressão do DANFE em orientação RETRATO. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” ia=“c:\imagens\info.bmp” iaa=650 SaidaErros (opcional) – {s} – aceita os valores “V” para vídeo ou “A” para arquivo; define onde devem ser geradas as possíveis mensagens de erro do sistema. Útil para os casos em que a impressão e envio por e-mail do DANFE, DACTE ou CC-e seja configurada para ser executada automaticamente sem a intervenção de usuários. Se SaidaErros=A e o parâmetro ArquivoErros for omitido, ArquivoErros será o mesmo nome do XML acrescido da extensão “.err”. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” s=V Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” s=A ArquivoErros (opcional) – {ae} – define o nome do arquivo que vai receber os erros ocorridos durante a geração do DANFE, DACTE ou CC-e, se houver. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” s=A ae=“c:\erros\meus_erros.txt” Remetente (opcional) – {r} – E-mail ou apelido do remetente de e-mail que deve ser utilizado para o envio do documento auxiliar (ou XML) por e-mail. O remetente deve estar previamente cadastrado no sistema mesmo quando este parâmetro contiver um endereço eletrônico (e-mail) pois outras informações são necessárias para o envio do e-mail, como servidor smtp, porta, senha, etc. É possível cadastrar remetentes informando o CNPJ do emitente no campo “Apelido” para que o mesmo seja selecionado automaticamente. Consulte a seção “Configurando as Contas de Remetentes” para maiores detalhes. É possível informar o remetente também no XML auxiliar ou nas TAG´s de uso livre. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” r=FATURAMENTO Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” [email protected] IgnorarEmailXML (opcional) – {iex} – instrução para que o UniDANFE ignore endereços de e-mail dos destinatários presentes nos arquivos XML principal e auxiliar. Os valores aceitos são: “0” = não ignora nenhum dos e-mails presentes nos XMLs; “1” – ignora a TAG <email> presente no XML principal da NF-e 2.0 em diante; “2” – ignora os e-mails informado na TAG <obsCont> do XML principal, atributos Email_Destinatario, Email_CC e Email_CCO; “3” – ignora os e-mails informados no XML auxiliar, nas TAGs <EmailDest>, <EmailCC> e <EmailCCO> NOTA 1: com exceção do valor “0”, todos os outros podem ser combinados num mesmo parâmetro. Ex: UniDANFE.exe a=0101010.xml iex=1 Ex: UniDANFE.exe a=0101010.xml iex=23 Ex: UniDANFE.exe a=0101010.xml iex=13 Ex: UniDANFE.exe a=0101010.xml iex=123 NOTA 2: o valor “2” não se aplica à emissão de CC-e. Delete (opcional) – {DL} – Instrui o UniDANFE se este deve deletar (excluir) os arquivos XML envolvidos na geração do documento auxiliar após o término do processo. Se passado o valor “1”, os XML´s serão deletados no final. Qualquer outro valor instrui o UniDANFE a não deletar qualquer arquivo XML. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” DL=1 ImprimirProdutos (opcional) – {iqp} – aceita os valores “0” para falso” ou “1” para verdadeiro; informa ao UniDANFE se o impresso gerado deverá conter a seção/divisão “Detalhe” dos produtos. Específico para DANFE de NFC-e e extrato SAT. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” iqp=0 Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” iqp=1 ITT (opcional) – {itt} – indica ao sistema se deve imprimir ou não o Valor Aproximado de Tributos (Lei da Transparência Fiscal). Aceita os valores “0” para falso” ou “1” para verdadeiro. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” itt=0 Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” itt=1 ITTP (opcional) – {ittp} – indica ao sistema se deve imprimir ou não o Valor Aproximado de Tributos do Produto (Lei da Transparência Fiscal). Aceita os valores “0” para falso” ou “1” para verdadeiro. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” ittp=0 Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” ittp=1 TextoMarcaDagua (opcional) {tmd} – texto a ser impresso como marca d´água do documento. CorMarcaDagua (opcional) {cmd} – cor do texto a ser impresso como marca d´água do documento. PosYMarcaDagua (opcional) {ymd} – posição inicial (vertical) da impressão do texto de marca d´água. Ex: unidanfe.exe a=“001.xml” tmd=”Texto para a marca d´água” cmd=”#cc0000” ymd=180 Cancelada (opcional) – {cc} – aceita os valores “0” para falso ou “1” para verdadeiro. Esse parâmetro indica ao UniDANFE se este deve imprimir a palavra “CANCELADA” no corpo do documento auxiliar, na diagonal. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” CC=1 TextoDiagonal (opcional) – {td} – Texto a ser impresso na diagonal, no corpo do documento. Aceita qualquer texto e quando informado, sobrepõe qualquer outro texto definido pelo sistema. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” TD=”Texto para ser impresso” Exemplo (NF-e): c:\unimake\uninfe\UniDANFE.exe T=danfe a=“\\meuservidor\c\pasta_xml\0102012.xml” pc=“x:\unimake\uninfe” L=”c:\imagens\logotipo_filial_001.jpg” v=0 i=1 p=2 [email protected] Exemplo (CC-e): c:\unimake\uninfe\UniDANFE.exe T=cce A=“c:\minhapasta\010101010101-01-procEventoNFe.xml” N=“c:\minhapasta\010101010101-procNFe.xml” Exemplo (CT-e): c:\unimake\uninfe\UniDANFE.exe T=dacte A=“c:\minhapasta\010101010101-provCTe.xml” Pasta_Local_QRCode(Plus) (opcional) – {plq} – pasta local ou da rede para onde a imagem do QR Code gerada (ex: na NFC-e) deve ser copiada. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” plq=”c:\meu_erp\imagens\qrcode” ComprovanteTEF<n> (opcional) – {ct<n>} – nome do arquivo, incluindo o caminho completo, dos arquivos de texto cujo conteúdo deverão ser impressos no final do DANFE de NFC-e e Extrato SAT, onde <n> é um número de 1 a 9. Pode-se utilizar arquivos textos normais, cujo conteúdo será integralmente impresso, ou os próprios arquivos de resposta de venda gerados pelos sistemas de transmissão de TEF. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” t=NFC-e ct1=tef001.res ct2=tef002.res ImprimirApenasComprovanteTEF (opcional) – {iact} – aceita os valores “0” para falso” ou “1” para verdadeiro; indica ao sistema que deverão ser impressos apenas os comprovantes TEF passados na lista anterior (ct1 a ct9), não sendo impresso o DANFE/Extrato. NOTA 1: quando esse parâmetro é informado com o valor “1”, apenas a visualização e/ou impressão é realizada, não sendo executadas outras operações como enviar e-mail, gerar pdf, salvar xml, etc. Nesse caso pode-se omitir o parâmetro “arquivo”. Ex: unidanfe.exe a= t=NFC-e ct1=tef001.res ct2=tef002.res iact=1 Forçando Uma Edição Específica do UniDANFE Caso tenha necessidade de executar o UniDANFE em uma edição específica (Plus ou Free), você pode adicionar o parâmetro “d” à linha de comando. Exemplo: UniDANFE.exe arquivo=0100202020202.xml d=Free NOTA 1: ao usar o parâmetro edição=Plus, é necessário ter a licença correspondente para que a geração funcione como desejado. Passando arquivos externos para serem anexados ao e-mail enviado ao destinatário 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 parâmetro, no máximo cinco, no seguinte formato: UniDANFE.exe arquivo=”12313123213.xml” anexo1=”c:\pasta\arquivo1.ext” anexo2=”y:\xyxyxy.txt” Abreviando a Linha de Comando ao Carregar o UniDANFE

Parâmetro	Abrev	Descrição	Exemplos
Arquivo*	a	Nome completo do arquivo XML do Documento Fiscal Eletrônico, CC-e ou Cancelamento, gerado pelo ERP, incluindo todo o caminho para encontrá-lo. Esse arquivo deve ser o XML de distribuição já autorizado pela SEFAZ (procNFe, procCTe, procMDFe, procEventoNFe, etc).	..\unidanfe.exe a="c:\minha pasta\0101010101010-procNFe.xml"
Tipo	t	Indica ao UniDANFE qual o tipo do XML passado pelo parâmetro “arquivo”. As opções válidas são: “danfe”, “nfe” ou “nf-e” “ds” ou “danfesimplificado” “nfce” ou “nfc-e” “dacte”, “ct-e” ou “cte” “dacteos”, “ct-e os” ou “cteos” “damdfe”, “mdf-e” ou “mdfe” “cce” (para CC-e de NF-e) “ccdse” ou “ccds-e” (para CC-e de NF-e - Simplificada) “ccte” (para CC-e de CT-e). “sat” ou “cfe” ou “cf-e” Se omitido esse parâmetro, o UniDANFE abrirá o arquivo XML para saber do que se trata, ocasionando um pequeno atraso no processamento. Além disso, no caso de CC-e de NF-e, não há como identificar pelo XML se o mesmo se refere a DANFE simplificado ou não.	...\unidanfe.exe a="c:\minhapasta\01010101010-procNFe.xml" t=nfe ...\unidanfe.exe a="c:\minhapasta\01010101010-procNFe.xml" t=ds ...\unidanfe.exe a="c:\minhapasta\01010101010-procNFe.xml" t=nfce ...\unidanfe.exe a="c:\minhapasta\01010101010-procCTe.xml" t=cte ...\unidanfe.exe a="c:\minhapasta\01010101010-procMDFe.xml" t=mdfe ...\unidanfe.exe a="c:\minhapasta\CFe01010101010.xml" t=sat
ArquivoAuxiliar	au	Nome completo do arquivo XML auxiliar, incluindo todo o caminho para encontrá-lo. No XML auxiliar existem TAGS complementares para o UniDANFE, com algumas personalizações. Se esse parâmetro não for passado, o UniDANFE procurará, na mesma pasta do XML principal, um outro arquivo XML com o mesmo nome, precedido do texto “aux-”. Se encontrar tal arquivo, o usará como auxiliar, sem a necessidade de passar seu nome na linha de comando.	...\unidanfe.exe a="c:\x\0101-procNFe.xml" au="c:\x\aux-0101-procNFe.xml"
ArquivoEPEC	ad	Nome completo, incluindo todo caminho, do arquivo XML que contém as informações do registro do EPEC. A informação desse arquivo é obrigatória quando necessitar imprimir DANFE de NF-e ou DACTE de CT-e emitido em contingência EPEC antes de sua autorização. O UniDANFE não gerará o Documento Auxiliar em contingência EPEC sem conferir as informações desse arquivo XML. Após a normalização do serviço, quando o XML da NF-e ou do CT-e já contiver o protocolo de autorização de uso, esse parâmetro deixa de ser necessário.	...\unidanfe.exe a="c:\x\0101-procNFe.xml" ad="c:\x\0101-dpec.xml"
NFe	n	Parâmetro utilizado apenas para impressão da Carta de Correção Eletrônica. Indica ao UniDANFE o nome completo, incluindo todo o caminho, do arquivo XML da NF-e, NFC-e, CT-e ou MDF-e que está sofrendo correção. Quando esse parâmetro é informado, o UniDANFE vai buscar informações relativas ao emitente, destinatário, remetente, expedidor, recebedor, etc., nesse arquivo XML. Quando esse parâmetro é omitido, o UniDANFE busca primeiramente em sua base de dados essas informações e, em não as localizando, procura pelo XML da NF-e/CT-e na mesma pasta do XML do evento da CC-e, nos padrões “chavedeacesso-procXXX.xml” e “chavedeacesso-XXX.xml”, onde XXX=NFe ou CTe, conforme o caso.	...\unidanfe.exe a="c:\x\0101-1-procEventoNFe.xml" n="c:\x\0101-procNFe.xml"
Configuracao	c	Nome da configuração que será utilizada para gerar o Documento Auxiliar. Se esse parâmetro não for passado, o UniDANFE tentará localizar a configuração ideal automaticamente. Clique aqui para conhecer os critérios de escolha automática da configuração. Atenção: Para esse parâmetro funcionar é necessário que a configuração passada tenha sido previamente cadastrada no UniDANFE.	...\unidanfe.exe a="c:\x\0101-procNFe.xml" c=RETRATO ...\unidanfe.exe a="c:\x\0101-procNFe.xml" c=PAISAGEM ...\unidanfe.exe a="c:\x\0101-procNFe.xml" c=APENAS_GERAR_PDF ...\unidanfe.exe a="c:\x\0101-procNFe.xml" c=APENAS_UPLOAD ...\unidanfe.exe a="c:\x\0101-procNFe.xml" c=APENAS_EMAIL ...\unidanfe.exe a="c:\x\0101-procNFe.xml" c=APENAS_VISUALIZAR
Email	e	Endereço de e-mail adicional para envio ao destinatário do Documento. Esse e-mail deve ser informado nos casos em que o XML do documento não tenha TAGS específicas para isso - como XML de CC-e e Cancelamento - ou quando deseja-se enviar o Documento para um endereço diferente. O e-mail também pode ser gerado no XML auxiliar, ao invés de passado por parâmetro.	...\unidanfe.exe a=“c:\x\0101-procNFe.xml” [email protected] ...\unidanfe.exe a=“c:\x\0101-procNFe.xml” e=“[email protected],[email protected]”
EmailCC	ec	Endereço para o qual o Documento e/ou o XML serão enviados como cópia (CC).	...\unidanfe.exe a=“c:\x\0101-procNFe.xml” [email protected] [email protected]
EmailCCO	eo	Endereço para o qual o Documento e/ou o XML serão enviados como cópia oculta (CCO).	...\unidanfe.exe a=“c:\x\0101-procNFe.xml” [email protected] [email protected]
EnviaEmail	ee	Informa ao UniDANFE se o impresso gerado deverá ser enviado por e-mail ou não. 1=Sim 0=Não. Se informado, esse parâmetro se sobrepõe às configurações efetuadas no painel de controle do UniDANFE.	...\unidanfe.exe a=“c:\x\0101-procNFe.xml” ee=0 ...\unidanfe.exe a=“c:\x\0101-procNFe.xml” ee=1
PastaConfiguracao	pc	Define a pasta local ou da rede onde o UniDANFE deve ler/gravar suas configurações. Deve ser informado o nome da pasta principal que irá abrigar as subpastas (dados, email, lic, etc) utilizadas pelo UniDANFE, geralmente a mesma pasta onde o arquivo executável do UniDANFE foi instalado.	...\unidanfe.exe a=“c:\x\0101-procNFe.xml” pc=“Y:\unimake\uninfe” ...\unidanfe.exe a=“c:\x\0101-procNFe.xml” pc=“\\SERVER01\G\unimake\uninfe”
Logotipo	L	Nome da imagem, incluindo seu caminho completo, que será usada na geração do Documento Auxiliar. Há um campo específico da interface de configuração do UniDANFE para informar esse arquivo de imagem. No entanto, em alguns casos, deseja-se utilizar uma mesma configuração para mais de uma empresa/filial. Para esses casos, pode-se passar a imagem através da linha de comando, ou informá-la no XML auxiliar.	...\unidanfe.exe a=“c:\x\0101-procNFe.xml” L=“c:\imagens\img01.jpg”
Visualizar	v	Informa ao UniDANFE se o Documento Auxiliar gerado deverá ser visualizado na tela do computador antes da impressão/envio por e-mail. 1=Sim 0=Não. Se informado, esse parâmetro se sobrepõe às configurações efetuadas no painel de controle do UniDANFE.	...\unidanfe.exe a=“c:\x\0101-procNFe.xml” v=0 ...\unidanfe.exe a=“c:\x\0101-procNFe.xml” v=1
Exemplos
...\unidanfe.exe autoupdate=1

(*) Parâmetros obrigatórios

Para economizar o espaço de buffer da linha de comando, o integrador pode optar por utilizar os parâmetros em sua forma abreviada.

Assim, ao invés de fazer uma chamada ao UniDANFE dessa forma: c:\unimake\uninfe\UniDANFE.exe arquivo=“1232378213276.xml” arquivoauxiliar=“746647467474.xml” email=“[email protected]” Faça assim: c:\unimake\uninfe\UniDANFE.exe a=“1232378213276.xml” au=“746647467474.xml” e=“[email protected]”

Exemplo de chamada ao UniDANFE pela linha de comando:

UniDANFE.exe arquivo=“c:\unimake\uninfe\nfe000100-nfe.xml” arquivoauxiliar=“c:\unimake\uninfe\ nfe000100danfe.xml” configuracao=PAISAGEM [email protected] logotipo=“c:\img\filial001.jpg” tipo=danfe

UniDANFE.exe arquivo=“c:\unimake\uninfe\nfe000100-nfe.xml” configuracao=RETRATO

UniDANFE.exe arquivo=“c:\unimake\uninfe\nfe000100-nfe.xml” configuracao=SEM_IPI

UniDANFE.exe a=“c:\unimake\uninfe\nfe000100-nfe.xml” [email protected] [email protected]

UniDANFE.exe arquivo=“c:\unimake\uninfe\nfe000100-nfe.xml” cancelada=1 delete=1