---
title: Como funcionam os documentos customizados?
description: Envio de documentos customizados
---

[Pular para o conteúdo](https://conteudo.cubienergia.com/ajuda/como-funcionam-os-documentos-customizados#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. [Ferramentas](https://conteudo.cubienergia.com/ajuda/ferramentas?hsLang=pt-br)
3. [Ferramentas | Envio de Faturas](https://conteudo.cubienergia.com/ajuda/ferramentas?hsLang=pt-br#ferramentas-envio-de-faturas)

# Como funcionam os documentos customizados?

Um documento customizado é uma forma rápida e fácil de se enviar dados para o processamento da plataforma manualmente. Essa função pode ser encontrada no sistema da CUBi em Ferramentas \> Complementos \> Customizadas. Esses são casos especialmente úteis quando:

1. Você não tem um [documento válido](https://conteudo.cubienergia.com/ajuda/formatos-validos-de-documentos?hsLang=pt-br) para enviar à CUBi;
2. Você não quer [esperar os SLA entre 72 a 96 horas úteis (consulte seu contrato)](https://conteudo.cubienergia.com/ajuda/o-que-significa-documento-com-status-de-processando?hsLang=pt-br) para extração e/ou coleta automatizada.

O formulário de envio vai funcionar exatamente como se você estivesse enviando um documento válido. Ou seja, o comportamento padrão é:

**Para envios de documentos de energia:**

1. Caso já exista um número de Unidade Consumidora de Energia idêntico registrado na plataforma, o sistema associará o documento automaticamente com essa unidade;
2. Caso o número de  Unidade Consumidora de Energia enviado seja inédito, o sistema vai criar uma nova Unidade para associar o documento;

**Para envios de documentos de água:**

1. Caso já exista um número de Unidade Consumidora de Água idêntico registrado na plataforma vinculado a um número de Unidade Consumidora de Energia, o sistema associará o documento automaticamente com essa Unidade de energia;
2. Caso o número de Unidade Consumidora de Água enviado seja inédito, você pode preencher o número de Unidade Consumidora de Energia idêntico ao registrado na plataforma e o vínculo acontecerá automaticamente ou deixar em branco e vincular a fatura de água a uma unidade de energia na tela de [vincular faturas](https://conteudo.cubienergia.com/ajuda/relacionar-documentos-de-danfe-e-faturas-de-agua-com-unidades?hsLang=pt-br) ;

**Limitações do sistema de documentos customizados:**

O documento anexado como evidência não pode ser protegido por senha.

Os campos aceitos atualmente são (`água`/`energia`):

*Veja detalhes e definições para campos de [água](https://conteudo.cubienergia.com/ajuda/campos-faturaagua?hsLang=pt-br) e [energia](https://conteudo.cubienergia.com/ajuda/campos-faturaenergia?hsLang=pt-br).*

- Nome do fornecedor `basic_provider`/`basic_fullName`;
- Quantidade (kwh ou m3) `measures_water`/`measures_energyTotal`;
- Valor (R$) `meterLevel_totalCharges`/`values_totalCharges`;
- Mês de referência `basic_referenceMonth`/`basic_referenceMonth`;
- Data de leitura inicial `basic_previousReading`/`basic_startDate`;
- Data de leitura final `basic_readingDate`/`basic_endDate`;
- Data de vencimento `basic_dueDate`/`basic_dueDate`;
- Método de pagamento *(não mapeado, apenas no PDF)*;
- Informações complementares `basic_billingInfo`/`basic_billingInfo`;
- Código de barras `basic_barcode` / `basic_barcode`;
- Multa por Pagamento em atraso (R$) `values_lateFee`/`values_lateFee`;
- Lançamentos Extras (R$)`values_otherCharges` / `values_otherCharges`
- Tipo de Faturamento `meterLevel_billingType`/ `basic_billingType`

- Número da Nota Fiscal `basic_invoiceNumber`/`basic_invoiceNumber`
- Valor para parcela de Água (R$)
- Valor para parcela de Esgoto (R$)

- Anexo de evidência *(não mapeado, apenas no PDF)*;

 

**Como o documento será emitido?**

Após enviar os dados via formulário, um arquivo em PDF será gerado com um layout padrão, conforme o exibido abaixo. Nele todas informações inseridas no formulário serão exibidas na primeira página e o PDF de evidência será anexado na segunda página (no caso abaixo é um boleto).

![Customizada](https://conteudo.cubienergia.com/hs-fs/hubfs/Customizada.jpg?width=339&height=935&name=Customizada.jpg)

[![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).

<https://www.linkedin.com/company/cubienergia> <https://www.youtube.com/@cubienergia>

Copyright © 2025, CUBi Energia