Mudanças

=__NOTOC____NOTITLE__== Estrutura do XML auxiliar ===

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.

<nowikipre><?xml version="1.0" encoding="UTF-8"?>

<horaSaida>12:20</horaSaida> <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>

<ImprimirTotalTributosimprimirTotalTributos>1</ImprimirTotalTributosimprimirTotalTributos> <ImprimirTotalTributosProdutoimprimirTotalTributosProduto>1</ImprimirTotalTributosProdutoimprimirTotalTributosProduto> <imprimirValorUnitarioLiquido>0</imprimirValorUnitarioLiquido> <imprimirValorTotalLiquido>9</imprimirValorTotalLiquido>

<trocoimprimirQRCodePix>43.201</imprimirQRCodePix> <qrCodePix>minha-chave-pix-aqui</qrCodePix> <pastaLocalQRCodePix>c:\Meu_Erp\MinhasImagens\QRCodePix</trocopastaLocalQRCodePix> <TextoMarcaDaguatextoMarcaDagua>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</combinarPDF> <senhaPDF>123456</Anexo1senhaPDF> <descricaoAnexo1> (até Arquivo PDF com os boletos das parcelas da compra ref. pedido 99999<Anexo999/descricaoAnexo1>)

<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>

</nowikipre>

=== 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.

<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 {| class="Identificação do Emitentewikitable", no documento (DANFE, DACTE ou CC|-e).!colspan="2"|TAGS comuns a todos tipos de documentos

<emailDest> |- Endereço eletrônico |Encoding|Conjunto de caracteres do destinatárioXML. Esse endereço será usado pelo UniDANFE para enviar Válidos: "UTF-8" e"ISO-mail ao destinatário contendo o documento (DANFE, DACTE ou CC8859-e) e/ou o XML principal, como anexo(s)1".

|-|<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>);

Outras TAGS utilizadas |-|<poweredBy>|Publicidade que é impressa no DANFE de NF-e:rodapé do impresso. Nome da empresa desenvolvedora do sistema;

|-|<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:

<nomeLocalRetirada> - Igualmente ao CEP 0 = não combinar os PDFs;1 = Combinar todos os PDFs externos junto com o PDF do local de retiradadocumento, enviando apenas um único PDF como anexo;2 = Combinar apenas os PDFs externos, enviando dois PDFs como anexo: o UniDANFE imprime o local de retirada no corpo do DANFE quando informado no XML principal. No entanto, para preenchimento PDF do NOME, é necessário informá-lo no XML auxiliardocumento e um PDF combinando todos os PDFs externos.

|-|<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.

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!colspan="2"|Fatura: UniDANFE.exe a=01010101.xml d=free

|-|<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>.

<ImprimirTotalTributosProduto> |- Indica ao sistema se deve imprimir o total aproximado !colspan="2"|Outras TAGS utilizadas no DANFE de tributos do produto (Lei da Transparência Fiscal);NF-e:

Outras TAGS utilizadas |-|<textoCanhoto>|Redefinição do texto padrão impresso no canhoto do DANFE de NFC. O texto que for definido nessa TAG será impresso integralmente, sobrepondo-e:se ao padrão atual do sistema.

|-|<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.

?|-|<aux_nnnnnn>(Plus) Campos não previstos |No UniDANFE Plus é possível configurar cada coluna que será impressa no XML Principal Além da utilização do arquivo XML auxiliarDANFE, bem como mudar sua posição, há a possibilidade de informar alguns campos e inclusive remover colunas não previstos no XML principal utilizando-se as TAG´s utilizadas, como valor e alíquota de uso livre. Observe IPI para empresas que a SEFAZ aceita no máximo 10 (dez) TAG´s dessas no mesmo XMLnão utilizem esse imposto, por exemplo. Assim, fica a cargo Também é possível adicionar novas colunas do desenvolvedor escolher quais irá utilizar para melhor integrar seu ERP ao UniDANFEDANFE. As informações que são previstas e que Nesse caso, podem ser informadas nessa adicionadas qualquer TAG são: Logotipo - Logotipo do emitente; Telefones_Emitente - Telefones grupo <det> do emitenteXML principal, ou mesmo outras que não existam nesse XML principal. Por exemplo, para sair adicionar no quadro "Identificação DANFE, logo após a descrição do Emitente". Utilizar quando se deseja imprimir mais de um número de telefone nesse quadro. Email_Destinatario - E-mail produto uma coluna contendo a cor do mesmo, basta incluir a coluna <aux_Cor> na configuração do destinatário da NF-e. Informar para automatizar processo de envio da NF-e 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 para o destinatário da NF-e. Email_CC - E-mail para auxiliar, onde uma cópia da NF-foram definidas as TAGS <aux_Cor> 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<aux_Tamanho>.

