Mudanças entre as edições de "Manuais:UniDANFE/Integrando o UniDANFE ao ERP/XML auxiliar/Estrutura"

De unimake
Ir para: navegação, pesquisa
 
(39 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 1: Linha 1:
=== Estrutura do XML auxiliar ===
+
__NOTOC__
 +
__NOTITLE__
 +
== Estrutura do XML auxiliar ==
  
O XML auxiliar deve ter a seguinte estrutura:
+
O [[Manuais:UniDANFE/Integrando o UniDANFE ao ERP/XML auxiliar|XML Auxiliar]] deve ter a estrutura abaixo. Observe que todas as TAGS são opcionais.
  
<?xml version="1.0" encoding="UTF-8"?>
+
<pre><?xml version="1.0" encoding="UTF-8"?>
 
<outrasInf>
 
<outrasInf>
  <foneEmitente>Fone: (11) 1234-1234  Fax: 1234-5678  DDG: 0800-80-8080</foneEmitente>
 
 
   <emailDest>EMAIL DO DESTINATÁRIO</emailDest>
 
   <emailDest>EMAIL DO DESTINATÁRIO</emailDest>
 
   <emailCC>EMAIL PARA ENVIAR CÓPIA</emailCC>
 
   <emailCC>EMAIL PARA ENVIAR CÓPIA</emailCC>
 
   <emailCCO>EMAIL PARA ENVIAR CÓPIA OCULTA</emailCCO>
 
   <emailCCO>EMAIL PARA ENVIAR CÓPIA OCULTA</emailCCO>
 
   <remetente>email ou apelido do remetente previamente cadastrado no UniDANFE</remetente>
 
   <remetente>email ou apelido do remetente previamente cadastrado no UniDANFE</remetente>
 +
  <textoAdicionalEmail>Texto ou nome de arquivo para ser inserido no corpo do e-mail</textoAdicionalEmail>
 
   <logotipo>c:\teste\imagem001.jpg</logotipo>
 
   <logotipo>c:\teste\imagem001.jpg</logotipo>
 
   <copias>2</copias>
 
   <copias>2</copias>
Linha 15: Linha 17:
 
   <poweredBy>Unimake Softwares</poweredBy>
 
   <poweredBy>Unimake Softwares</poweredBy>
 
   <poweredSite>www.unimake.com.br</poweredSite>
 
   <poweredSite>www.unimake.com.br</poweredSite>
  <horaSaida>12:20</horaSaida>
+
   <codigoDest>01982</codigoDest>
  <dSaiEnt>2010-05-20</dSaiEnt>
 
  <nomeFantasiaDest>NOME FANTASIA DO DESTINATÁRIO</nomeFantasiaDest>
 
   <codigoDest>01982 </codigoDest>
 
  <cepLocalEntrega>12345123</cepLocalEntrega>
 
  <nomeLocalEntrega>NOME ESTABELECIMENTO DO LOCAL DE ENTREGA</nomeLocalEntrega>
 
  <cepLocalRetirada>12345123</cepLocalRetirada>
 
  <nomeLocalRetirada> NOME ESTABELECIMENTO DO LOCAL DE ENTREGA </nomeLocalRetirada>
 
 
   <textoCanhoto>Recebemos de MINHA EMPRESA LTDA a Nota Fiscal 0101010 indicada ao lado</textoCanhoto>
 
   <textoCanhoto>Recebemos de MINHA EMPRESA LTDA a Nota Fiscal 0101010 indicada ao lado</textoCanhoto>
 
   <imagemAdicional>c:\teste\nota_abnt_nbr_3758.jpg</imagemAdicional>
 
   <imagemAdicional>c:\teste\nota_abnt_nbr_3758.jpg</imagemAdicional>
 
   <alturaImagemAdicional>1000</alturaImagemAdicional>
 
   <alturaImagemAdicional>1000</alturaImagemAdicional>
 
   <imprimirProdutos>1</imprimirProdutos>
 
   <imprimirProdutos>1</imprimirProdutos>
   <ImprimirTotalTributos>1</ImprimirTotalTributos>
+
   <imprimirTotalTributos>1</imprimirTotalTributos>
   <ImprimirTotalTributosProduto>1</ImprimirTotalTributosProduto>
+
   <imprimirTotalTributosProduto>1</imprimirTotalTributosProduto>
 +
  <imprimirValorUnitarioLiquido>0</imprimirValorUnitarioLiquido>
 +
  <imprimirValorTotalLiquido>9</imprimirValorTotalLiquido>
 
   <pastaLocalQRCode>c:\Meu_Erp\MinhasImagens\QRCode</pastaLocalQRCode>
 
   <pastaLocalQRCode>c:\Meu_Erp\MinhasImagens\QRCode</pastaLocalQRCode>
   <troco>43.20</troco>
+
   <imprimirQRCodePix>1</imprimirQRCodePix>
   <TextoMarcaDagua>Texto para imprimir como marca dágua. A cor deve ser em html e a PosY deve ser em milímetros</TextoMarcaDagua>
+
  <qrCodePix>minha-chave-pix-aqui</qrCodePix>
   <CorMarcaDagua>#cc0000</CorMarcaDagua>
+
  <pastaLocalQRCodePix>c:\Meu_Erp\MinhasImagens\QRCodePix</pastaLocalQRCodePix>
   <PosYMarcaDagua>180</PosYMarcaDagua>
+
   <textoMarcaDagua>Texto para imprimir como marca dágua. A cor deve ser em html e a PosY deve ser em milímetros</textoMarcaDagua>
  <TextoDiagonal>texto para ser impresso na diagonal</TextoDiagonal>
+
   <corMarcaDagua>#cc0000</corMarcaDagua>
  <Anexo1>c:\pasta\meuarquivo.ext</Anexo1>   (até <Anexo999>)
+
   <posYMarcaDagua>180</posYMarcaDagua>
 +
  <textoDiagonal>texto para ser impresso na diagonal</textoDiagonal>
 +
  <nomeImpressao>NF=00123 CAIXA=001 OP=JUNIOR</nomeImpressao>
 +
  <anexo1>c:\pasta\meu_arquivo_externo.pdf</anexo1>
 +
  <combinarPDF>1</combinarPDF>
 +
  <senhaPDF>123456</senhaPDF>
 +
  <descricaoAnexo1>Arquivo PDF com os boletos das parcelas da compra ref. pedido 99999</descricaoAnexo1>
 
   <produtos>
 
   <produtos>
 
       <produto1>
 
       <produto1>
Linha 45: Linha 48:
 
         <aux_cor>Verde</aux_cor>
 
         <aux_cor>Verde</aux_cor>
 
         <aux_tamanho>P</aux_tamanho>
 
         <aux_tamanho>P</aux_tamanho>
         <aux_outra_tag>Conteúdo de qualquer campo do cadastro do produto, ou da venda, etc</aux_outra_tag>      
+
         <aux_outra_tag>Conteúdo 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>
+
        <infAdVeic>Nota Fiscal de Entrada: 02020202 Data: 02/02/2002 BLA BLA BLA</infAdVeic>
 
       </produto2>
 
       </produto2>
 
   </produtos>
 
   </produtos>
 +
  <fatura>
 +
      <parcela1>
 +
        <nValor>100.01</nValor>
 +
        <dVencto>2024-01-10</dVencto>
 +
      </parcela1>
 +
      <parcela2>
 +
        <nValor>100.02</nValor>
 +
        <dVencto>2024-02-10</dVencto>
 +
      </parcela2>
 +
  </fatura>
 
</outrasInf>
 
</outrasInf>
 +
</pre>
  
TAGS comuns a todos tipos de documentos:
+
=== TAGS do XML auxiliar ===
 +
As TAGS seguintes serão tratadas pelo UniDANFE se existirem no XML auxiliar.
 +
Qualquer outra TAG, não listada aqui, será ignorada se existir nesse XML.
  
<foneEmitente> Permite a informação de telefones do emitente de forma livre. As informações dessa TAG, quando informadas, substituirão completamente a linha do telefone, no quadro "Identificação do Emitente", no documento (DANFE, DACTE ou CC-e).
+
{| class="wikitable"
 +
|-
 +
!colspan="2"|TAGS comuns a todos tipos de documentos
  
<emailDest> - Endereço eletrônico do destinatário. Esse endereço será usado pelo UniDANFE para enviar e-mail ao destinatário contendo o documento (DANFE, DACTE ou CC-e) e/ou o XML principal, como anexo(s).
+
|-
 +
|Encoding
 +
|Conjunto de caracteres do XML. Válidos: "UTF-8" e "ISO-8859-1".
  
<emailCC> - Endereço eletrônico do destinatário para onde o e-mail deve ser enviado como cópia.
+
|-
 +
|<outrasInf>
 +
|Grupo de TAGS principal. Essa TAG é a única obrigatória no XML auxiliar.
  
<emailCCO> - Endereço eletrônico do destinatário para onde o e-mail deve ser enviado como cópia oculta.
 
  
<remetente> - Endereço eletrônico ou apelido do remetente de e-mails. O conteúdo 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 seção "Configurando as Contas de Remetentes" para maiores detalhes.
+
|-
 +
|<emailDest>
 +
|Endereço eletrônico do destinatário. Esse endereço será usado pelo UniDANFE para enviar e-mail ao destinatário contendo o documento (DANFE, DACTE ou CC-e) e/ou o XML principal, como anexo(s).
  
<logotipo> - Imagem que contém o logotipo do emitente, para ser impresso no quadro correspondente;
+
|-
 +
|<emailCC>
 +
|Endereço eletrônico do destinatário para onde o e-mail deve ser enviado como cópia.
  
<copias> - Número de cópias (vias) em que o documento (DANFE, DACTE ou CC-e) deve ser gerado/impresso;
+
|-
 +
|<emailCCO>
 +
|Endereço eletrônico do destinatário para onde o e-mail deve ser enviado como cópia oculta.
  
<configuracao> - Configuração do UniDANFE que será usada para a geração/impressão do documento (DANFE, DACTE ou CC-e);
+
|-
 +
|<textoAdicionalEmail>
 +
|Texto a ser inserido no assuntou ou no corpo do e-mail. Pode conter um texto ou um nome de arquivo ".txt", ".htm" ou ".html". Na personalização do e-mail deve ser incluído o campo #texto_adicional_email" no ponto onde o texto adicional deve ser inserido.
  
<poweredBy> - Publicidade que é impressa no rodapé do impresso. Nome da empresa desenvolvedora do sistema;
+
|-
 +
|<remetente>
 +
|Endereço eletrônico ou apelido do remetente de e-mails. O conteúdo 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 seção "Configurando as Contas de Remetentes" para maiores detalhes.
  
<poweredSite> - Site da empresa desenvolvedora do sistema, impresso junto com o conteúdo da tag <poweredBy>;
+
|-
 +
|<logotipo>
 +
|Imagem que contém o logotipo do emitente, para ser impresso no quadro correspondente;
  
<ImprimirTotalTributos> - Indica ao sistema se deve imprimir o total aproximado de tributos (Lei da Transparência Fiscal);
+
|-
 +
|<copias>
 +
|Número de cópias (vias) em que o documento (DANFE, DACTE ou CC-e) deve ser gerado/impresso;
  
<Anexo999> - Outros arquivos que devem ser anexados ao e-mail. Aceita desde <Anexo1> até <Anexo999>;
+
|-
 +
|<configuracao>
 +
|Configuração do UniDANFE que será usada para a geração/impressão do documento (DANFE, DACTE ou CC-e);
  
Outras TAGS utilizadas no DANFE de NF-e:
+
|-
 +
|<poweredBy>
 +
|Publicidade que é impressa no rodapé do impresso. Nome da empresa desenvolvedora do sistema;
  
<horaSaida> Hora da saída da mercadoria, para o transporte.  Esse campo já existe na estrutura do XML principal, contudo, em muitos casos não se tem essa hora no momento da geração da NF-e, mas apenas no momento da impressão da mesma. O valor dessa TAG não será atualizado no XML principal, mas apenas impresso no DANFE.
+
|-
 +
|<poweredSite>
 +
|Site da empresa desenvolvedora do sistema, impresso junto com o conteúdo da tag <poweredBy>;
  
<dSaiEnt> Data da saída da mercadoria, para o transporte. Esse campo já existe na estrutura do XML principal, contudo, em muitos casos não se tem essa data no momento da geração da NF-e, mas apenas no momento da impressão da mesma. O valor dessa TAG não será atualizado no XML principal, mas apenas impresso no DANFE.
+
|-
 +
|<nomeImpressao>
 +
|Texto que vai aparecer no gerenciador de impressão do Windows. Se não informado o texto padrão é gerado pelo UniDANFE;
  
<nomeFantasiaDest> e <codigoDest> - Como seus próprios nomes demonstram, servem para informar ao UniDANFE o nome de fantasia e o código do destinatário. Essas informações, quando preenchidas, serão impressas no DANFE no campo "Nome/Razão Social" (do destinatário), logo após a razão social informada no XML principal, e tem a função de facilitar ao transportador (entregador) a localização dos estabelecimentos destinatários, que raramente estampam a razão social em placas externas.
+
|-
 +
|<imprimirTotalTributos>
 +
|Indica ao sistema se deve imprimir o total aproximado de tributos (Lei da Transparência Fiscal);
  
<cepLocalEntrega> - Campo que não 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, é necessário informá-lo no XML auxiliar.
+
|-
 +
|<anexo1>
 +
|Outros arquivos que devem ser anexados ao e-mail. Aceita desde <anexo1> até <anexo9>;
  
<nomeLocalEntrega> - Campo que não 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, é necessário informá-lo no XML auxiliar.
+
|-
 +
|<descricaoAnexo1>
 +
|Descrição do arquivo informado em <Anexo1>. Aceita desde <descricaoAnexo1> até <descricaoAnexo9>;
  
<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, é necessário informá-lo no XML auxiliar.
+
|-
 +
|<combinarPDF>
 +
|Define se o UniDANFE deve combinar vários arquivos PDF em único PDF.
 +
Usado em conjunto com os parâmetros "Anexo1", "Anexo2", etc, quando outros PDFs externos podem ser anexados ao e-mail. Os valores aceitos são:
  
<nomeLocalRetirada> - Igualmente ao CEP do local de retirada, o UniDANFE imprime o local de retirada no corpo do DANFE quando informado no XML principal. No entanto, para preenchimento do NOME, é necessário informá-lo no XML auxiliar.
+
0 = não combinar os PDFs;
 +
1 = Combinar todos os PDFs externos junto com o PDF do documento, enviando apenas um único PDF como anexo;
 +
2 = Combinar apenas os PDFs externos, enviando dois PDFs como anexo: o PDF do documento e um PDF combinando todos os PDFs externos.
  
<textoCanhoto> - Redefinição do texto padrão impresso no canhoto do DANFE. O texto que for definido nessa TAG será impresso integralmente, sobrepondo-se ao padrão atual do sistema.
+
|-
 +
|<senhaPDF>
 +
|Define uma senha para o PDF combinado.
  
<imagemAdicional> - Nome completo, incluindo o caminho, de uma imagem para ser impressa no rodapé da seção "DADOS ADICIONAIS", dentro do quadro "Informações Complementares". sistema. Válido apenas para impressão do DANFE em orientação RETRATO.
+
|-
 +
|<pastaLocalQRCode>(Plus)
 +
|Indica uma pasta local ou da rede para onde a imagem do QRCode da chave de acesso gerada deve ser copiada para posterior utilização pelo sistema ERP do cliente.
  
<alturaImagemAdicional> - 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.
+
|-
 +
|<imprimirQRCodePix>(Plus)
 +
|Indica ao sistema se deve imprimir o QRCode do PIX no documento auxiliar. Aceita os valores "1" (sim) ou "0" (não).  
  
<produtos> - TAGS utilizadas para informações complementares aos produtos. É um recurso especial do UniDANFE para suprir necessidades que o XML auxiliar não contempla. Através dessas TAGS, é possível incluir uma coluna livre (Free) no DANFe, ou definir colunas específicas (Plus) iniciadas com o prefixo "Aux_" para utilização através das configurações de colunas, presentes no UniDANFE Plus.  
+
|-
 +
|<qrCodePix>(Plus)
 +
|Chave do pix que deve ser codificada no QRCode.  
  
<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 símbolo "?" presente nessa TAG deve ser substituído pelo mesmo número de sequência presente na TAG de grupo <det nItem="?"> do XML principal.
+
|-
 +
|<pastaLocalQRCodePix>(Plus)
 +
|Indica uma pasta local ou da rede para onde a imagem do QRCode do Pix gerada deve ser copiada para posterior utilização pelo sistema ERP do cliente.
  
<colunaLivre>(Free) - O conteúdo dessa TAG será impresso na coluna correspondente do DANFE, desde que previamente configurado na interface amigável do UniDANFE. É utilizada para imprimir conteúdos do cadastro de produtos ou dos itens das vendas que não estejam presentes na estrutura do XML principal. Para maiores detalhes a respeito dessa configuração, consulte a seção "Coluna Livre".
 
  
Atenção: se você estiver imprimindo DANFE´s em ambiente de homologação, o UniDANFE se comporta como edição Plus e não imprime os dados da coluna livre. Para contornar isso, ao carregar o UniDANFE passe o parâmetro indicando que quer utilizar especificamente a edição free.
+
|-
Ex: UniDANFE.exe a=01010101.xml d=free
+
!colspan="2"|Fatura:
  
<aux_nnnnnn>(Plus) - No UniDANFE v.3 Plus é possível configurar cada coluna que será impressa no DANFE, bem como mudar sua posição, e inclusive remover colunas não utilizadas, como valor e alíquota de IPI para empresas que não utilizem esse imposto, por exemplo. Também é possível adicionar novas colunas do DANFE. Nesse caso, podem ser adicionadas qualquer TAG do grupo <det> do XML principal, ou mesmo outras que não existam nesse XML principal. Por exemplo, para adicionar no DANFE, logo após a descrição do produto uma coluna contendo a cor do mesmo, basta incluir a coluna <Aux_Cor> na configuração do UniDANFE, e gerar no XML auxiliar a mesma TAG com seu respectivo conteúdo, como pode ser visto no exemplo dado logo acima na estrutura do XML auxiliar, onde foram definidas as TAGS <Aux_Cor> e <Aux_Tamanho>.
+
|-
 +
|<fatura><parcela?>
 +
|Grupo de TAGS onde é possível informar parcelamento para os tipos de impresso que não tem esse conjunto de TAGs no XML, como é o caso da NFS-e.  
  
<infAdVeic>(Plus) - Ao emitir DANFE de venda de veículos novos, é possível configurar o UniDANFE v.3 Plus para emitir a descrição complementar dos veículos logo abaixo da linha do produto com as informações presentes nas TAG´s específicas (grupo <veicProd>). No entanto, em havendo necessidade de destacar ali outras informações adicionais não contempladas no conjunto de TAG´s específicas, pode-se gerar o complemento da descrição nessa TAG <infAdVeic> no arquivo auxiliar, que a mesma será adicionada à descrição complementar, no ponto onde a mesma for inserida na interface de configuração do UniDANFE.
 
  
<ImprimirTotalTributosProduto> - Indica ao sistema se deve imprimir o total aproximado de tributos do produto (Lei da Transparência Fiscal);
+
|-
 +
!colspan="2"|Outras TAGS utilizadas no DANFE de NF-e:
  
Outras TAGS utilizadas no DANFE de NFC-e:
+
|-
 +
|<textoCanhoto>
 +
|Redefinição do texto padrão impresso no canhoto do DANFE. O texto que for definido nessa TAG será impresso integralmente, sobrepondo-se ao padrão atual do sistema.
  
<imprimirProdutos> - Indica se deve ou não imprimir os produtos. Aceita os valores "1" (sim) ou "0" (não).  
+
|-
 +
|<imagemAdicional>
 +
|Nome completo, incluindo o caminho, de uma imagem para ser impressa no rodapé da seção "DADOS ADICIONAIS", dentro do quadro "Informações Complementares". sistema. Válido apenas para impressão do DANFE em orientação RETRATO.
  
<pastaLocalQRCode>(Plus)  - Indica uma pasta local ou da rede para onde a imagem do QRCode gerada deve ser copiada para posterior utilização pelo sistema ERP do cliente.
+
|-
 +
|<alturaImagemAdicional>
 +
|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.
  
<troco> - indica ao sistema o valor que deve ser impresso no campo "Troco", na seção de totais.
+
|-
Atenção: Essa TAG é desconsiderada a partir da versão 4.00 do XML, que já contempla a TAG <vTroco> no próprio XML da NFC-e.
+
|<produtos>
 +
|TAGS utilizadas para informações complementares aos produtos. É um recurso especial do UniDANFE para suprir necessidades que o XML auxiliar não contempla. Através dessas TAGS, é possível incluir uma coluna livre (Free) no DANFE, ou definir colunas específicas (Plus) iniciadas com o prefixo "Aux_" para utilização através das configurações de colunas, presentes no UniDANFE Plus.  
  
<ImprimirTotalTributosProduto> - Indica ao sistema se deve imprimir o total aproximado de tributos do produto (Lei da Transparência Fiscal);
+
|-
 +
|<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 símbolo "?" presente nessa TAG deve ser substituído pelo mesmo número de sequência presente na TAG de grupo <det nItem="?"> do XML principal.
  
 +
|-
 +
|<colunaLivre>(Free)
 +
|O conteúdo dessa TAG será impresso na coluna correspondente do DANFE, desde que previamente configurado na interface amigável do UniDANFE. É utilizada para imprimir conteúdos do cadastro de produtos ou dos itens das vendas que não estejam presentes na estrutura do XML principal. Para maiores detalhes a respeito dessa configuração, consulte a seção "Coluna Livre".
  
 +
Atenção: se você estiver imprimindo DANFE´s em ambiente de homologação, o UniDANFE se comporta como edição Plus e não imprime os dados da coluna livre. Para contornar isso, ao carregar o UniDANFE passe o parâmetro indicando que quer utilizar especificamente a edição free.
 +
Ex: UniDANFE.exe a=01010101.xml d=free
  
?
+
|-
Campos não previstos no XML Principal
+
|<aux_nnnnnn>(Plus)
 
+
|No UniDANFE Plus é possível configurar cada coluna que será impressa no DANFE, bem como mudar sua posição, e inclusive remover colunas não utilizadas, como valor e alíquota de IPI para empresas que não utilizem esse imposto, por exemplo. Também é possível adicionar novas colunas do DANFE. Nesse caso, podem ser adicionadas qualquer TAG do grupo <det> do XML principal, ou mesmo outras que não existam nesse XML principal. Por exemplo, para adicionar no DANFE, logo após a descrição do produto uma coluna contendo a cor do mesmo, basta incluir a coluna <aux_Cor> na configuração do UniDANFE, e gerar no XML auxiliar a mesma TAG com seu respectivo conteúdo, como pode ser visto no exemplo dado logo acima na estrutura do XML auxiliar, onde foram definidas as TAGS <aux_Cor> e <aux_Tamanho>.
Além da utilização do arquivo XML auxiliar, há a possibilidade de informar alguns campos não previstos no XML principal utilizando-se as TAG´s de uso livre. Observe que a SEFAZ aceita no máximo 10 (dez) TAG´s dessas no mesmo XML. Assim, fica a cargo do desenvolvedor escolher quais irá utilizar para melhor integrar seu ERP ao UniDANFE. As informações que são previstas e que podem ser informadas nessa TAG são:
 
 
 
Logotipo - Logotipo do emitente;
 
 
 
Telefones_Emitente - Telefones do emitente, para sair no quadro "Identificação do Emitente". Utilizar quando se deseja imprimir mais de um número de telefone nesse quadro.
 
 
 
Email_Destinatario - E-mail do destinatário da NF-e. Informar para automatizar processo de envio da NF-e e do XML para o destinatário da NF-e.
 
 
 
Email_CC - E-mail para onde uma cópia da NF-e deva ser enviada.
 
 
 
Email_CCO - E-mail para onde uma cópia da NF-e deva ser enviada. Endereços informados nesse campo ficarão invisíveis aos destinatários.
 
  
Remetente - Email ou apelido do remetente de e-mails. O conteúdo 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 seção "Configurando as Contas de Remetentes" para maiores detalhes.
+
|-
 +
|<infAdVeic>(Plus)
 +
|Ao emitir DANFE de venda de veículos novos, é possível configurar o UniDANFE v.3 Plus para emitir a descrição complementar dos veículos logo abaixo da linha do produto com as informações presentes nas TAG´s específicas (grupo <veicProd>). No entanto, em havendo necessidade de destacar ali outras informações adicionais não contempladas no conjunto de TAG´s específicas, pode-se gerar o complemento da descrição nessa TAG <infAdVeic> no arquivo auxiliar, que a mesma será adicionada à descrição complementar, no ponto onde a mesma for inserida na interface de configuração do UniDANFE.  
  
Nome_Fantasia_Dest - Ao informar esse campo, o nome fantasia é impresso no DANFE à direita da razão social do destinatário da NF-e.
+
|-
 +
|<imprimirTotalTributosProduto>
 +
|Indica ao sistema se deve imprimir o total aproximado de tributos do produto (Lei da Transparência Fiscal);
  
Codigo_Destinatario - Ao informar esse campo, o código é impresso no DANFE à direita da razão social do destinatário da NF-e.
+
|-
 +
|<imprimirValorUnitarioLiquido> (Plus)
 +
|Indica ao sistema se deve imprimir a coluna "Valor Unitário Líquido" do produto. Aceita os valores "1" (sim, sempre), "0" (não) ou "9" (automático - imprime apenas se o valor líquido for diferente do valor bruto);
  
Nome_Local_Entrega - Nome do estabelecimento no local de entrega. Impresso no corpo do DANFE, juntamente ao endereço de entrega.
+
|-
 +
|<imprimirValorTotalLiquido> (Plus)
 +
|Indica ao sistema se deve imprimir a coluna "Valor Total Líquido" do produto. Aceita os valores "1" (sim, sempre), "0" (não) ou "9" (automático - imprime apenas se o valor líquido for diferente do valor bruto);
  
Cep_Local_Entrega - CEP do local de entrega. Impresso no corpo do DANFE, juntamente ao endereço de entrega.
+
|-
 +
!colspan="2"|Outras TAGS utilizadas no DANFE de NFC-e
  
Nome_Local_Retirada - Nome do estabelecimento no local de retirada. Impresso no corpo do DANFE, juntamente ao endereço de retirada.
+
|-
 +
|<imprimirProdutos>
 +
|Indica se deve ou não imprimir os produtos. Aceita os valores "1" (sim) ou "0" (não).  
  
Cep_Local_Retirada - CEP do local de retirada. Impresso no corpo do DANFE, juntamente ao endereço de retirada.
+
|-
 +
|<imprimirTotalTributosProduto>
 +
|Indica ao sistema se deve imprimir o total aproximado de tributos do produto (Lei da Transparência Fiscal);
  
Texto_Fatura - Texto para ser impresso no campo "Fatura", do quadro "Fatura/duplicatas".
+
|-
 +
!colspan="2"|Outras TAGS utilizadas na CC-e
  
veicTransp - Placa do veiculo, UF e número do RNTC, para os casos em que esses campos não estão previstos no XML do documento e mesmo assim queira-se imprimi-los. Caso o grupo de TAGs <veicTransp> esteja presente no XML do documento, esse conteúdo dentro do grupo <infAdic> será ignorado automaticamente.
+
|-
 +
|<anexarDFe>
 +
|Indica se o Arquivo Auxiliar (DANFE, DACTE, etc) deve ser anexado à impressão da CC-e. Válidos: 0=Não 1=Sim (antes da CC-e) 2=Sim (após a CC-e).
  
 +
|}
  
Exemplo da utilização das TAG´s de uso livre (obs: há um limite de utilização, de 10 campos por XML - fica a cargo do programador/emitente escolher quais campos vai utilizar):
+
==Veja também==
...
+
* [[Manuais:UniDANFE/Integrando o UniDANFE ao ERP/XML auxiliar|XML Auxiliar]]
<infAdic>
+
* [[Manuais:UniDANFE/Integrando o UniDANFE ao ERP/TAGS de uso livre|TAGS de uso livre no próprio XML do Documento Fiscal Eletrônico]]
<infCpl>xxxx xxx xxxxxxxx xxxxx xxxxx;xxxxx xxxx xxxx xxxxx</infCpl>
+
* [[Manuais:UniDANFE/Configurando o UniDANFE|Configurando o UniDANFE]]
<obsCont  xCampo="Logotipo"><xTexto>c:\imagens\logomarca.jpg</xTexto></obsCont>
 
<obsCont  xCampo="Email_Destinatario"><xTexto>[email protected]</xTexto></obsCont>
 
<obsCont  xCampo="Email_CC"><xTexto>[email protected]</xTexto></obsCont>
 
<obsCont  xCampo="Email_CCO"><xTexto>[email protected]</xTexto></obsCont>
 
<obsCont  xCampo="Remetente"><xTexto>[email protected]</xTexto></obsCont>
 
<obsCont  xCampo="Remetente"><xTexto>apelido do remetente</xTexto></obsCont>
 
<obsCont  xCampo="Telefones_Destinatario"><xTexto>Fone: (nn) nnnn-nnnn - Fax: nnnn-nnnn</xTexto></obsCont>
 
<obsCont  xCampo="Nome_Fantasia_Dest"><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="Texto_Fatura"><xTexto>PAGAMENTO ANTECIPADO</xTexto></obsCont>
 
<obsCont  xCampo="veicTransp"><xTexto>AAA1234|PR|1234567890</xTexto></obsCont>
 
</infAdic>
 
...
 

Edição atual tal como às 09h03min de 31 de janeiro de 2024


Estrutura do XML auxiliar

O XML Auxiliar deve ter a estrutura abaixo. Observe que todas as TAGS são opcionais.

<?xml version="1.0" encoding="UTF-8"?>
<outrasInf>
   <emailDest>EMAIL DO DESTINATÁRIO</emailDest>
   <emailCC>EMAIL PARA ENVIAR CÓPIA</emailCC>
   <emailCCO>EMAIL PARA ENVIAR CÓPIA OCULTA</emailCCO>
   <remetente>email ou apelido do remetente previamente cadastrado no UniDANFE</remetente>
   <textoAdicionalEmail>Texto ou nome de arquivo para ser inserido no corpo do e-mail</textoAdicionalEmail>
   <logotipo>c:\teste\imagem001.jpg</logotipo>
   <copias>2</copias>
   <configuracao>RETRATO</configuracao>
   <poweredBy>Unimake Softwares</poweredBy>
   <poweredSite>www.unimake.com.br</poweredSite>
   <codigoDest>01982</codigoDest>
   <textoCanhoto>Recebemos de MINHA EMPRESA LTDA a Nota Fiscal 0101010 indicada ao lado</textoCanhoto>
   <imagemAdicional>c:\teste\nota_abnt_nbr_3758.jpg</imagemAdicional>
   <alturaImagemAdicional>1000</alturaImagemAdicional>
   <imprimirProdutos>1</imprimirProdutos>
   <imprimirTotalTributos>1</imprimirTotalTributos>
   <imprimirTotalTributosProduto>1</imprimirTotalTributosProduto>
   <imprimirValorUnitarioLiquido>0</imprimirValorUnitarioLiquido>
   <imprimirValorTotalLiquido>9</imprimirValorTotalLiquido>
   <pastaLocalQRCode>c:\Meu_Erp\MinhasImagens\QRCode</pastaLocalQRCode>
   <imprimirQRCodePix>1</imprimirQRCodePix>
   <qrCodePix>minha-chave-pix-aqui</qrCodePix>
   <pastaLocalQRCodePix>c:\Meu_Erp\MinhasImagens\QRCodePix</pastaLocalQRCodePix>
   <textoMarcaDagua>Texto para imprimir como marca dágua. A cor deve ser em html e a PosY deve ser em milímetros</textoMarcaDagua>
   <corMarcaDagua>#cc0000</corMarcaDagua>
   <posYMarcaDagua>180</posYMarcaDagua>
   <textoDiagonal>texto para ser impresso na diagonal</textoDiagonal>
   <nomeImpressao>NF=00123 CAIXA=001 OP=JUNIOR</nomeImpressao>
   <anexo1>c:\pasta\meu_arquivo_externo.pdf</anexo1>
   <combinarPDF>1</combinarPDF>
   <senhaPDF>123456</senhaPDF>
   <descricaoAnexo1>Arquivo PDF com os boletos das parcelas da compra ref. pedido 99999</descricaoAnexo1>
   <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>Conteúdo 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>
   <fatura>
      <parcela1>
         <nValor>100.01</nValor>
         <dVencto>2024-01-10</dVencto>
      </parcela1>
      <parcela2>
         <nValor>100.02</nValor>
         <dVencto>2024-02-10</dVencto>
      </parcela2>
   </fatura>
</outrasInf>

TAGS do XML auxiliar

As TAGS seguintes serão tratadas pelo UniDANFE se existirem no XML auxiliar. Qualquer outra TAG, não listada aqui, será ignorada se existir nesse XML.

TAGS comuns a todos tipos de documentos
Encoding Conjunto de caracteres do XML. Válidos: "UTF-8" e "ISO-8859-1".
<outrasInf> Grupo de TAGS principal. Essa TAG é a única obrigatória no XML auxiliar.


<emailDest> Endereço eletrônico do destinatário. Esse endereço será usado pelo UniDANFE para enviar e-mail ao destinatário contendo o documento (DANFE, DACTE ou CC-e) e/ou o XML principal, como anexo(s).
<emailCC> Endereço eletrônico do destinatário para onde o e-mail deve ser enviado como cópia.
<emailCCO> Endereço eletrônico do destinatário para onde o e-mail deve ser enviado como cópia oculta.
<textoAdicionalEmail> Texto a ser inserido no assuntou ou no corpo do e-mail. Pode conter um texto ou um nome de arquivo ".txt", ".htm" ou ".html". Na personalização do e-mail deve ser incluído o campo #texto_adicional_email" no ponto onde o texto adicional deve ser inserido.
<remetente> Endereço eletrônico ou apelido do remetente de e-mails. O conteúdo 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 seção "Configurando as Contas de Remetentes" para maiores detalhes.
<logotipo> Imagem que contém o logotipo do emitente, para ser impresso no quadro correspondente;
<copias> Número de cópias (vias) em que o documento (DANFE, DACTE ou CC-e) deve ser gerado/impresso;
<configuracao> Configuração do UniDANFE que será usada para a geração/impressão do documento (DANFE, DACTE ou CC-e);
<poweredBy> Publicidade que é impressa no rodapé do impresso. Nome da empresa desenvolvedora do sistema;
<poweredSite> Site da empresa desenvolvedora do sistema, impresso junto com o conteúdo da tag <poweredBy>;
<nomeImpressao> Texto que vai aparecer no gerenciador de impressão do Windows. Se não informado o texto padrão é gerado pelo UniDANFE;
<imprimirTotalTributos> Indica ao sistema se deve imprimir o total aproximado de tributos (Lei da Transparência Fiscal);
<anexo1> Outros arquivos que devem ser anexados ao e-mail. Aceita desde <anexo1> até <anexo9>;
<descricaoAnexo1> Descrição do arquivo informado em <Anexo1>. Aceita desde <descricaoAnexo1> até <descricaoAnexo9>;
<combinarPDF> Define se o UniDANFE deve combinar vários arquivos PDF em único PDF.

Usado em conjunto com os parâmetros "Anexo1", "Anexo2", etc, quando outros PDFs externos podem ser anexados ao e-mail. Os valores aceitos são:

0 = não combinar os PDFs; 1 = Combinar todos os PDFs externos junto com o PDF do documento, enviando apenas um único PDF como anexo; 2 = Combinar apenas os PDFs externos, enviando dois PDFs como anexo: o PDF do documento e um PDF combinando todos os PDFs externos.

<senhaPDF> Define uma senha para o PDF combinado.
<pastaLocalQRCode>(Plus) Indica uma pasta local ou da rede para onde a imagem do QRCode da chave de acesso gerada deve ser copiada para posterior utilização pelo sistema ERP do cliente.
<imprimirQRCodePix>(Plus) Indica ao sistema se deve imprimir o QRCode do PIX no documento auxiliar. Aceita os valores "1" (sim) ou "0" (não).
<qrCodePix>(Plus) Chave do pix que deve ser codificada no QRCode.
<pastaLocalQRCodePix>(Plus) Indica uma pasta local ou da rede para onde a imagem do QRCode do Pix gerada deve ser copiada para posterior utilização pelo sistema ERP do cliente.


Fatura:
<fatura><parcela?> Grupo de TAGS onde é possível informar parcelamento para os tipos de impresso que não tem esse conjunto de TAGs no XML, como é o caso da NFS-e.


Outras TAGS utilizadas no DANFE de NF-e:
<textoCanhoto> Redefinição do texto padrão impresso no canhoto do DANFE. O texto que for definido nessa TAG será impresso integralmente, sobrepondo-se ao padrão atual do sistema.
<imagemAdicional> Nome completo, incluindo o caminho, de uma imagem para ser impressa no rodapé da seção "DADOS ADICIONAIS", dentro do quadro "Informações Complementares". sistema. Válido apenas para impressão do DANFE em orientação RETRATO.
<alturaImagemAdicional> 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.
<produtos> TAGS utilizadas para informações complementares aos produtos. É um recurso especial do UniDANFE para suprir necessidades que o XML auxiliar não contempla. Através dessas TAGS, é possível incluir uma coluna livre (Free) no DANFE, ou definir colunas específicas (Plus) iniciadas com o prefixo "Aux_" para utilização através das configurações 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 símbolo "?" presente nessa TAG deve ser substituído pelo mesmo número de sequência presente na TAG de grupo <det nItem="?"> do XML principal.
<colunaLivre>(Free) O conteúdo dessa TAG será impresso na coluna correspondente do DANFE, desde que previamente configurado na interface amigável do UniDANFE. É utilizada para imprimir conteúdos do cadastro de produtos ou dos itens das vendas que não estejam presentes na estrutura do XML principal. Para maiores detalhes a respeito dessa configuração, consulte a seção "Coluna Livre".

Atenção: se você estiver imprimindo DANFE´s em ambiente de homologação, o UniDANFE se comporta como edição Plus e não imprime os dados da coluna livre. Para contornar isso, ao carregar o UniDANFE passe o parâmetro indicando que quer utilizar especificamente a edição free. Ex: UniDANFE.exe a=01010101.xml d=free

<aux_nnnnnn>(Plus) No UniDANFE Plus é possível configurar cada coluna que será impressa no DANFE, bem como mudar sua posição, e inclusive remover colunas não utilizadas, como valor e alíquota de IPI para empresas que não utilizem esse imposto, por exemplo. Também é possível adicionar novas colunas do DANFE. Nesse caso, podem ser adicionadas qualquer TAG do grupo <det> do XML principal, ou mesmo outras que não existam nesse XML principal. Por exemplo, para adicionar no DANFE, logo após a descrição do produto uma coluna contendo a cor do mesmo, basta incluir a coluna <aux_Cor> na configuração do UniDANFE, e gerar no XML auxiliar a mesma TAG com seu respectivo conteúdo, 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 veículos novos, é possível configurar o UniDANFE v.3 Plus para emitir a descrição complementar dos veículos logo abaixo da linha do produto com as informações presentes nas TAG´s específicas (grupo <veicProd>). No entanto, em havendo necessidade de destacar ali outras informações adicionais não contempladas no conjunto de TAG´s específicas, pode-se gerar o complemento da descrição nessa TAG <infAdVeic> no arquivo auxiliar, que a mesma será adicionada à descrição complementar, no ponto onde a mesma for inserida na interface de configuração do UniDANFE.
<imprimirTotalTributosProduto> Indica ao sistema se deve imprimir o total aproximado de tributos do produto (Lei da Transparência Fiscal);
<imprimirValorUnitarioLiquido> (Plus) Indica ao sistema se deve imprimir a coluna "Valor Unitário Líquido" do produto. Aceita os valores "1" (sim, sempre), "0" (não) ou "9" (automático - imprime apenas se o valor líquido for diferente do valor bruto);
<imprimirValorTotalLiquido> (Plus) Indica ao sistema se deve imprimir a coluna "Valor Total Líquido" do produto. Aceita os valores "1" (sim, sempre), "0" (não) ou "9" (automático - imprime apenas se o valor líquido for diferente do valor bruto);
Outras TAGS utilizadas no DANFE de NFC-e
<imprimirProdutos> Indica se deve ou não imprimir os produtos. Aceita os valores "1" (sim) ou "0" (não).
<imprimirTotalTributosProduto> Indica ao sistema se deve imprimir o total aproximado de tributos do produto (Lei da Transparência Fiscal);
Outras TAGS utilizadas na CC-e
<anexarDFe> Indica se o Arquivo Auxiliar (DANFE, DACTE, etc) deve ser anexado à impressão da CC-e. Válidos: 0=Não 1=Sim (antes da CC-e) 2=Sim (após a CC-e).

Veja também