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 na geração.

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”

Parâmetros	Abrev	Descrição
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 XML deve ser o arquivo já autorizado pela SEFAZ (procNFe, procCTe, procMDFe, procEventoNFe, etc., conforme o caso). Ex: unidanfe.exe a=“c:\minhapasta\0101010101010-procNFe.xml” Quando se tratar de cancelamento de NF-e ou CT-e, esse parâmetro deve ser o nome completo do arquivo XML de cancelamento autorizado pela SEFAZ. Nesse caso, o arquivo será enviado por e-mail ao(s) destinatário(s), acompanhados de um impresso informativo de cancelamento, que é opcional.
display	Indica se deve ou não exibir a tela com o status da atualização. 1=Sim 0=Não	xxx
Exemplos
...\unidanfe.exe autoupdate=1

(*) Parâmetros obrigatórios

(obrigatório) – –

Tipo (opcional) – {t} – Se informado, 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.

Ex: unidanfe.exe a=“c:\minhapasta\01010101010-procNFe.xml” t=nfe Ex: unidanfe.exe a=“c:\minhapasta\01010101010-procNFe.xml” t=ds Ex: unidanfe.exe a=“c:\minhapasta\01010101010-procNFe.xml” t=nfce Ex: unidanfe.exe a=“c:\minhapasta\01010101010-procCTe.xml” t=cte Ex: unidanfe.exe a=“c:\minhapasta\01010101010-procMDFe.xml” t=mdfe Ex: unidanfe.exe a=“c:\minhapasta\CFe01010101010.xml” t=sat

ArquivoAuxiliar (opcional) – {au} – 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 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. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” au=“c:\x\aux-0101-procNFe.xml”

ArquivoEPEC (opcional) – {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 DANFE/DACTE 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. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” ad=“c:\x\0101-dpec.xml”

NFe (opcional) – {n} – Parâmetro utilizado apenas para impressão da CC-e – Carta de Correção Eletrônica. Indica ao UniDANFE o nome completo, incluindo todo o caminho, do arquivo XML da NF-e ou do CT-e que está sofrendo correção. Quando esse parâmetro é informado, o UniDANFE vai buscar informações relativas ao emitente e destinatário da NF-e/CT-e 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. Ex: unidanfe.exe a=“c:\x\0101-1-procEventoNFe.xml” n=“c:\x\0101-procNFe.xml”

Configuracao (opcional) – {c} – Nome da configuração que será utilizada para imprimir o DANFE, DACTE, DAMDFE ou CC-e. 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.

Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” c=RETRATO Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” c=PAISAGEM Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” c=APENAS_GERAR_PDF Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” c=APENAS_UPLOAD Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” c=APENAS_EMAIL Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” c=APENAS_VISUALIZAR

Email (opcional) – {e} – E-mail do destinatário do documento (DANFE, DACTE ou CC-e). Esse e-mail deve ser informado nos casos em que o UniDANFE é configurado para enviar automaticamente e-mail com o DANFE, DACTE ou CC-e e/ou com o XML anexados. O e-mail também pode ser gerado no XML auxiliar, ao invés de passado por parâmetro, ou através das TAG´s de uso livre, no próprio XML principal. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” [email protected] Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” e=“[email protected],[email protected]”

EmailCC (opcional) – {ec} – Endereço para o qual o DANFE, DACTE ou CC-e e/ou o XML serão enviados como cópia (CC). Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” [email protected] [email protected]

EmailCCO (opcional) – {eo} – Endereço para o qual o DANFE, DACTE ou CC-e e/ou o XML serão enviados como cópia oculta (CCO). Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” [email protected] [email protected]

EnviaEmail (opcional) – {ee} – aceita os valores “0” para falso” ou “1” para verdadeiro; informa ao UniDANFE se o impresso gerado deverá ser enviado por e-mail 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” ee=0 Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” ee=1

PastaConfiguracao (opcional) – {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. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” pc=“Y:\unimake\uninfe” Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” pc=“\\SERVER01\G\unimake\uninfe”

Logotipo (opcional) – {L} – nome da imagem, incluindo seu caminho completo, que será usada na impressão do DANFE, DACTE ou CC-e. 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. Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” L=“c:\imagens\img01.jpg”

Visualizar (opcional) – {v} – aceita os valores “0” para falso” ou “1” para verdadeiro; informa ao UniDANFE se o DANFE, DACTE ou CC-e gerado deverá ser visualizado na tela do computador antes da impressão/envio por e-mail. 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 Ex: unidanfe.exe a=“c:\x\0101-procNFe.xml” v=1

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

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