Home
Softono
erpbrasil.edoc

erpbrasil.edoc

Open source MIT Python
GitHub
23
Stars
23
Forks
15
Issues
6
Watchers
1 month
Last Commit
ERP Invoicing & Billing CMS Plugins & Extensions

About erpbrasil.edoc

erpbrasil.edoc is a free Python library licensed under MIT for issuing electronic fiscal documents and handling other official tax obligations in Brazil. Developed collaboratively by companies such as Akretion and KMEE, it supports the generation and transmission of key documents including NF-e (Electronic Invoice), NFS-e (Service Invoice), MDF-e (Freight Manifest), CT-e (Electronic Transport Note), REINF, and E-Social events. The software offers a modular architecture, allowing users to install dependencies on demand to keep their ERP systems lightweight. Installation supports optional extras for specific document types, such as nfelib for NF-e, mdfelib for freight manifests, ctelib for transport notes, gnrelib for tax payments, and various nfselib providers for municipal service invoices like GINFES, Betha, DSF, Paulistana, and ISSNET. Designed for flexibility, it works with multiple Python implementations and versions. The library is open source with comprehensive documentation available online and a histo

Platforms

Web Self-hosted

Languages

Python

Links

Source Code
e
Published by
erpbrasil
Visit View Profile

README.md

View on GitHub

======== Overview

.. start-badges

.. list-table:: :stub-columns: 1

* - tests
  - |codecov|
* - package
  - |version| |wheel| |supported-versions| |supported-implementations|
    |commits-since|

.. |codecov| image:: https://codecov.io/github/erpbrasil/erpbrasil.edoc/coverage.svg?branch=master :alt: Coverage Status :target: https://codecov.io/github/erpbrasil/erpbrasil.edoc

.. |version| image:: https://img.shields.io/pypi/v/erpbrasil.edoc.svg :alt: PyPI Package latest release :target: https://pypi.org/project/erpbrasil.edoc

.. |commits-since| image:: https://img.shields.io/github/commits-since/erpbrasil/erpbrasil.edoc/v3.1.1.svg :alt: Commits since latest release :target: https://github.com/erpbrasil/erpbrasil.edoc/compare/v3.1.1...master

.. |wheel| image:: https://img.shields.io/pypi/wheel/erpbrasil.edoc.svg :alt: PyPI Wheel :target: https://pypi.org/project/erpbrasil.edoc

.. |supported-versions| image:: https://img.shields.io/pypi/pyversions/erpbrasil.edoc.svg :alt: Supported versions :target: https://pypi.org/project/erpbrasil.edoc

.. |supported-implementations| image:: https://img.shields.io/pypi/implementation/erpbrasil.edoc.svg :alt: Supported implementations :target: https://pypi.org/project/erpbrasil.edoc

.. end-badges

Emissão de documentos fiscais e outras obrigações (NF-E, NFS-E, MDF-E, CT-E, REINF, E-SOCIAL)

Documentação

https://erpbrasil.github.io/

Créditos

Esta é uma biblioteca criada através do esforço das empresas:

Favor consultar a lista de contribuidores:

https://github.com/erpbrasil/erpbrasil.edoc/graphs/contributors

Licença



* Free software: MIT license

Instalação
==========

Para permitir que a instalação do seu ERP cresça somente com a necessidade
do cliente é possível instalar as dependências da biblioteca de forma opcional:

::

    pip install erpbrasil.edoc

    # Documentos do Sefaz

    pip install erpbrasil.edoc[nfelib] # Emissão de NF-e
    pip install erpbrasil.edoc[mdfelib] # Emissão de Manifesto de Carga - MD
    pip install erpbrasil.edoc[ctelib] # Emissão de CT-e
    pip install erpbrasil.edoc[gnrelib] # Emissão de GNRE

    # Notas de Serviço / Prefeituras

    pip install erpbrasil.edoc[nfselib.ginfes] # Emissão de NFS-E GINFES
    pip install erpbrasil.edoc[nfselib.betha] # Emissão de NFS-E Betha
    pip install erpbrasil.edoc[nfselib.dsf] # Emissão de NFS-E DSF
    pip install erpbrasil.edoc[nfselib.paulistana] # Emissão de NFS-E Paulistana
    pip install erpbrasil.edoc[nfselib.issnet] # Emissão de NFS-E ISSNET

Documentation
=============

https://erpbrasil.github.io/docs/

Development
===========

To run the all tests run::

    tox

Note, to combine the coverage data from all the tox environments run:

.. list-table::
    :widths: 10 90
    :stub-columns: 1

    - - Windows
      - ::

            set PYTEST_ADDOPTS=--cov-append
            tox

    - - Other
      - ::

            PYTEST_ADDOPTS=--cov-append tox