Remetente |- Email ou apelido |<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 remetente 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 eTAG´s específicas, pode-mails. O conteúdo dessa se gerar o complemento da descrição nessa TAG <infAdVeic> no arquivo auxiliar, que a mesma 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 adicionada à descrição complementar, no sistema. Consulte ponto onde a seção "Configurando as Contas mesma for inserida na interface de Remetentes" para maiores detalhesconfiguração do UniDANFE.

Nome_Fantasia_Dest |- Ao informar esse campo, |<imprimirTotalTributosProduto>|Indica ao sistema se deve imprimir o nome fantasia é impresso no DANFE à direita da razão social total aproximado de tributos do destinatário produto (Lei da NF-e.Transparência Fiscal);

Codigo_Destinatario |- Ao informar esse campo|<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 código é impresso no DANFE à direita da razão social valor líquido for diferente do destinatário da NF-e.valor bruto);

Nome_Local_Entrega |- Nome |<imprimirValorTotalLiquido> (Plus)|Indica ao sistema se deve imprimir a coluna "Valor Total Líquido" do estabelecimento no local de entregaproduto. Impresso no corpo Aceita os valores "1" (sim, sempre), "0" (não) ou "9" (automático - imprime apenas se o valor líquido for diferente do DANFE, juntamente ao endereço de entrega.valor bruto);

Cep_Local_Entrega |- CEP do local de entrega. Impresso !colspan="2"|Outras TAGS utilizadas no corpo do DANFE, juntamente ao endereço de entrega.NFC-e

Nome_Local_Retirada |- Nome do estabelecimento no local de retirada|<imprimirProdutos>|Indica se deve ou não imprimir os produtos. Impresso no corpo do DANFE, juntamente ao endereço de retiradaAceita os valores "1" (sim) ou "0" (não).

Cep_Local_Retirada |- CEP do local |<imprimirTotalTributosProduto>|Indica ao sistema se deve imprimir o total aproximado de retirada. Impresso no corpo tributos do DANFE, juntamente ao endereço de retirada.produto (Lei da Transparência Fiscal);

Texto_Fatura |- Texto para ser impresso no campo !colspan="Fatura2", do quadro "Fatura/duplicatas".|Outras TAGS utilizadas na CC-e

veicTransp |- Placa do veiculo|<anexarDFe>|Indica se o Arquivo Auxiliar (DANFE, UF e número do RNTCDACTE, para os casos em que esses campos não estão previstos no XML do documento etc) deve ser anexado à impressão da CC-e mesmo assim queira. Válidos: 0=Não 1=Sim (antes da CC-se imprimie) 2=Sim (após a CC-los. Caso o grupo de TAGs <veicTransp> esteja presente no XML do documento, esse conteúdo dentro do grupo <infAdic> será ignorado automaticamentee).

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):...<infAdic><infCpl>xxxx xxx xxxxxxxx xxxxx xxxxx;xxxxx xxxx xxxx xxxxx</infCpl><obsCont xCampo="Logotipo"><xTexto>c:\imagens\logomarca.jpg</xTexto></obsCont><obsCont xCampo="Email_Destinatario"><xTexto>[email protected]</xTexto></obsCont><obsCont xCampoVeja também="Email_CC"><xTexto>[email protected]</xTexto></obsCont><obsCont xCampo="Email_CCO"><xTexto>[email protected]</xTexto></obsCont><obsCont xCampo="Remetente"><xTexto>[email protected]<* [[Manuais:UniDANFE/xTexto><Integrando o UniDANFE ao ERP/obsCont><obsCont xCampo="Remetente"><xTexto>apelido do remetente</xTexto></obsCont>XML auxiliar|XML Auxiliar]]<obsCont xCampo="Telefones_Destinatario"><xTexto>Fone* [[Manuais: (nn) nnnn-nnnn - Fax: nnnn-nnnn<UniDANFE/xTexto><Integrando o UniDANFE ao ERP/obsCont><obsCont xCampo="Nome_Fantasia_Dest"><xTexto>Nome TAGS de uso livre|TAGS de Fantasia</xTexto></obsCont>uso livre no próprio XML do Documento Fiscal Eletrônico]]<obsCont xCampo="Codigo_Destinatario"><xTexto>12345</xTexto></obsCont><obsCont xCampo="Nome_Local_Entrega"><xTexto>NOME DO ESTABELECIMENTO</xTexto><* [[Manuais:UniDANFE/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|PRConfigurando o UniDANFE|1234567890</xTexto></obsCont></infAdic>...Configurando o UniDANFE]]