Skip to content

Commit a7a2e5d

Browse files
committed
[IMP] Update README
1 parent aaa45b3 commit a7a2e5d

File tree

1 file changed

+13
-9
lines changed

1 file changed

+13
-9
lines changed

README.rst

Lines changed: 13 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Os módulos da SPED tratados por esse package são :
1212
- `EFD Contribuições (PIS, COFINS) <http://sped.rfb.gov.br/pasta/show/1989>`_
1313
- `EFD ICMS IPI <http://sped.rfb.gov.br/pasta/show/1573>`_
1414

15-
📚 Para cada módulo estão gerados 4 arquivos :
15+
📚 Para cada módulo estão gerados 4 arquivos :
1616

1717
- *MODULE_registers.csv* : a lista detalhada dos **registros** do módulo ``MODULE``.
1818
- *MODULE_accurate_fields.csv* : a lista das linhas dos **campos** de cada registro *como eles aparecem no pdf* das especificações (para conferir e melhorar o resultado da extração).
@@ -48,11 +48,13 @@ Utilização
4848

4949
Depois de ter baixado esse repositório, todos os arquivos da pasta *scripts/* podem ser usados como Interface de linha de comando no seu terminal.
5050

51-
1. 📥 ``./download.sh`` : **Baixe os arquivos pdf** originais contendo as especificaões da SPED :
51+
1. 📥 ``./download.sh`` : **Baixe os arquivos pdf** originais contendo as especificações da SPED :
52+
53+
🔎 A opção ``--year`` permite definir a versão dos pdf do ano desejado. Se não indicar nada os pdf mais recentes serão baixados.
5254

5355
::
5456

55-
PATH_TO/sped_extractor/scripts$ ./download.sh
57+
PATH_TO/sped_extractor/scripts$ ./download.sh --year=2019
5658
downloading ECD pdf Dezembro 2019
5759
[...]
5860
downloading ECF pdf Dezembro 2019
@@ -63,7 +65,8 @@ Depois de ter baixado esse repositório, todos os arquivos da pasta *scripts/* p
6365
[...]
6466

6567
2. ⛏️ ``./extract_csv.py`` : Use `camelot`_ para **extrair as tabelas dos pdf** e coloque os arquivos CSV extraidos na pasta */specs/MODULE/raw_camelot_csv/* :
66-
A opção ``--limit=n`` é facultativa para extrair apenas as tabelas das 'n' primeiras páginas.
68+
69+
🔎 A opção ``--limit=n`` é facultativa para extrair apenas as tabelas das 'n' primeiras páginas.
6770

6871
::
6972

@@ -80,7 +83,7 @@ Depois de ter baixado esse repositório, todos os arquivos da pasta *scripts/* p
8083

8184
3. 🏗️ ``./build_csv.py`` : Percorre os CSV da pasta */specs/MODULE/raw_camelot_csv/* e **cria 3 arquivos CSV** por módulo :
8285

83-
🔎 O ``./build_csv.py`` aplica linhas corretivas escritas em duro na pasta *scripts/camelot_patch/2019/* por padrão. Para não aplicar essas correções, usar a opção ``--no-patch``.
86+
🔎 O ``./build_csv.py`` aplica linhas corretivas escritas em duro na pasta *scripts/camelot_patch/2019/* por padrão. Para não aplicar essas correções, usar a opção ``--no-patch``.
8487

8588
::
8689

@@ -112,7 +115,7 @@ Depois de ter baixado esse repositório, todos os arquivos da pasta *scripts/* p
112115

113116
Além desses scripts básicos, existe também o ``./build_json.py`` para **criar um arquivo JSON** por módulo com a lista dos campos com atributos "interpretados" :
114117

115-
⚠️ Como esse script usa os arquivos CSV dos campos "fiéis" criados por ``./build_csv.py`` para criar os JSON, é nécessário ter gerado esses arquivos primeiro.
118+
⚠️ Como esse script usa os arquivos CSV dos campos "fiéis" criados por ``./build_csv.py`` para criar os JSON, é nécessário ter gerado esses arquivos primeiro.
116119

117120
::
118121

@@ -133,7 +136,7 @@ Apesar de `camelot`_ ser o melhor package python para extrair tabelas de pdf, el
133136

134137
Para isso basta escrever a linha correta no arquivo *scripts/camelot_patch/2019/MODULE_camelot_patch.csv* para ela ser applicada no lugar certo no CSV *MODULE_accurate_fields.csv*.
135138

136-
🔎 O ``./build_csv.py`` aplica as linhas corretivas por padrão. Para não aplicar essas correções, usar a opção ``--no-patch``.
139+
🔎 O ``./build_csv.py`` aplica as linhas corretivas por padrão. Para não aplicar essas correções, usar a opção ``--no-patch``.
137140

138141
Cabeçalhos de Módulos
139142
~~~~~~~
@@ -167,15 +170,16 @@ python-sped_ é uma biblioteca python com a lista dos campos de cada módulo da
167170

168171
Apesar disso, pode ser interessante comparar essas listas de campos com as listas extraidas pelo **sped_extractor**. Para isso é só lançar o script ``./compare_ptyhon-sped.py``.
169172

173+
Um exemple de comparação com python-sped_ pode ser encontrada `aqui <https://gist.github.com/clementmbr/3a730276bd19f639780521777628d763>`_.
174+
170175

171176
Roadmap
172177
========
173178

174-
- Tirar esse package do module Odoo **l10n_br_spec_sped** para poder ser usado para outras utilizações do que implementar as specificações da SPED em Odoo.
175179
- Detalhar a Instalação no README.
176180
- Criar o arquivo JSON para os registros de cada módulo.
177181
- Adicionar o atributo interpretado ``required`` aos registros.
178-
- Work on ``./build_json.py`` in order to render JSON with a real nested structure : *Block > Register > Field* (with nested Registers following their own level)
182+
- Work on ``./build_json.py`` in order to render JSON with a real nested structure : *Block > Register > Field* (with nested Registers following their own level, following *python-sped* structure)
179183

180184
Créditos
181185
=======

0 commit comments

Comments
 (0)