{"id":23299228,"url":"https://github.com/abstra-app/template-nota-carioca","last_synced_at":"2025-08-22T03:33:07.500Z","repository":{"id":244140990,"uuid":"814383463","full_name":"abstra-app/template-nota-carioca","owner":"abstra-app","description":"Template para a emissão de notas fiscais eletrônicas em Python através do sistema Nota Carioca.","archived":false,"fork":false,"pushed_at":"2025-02-26T22:30:57.000Z","size":230,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-05-30T12:54:52.744Z","etag":null,"topics":["automation","invoice","invoice-generator","nota-fiscal","nota-fiscal-eletronica","notafiscal","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/abstra-app.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-06-12T22:55:54.000Z","updated_at":"2025-02-26T22:31:00.000Z","dependencies_parsed_at":"2024-08-22T21:27:09.553Z","dependency_job_id":"99a65140-d604-48e5-9fee-e6adc3b2e161","html_url":"https://github.com/abstra-app/template-nota-carioca","commit_stats":null,"previous_names":["abstra-app/template-nota-carioca"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/abstra-app/template-nota-carioca","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abstra-app%2Ftemplate-nota-carioca","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abstra-app%2Ftemplate-nota-carioca/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abstra-app%2Ftemplate-nota-carioca/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abstra-app%2Ftemplate-nota-carioca/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/abstra-app","download_url":"https://codeload.github.com/abstra-app/template-nota-carioca/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abstra-app%2Ftemplate-nota-carioca/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271579451,"owners_count":24784253,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-22T02:00:08.480Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","invoice","invoice-generator","nota-fiscal","nota-fiscal-eletronica","notafiscal","python"],"created_at":"2024-12-20T08:14:59.031Z","updated_at":"2025-08-22T03:33:07.115Z","avatar_url":"https://github.com/abstra-app.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003e **Note**: This repository and the majority of the documentation and code are in Portuguese, as it is a template applied to Brazil. However, contributions and questions in English are also welcome.\n\n# Projeto de Emissão de Notas Fiscais via Nota Carioca com Abstra\n\n## Como Funciona\n\nEste projeto fornece um template para a emissão, cancelamento e busca de notas fiscais eletrônicas de serviços através do sistema Nota Carioca, utilizando Python e Abstra. O foco deste repositório é auxiliar desenvolvedores e empresas brasileiras a automatizar esses processos.\n\nPara customizar este template para o seu time e explorar ainda mais possibilidades, [agende uma demonstração aqui](https://meet.abstra.app/demo?url=template-nota-carioca).\n\n![Um workflow de emissao de nota fiscal utilizando Abstra](https://github.com/user-attachments/assets/711a424f-a3c2-4d13-bede-cd97dc20ff40)\n\n## Configuração Inicial\n\nPara utilizar este projeto, é necessário realizar algumas configurações iniciais:\n\n1. **Certificado Digital A1**: É necessário possuir um certificado digital A1 válido. As credenciais deste certificado deverão ser configuradas no arquivo `.env` deste projeto.\n2. **Variáveis de ambiente**: Crie um arquivo `.env` na raiz do projeto e adicione as seguintes variáveis com as credenciais do seu certificado digital A1:\n\n   ```ini\n   INVOICE_CERT_PATH=\"caminho/para/o/seu/certificado.pfx\"\n   INVOICE_CERT_PASSWORD=\"senhaDoCertificado\"\n   ```\n\n3. **Dependências**: Para instalar as dependências necessárias para este projeto, um arquivo `requirements.txt` é fornecido. Este arquivo inclui todas as bibliotecas necessárias.\n\n   Siga estes passos para instalar as dependências:\n\n   1. Abra seu terminal e navegue até o diretório do projeto.\n   2. Execute o seguinte comando para instalar as dependências a partir do `requirements.txt`:\n\n      ```sh\n      pip install -r requirements.txt\n      ```\n\n4. **Configuração de Tabelas**: Configure suas tabelas de banco de dados no Abstra Cloud Tables de acordo com o schema definido em `abstra-tables.json`.\n\n   Para criar automaticamente o schema da tabela, siga estes passos:\n\n   1. Abra seu terminal e navegue até o diretório do projeto.\n\n   2. Execute o seguinte comando para instalar o schema da tabela a partir de `abstra-tables.json`:\n      ```sh\n      abstra restore\n      ```\n\n   Para obter orientações sobre como criar e gerenciar tabelas no Abstra, consulte a [documentação do Abstra Tables](https://docs.abstra.io/cloud/tables).\n\n5. **Controle de Acesso**: O formulário gerado é protegido por padrão. Para testes locais, nenhuma configuração adicional é necessária. No entanto, para uso na nuvem, é necessário adicionar suas próprias regras de acesso.\n\n   Para obter mais informações sobre como configurar o controle de acesso, consulte a [documentação para controle de acesso da Abstra](https://docs.abstra.io/concepts/access-control).\n\n6. **Uso Local**: Para acesso ao editor local com o projeto, utilize o seguinte comando:\n\n   ```sh\n      abstra editor caminho/para/a/pasta/do/seu/projeto/\n   ```\n\n## Funcionalidades\n\nEste projeto oferece três funcionalidades principais: emitir, cancelar e buscar notas fiscais. Para interagir com as notas fiscais (emitir, cancelar e buscar), utilize o form Send Invoice, arquivo `send_invoice.py`. Este arquivo contém a lógica para as três funcionalidades:\n\n1. **Emissão de Notas Fiscais**: Envia os dados da nota fiscal para o sistema Nota Carioca.\n2. **Cancelamento de Notas Fiscais**: Envia uma solicitação de cancelamento para o sistema Nota Carioca.\n3. **Busca de Notas Fiscais**: Recupera informações de uma nota fiscal específica por período consultando o sistema Nota Carioca.\n\n## Arquivos Importantes\n\n- **send_invoice.py**: Este é o arquivo principal do projeto. Ele contém a lógica para emitir, cancelar e buscar notas fiscais no sistema Nota Carioca. Dependendo da opção escolhida pelo usuário, ele executará a função correspondente.\n\n- **send_email_with_invoice_link.py**: Este script é responsável pelo envio do link da nota emitida para o email cadastrado no formulário \"Send Invoice\".\n\nSe você estiver interessado em personalizar este template para a sua equipe em menos de 30 minutos, [agende uma sessão de personalização aqui.](https://meet.abstra.app/demo?url=template-nota-carioca)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabstra-app%2Ftemplate-nota-carioca","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabstra-app%2Ftemplate-nota-carioca","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabstra-app%2Ftemplate-nota-carioca/lists"}