nfselib.paulistana


Namenfselib.paulistana JSON
Version 0.2.0 PyPI version JSON
download
home_pagehttps://github.com/erpbrasil/nfselib.paulistana
SummaryPython Library to genereate paulistana NFS-E
upload_time2020-12-16 18:29:47
maintainer
docs_urlNone
authorLuis Felipe Mileo
requires_python>=3.5, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI
coveralls test coverage
            ========
Overview
========



Python Library to genereate NFS-E Paulistana
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Biblioteca Python para ler e gerar NFSe's / XML para o webservice da prefeitura de São Paulo:

* Esta biblioteca faz parte do projeto: https://erpbrasil.github.io/
* Para transmitir aconselhamos a biblioteca Python Zeep, ou então por exemplo https://github.com/erpbrasil/erpbrasil.edoc.
* Ela foi gerada automaticamente através do generateDS e da ferramenta https://github.com/erpbrasil/erpbrasil.edoc.gen
* Verificar o conteúdo da pasta *script* e o manual do processo de relase em https://erpbrasil.github.io/docs/

A bibliotca permite de:

* Gerar os XMLs dos documentos fiscais;
* Validar os dados com **as mesmas validações dos XSD's ao montar os objetos**, o que evita detectar os erros apenas ao transmitir o XML;
* Importar XMLs e transforma-los em objetos Python. Usando um sistema de sub-classes, fica fácil mapear esses objetos em outros objetos ou adicionar qualquer método customizado;

A biblioteca é:

* **Simples e confiável**. O código é gerado pelo generateDS a partir dos XSD's do paulistana. Ele **reflete exatamente a especificação fiscal** da versão do esquema escolhida sem que você deva se perguntar qual é o grau de aderência do código;
* Compatível com **Python 3** (e com Python 2 se botar patches no generateDS e usar uma versao anterior);
* Capaz de carregar **várias versões dos esquemas**. Isso pode ser bem útil ao receber um documento fiscal com um leiaute antigo.

Além disso, usando outros recursos do GenerateDS, é possível ir além dessa biblioteca e gerar automaticamente o modelo de dados do ERP.

Pelo menos no ERP Odoo que tem um framework bastante poderoso. Sendo assim, é possivel montar dinamicamente as telas do usuário, a geração do XML ou a importação do XML quase que sem escrever código (apenas relacionar os campos mapeados com os campos já existentes do ERP).

Fica então bem mais razoável para manter quando tem que atualizar os esquemas e assim também fica finalmente possível manter os dados do SPED dentro do ERP com um custo de manutenção compatível com o modelo open source.

Você pode aprender mais sobre o generateDS `aqui <http://www.davekuhlman.org/generateDS.html>`__ e sobre o conjunto de tecnologias que estamos utilizando para facilitar o desenvolvimento de ERPs no Brasil: https://erpbrasil.github.io/docs/


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

::

    pip install nfselib.paulistana

You can also install the in-development version with::

    pip install https://github.com/erpbrasil/nfselib.paulistana/archive/master_gen.zip


Branchs
=======

* master - Script de geração e outros arquivos importantes (Customizações, Testes e Readme);
* master_gen - Versão final da bibliotaca para uso;

Documentação
============

https://erpbrasil.github.io/

Créditos
========

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

* Akretion https://akretion.com/pt-BR/
* KMEE https://www.kmee.com.br

Licença
~~~~~~~

* Free software: MIT license

Desenvolvimento
===============

To run all the 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

Authors
=======

* `KMEE <https://www.kmee.com.br>`__:

    * Luis Felipe Mileo <mileo@kmee.com.br>
    * Luis Otávio Malta <luis.malta@kmee.com.br>


Changelog
=========

0.1.0 (2020-11-08)
~~~~~~~~~~~~~~~~~~

