---
title: Como funciona a renomeação automática no download de arquivo?
description: Renomeação de documentos e sintaxe padrão de nomenclatura.
---

[Pular para o conteúdo](https://conteudo.cubienergia.com/ajuda/como-funciona-a-renomeacao-automatica-no-download-de-arquivos#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 | Geral](https://conteudo.cubienergia.com/ajuda/relat%C3%B3rios-e-dados?hsLang=pt-br#faturas-geral)

# Como funciona a renomeação automática no download de arquivo?

Todos arquivos enviados ao sistema tem o nome substituído por um padrão que facilita sua indexação nos gerenciadores de arquivos. O padrão usado pela CUBI segue a seguinte sintaxe:

###### **Para documentos de água:**

`branch_tradename`\_Forn\_`basic_provider`\_IdDoc\_`meta_billingFileId`\_NumUC\_`basic_locationNumber`\_MesRef\_`basic_referenceMonth`\_Venc\_`basic_dueDate`\_ValorBRL\_`meterLevel_totalCharges`.pdf  

###### **Para documentos de energia:**

`branch_tradename`\_Forn\_`basic_fullName`\_IdDoc\_`meta_billingFileId`\_NumUC\_`branch_locationNumber`\_MesRef\_`basic_referenceMonth`\_Venc\_`basic_dueDate`\_ValorBRL\_`values_totalCharges`.pdf  

###### **Para documentos de danfe:**

`branch_tradename`\_Forn\_`basic_sellerName`\_IdDoc\_`meta_billingFileId`\_NumUC\_`branch_locationNumber`\_MesRef\_`basic_referenceMonth`\_Venc\_`basic_dueDate`\_ValorBRL\_`values_totalCharges`.pdf  

 

Consulte os campos já mapeados de [energia](https://conteudo.cubienergia.com/ajuda/campos-faturaenergia?hsLang=pt-br), [água](https://conteudo.cubienergia.com/ajuda/campos-faturaagua?hsLang=pt-br) e [danfe](https://conteudo.cubienergia.com/ajuda/campos-danfe?hsLang=pt-br) para saber mais sobre os campos considerados na sintaxe.

---

### Regras de funcionamento

1. O arquivo será renomeado apenas após o status do arquivo passar para o estado de "sucesso"; [Veja detalhes sobre o status dos arquivos neste artigo](https://conteudo.cubienergia.com/ajuda/o-que-significa-documento-com-status-de-processando?hsLang=pt-br).
2. O arquivo de água e danfe que estiver com o estado de "sucesso" mas não tiver um vínculo com alguma Unidade da plataforma exibirá "Aguardando Relacionamento - água" ou "Aguardando Relacionamento - danfe" no lugar do `branch_tradename` até que o documento seja vinculado; [Veja detalhes sobre o vínculo de documentos neste artigo](https://conteudo.cubienergia.com/ajuda/faturas-de-energia-e-documentos-de-danfe-relacionados?hsLang=pt-br).
3. Antes de entrar no estado de "sucesso" o documento será renomeado com todos os campos rotulados como "Desconhecido", apenas o DocId será preenchido;
4. Quando qualquer uma das informações usadas na nomenclatura não for encontrada no arquivo o campo será preenchido como "Desconhecido" na nomenclatura;
5. Caso o usuário troque o nome da Unidade ou o número da unidade consumidora da Unidade a nomenclatura dos arquivos enviados anteriormente à mudança não serão atualizados;
6. É possível que existam casos de arquivos no status "sucesso" e que já foram relacionados com Unidades mas que ainda apresentam a nomenclatura do nome da unidade como "Unidade não relacionada" ou "Aguardando relacionamento \[...\]". Esses casos deverão ser reprocessados automaticamente em até 24 horas após o vínculo (se aplicável) e o status se tornar "sucesso";
7. A renomeação de arquivos funciona apenas na função de download em massa. [Veja mais informações sobre download em massa aqui](https://conteudo.cubienergia.com/ajuda/como-fazer-download-de-documentos?hsLang=pt-br).

 

**Dica**: se você quer organizar seus arquivos de alguma forma específica ou com algum código ou nome que remeta à unidade, renomeie suas Unidades de acordo com sua necessidade pois o nome da Unidade vai aparecer em todos arquivos vinculados a ela!

 

 

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