.. image:: https://odoo-community.org/readme-banner-image
:target: https://odoo-community.org/get-involved?utm_source=readme
:alt: Odoo Community Association
====================
CT-e abstract models
====================
..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:45937d4ad734eadd446168ffbb89b5a7372c2b7c2ebc6bf871b6ee24adffa5df
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |badge1| image:: https://img.shields.io/badge/maturity-Production%2FStable-green.png
:target: https://odoo-community.org/page/development-status
:alt: Production/Stable
.. |badge2| image:: https://img.shields.io/badge/license-LGPL--3-blue.png
:target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
:alt: License: LGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fl10n--brazil-lightgray.png?logo=github
:target: https://github.com/OCA/l10n-brazil/tree/16.0/l10n_br_cte_spec
:alt: OCA/l10n-brazil
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/l10n-brazil-16-0/l10n-brazil-16-0-l10n_br_cte_spec
:alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
:target: https://runboat.odoo-community.org/builds?repo=OCA/l10n-brazil&target_branch=16.0
:alt: Try me on Runboat
|badge1| |badge2| |badge3| |badge4| |badge5|
Este módulo é a fundação para a emissão do Conhecimento de Transporte
Eletrônico (``CT-e``, ``Modelo 57``) no Odoo. Ele fornece a estrutura de
dados completa e atualizada, em conformidade com os leiautes oficiais da
SEFAZ para o CT-e 4.0.
É importante ressaltar que este módulo não realiza a emissão do CT-e
sozinho. Ele funciona como uma biblioteca de modelos de dados abstratos
(mixins). A sua principal função é servir de base para um módulo de
implementação, como o ``l10n_br_cte``, que é responsável por mapear
esses modelos nos documentos fiscais do Odoo
(``l10n_br_fiscal.document``), adicionar as regras de negócio e realizar
a comunicação com os web services da SEFAZ. Essa arquitetura desacoplada
segue o mesmo padrão de sucesso já utilizado pelos módulos
``l10n_br_nfe_spec`` e ``l10n_br_nfe``.
Estrutura por Modal de Transporte
---------------------------------
Para garantir a conformidade com as particularidades de cada operação, o
módulo implementa modelos de dados específicos para todos os modais de
transporte previstos na legislação:
- Rodoviário (``cte.40.rodo``): Contempla informações essenciais como o
RNTRC e as Ordens de Coleta associadas.
- Aéreo (``cte.40.aereo``): Inclui campos para o número da minuta, o
número operacional do conhecimento aéreo (IATA) e detalhes sobre a
natureza e periculosidade da carga.
- Aquaviário (``cte.40.aquav``): Aborda dados como o valor do AFRMM, a
identificação do navio, informações de balsas e o detalhamento de
contêineres.
- Ferroviário (``cte.40.ferrov``): Permite detalhar o tipo de tráfego
(próprio, mútuo, etc.) e as ferrovias envolvidas na operação.
- Dutoviário (``cte.40.duto``): Contém campos para o valor da tarifa, as
datas de início e fim do serviço e as características do duto.
- Multimodal (``cte.40.multimodal``): Estruturado para gerenciar o
Certificado do Operador de Transporte Multimodal (COTM) e as
informações de seguro associadas.
Geração de Código Automatizada
------------------------------
A principal característica deste módulo é que 100% dos seus modelos de
dados Odoo são gerados automaticamente a partir dos esquemas XSD
oficiais, publicados pelo Portal do CT-e. Essa geração pelo
``xsdata-odoo`` garante máxima fidelidade aos leiautes fiscais e
agilidade na atualização para novas versões.
Embora os esquemas XSD oficiais do CT-e sejam publicados e mantidos no
Portal da SEFAZ, a arquitetura deste projeto se apoia na biblioteca
``nfelib`` para a tarefa de serialização dos dados em XML. Para
facilitar o processo de desenvolvimento e garantir a consistência, a
própria ``nfelib`` armazena em seu repositório uma cópia atualizada
desses esquemas oficiais.
Portanto, a prática recomendada para (re)gerar os modelos deste módulo é
utilizar um clone local do repositório da nfelib como fonte para os
arquivos de esquema (.xsd), direcionando o comando do ``xsdata-odoo``
para o diretório correspondente.
Links:
- `GitHub -
akretion/xsdata-odoo <https://github.com/akretion/xsdata-odoo>`__
- `GitHub - akretion/nfelib <https://github.com/akretion/nfelib>`__
O comando utilizado para gerar os modelos da versão 4.0 do CT-e foi:
.. code:: bash
git clone https://github.com/akretion/nfelib
cd nfelib
export XSDATA_SCHEMA=cte
export XSDATA_VERSION=40
export XSDATA_SKIP="^ICMS\d+|^ICMSSN+|ICMSOutraUF|ICMSUFFim|INFESPECIE_TPESPECIE"
export XSDATA_LANG="portuguese"
xsdata generate nfelib/cte/schemas/v4_0 \
--package nfelib.cte.odoo.v4_0 \
--output=odoo
Prefixo dos campos e versão
---------------------------
Com mais de 1000 campos fiscais apenas no CT-e, com uma meia dúzia de
documentos fiscais complexos, com 3000 módulos OCA, existiria um risco
real de conflito com os nomes de campos vindo dos esquemas. Além disso,
temos várias versões do CT-e, a 3.0, a 4.0...
Nisso foi decidido que cada campo tem um prefixo composto do nome do
schema e de alguns dígitos da versão do esquema. No caso cte40\_. A
escolha de 2 dígitos permite que uma atualização menor do esquema use os
mesmos campos (e dados no banco então) e que um simples update Odoo
(--update=...) consiga resolver a migração. Enquanto que para uma
mudança maior como de 3.0 para 4.0, seria assumido de usar novos campos
e novas tabelas (para os objetos não Odoo) e que a lib nfelib iria
trabalhar com os campos da versão maior do documento fiscal considerado.
**Table of contents**
.. contents::
:local:
Bug Tracker
===========
Bugs are tracked on `GitHub Issues <https://github.com/OCA/l10n-brazil/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/l10n-brazil/issues/new?body=module:%20l10n_br_cte_spec%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
Do not contact contributors directly about support or help with technical issues.
Credits
=======
Authors
-------
* Akretion
Contributors
------------
- `AKRETION <https://akretion.com/pt-BR/>`__:
- Raphaël Valyi <raphael.valyi@akretion.com.br>
Maintainers
-----------
This module is maintained by the OCA.
.. image:: https://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: https://odoo-community.org
OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.
.. |maintainer-rvalyi| image:: https://github.com/rvalyi.png?size=40px
:target: https://github.com/rvalyi
:alt: rvalyi
Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
|maintainer-rvalyi|
This module is part of the `OCA/l10n-brazil <https://github.com/OCA/l10n-brazil/tree/16.0/l10n_br_cte_spec>`_ project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
Raw data
{
"_id": null,
"home_page": "https://github.com/OCA/l10n-brazil",
"name": "odoo-addon-l10n-br-cte-spec",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Akretion, Odoo Community Association (OCA)",
"author_email": "support@odoo-community.org",
"download_url": null,
"platform": null,
"description": ".. image:: https://odoo-community.org/readme-banner-image\n :target: https://odoo-community.org/get-involved?utm_source=readme\n :alt: Odoo Community Association\n\n====================\nCT-e abstract models\n====================\n\n.. \n !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n !! This file is generated by oca-gen-addon-readme !!\n !! changes will be overwritten. !!\n !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n !! source digest: sha256:45937d4ad734eadd446168ffbb89b5a7372c2b7c2ebc6bf871b6ee24adffa5df\n !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n\n.. |badge1| image:: https://img.shields.io/badge/maturity-Production%2FStable-green.png\n :target: https://odoo-community.org/page/development-status\n :alt: Production/Stable\n.. |badge2| image:: https://img.shields.io/badge/license-LGPL--3-blue.png\n :target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html\n :alt: License: LGPL-3\n.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fl10n--brazil-lightgray.png?logo=github\n :target: https://github.com/OCA/l10n-brazil/tree/16.0/l10n_br_cte_spec\n :alt: OCA/l10n-brazil\n.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png\n :target: https://translation.odoo-community.org/projects/l10n-brazil-16-0/l10n-brazil-16-0-l10n_br_cte_spec\n :alt: Translate me on Weblate\n.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png\n :target: https://runboat.odoo-community.org/builds?repo=OCA/l10n-brazil&target_branch=16.0\n :alt: Try me on Runboat\n\n|badge1| |badge2| |badge3| |badge4| |badge5|\n\nEste m\u00f3dulo \u00e9 a funda\u00e7\u00e3o para a emiss\u00e3o do Conhecimento de Transporte\nEletr\u00f4nico (``CT-e``, ``Modelo 57``) no Odoo. Ele fornece a estrutura de\ndados completa e atualizada, em conformidade com os leiautes oficiais da\nSEFAZ para o CT-e 4.0.\n\n\u00c9 importante ressaltar que este m\u00f3dulo n\u00e3o realiza a emiss\u00e3o do CT-e\nsozinho. Ele funciona como uma biblioteca de modelos de dados abstratos\n(mixins). A sua principal fun\u00e7\u00e3o \u00e9 servir de base para um m\u00f3dulo de\nimplementa\u00e7\u00e3o, como o ``l10n_br_cte``, que \u00e9 respons\u00e1vel por mapear\nesses modelos nos documentos fiscais do Odoo\n(``l10n_br_fiscal.document``), adicionar as regras de neg\u00f3cio e realizar\na comunica\u00e7\u00e3o com os web services da SEFAZ. Essa arquitetura desacoplada\nsegue o mesmo padr\u00e3o de sucesso j\u00e1 utilizado pelos m\u00f3dulos\n``l10n_br_nfe_spec`` e ``l10n_br_nfe``.\n\nEstrutura por Modal de Transporte\n---------------------------------\n\nPara garantir a conformidade com as particularidades de cada opera\u00e7\u00e3o, o\nm\u00f3dulo implementa modelos de dados espec\u00edficos para todos os modais de\ntransporte previstos na legisla\u00e7\u00e3o:\n\n- Rodovi\u00e1rio (``cte.40.rodo``): Contempla informa\u00e7\u00f5es essenciais como o\n RNTRC e as Ordens de Coleta associadas.\n- A\u00e9reo (``cte.40.aereo``): Inclui campos para o n\u00famero da minuta, o\n n\u00famero operacional do conhecimento a\u00e9reo (IATA) e detalhes sobre a\n natureza e periculosidade da carga.\n- Aquavi\u00e1rio (``cte.40.aquav``): Aborda dados como o valor do AFRMM, a\n identifica\u00e7\u00e3o do navio, informa\u00e7\u00f5es de balsas e o detalhamento de\n cont\u00eaineres.\n- Ferrovi\u00e1rio (``cte.40.ferrov``): Permite detalhar o tipo de tr\u00e1fego\n (pr\u00f3prio, m\u00fatuo, etc.) e as ferrovias envolvidas na opera\u00e7\u00e3o.\n- Dutovi\u00e1rio (``cte.40.duto``): Cont\u00e9m campos para o valor da tarifa, as\n datas de in\u00edcio e fim do servi\u00e7o e as caracter\u00edsticas do duto.\n- Multimodal (``cte.40.multimodal``): Estruturado para gerenciar o\n Certificado do Operador de Transporte Multimodal (COTM) e as\n informa\u00e7\u00f5es de seguro associadas.\n\nGera\u00e7\u00e3o de C\u00f3digo Automatizada\n------------------------------\n\nA principal caracter\u00edstica deste m\u00f3dulo \u00e9 que 100% dos seus modelos de\ndados Odoo s\u00e3o gerados automaticamente a partir dos esquemas XSD\noficiais, publicados pelo Portal do CT-e. Essa gera\u00e7\u00e3o pelo\n``xsdata-odoo`` garante m\u00e1xima fidelidade aos leiautes fiscais e\nagilidade na atualiza\u00e7\u00e3o para novas vers\u00f5es.\n\nEmbora os esquemas XSD oficiais do CT-e sejam publicados e mantidos no\nPortal da SEFAZ, a arquitetura deste projeto se apoia na biblioteca\n``nfelib`` para a tarefa de serializa\u00e7\u00e3o dos dados em XML. Para\nfacilitar o processo de desenvolvimento e garantir a consist\u00eancia, a\npr\u00f3pria ``nfelib`` armazena em seu reposit\u00f3rio uma c\u00f3pia atualizada\ndesses esquemas oficiais.\n\nPortanto, a pr\u00e1tica recomendada para (re)gerar os modelos deste m\u00f3dulo \u00e9\nutilizar um clone local do reposit\u00f3rio da nfelib como fonte para os\narquivos de esquema (.xsd), direcionando o comando do ``xsdata-odoo``\npara o diret\u00f3rio correspondente.\n\nLinks:\n\n- `GitHub -\n akretion/xsdata-odoo <https://github.com/akretion/xsdata-odoo>`__\n- `GitHub - akretion/nfelib <https://github.com/akretion/nfelib>`__\n\nO comando utilizado para gerar os modelos da vers\u00e3o 4.0 do CT-e foi:\n\n.. code:: bash\n\n git clone https://github.com/akretion/nfelib\n cd nfelib\n export XSDATA_SCHEMA=cte\n export XSDATA_VERSION=40\n export XSDATA_SKIP=\"^ICMS\\d+|^ICMSSN+|ICMSOutraUF|ICMSUFFim|INFESPECIE_TPESPECIE\"\n export XSDATA_LANG=\"portuguese\"\n\n xsdata generate nfelib/cte/schemas/v4_0 \\\n --package nfelib.cte.odoo.v4_0 \\\n --output=odoo\n\nPrefixo dos campos e vers\u00e3o\n---------------------------\n\nCom mais de 1000 campos fiscais apenas no CT-e, com uma meia d\u00fazia de\ndocumentos fiscais complexos, com 3000 m\u00f3dulos OCA, existiria um risco\nreal de conflito com os nomes de campos vindo dos esquemas. Al\u00e9m disso,\ntemos v\u00e1rias vers\u00f5es do CT-e, a 3.0, a 4.0...\n\nNisso foi decidido que cada campo tem um prefixo composto do nome do\nschema e de alguns d\u00edgitos da vers\u00e3o do esquema. No caso cte40\\_. A\nescolha de 2 d\u00edgitos permite que uma atualiza\u00e7\u00e3o menor do esquema use os\nmesmos campos (e dados no banco ent\u00e3o) e que um simples update Odoo\n(--update=...) consiga resolver a migra\u00e7\u00e3o. Enquanto que para uma\nmudan\u00e7a maior como de 3.0 para 4.0, seria assumido de usar novos campos\ne novas tabelas (para os objetos n\u00e3o Odoo) e que a lib nfelib iria\ntrabalhar com os campos da vers\u00e3o maior do documento fiscal considerado.\n\n**Table of contents**\n\n.. contents::\n :local:\n\nBug Tracker\n===========\n\nBugs are tracked on `GitHub Issues <https://github.com/OCA/l10n-brazil/issues>`_.\nIn case of trouble, please check there if your issue has already been reported.\nIf you spotted it first, help us to smash it by providing a detailed and welcomed\n`feedback <https://github.com/OCA/l10n-brazil/issues/new?body=module:%20l10n_br_cte_spec%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.\n\nDo not contact contributors directly about support or help with technical issues.\n\nCredits\n=======\n\nAuthors\n-------\n\n* Akretion\n\nContributors\n------------\n\n- `AKRETION <https://akretion.com/pt-BR/>`__:\n\n - Rapha\u00ebl Valyi <raphael.valyi@akretion.com.br>\n\nMaintainers\n-----------\n\nThis module is maintained by the OCA.\n\n.. image:: https://odoo-community.org/logo.png\n :alt: Odoo Community Association\n :target: https://odoo-community.org\n\nOCA, or the Odoo Community Association, is a nonprofit organization whose\nmission is to support the collaborative development of Odoo features and\npromote its widespread use.\n\n.. |maintainer-rvalyi| image:: https://github.com/rvalyi.png?size=40px\n :target: https://github.com/rvalyi\n :alt: rvalyi\n\nCurrent `maintainer <https://odoo-community.org/page/maintainer-role>`__:\n\n|maintainer-rvalyi| \n\nThis module is part of the `OCA/l10n-brazil <https://github.com/OCA/l10n-brazil/tree/16.0/l10n_br_cte_spec>`_ project on GitHub.\n\nYou are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.\n",
"bugtrack_url": null,
"license": "LGPL-3",
"summary": "CT-e abstract models generated by xsdata-odoo from the official xsd",
"version": "16.0.1.1.0",
"project_urls": {
"Homepage": "https://github.com/OCA/l10n-brazil"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b30def36b05ee3a465f4e0dbd088515ff73163bbfc2d47606d07fedc68b6148a",
"md5": "57b517a3c4a3badfcb1ff4d3b2d7b5db",
"sha256": "2fbffad10d2f14c57251ef9738b79a91addffb8589c405297c4ae07651eedc25"
},
"downloads": -1,
"filename": "odoo_addon_l10n_br_cte_spec-16.0.1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "57b517a3c4a3badfcb1ff4d3b2d7b5db",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 166215,
"upload_time": "2025-07-16T15:18:06",
"upload_time_iso_8601": "2025-07-16T15:18:06.297198Z",
"url": "https://files.pythonhosted.org/packages/b3/0d/ef36b05ee3a465f4e0dbd088515ff73163bbfc2d47606d07fedc68b6148a/odoo_addon_l10n_br_cte_spec-16.0.1.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-16 15:18:06",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "OCA",
"github_project": "l10n-brazil",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [
{
"name": "brazilcep",
"specs": []
},
{
"name": "brazilfiscalreport",
"specs": []
},
{
"name": "email-validator",
"specs": []
},
{
"name": "erpbrasil.assinatura",
"specs": [
[
">=",
"1.7.0"
]
]
},
{
"name": "erpbrasil.base",
"specs": [
[
">=",
"2.3.0"
]
]
},
{
"name": "erpbrasil.edoc",
"specs": [
[
">=",
"2.5.2"
]
]
},
{
"name": "erpbrasil.transmissao",
"specs": [
[
">=",
"1.1.0"
]
]
},
{
"name": "nfelib",
"specs": [
[
"<=",
"2.0.7"
]
]
},
{
"name": "num2words",
"specs": []
},
{
"name": "phonenumbers",
"specs": []
},
{
"name": "pyyaml",
"specs": []
},
{
"name": "unidecode",
"specs": []
},
{
"name": "workalendar",
"specs": []
}
],
"lcname": "odoo-addon-l10n-br-cte-spec"
}
JSON
