--- title: Quais são os campos de Faturas de Água já mapeados? description: Entenda a definição e campos de faturas de água que já são mapeados na plataforma. --- [Pular para o conteúdo](https://conteudo.cubienergia.com/ajuda/campos-faturaagua#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 Faturas de Água já mapeados? ## Entenda a definição e campos de faturas de água que já são mapeados na plataforma. 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 água [1. Pagamento e identificação básicos (todos primários)](https://conteudo.cubienergia.com/ajuda/campos-faturaagua#Pagamento-e-identificacao-basicos) [2. Gerados pelo sistema da CUBi](https://conteudo.cubienergia.com/ajuda/campos-faturaagua#Gerados-pelo-sistema-da-CUBi) [3. Identificação](https://conteudo.cubienergia.com/ajuda/campos-faturaagua#Identificacao) [4. Datas](https://conteudo.cubienergia.com/ajuda/campos-faturaagua#datas) [5. Concessionária de água](https://conteudo.cubienergia.com/ajuda/campos-faturaagua#concessionaria-agua) [6. Consumo de água e esgoto](https://conteudo.cubienergia.com/ajuda/campos-faturaagua#consumo-agua-esgoto) [7. Impostos](https://conteudo.cubienergia.com/ajuda/campos-faturaagua#impostos) [9. Outras cobranças e créditos](https://conteudo.cubienergia.com/ajuda/campos-faturaagua#outras-cobrancas) | ###### PROPRIEDADES DE PAGAMENTO E IDENTIFICAÇÃO BÁSICOS | | | | | | --- | --- | --- | --- | --- | | ###### ID | ###### Nome aparente | ###### Descrição | ###### Tipo de extração | ###### Uso interno/API | | 1 | CNPJ da Unidade Consumidora | CNPJ da Unidade Consumidora que aparece na fatura | Primário | basic\_cnpj | | 2 | Número da Unidade Consumidora | Número da Unidade Consumidora da Unidade de água | Primário | basic\_locationNumber | | 3 | CNPJ do fornecedor | CNPJ da concessionária de energia | Primário | basic\_sellerCnpj | | 4 | Código de Barras | Código de barras do arquivo | Primário | basic\_barCode | | 5 | Número da Nota Fiscal | Número da Nota Fiscal da fatura | Primário | basic\_invoiceNumber | | 6 | Valor total (R$) | Valor total da fatura | Primário | meterLevel\_totalCharges | | 7 | Mês de Referência | Mês de referência de consumo | Primário | basic\_referenceMonth | | 8 | Data de vencimento | Data de vencimento da fatura | Primário | basic\_dueDate | | 9 | Volume faturado de Água (m³) | Valor em metros cúbicos faturados de água tratada | Primário | meterLevel\_billedVolume | | 10 | Razão Social | Nome da entidade PJ ou PF responsável pela Unidade Consumidora que aparece na fatura | Primário | basic\_name | | 11 | Nome do fornecedor | Nome da Distribuidora de água | Primário | basic\_provider | | ###### PROPRIEDADES GERADAS PELO SISTEMA DA CUBi | | | | | | ###### ID | ###### Nome aparente | ###### Descrição | ###### Tipo de extração | ###### Uso interno/API | | 12 | Nome da Unidade | Nome comercial da branch (unidade no KiP) | N/A | branch\_tradename | | 13 | CNPJ da UC (KiP) | CNPJ da branch (unidade no KiP) | N/A | branch\_cnpj | | 14 | CNPJ da Empresa (KiP) | CNPJ da Empresa em que o documento foi registrado no KiP | N/A | company\_cnpj | | 15 | ID do arquivo | Código de identificador único de um registro de dado na plataforma da CUBi | N/A | meta\_billingFileId | | 16 | ID da Unidade | Código de identificador único de uma Unidade na plataforma da CUBi | N/A | branch\_id | | 17 | 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 | | 18 | Observações do arquivo | Observação inserida pelo usuário da CUBi no arquivo associado ao ID do arquivo. | N/A | meta\_billingNotes | | 19 | Data de envio do documento | Data em que o documento foi recebido pela CUBi | N/A | pdf\_uploadDatetime | | 20 | Data de extração | Data em que o documento foi processado com sucesso pela primeira vez | N/A | meta\_billedAt | | 21 | Data de processamento | Última data de processamento do documento. | N/A | meta\_updatedAt | | ###### PROPRIEDADES DE IDENTIFICAÇÃO | | | | | | ###### ID | ###### Nome aparente | ###### Descrição | ###### Tipo de extração | ###### Uso interno/API | | 22 | Estado | O Estado Federativo do Brasil que pertence o endereço da Unidade Consumidora | Terciário | basic\_state | | 23 | Cidade | Cidade da Unidade Consumidora | Terciário | basic\_city | | 24 | Logradouro | Logradouro da Unidade Consumidora | Terciário | basic\_address | | 25 | Número do Medidor | Número do medidor da Unidade de água | Terciário | meterLevel\_meterNumber | | ###### PROPRIEDADES DA CONCESSIONÁRIA DE DISTRIBUIÇÃO DE ÁGUA | | | | | | ###### ID | ###### Nome aparente | ###### Descrição | ###### Tipo de extração | ###### Uso interno/API | | 26 | Tipo de Faturamento | Descrição do tipo de faturamento (medido ou média) | Terciário | meterLevel\_billingType | | 27 | Dias medidos | Dias de faturamento medidos | Terciário | meterLevel\_days | | 28 | Informações Complementares (Fatura de Água) | Campo textual para as informações complementares das faturas de água | Terciário | basic\_billingInfo | | ###### PROPRIEDADES DE DATAS | | | | | | ###### ID | ###### Nome aparente | ###### Descrição | ###### Tipo de extração | ###### Uso interno/API | | 29 | Data de leitura anterior | Data da leitura anterior da fatura dessa Unidade Consumidora | Terciário | basic\_previousReading | | 30 | Data de leitura | Data de leitura atual da fatura | Secundário | basic\_readingDate | | 31 | Data de próxima leitura | Data da próxima leitura para gerar a fatura dessa Unidade Consumidora | Terciário | basic\_nextReading | | 32 | Data de emissão | Data de emissão da Fatura | Secundário | basic\_issueDate | | ###### PROPRIEDADES DE CONSUMO (ÁGUA E ESGOTO) | | | | | | ###### ID | ###### Nome aparente | ###### Descrição | ###### Tipo de extração | ###### Uso interno/API | | 33 | Volume medido de Esgoto (m³) | Valor em metros cúbicos medidos de esgoto | Terciário | measures\_sewer | | 34 | Volume medido de Água (m³) | Valor em metros cúbicos medidos de água tratada | Terciário | measures\_water, meterLevel\_measuredVolume | | 35 | Valor para tratamento de esgoto (R$) | Valor monetário total a ser pago referente ao uso do sistema de tratamento de esgoto | Terciário | values\_sewer | | 36 | Valor do consumo de água (R$) | Valor monetário total a ser pago referente ao uso do sistema de tratamento de água | Secundário | values\_water | | ###### PROPRIEDADES DE IMPOSTOS | | | | | | ###### ID | ###### Nome aparente | ###### Descrição | ###### Tipo de extração | ###### Uso interno/API | | 37 | Alíquota de PIS | Alíquota do imposto PIS em % | Terciário | rates\_pis | | 38 | Valor de PIS (R$) | Valor monetário total pago por PIS | Terciário | values\_pis | | 39 | Alíquota de COFINS | Alíquota do imposto PIS em % | Terciário | rates\_cofins | | 40 | Valor de COFINS (R$) | Valor monetário total pago por COFINS | Terciário | values\_cofins | | 41 | Valor de PIS/COFINS (R$) | Valor monetário total pago por PIS/COFINS | Primário | values\_pisCofins | | 45 | Valor de IBS (R$) | Valor monetário total pago por IBS | Terciário | values\_ibs | | 46 | Valor de CBS (R$) | Valor monetário total pago por CBS | Terciário | values\_cbs | | ###### PROPRIEDADES DE OUTRAS COBRANÇAS E CRÉDITOS | | | | | | ###### ID | ###### Nome aparente | ###### Descrição | ###### Tipo de extração | ###### Uso interno/API | | 42 | Multa por Pagamento em atraso (R$) | Multa por Pagamento em atraso (R$) | Primário | values\_lateFee | | 43 | Descontos Extras (R$) | Outros descontos e créditos lançados na fatura | Terciário | values\_otherDiscountCharges | | 44 | Outras cobranças (R$) | Outras cobranças lançadas na fatura | Terciário | values\_othersCharges |       ### 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