Localização PT+

O código dos módulos da localização PT+ da Exo Software é disponibilizado exclusivamente através de repositórios Git. Há um total de 4 repositórios, contendo módulos de diferentes naturezas:

	Nome do Repositório	Tipo de Repositório	Tipo de Módulos
	pt-plus	Privado; Ofuscado	Faturação e Contabilidade
	pt-payment	Privado; Ofuscado	Pagamentos Multibanco e MBWay
	pt-payroll	Privado; Ofuscado	Processamento de Salários
	portugal-plus-extra	Público	Utilitários e ligação com módulos de terceiros

Acesso aos repositórios

Importante

O acesso aos repositórios privados é concedido mediante subscrição e estará disponível enquanto esta estiver ativa.

Há 2 tipos de acesso possíveis:

• Chaves SSH: o cliente fornece à Exo uma chave SSH exclusiva para cada para cada repositório a que pretende aceder. O acesso é gratuito mas apenas pode clonar o repositório por SSH.

• Utilizador Github: A Exo adiciona um ou mais utilizadores à sua equipa Github como colaboradores externos. Este acesso tem um custo de 4€/mês/utilizador e permite acesso de leitura completamente funcional a todos os repositórios compatíveis com a subscrição, incluindo clonagem HTTPS e SSH.

Obter o código

Importante

O único sistema operativo suportado é Linux. Outros, nomeadamente o Windows, poderão também ser adicionados quando (e se) a procura o justificar.

Importante

O código dos repositórios privados está ofuscado por motivos legais. Embora o seu comportamento funcional seja idêntico ao código não ofuscado.

Para clonar um repositório, escolha entre o método HTTPS ou SSH (ver secção anterior). Dada a sua natureza gratuita, a opção SSH é a mais comum.

LinuxWindowsMac OS

Clonar com HTTPSClonar com SSH

$ git clone https://github.com/exosoftware/pt-plus.git
$ git clone https://github.com/exosoftware/pt-payment.git
$ git clone https://github.com/exosoftware/pt-payroll.git

Nota

O repositório Git Enterprise não contem acesso total ao código do Odoo. É apenas uma coleção de add-ons extra. O código principal do servidor está na versão Community. Correr a versão Enterprise significa correr o servidor a partir da versão Community com a opção addons-path definida para para o diretório com a versão Enterprise. É obrigatório clonar tanto os repositórios da versão Community como o da versão Enterprise, para ter uma instalação Odoo Enterprise a funcionar.

Escolher o branch

Importante

Devido ao ofuscamento de código, é necessário um passo adicional no momento de escolher o branch.

Dado que é feita uma ofuscação para cada versão Python, os branches são combinações de versões Odoo com versões Python.

Example

Em vez de 17.0 podemos ter 17.0-py3.12

Antes de continuar, é portanto necessário determinar a versão do Python no seu sistema Odoo. Uma forma fácil é através do comando:

$ python3 --version

Do resultado, considere apenas a versão principal e a subversão.

Example

Se for 3.10.2, a versão Python é 3.10

Pode agora calcular o branch que pretende com a fórmula <ODOO_VERSION>**-py**<PYTHON_VERSION>

Example

Odoo 15.0 e Python 3.8: branch 15.0-py3.8 Odoo 17.0 e Python 3.10: branch 16.0-py3.10

Nota

As versões Python suportadas são: 3.8, 3.9, 3.10, 3.11 e 3.12.

Dependências

Os módulos da localização PT+ dependem de algumas libraries Python, bem como de alguns módulos da Odoo Community Association, em função das funcionalidades que se pretende ver implementadas. A seguinte tabela indica todas as dependências necessárias para cada módulo:

	Repositório	Grupo	Módulo	Dependências Python	Dependências SO	Módulos Extra
	pt-plus	Faturação	ptplus	git+https://github.com/OCA/openupgradelib.git@master, unicodecsv, xmlschema==2.4.0, zeep
	pt-plus	Faturação	ptplus_account_credit_note			account_invoice_refund_link
	pt-plus	Faturação	ptplus_stock			stock_picking_invoice_link
	pt-plus	Faturação	ptplus_backend_exo	cryptography
	pt-plus	Faturação	ptplus_partner	suds-py3
	pt-plus	Faturação	ptplus_pdf_sign	pyotp, asn1crypto, pyhanko, cryptography==35.0.0
	pt-plus	Contabilidade	ptplus_accounting_asset_management			account_asset_management report_xlsx_helper report_xlsx
	pt-plus	Contabilidade	ptplus_accounting_efatura	bs4, requests_html, pymupdf==1.24.10, pyzbar	zbar-tools
	pt-plus	Contabilidade	ptplus_accounting_mis_report			mis_builder report_xlsx date_range
	pt-payroll	Salários	ptplus_payroll_ce			payroll payroll_account base_time_parameter payroll_rule_time_parameter