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”

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

Parâmetro	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 deve ser o XML de distribuição já autorizado pela SEFAZ (procNFe, procCTe, procMDFe, procEventoNFe, etc).
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.
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.
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.
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.
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
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