https://github.com/tgentil/organizadornfe
Este código é um organizador de arquivos XML que move os arquivos para diferentes diretórios com base em informações contidas nos arquivos XML.
https://github.com/tgentil/organizadornfe
nf-e nfc-e python sorting-files
Last synced: 3 months ago
JSON representation
Este código é um organizador de arquivos XML que move os arquivos para diferentes diretórios com base em informações contidas nos arquivos XML.
- Host: GitHub
- URL: https://github.com/tgentil/organizadornfe
- Owner: Tgentil
- Created: 2023-04-17T17:53:23.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2023-07-11T12:21:14.000Z (almost 2 years ago)
- Last Synced: 2025-03-20T08:43:32.074Z (3 months ago)
- Topics: nf-e, nfc-e, python, sorting-files
- Language: Python
- Homepage:
- Size: 70.3 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Organizador de NF-Es
[](./docs/translate/english/README.md)
[](https://github.com/Tgentil)
Este código é um organizador de arquivos XML que move os arquivos para diferentes diretórios com base em informações contidas nos arquivos XML.
## Funcionalidade
O código lê NF-Es em arquivos XML dentro do diretório data e, com base em informações dentro do arquivo, move o arquivo para um diretório correspondente. os arquivos são movidos para diretórios diferentes dependendo do valor do elemento tPag no arquivo XML. Se o arquivo já existir no diretório de destino, uma mensagem de aviso será exibida. Arquivos que não atendem aos critérios acima são movidos para um diretório de arquivos cancelados e inutilizados. Quando a tarefa é concluída, uma mensagem de conclusão é exibida.
## Instalação
Este código não requer nenhuma biblioteca adicional, além das bibliotecas padrão do Python. Basta clonar o repositório ou copiar o código para o seu ambiente.
## Estruturação do código
```bash
+--./
|-- README.md
| +--.github/
| | +--workflows/
| | |-- pylint.yml
| +--.vscode/
| |-- settings.json
| +--code/
| |-- nfe_finder.py
| |-- organizador_nfce.py
| |-- parcelas_por_mes.py
| |-- sorter.py
| +--data/
| |-- .gitkeep
| +--docs/
| | +--nfe-finder/
| | |-- README.md
| | +--parcela_por_mes/
| | |-- README.md
| | +--sorter/
| | |-- README.md
```
## Como utilizar o código
Para utilizar este código, é necessário colocar os arquivos XML que deseja organizar dentro da pasta `data`. Em seguida, execute o código e os arquivos serão organizados e armazenados na pasta `out`. Um relatório em formato TXT será gerado, mostrando quantos arquivos foram movidos para cada pasta.
Após o uso do código, é recomendável mover a pasta `out` para o local desejado. Para reutilizar o código em outra ocasião. Dessa forma, os arquivos já organizados serão preservados e você poderá continuar trabalhando com a organização dos arquivos XML.
## Uso
Para executar o código, basta executar o arquivo Python `organizador_nfce.py`. O código será executado e organizará todos os arquivos XML no diretório especificado. O código exibirá uma mensagem de aviso se o arquivo já existir no diretório de destino e uma mensagem de conclusão após a organização dos arquivos.
## Arquivos repetidos
Caso houver arquivos repetidos, o código irá identificá-los e salvá-los dentro da pasta `repetidos` dentro da pasta `out`. Além disso, o relatório gerado também irá informar quantos arquivos foram identificados como repetidos.
Para continuar a utilização do código, é importante salvar o relatório gerado e deletar os arquivos em `data` que foram processados pelo código. Em seguida, é preciso importar os arquivos de repetidos para a pasta `data` e rodar o código novamente.
## Exemplo de saída Relatório
```
Cartões:
credito - 5073
debito - 6841
diferentes - 2
dinheiro - 4175
outros - 1663
repetidos - 0
semTag - 0
------------------------
Total de arquivos - 17754
```
## Exemplo de saída Relatório de Parcelas
```
Relatório de Data de Vencimento das Notas Fiscais
=============================================
Mês 02: 281 notas fiscais
Mês 03: 221 notas fiscais
Mês 04: 3 notas fiscais
=============================================
Total de Parcelas: 505 notas fiscais
```
## Exceptions
Se o arquivo não puder ser lido, o código irá pular para o próximo arquivo. Se não for possível mover o arquivo, será lançada uma exceção ArquivoNaoMovido.
# Outros Scripts
1. [README - Achar NF-e por valor](./docs/nfe_finder/README.md)
2. [README - Parcelas por Mês](./docs/parcela_por_mes/README.md)
3. [README - Sorter](./docs/sorter/README.md)
**Nota:** Antes de utilizar qualquer um dos scripts certifique de ter python instalado em sua máquina.
## Autor
* Thiago Da Silveira Gentil