--- title: Quais são os campos de Danfes de energia já mapeados? description: Entenda a definição e campos de Danfes que já são mapeados na plataforma. --- [Pular para o conteúdo](https://conteudo.cubienergia.com/ajuda/campos-danfe#main-content) Português - Brasil Mostrar submenu para traduções [Entre em contato com nosso suporte](https://conteudo.cubienergia.com/ajuda/kb-tickets/new?hsLang=pt-br) [Ver meus chamados abertos](https://suporte.cubienergia.com/chamados?hsLang=pt-br) [![logo branco.png\]](https://conteudo.cubienergia.com/hs-fs/hubfs/logo%20branco.png?width=78&height=47&name=logo%20branco.png)](https://conteudo.cubienergia.com/ajuda?hsLang=pt-br) - [Ver novidades de produto](https://www.cubienergia.com/novidades-de-produto-da-cubi/) - [Central de conhecimento](https://conteudo.cubienergia.com/ajuda) Abrir navegação principal Fechar navegação principal - [Ver novidades de produto](https://www.cubienergia.com/novidades-de-produto-da-cubi/) - [Central de conhecimento](https://conteudo.cubienergia.com/ajuda) - Português - Brasil Mostrar submenu para traduções - [Entre em contato com nosso suporte](https://conteudo.cubienergia.com/ajuda/kb-tickets/new) - [Ver meus chamados abertos](https://suporte.cubienergia.com/chamados) - [Acesse a plataforma](https://kip.cubi.com.br/login) [Acesse a plataforma](https://kip.cubi.com.br/login) Olá. Como podemos te ajudar hoje? - Não há sugestões porque o campo de pesquisa está em branco. 1. [Tudo que você precisa saber sobre gestão de energia na plataforma da CUBi](https://conteudo.cubienergia.com/ajuda?hsLang=pt-br) 2. [Relatórios e dados](https://conteudo.cubienergia.com/ajuda/relat%C3%B3rios-e-dados?hsLang=pt-br) 3. [Faturas | Mapeamento de campos](https://conteudo.cubienergia.com/ajuda/relat%C3%B3rios-e-dados?hsLang=pt-br#faturas-mapeamento-de-campos) # Quais são os campos de Danfes de energia já mapeados? ## Entenda a definição e campos de Danfes que já são mapeados na plataforma. **Atenção**, apenas arquivos .xml são aceitos como danfes. Veja abaixo a lista de campos conhecidos e já mapeados. **Atenção**: os campos listados abaixo são extraídos apenas se estiverem explicitamente rotulados na fatura de energia, via de regra nenhuma inferência é feita exceto quando expressamente rotulado. Para casos genéricos é possível que exista agregação de uma ou mais linhas da fatura de energia somados em um mesmo campo. Para casos generalistas em que o posto tarifário não é informado, sempre consideraremos horário fora ponta. Caso não encontre um campo, veja como **[solicitar um mapeamento](https://conteudo.cubienergia.com/ajuda/como-solicitar-o-mapeamento-de-um-campo-novo?hsLang=pt-br)** ### Índice de campos de danfe de ACL [1. Pagamento e identificação básicos (todos primários)](https://conteudo.cubienergia.com/ajuda/campos-danfe#Pagamento-e-identificacao-basicos) [2. Gerados pelo sistema da CUBi](https://conteudo.cubienergia.com/ajuda/campos-danfe#Gerados-pelo-sistema-da-CUBi) [3. Identificação](https://conteudo.cubienergia.com/ajuda/campos-danfe#identificacao-comprador-vendedor) [4. Impostos](https://conteudo.cubienergia.com/ajuda/campos-danfe#impostos) [5. Outras informações](https://conteudo.cubienergia.com/ajuda/campos-danfe#outras-informacoes)   | ###### PROPRIEDADES DE PAGAMENTO E IDENTIFICAÇÃO BÁSICOS | | | | | | --- | --- | --- | --- | --- | | ###### ID | ###### Nome aparente | ###### Descrição | ###### Tipo de extração | ###### Uso interno/API | | 1 | Nome do comprador | Nome do comprador | Primário | basic\_buyerName | | 2 | CNPJ do comprador | Cadastro Nacional de Pessoa Jurídica do comprador | Primário | basic\_buyerCnpj | | 3 | IE do comprador | Inscrição Estadual do comprador | Primário | basic\_buyerIe | | 4 | Nome do fornecedor | Razão Social do vendedor | Primário | basic\_sellerName | | 5 | CNPJ do fornecedor | Cadastro Nacional de Pessoa Jurídica do vendedor | Primário | basic\_sellerCnpj | | 6 | IE fornecedor | Inscrição Estadual do vendedor | Primário | basic\_sellerIe | | 7 | Data de emissão | Data de emissão da Danfe no formato DD/MM/AAAA. Atenção este campo é considerado como o mês de referência caso não exista um mês de referência mencionado nas informações adicionais | Primário | basic\_issueDate | | 8 | Mês de referência | Mês de referência é preenchido com a data de emissão caso nas informações complementares não identificarmos uma string no formato identificável: "competência: MM/AAAA" | Primário / inferência | basic\_referenceMonth | | 9 | Data de vencimento | Não há no xml padrão um campo específico apra o vencimento. A data de vencimento da Danfe é extraída apenas caso nas informações complementares não identificarmos uma string no formato identificável: "vencimento: DD/MM/AAAA" | Primário / inferência | basic\_dueDate | | 10 | Código de acesso | Código de acesso na receita federal ao documento fiscal | Primário | basic\_accessKey | | 11 | Número da nota 1 | Número da Nota Fiscal indicado na primeira linha | Primário | basic\_invoice1 | | 12 | Número da nota 2 | Número da Nota Fiscal indicado na segunda linha | Primário | basic\_invoice2 | | 13 | Série da nota 1 | Série da Nota Fiscal indicado na primeira linha | Primário | basic\_serie1 | | 14 | Série da nota 2 | Série da Nota Fiscal indicado na segunda linha | Primário | basic\_serie2 | | 15 | Total da Fatura (R$) | Valor monetário total da Danfe com todos descontos e adições, é o valor fiscal do documento. | Primário | values\_totalCharges | | ###### PROPRIEDADES GERADAS PELO SISTEMA DA CUBi | | | | | | ###### ID | ###### Nome aparente | ###### Descrição | ###### Tipo de extração | ###### Uso interno/API | | 16 | Nome da Unidade | Nome comercial da branch (unidade no KiP) | N/A | branch\_tradename | | 17 | CNPJ da UC (KiP) | CNPJ da branch (unidade no KiP) | N/A | branch\_cnpj | | 18 | CNPJ da Empresa (KiP) | CNPJ da Empresa em que o documento foi registrado no KiP | N/A | company\_cnpj | | 19 | ID do arquivo | Código de identificador único de um registro de dado na plataforma da CUBi | N/A | meta\_billingFileId | | 20 | ID da Unidade | Código de identificador único de uma Unidade na plataforma da CUBi | N/A | branch\_id | | 21 | ID de processamento | Código de identificador único de um registro de extração de dados de documentos na plataforma da CUBi. Esse código pode mudar de acordo com um evento de reprocessamento do registro. | N/A | N/D | | 22 | Data de envio do documento | Data em que o documento foi recebido pela CUBi | N/A | pdf\_uploadDatetime | | 23 | Data de extração | Data em que o documento foi processado com sucesso pela primeira vez | N/A | meta\_billedAt | | 24 | Data de processamento | Última data de processamento do documento. | N/A | basic\_updatedAt | | 25 | Observações do arquivo | Observação inserida pelo usuário da CUBi no arquivo associado ao ID do arquivo. | N/A | meta\_billingNotes | | ###### PROPRIEDADES DE IDENTIFICAÇÃO - COMPRADOR e FORNECEDOR | | | | | | ###### ID | ###### Nome aparente | ###### Descrição | ###### Tipo de extração | ###### Uso interno/API | | 26 | Estado do comprador | Estado da federação do comprador | Terciário | basic\_buyerState | | 27 | Cidade do comprador | Cidade do comprador | Terciário | basic\_buyerCity | | 28 | Logradouro do comprador | Logradouro do comprador | Terciário | basic\_buyerAddress | | 29 | Endereço completo do vendedor | Endereço completo do vendedor | Terciário | basic\_sellerAddress | | ###### PROPRIEDADES DE IMPOSTOS | | | | | | ###### ID | ###### Nome aparente | ###### Descrição | ###### Tipo de extração | ###### Uso interno/API | | 30 | Valor de ICMS ST | Valor de ICMS de Substituição tributária da Danfe globalmente | Primário | values\_icmsSt | | 31 | Base de Cálculo ICMS (R$) | Valor monetário total sobre o qual incide o ICMS | Primário | values\_icmsTaxable | | 32 | Base de Cálculo ICMS ST (R$) | Base de cálculo do ICMS da Danfe globalmente | Primário | values\_icmsTaxableSt | | 33 | Valor de ICMS (R$) | Valor do ICMS da Danfe globalmente | Primário | values\_icmsValue | | ###### OUTRAS INFORMAÇÕES | | | | | | ###### ID | ###### Nome aparente | ###### Descrição | ###### Tipo de extração | ###### Uso interno/API | | 34 | Observações | Descrição do campo de observações ou dados auxiliares à Danfe | Terciário | basic\_auxiliaryData |     ### Não encontrou o que procurava? Volte para a página inicial e procure pela palavra chave ou entre em contato conosco pelo [suporte@cubienergia.com](mailto:suporte@cubienergia.com)! [![Chill listening crop-3](https://conteudo.cubienergia.com/hs-fs/hubfs/favicon%20CUBi%20(1).png?width=23&height=24&name=favicon%20CUBi%20(1).png "Chill listening crop-3")](https://www.cubienergia.com/) Centro de ajuda da cubienergia.com Peça uma nova funcionalidade preenchendo [este formulário](https://forms.gle/1FB7BMHcfyJZZsso9). Copyright © 2025, CUBi Energia