3 255
edições
Mudanças
sem sumário de edição
O [[Manuais:UniDANFE/Integrando o UniDANFE ao ERP/XML auxiliar |XML Auxiliar]] deve ter a seguinte estrutura:abaixo. Observe que todas as TAGS são opcionais.
<pre><?xml version="1.0" encoding="UTF-8"?>
<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>
<alturaImagemAdicional>1000</alturaImagemAdicional>
<imprimirProdutos>1</imprimirProdutos>
<ImprimirTotalTributosimprimirTotalTributos>1</ImprimirTotalTributosimprimirTotalTributos> <ImprimirTotalTributosProdutoimprimirTotalTributosProduto>1</ImprimirTotalTributosProdutoimprimirTotalTributosProduto> <imprimirValorUnitarioLiquido>0</imprimirValorUnitarioLiquido> <imprimirValorTotalLiquido>9</imprimirValorTotalLiquido>
<pastaLocalQRCode>c:\Meu_Erp\MinhasImagens\QRCode</pastaLocalQRCode>
<TextoMarcaDaguaimprimirQRCodePix>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</TextoMarcaDaguatextoMarcaDagua> <CorMarcaDaguacorMarcaDagua>#cc0000</CorMarcaDaguacorMarcaDagua> <PosYMarcaDaguaposYMarcaDagua>180</PosYMarcaDaguaposYMarcaDagua> <TextoDiagonaltextoDiagonal>texto para ser impresso na diagonal</TextoDiagonaltextoDiagonal> <Anexo1nomeImpressao>NF=00123 CAIXA=001 OP=JUNIOR</nomeImpressao> <anexo1>c:\pasta\meuarquivomeu_arquivo_externo.extpdf</anexo1> <combinarPDF>1</Anexo1combinarPDF> <senhaPDF> (até 123456<Anexo999/senhaPDF> <descricaoAnexo1>Arquivo PDF com os boletos das parcelas da compra ref. pedido 99999</descricaoAnexo1>)
<produtos>
<produto1>
</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></pre>
=== TAGS comuns a todos tipos de documentos: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.
|-|<emailCCoutrasInf> - Endereço eletrônico do destinatário para onde o e-mail deve ser enviado como cópia|Grupo de TAGS principal. Essa TAG é a única obrigatória no XML auxiliar.
|-|<remetenteemailDest> - |Endereço eletrônico ou apelido do remetente de e-mailsdestinatário. O conteúdo dessa TAG Esse endereço será utilizado usado pelo UniDANFE para localizar enviar e-mail ao destinatário contendo o documento (DANFE, DACTE ou CC-e) e/ou 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 detalhesXML principal, como anexo(s).
|-|<logotipoemailCC> - Imagem que contém o logotipo |Endereço eletrônico do emitente, destinatário para onde o e-mail deve ser impresso no quadro correspondente;enviado como cópia.
|-|<copiasemailCCO> - Número de cópias (vias) em que |Endereço eletrônico do destinatário para onde o documento (DANFE, DACTE ou CCe-e) mail deve ser gerado/impresso;enviado como cópia oculta.
|-|<configuracaotextoAdicionalEmail> - Configuração do UniDANFE que será usada para |Texto a geração/impressão ser inserido no assuntou ou no corpo do documento (DANFEe-mail. Pode conter um texto ou um nome de arquivo ".txt", DACTE ".htm" ou CC".html". Na personalização do e-e);mail deve ser incluído o campo #texto_adicional_email" no ponto onde o texto adicional deve ser inserido.
|-|<poweredByremetente> |Endereço eletrônico ou apelido do remetente de e- Publicidade que é impressa mails. O conteúdo dessa TAG será utilizado pelo UniDANFE para localizar o registro correspondente ao remetente desejado na tabela de remetentes cadastrados no rodapé do impressosistema. Nome da empresa desenvolvedora do O remetente deve estar previamente cadastrado no sistema;. Consulte a seção "Configurando as Contas de Remetentes" para maiores detalhes.
|-|<poweredSitelogotipo> - Site da empresa desenvolvedora |Imagem que contém o logotipo do sistemaemitente, para ser impresso junto com o conteúdo da tag <poweredBy>no quadro correspondente;
|-|<ImprimirTotalTributoscopias> - Indica ao sistema se deve imprimir |Número de cópias (vias) em que o total aproximado de tributos documento (Lei da Transparência FiscalDANFE, DACTE ou CC-e)deve ser gerado/impresso;
|-|<Anexo999configuracao> |Configuração do UniDANFE que será usada para a geração/impressão do documento (DANFE, DACTE ou CC- Outros arquivos que devem ser anexados ao e-mail. Aceita desde <Anexo1> até <Anexo999>);
|-|<horaSaidapoweredSite> Hora |Site da saída da mercadoriaempresa desenvolvedora do sistema, para impresso junto com o transporte. Esse campo já existe na estrutura do XML principal, contudo, em muitos casos não se tem essa hora no momento conteúdo 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.tag <poweredBy>;
|-|<dSaiEntnomeImpressao> 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 |Texto que vai aparecer no momento da gerenciador de impressão da mesmado Windows. O valor dessa TAG Se não será atualizado no XML principal, mas apenas impresso no DANFE.informado o texto padrão é gerado pelo UniDANFE;
|-|<nomeFantasiaDestimprimirTotalTributos> e <codigoDest> - Como seus próprios nomes demonstram, servem para informar |Indica ao UniDANFE sistema se deve imprimir o nome total aproximado 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 tributos (entregadorLei da Transparência Fiscal) a localização dos estabelecimentos destinatários, que raramente estampam a razão social em placas externas.;
|-|<cepLocalEntregaanexo1> - Campo |Outros arquivos 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ádevem ser anexados ao e-lo no XML auxiliarmail.Aceita desde <anexo1> até <anexo9>;
|-|<nomeLocalEntregadescricaoAnexo1> - Campo que não existe atualmente na estrutura do XML principal. O UniDANFE imprime o local de entrega no corpo |Descrição do DANFE quando arquivo informado no XML principal. No entanto, para preenchimento do NOME, é necessário informá-lo no XML auxiliarem <Anexo1>.Aceita desde <descricaoAnexo1> até <descricaoAnexo9>;
|-|<cepLocalRetiradacombinarPDF> - Igualmente ao CEP do local de entrega, |Define se o UniDANFE imprime o local de retirada no corpo do DANFE quando informado no XML principaldeve combinar vários arquivos PDF em único PDF. No entantoUsado em conjunto com os parâmetros "Anexo1", "Anexo2", para preenchimento do CEPetc, é necessário informáquando outros PDFs externos podem ser anexados ao e-lo no XML auxiliarmail.Os valores aceitos são:
|-|<textoCanhotosenhaPDF> - 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|Define uma senha para o PDF combinado.
|-|<imagemAdicionalpastaLocalQRCode> - Nome completo, incluindo o caminho, de (Plus)|Indica uma pasta local ou da rede para onde a imagem do QRCode da chave de acesso gerada deve ser copiada para ser impressa no rodapé da seção "DADOS ADICIONAIS", dentro do quadro "Informações Complementares". posterior utilização pelo sistema. Válido apenas para impressão ERP do DANFE em orientação RETRATOcliente.
|-|<alturaImagemAdicionalimprimirQRCodePix> - Altura, em milésimos de polegadas, com que a imagem adicional vai ser impressa(Plus)|Indica ao sistema se deve imprimir o QRCode do PIX no documento auxiliar. Essa altura será adicionada ao quadro Aceita os valores "1" (sim) ou "Dados Adicionais0". Se omitido, o valor padrão 1000 (aproximadamente 25mmnão) é assumido. Válido apenas para impressão do DANFE em orientação RETRATO.
|-|<produtosqrCodePix> - 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 |Chave do pix que deve ser codificada no UniDANFE PlusQRCode.
|-|<produto?pastaLocalQRCodePix> - Abre um grupo de TAGS de produtos. Deve ser aberta (Plus)|Indica uma TAG de grupo de produtos pasta local ou da rede para cada produto constante no XML auxiliar. O símbolo "?" presente nessa TAG onde a imagem do QRCode do Pix gerada deve ser substituído copiada para posterior utilização pelo mesmo número de sequência presente na TAG de grupo <det nItem="?"> sistema ERP do XML principalcliente.
|-|<fatura><aux_nnnnnnparcela?>(Plus) - No UniDANFE v.3 Plus |Grupo de TAGS onde é 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 informar parcelamento para os tipos de IPI para empresas impresso que não utilizem tem 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 conjunto de TAGs 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> é o caso da NFS-e <Aux_Tamanho>.
|-|<imprimirProdutosimagemAdicional> - Indica se deve ou não imprimir os produtos. Aceita os valores |Nome completo, incluindo o caminho, de uma imagem para ser impressa no rodapé da seção "1DADOS ADICIONAIS" (sim) ou , dentro do quadro "0Informações Complementares" (não). sistema. Válido apenas para impressão do DANFE em orientação RETRATO.
|-|<pastaLocalQRCodealturaImagemAdicional>(Plus) - Indica uma pasta local ou da rede para onde |Altura, em milésimos de polegadas, com que a imagem do QRCode gerada deve adicional vai ser copiada impressa. Essa altura será adicionada ao quadro "Dados Adicionais". Se omitido, o valor padrão 1000 (aproximadamente 25mm) é assumido. Válido apenas para posterior utilização pelo sistema ERP impressão do clienteDANFE em orientação RETRATO.
|-|<trocoprodutos> - indica ao sistema |TAGS utilizadas para informações complementares aos produtos. É um recurso especial do UniDANFE para suprir necessidades que o valor que deve ser impresso XML auxiliar não contempla. Através dessas TAGS, é possível incluir uma coluna livre (Free) no campo DANFE, ou definir colunas específicas (Plus) iniciadas com o prefixo "TrocoAux_", na seção para utilização através das configurações de totais.Atenção: Essa TAG é desconsiderada a partir da versão 4.00 do XMLcolunas, que já contempla a TAG <vTroco> presentes no próprio XML da NFC-eUniDANFE Plus.
|-|<ImprimirTotalTributosProdutoproduto?> - Indica ao sistema se |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 imprimir o total aproximado ser substituído pelo mesmo número de sequência presente na TAG de tributos grupo <det nItem="?"> do produto (Lei da Transparência Fiscal);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
|}