* First release on PyPI.



            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/erpbrasil/nfselib.paulistana",
    "name": "nfselib.paulistana",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.5, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*",
    "maintainer_email": "",
    "keywords": "",
    "author": "Luis Felipe Mileo",
    "author_email": "mileo@kmee.com.br",
    "download_url": "https://files.pythonhosted.org/packages/82/7a/489d01f93c8fb2b2dd4a14c29b371ad9759d524128222ad9509087d3b551/nfselib.paulistana-0.2.0.tar.gz",
    "platform": "",
    "description": "========\nOverview\n========\n\n\n\nPython Library to genereate NFS-E Paulistana\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nBiblioteca Python para ler e gerar NFSe's / XML para o webservice da prefeitura de S\u00e3o Paulo:\n\n* Esta biblioteca faz parte do projeto: https://erpbrasil.github.io/\n* Para transmitir aconselhamos a biblioteca Python Zeep, ou ent\u00e3o por exemplo https://github.com/erpbrasil/erpbrasil.edoc.\n* Ela foi gerada automaticamente atrav\u00e9s do generateDS e da ferramenta https://github.com/erpbrasil/erpbrasil.edoc.gen\n* Verificar o conte\u00fado da pasta *script* e o manual do processo de relase em https://erpbrasil.github.io/docs/\n\nA bibliotca permite de:\n\n* Gerar os XMLs dos documentos fiscais;\n* Validar os dados com **as mesmas valida\u00e7\u00f5es dos XSD's ao montar os objetos**, o que evita detectar os erros apenas ao transmitir o XML;\n* Importar XMLs e transforma-los em objetos Python. Usando um sistema de sub-classes, fica f\u00e1cil mapear esses objetos em outros objetos ou adicionar qualquer m\u00e9todo customizado;\n\nA biblioteca \u00e9:\n\n* **Simples e confi\u00e1vel**. O c\u00f3digo \u00e9 gerado pelo generateDS a partir dos XSD's do paulistana. Ele **reflete exatamente a especifica\u00e7\u00e3o fiscal** da vers\u00e3o do esquema escolhida sem que voc\u00ea deva se perguntar qual \u00e9 o grau de ader\u00eancia do c\u00f3digo;\n* Compat\u00edvel com **Python 3** (e com Python 2 se botar patches no generateDS e usar uma versao anterior);\n* Capaz de carregar **v\u00e1rias vers\u00f5es dos esquemas**. Isso pode ser bem \u00fatil ao receber um documento fiscal com um leiaute antigo.\n\nAl\u00e9m disso, usando outros recursos do GenerateDS, \u00e9 poss\u00edvel ir al\u00e9m dessa biblioteca e gerar automaticamente o modelo de dados do ERP.\n\nPelo menos no ERP Odoo que tem um framework bastante poderoso. Sendo assim, \u00e9 possivel montar dinamicamente as telas do usu\u00e1rio, a gera\u00e7\u00e3o do XML ou a importa\u00e7\u00e3o do XML quase que sem escrever c\u00f3digo (apenas relacionar os campos mapeados com os campos j\u00e1 existentes do ERP).\n\nFica ent\u00e3o bem mais razo\u00e1vel para manter quando tem que atualizar os esquemas e assim tamb\u00e9m fica finalmente poss\u00edvel manter os dados do SPED dentro do ERP com um custo de manuten\u00e7\u00e3o compat\u00edvel com o modelo open source.\n\nVoc\u00ea pode aprender mais sobre o generateDS `aqui <http://www.davekuhlman.org/generateDS.html>`__ e sobre o conjunto de tecnologias que estamos utilizando para facilitar o desenvolvimento de ERPs no Brasil: https://erpbrasil.github.io/docs/\n\n\nInstala\u00e7\u00e3o\n==========\n\n::\n\n    pip install nfselib.paulistana\n\nYou can also install the in-development version with::\n\n    pip install https://github.com/erpbrasil/nfselib.paulistana/archive/master_gen.zip\n\n\nBranchs\n=======\n\n* master - Script de gera\u00e7\u00e3o e outros arquivos importantes (Customiza\u00e7\u00f5es, Testes e Readme);\n* master_gen - Vers\u00e3o final da bibliotaca para uso;\n\nDocumenta\u00e7\u00e3o\n============\n\nhttps://erpbrasil.github.io/\n\nCr\u00e9ditos\n========\n\nEsta \u00e9 uma biblioteca criada atrav\u00eas do esfor\u00e7o de das empresas:\n\n* Akretion https://akretion.com/pt-BR/\n* KMEE https://www.kmee.com.br\n\nLicen\u00e7a\n~~~~~~~\n\n* Free software: MIT license\n\nDesenvolvimento\n===============\n\nTo run all the tests run::\n\n    tox\n\nNote, to combine the coverage data from all the tox environments run:\n\n.. list-table::\n    :widths: 10 90\n    :stub-columns: 1\n\n    - - Windows\n      - ::\n\n            set PYTEST_ADDOPTS=--cov-append\n            tox\n\n    - - Other\n      - ::\n\n            PYTEST_ADDOPTS=--cov-append tox\n\nAuthors\n=======\n\n* `KMEE <https://www.kmee.com.br>`__:\n\n    * Luis Felipe Mileo <mileo@kmee.com.br>\n    * Luis Ot\u00e1vio Malta <luis.malta@kmee.com.br>\n\n\nChangelog\n=========\n\n0.1.0 (2020-11-08)\n~~~~~~~~~~~~~~~~~~\n\n* First release on PyPI.\n\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Python Library to genereate paulistana NFS-E",
    "version": "0.2.0",
    "project_urls": {
        "Changelog": "https://nfselibpaulistana.readthedocs.io/en/latest/changelog.html",
        "Documentation": "https://nfselibpaulistana.readthedocs.io/",
        "Homepage": "https://github.com/erpbrasil/nfselib.paulistana",
        "Issue Tracker": "https://github.com/erpbrasil/nfselib.paulistana/issues"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d9cb745e3e9f646ee61b161c0e2c995b1ce9f539e8156d616e1a1dda61507946",
                "md5": "1cc6977a580050b4d971b83f0fac827a",
                "sha256": "1e36a16c8bdd301107ea3a5b280e5e7fd3ef46db184a988022dbfb7be91f9ae5"
            },
            "downloads": -1,
            "filename": "nfselib.paulistana-0.2.0-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "1cc6977a580050b4d971b83f0fac827a",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": ">=3.5, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*",
            "size": 310204,
            "upload_time": "2020-12-16T18:29:41",
            "upload_time_iso_8601": "2020-12-16T18:29:41.851648Z",
            "url": "https://files.pythonhosted.org/packages/d9/cb/745e3e9f646ee61b161c0e2c995b1ce9f539e8156d616e1a1dda61507946/nfselib.paulistana-0.2.0-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "827a489d01f93c8fb2b2dd4a14c29b371ad9759d524128222ad9509087d3b551",
                "md5": "820969274eb2f97b5ede7b2b18dc4c4c",
                "sha256": "66d61799857110d120ae761ff31d3d9074981aeaac7e5759ea575768c35750e1"
            },
            "downloads": -1,
            "filename": "nfselib.paulistana-0.2.0.tar.gz",
            "has_sig": false,
            "md5_digest": "820969274eb2f97b5ede7b2b18dc4c4c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.5, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*",
            "size": 314796,
            "upload_time": "2020-12-16T18:29:47",
            "upload_time_iso_8601": "2020-12-16T18:29:47.786625Z",
            "url": "https://files.pythonhosted.org/packages/82/7a/489d01f93c8fb2b2dd4a14c29b371ad9759d524128222ad9509087d3b551/nfselib.paulistana-0.2.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2020-12-16 18:29:47",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "erpbrasil",
    "github_project": "nfselib.paulistana",
    "travis_ci": true,
    "coveralls": true,
    "github_actions": false,
    "appveyor": true,
    "tox": true,
    "lcname": "nfselib.paulistana"
}
        
Elapsed time: 0.07394s