Module PIXBrasil - Revision history

Paulorcdo: /* Buy */ fcsf

2025-11-05T12:58:37Z

Buy: fcsf

← Older revision		Revision as of 12:58, 5 November 2025
Line 120:		Line 120:

	=<small>Buy</small>=		=<small>Buy</small>=
	On https://www.dolistore.com/en~~/modules/1133-Customize-Forms.html~~		On https://www.dolistore.com/product.php?id=856&title=pixbrasil&l=en

	=<small>Video</small>=		=<small>Video</small>=

Paulorcdo: /* Demo */ dzxcv

2022-05-30T13:20:47Z

Demo: dzxcv

← Older revision		Revision as of 13:20, 30 May 2022
Line 115:		Line 115:

	All Features - Dolibarr ≥ 7		All Features - Dolibarr ≥ 7
	=<small>Demo</small>=		=<small>'''Demo'''</small>=

			View DEMO:https://www.trucolivre.com.br/dolibarr user:demo passw:demo

	~~View DEMO:https://empresalivre.com/demo1/ user:demo passw:demo~~
	=<small>Buy</small>=		=<small>Buy</small>=
	On https://www.dolistore.com/en/modules/1133-Customize-Forms.html		On https://www.dolistore.com/en/modules/1133-Customize-Forms.html

Paulorcdo: /* Prerequisites */ xzczxc

2022-04-13T09:17:37Z

Prerequisites: xzczxc

← Older revision		Revision as of 09:17, 13 April 2022
Line 113:		Line 113:
	=<small>'''Prerequisites'''</small>=		=<small>'''Prerequisites'''</small>=

	~~Partial Features - Dolibarr ≥ 5.0.3~~

	All Features - Dolibarr ≥ ~~9.0.3~~		All Features - Dolibarr ≥ 7
	=<small>Demo</small>=		=<small>Demo</small>=

Paulorcdo: /* Facture PDF - Example PixBrasil */

2022-04-07T13:02:24Z

Facture PDF - Example PixBrasil

← Older revision		Revision as of 13:02, 7 April 2022
Line 106:		Line 106:
	==<small>Facture PDF - Example PixBrasil</small>==		==<small>Facture PDF - Example PixBrasil</small>==

	[[File:~~Tela3~~.~~png~~\|alt=Facture Print\|~~783x783px~~\|HomePage]]		[[File:Tela5.jpg\|alt=Facture Print\|782x782px\|HomePage]]

	=<small>Example QRCode</small>=		=<small>Example QRCode</small>=
	[[File:~~Tela4~~.png\|alt=QRCode\|419x419px\|HomePage]]		[[File:Tela6.png\|alt=QRCode\|419x419px\|HomePage]]

	=<small>'''Prerequisites'''</small>=		=<small>'''Prerequisites'''</small>=

Paulorcdo: /* Facture PDF - Example PixBrasil */

2022-04-07T12:50:16Z

Facture PDF - Example PixBrasil

← Older revision		Revision as of 12:50, 7 April 2022
Line 20:		Line 20:
	'''PIXBrasil''' PIX is a model of banking interaction through QRcode that allows you to carry out banking transactions without any typing or writing.		'''PIXBrasil''' PIX is a model of banking interaction through QRcode that allows you to carry out banking transactions without any typing or writing.

	=== ABOUT THE DOLIBARR PIX BRASIL MODULE ===		===ABOUT THE DOLIBARR PIX BRASIL MODULE===

	==='''When installing'''===		==='''When installing'''===
Line 107:		Line 107:

	[[File:Tela3.png\|alt=Facture Print\|783x783px\|HomePage]]		[[File:Tela3.png\|alt=Facture Print\|783x783px\|HomePage]]

			=<small>Example QRCode</small>=
			[[File:Tela4.png\|alt=QRCode\|419x419px\|HomePage]]

	=<small>'''Prerequisites'''</small>=		=<small>'''Prerequisites'''</small>=

Paulorcdo: /* Features */

2022-04-07T12:46:07Z

Features

← Older revision		Revision as of 12:46, 7 April 2022
Line 20:		Line 20:
	'''PIXBrasil''' PIX is a model of banking interaction through QRcode that allows you to carry out banking transactions without any typing or writing.		'''PIXBrasil''' PIX is a model of banking interaction through QRcode that allows you to carry out banking transactions without any typing or writing.

	ABOUT THE DOLIBARR PIX BRASIL MODULE		=== ABOUT THE DOLIBARR PIX BRASIL MODULE ===

	==='''When installing'''===		==='''When installing'''===
Line 53:		Line 53:
	''O PIX é um modelo de interação bancária por meio de código QRcode que permite realizar transações bancárias sem nenhuma digitação ou escrita. O modelo PIX permite também copiar e colar o texto gerador do QRcode, facilitando o compartilhamento e aumentando a segurança das transações.''		''O PIX é um modelo de interação bancária por meio de código QRcode que permite realizar transações bancárias sem nenhuma digitação ou escrita. O modelo PIX permite também copiar e colar o texto gerador do QRcode, facilitando o compartilhamento e aumentando a segurança das transações.''

	====''SOBRE O MÓDULO'' ====		====''SOBRE O MÓDULO''====

	====''Ao Instalar''====		====''Ao Instalar''====

Paulorcdo: /* O módulo Dolibarr PIXBRASIL */

2022-04-07T12:39:56Z

O módulo Dolibarr PIXBRASIL

← Older revision		Revision as of 12:39, 7 April 2022
Line 22:		Line 22:
	ABOUT THE DOLIBARR PIX BRASIL MODULE		ABOUT THE DOLIBARR PIX BRASIL MODULE

	=== '''When installing''' ===		==='''When installing'''===
	When installing the module, a new pdf print template is created for sales invoices and a table with editable fields with null values. First, it is necessary to register the Company Name, Company Municipality and PIX Key fields. With the 3 fields filled in, the system generates a new page in the sales invoices with the QRcode PIX and the field copies and pastes the PIX text. The value field is the invoice total and the other fields are mandatory according to the BACEN model.		When installing the module, a new pdf print template is created for sales invoices and a table with editable fields with null values. First, it is necessary to register the Company Name, Company Municipality and PIX Key fields. With the 3 fields filled in, the system generates a new page in the sales invoices with the QRcode PIX and the field copies and pastes the PIX text. The value field is the invoice total and the other fields are mandatory according to the BACEN model.

	=== How to register ===		===How to register===
	To register the Company Name field, simply click on the pencil and type the Name that you want to be printed on the QRcode and on the PIX COPIEeCOLE. This field is limited to 25 characters and does not allow the use of symbols and accents.		To register the Company Name field, simply click on the pencil and type the Name that you want to be printed on the QRcode and on the PIX COPIEeCOLE. This field is limited to 25 characters and does not allow the use of symbols and accents.

Line 32:		Line 32:
	To register the PIX Key field, simply click on the pencil and type the PIX Key that you want to be printed in the QRcode and in the PIX COPIEeCOLE. This field can be an email, CNPJ, CPF or a random Key.		To register the PIX Key field, simply click on the pencil and type the PIX Key that you want to be printed in the QRcode and in the PIX COPIEeCOLE. This field can be an email, CNPJ, CPF or a random Key.

	=== To use ===		===To use===
	When printing an invoice, choose the pixbrasil template and generate the document. The invoice with one page with the PIX will be printed in the pdf document.		When printing an invoice, choose the pixbrasil template and generate the document. The invoice with one page with the PIX will be printed in the pdf document.

Line 39:		Line 39:
	The Invoice code (Only numbers and letters, symbols are suppressed) is registered in the PIX, so it is possible to quickly identify the invoice in the system		The Invoice code (Only numbers and letters, symbols are suppressed) is registered in the PIX, so it is possible to quickly identify the invoice in the system

	=== Comments ===		===Comments===
	The PIX Key needs to be registered at any bank in Brazil to be valid for transactions.		The PIX Key needs to be registered at any bank in Brazil to be valid for transactions.

	When installing the module, the PIX payment method will be entered in the payment options.		When installing the module, the PIX payment method will be entered in the payment options.

	=== Safety ===		===Safety===
	The PIXBRASIL module creates a hash containing the information of the Receiver and the unique security identifier of each Dolibarr. In this way, modifying the PIX Key directly via the database will prevent the PIX from being printed, guaranteeing the integrity of the QRCode generated only from the system. The Hash will be created whenever the PIXBRASIL module information is changed by the system administrator or by a user with writing permission to the module.		The PIXBRASIL module creates a hash containing the information of the Receiver and the unique security identifier of each Dolibarr. In this way, modifying the PIX Key directly via the database will prevent the PIX from being printed, guaranteeing the integrity of the QRCode generated only from the system. The Hash will be created whenever the PIXBRASIL module information is changed by the system administrator or by a user with writing permission to the module.

			===''O MÓDULO DOLIBARR PIXBRASIL''===
			''O Módulo Pix Brasil cria um modelo de impressão para o Dolibarr nos arquivos pdf das faturas de vendas que permite imprimir o PIX para pagamento em todos os bancos do Brasil. Dessa forma, os clientes podem receber as faturas por email ou whatsapp e pagá-las rapidamente em qualquer dispositivo que aceite o PIX como pagamento.''

	==== O ~~módulo Dolibarr PIXBRASIL~~ ====		====''SOBRE O PIX''====
	O ~~Módulo Pix Brasil cria~~ um modelo de ~~impressão para o Dolibarr nos arquivos pdf das faturas~~ de ~~vendas~~ que permite ~~imprimir~~ o ~~PIX para pagamento em todos os bancos~~ do ~~Brasil. Dessa forma~~, ~~os clientes podem receber as faturas por email ou whatsapp~~ e ~~pagá-las rapidamente em qualquer dispositivo que aceite o PIX como pagamento~~.		''O PIX é um modelo de interação bancária por meio de código QRcode que permite realizar transações bancárias sem nenhuma digitação ou escrita. O modelo PIX permite também copiar e colar o texto gerador do QRcode, facilitando o compartilhamento e aumentando a segurança das transações.''

	==== SOBRE O ~~PIX~~ ====		====''SOBRE O MÓDULO'' ====
	O PIX é um modelo de interação bancária por meio de código QRcode que permite realizar transações bancárias sem nenhuma digitação ou escrita. O modelo PIX permite também copiar e colar o texto gerador do QRcode, facilitando o compartilhamento e aumentando a segurança das transações.

	=== ~~SOBRE O MÓDULO DOLIBARR PIX BRASIL~~ ===		====''Ao Instalar''====
			''Na instalação do módulo é criado um novo modelo de impressão em pdf nas faturas de vendas e a tabela com os campos editáveis com valores nulos. Primeiramente é necessário cadastrar os campos Nome da Empresa, Município da Empresa e Chave PIX. Com os 3 campos preenchidos, o sistema gera uma nova página nas faturas de vendas com o código QRcode PIX e o campo copia e cola do texto do PIX. O campo valor é o total da fatura e os demais campos são obrigatórios conforme o modelo do BACEN.''

	==== ~~Ao Instalar~~ ====		====''Como cadastrar''====
	~~Na instalação do módulo é criado um novo modelo de impressão em pdf nas faturas de vendas e a tabela com os campos editáveis com valores nulos. Primeiramente é necessário~~ cadastrar ~~os campos~~ Nome da Empresa, ~~Município da Empresa~~ e ~~Chave PIX. Com os 3 campos preenchidos,~~ o ~~sistema gera uma nova página nas faturas de vendas com o código~~ QRcode ~~PIX e o campo copia~~ e ~~cola do texto do~~ PIX. O campo ~~valor é~~ o ~~total da fatura~~ e ~~os demais campos são obrigatórios conforme o modelo do BACEN~~.		''Para cadastrar o campo Nome da Empresa, basta clicar no lápis e digitar o Nome que deseja ser impresso no QRcode e no PIX COPIEeCOLE. Este campo possui limitações de 25 caracteres e não permite o uso de símbolos e acentuação.''

	~~==== Como cadastrar ====~~		''Para cadastrar o campo Município da Empresa, basta clicar no lápis e digitar o Nome do Município que deseja ser impresso no QRcode e no PIX COPIEeCOLE. Este campo possui limitações de 15 caracteres e não permite o uso de símbolos e acentuação.''
	Para cadastrar o campo ~~Nome~~ da Empresa, basta clicar no lápis e digitar o Nome que deseja ser impresso no QRcode e no PIX COPIEeCOLE. Este campo possui limitações de 25 caracteres e não permite o uso de símbolos e acentuação.

	Para cadastrar o campo ~~Município da Empresa~~, basta clicar no lápis e digitar ~~o Nome do Município~~ que deseja ser impresso no QRcode e no PIX COPIEeCOLE. Este campo ~~possui limitações de 15 caracteres e não permite o uso de símbolos e acentuação~~.		''Para cadastrar o campo Chave PIX, basta clicar no lápis e digitar a Chave PIX que deseja ser impresso no QRcode e no PIX COPIEeCOLE. Este campo pode ser um email, CNPJ, CPF ou uma Chave aleatória.''

	Para ~~cadastrar~~ o ~~campo Chave PIX, basta clicar no lápis~~ e ~~digitar a Chave PIX que deseja ser~~ impresso no ~~QRcode e no~~ PIX ~~COPIEeCOLE. Este campo pode ser um email, CNPJ, CPF ou uma Chave aleatória~~.		====''Para utilizar''====
			''Ao imprimir uma fatura, escolha o modelo pixbrasil e gere o documento. Será impresso no documento pdf a fatura com uma página com o PIX.''

	~~==== Para utilizar ====~~		''Se desejar não aparecer o PIX na fatura, basta deixar um ou mais campos sem valor.''
	~~Ao imprimir uma~~ fatura, ~~escolha o modelo pixbrasil e gere o documento. Será impresso no documento pdf a fatura com uma página com o PIX~~.

	~~Se desejar não aparecer o~~ PIX na fatura~~, basta deixar um ou mais campos sem valor.~~		''O código da Fatura (Somente números e letras, os símbolos são suprimidos) é cadastrado no PIX, dessa forma é possível identificar a fatura rapidamente no sistema''

	~~O código da Fatura (Somente números e letras, os símbolos são suprimidos) é cadastrado no~~ PIX~~, dessa forma é possível identificar a fatura rapidamente~~ no ~~sistema~~		====''Observações''====
			''A Chave PIX precisa ser cadastrada em qualquer banco no Brasil para ter validade nas transações.''

	~~==== Observações ====~~		''Ao instalar o módulo, será inserido o modo de pagamento PIX nas opções de pagamento.''
	~~A Chave~~ PIX ~~precisa ser cadastrada em qualquer banco no Brasil para ter validade~~ nas ~~transações~~.

	~~Ao instalar o módulo, será inserido o modo de pagamento PIX nas opções de pagamento.~~		====''Segurança''====
			''O módulo PIXBRASIL cria um hash contendo as informações do Recebedor e do identificador único de segurança de cada Dolibarr. Dessa forma, a modificação da Chave PIX diretamente via banco de dados impedirá a impressão do PIX, garantindo a integridade do QRCode gerado somente a partir do sistema. O Hash será criado sempre que as informações do módulo PIXBRASIL forem alteradas pelo administrador do sistema ou por usuário com permissão de escrita ao módulo.''
	==== Segurança ====
	O módulo PIXBRASIL cria um hash contendo as informações do Recebedor e do identificador único de segurança de cada Dolibarr. Dessa forma, a modificação da Chave PIX diretamente via banco de dados impedirá a impressão do PIX, garantindo a integridade do QRCode gerado somente a partir do sistema. O Hash será criado sempre que as informações do módulo PIXBRASIL forem alteradas pelo administrador do sistema ou por usuário com permissão de escrita ao módulo.

	=<small>Install</small>=		=<small>Install</small>=

Paulorcdo: /* Logo */

2022-04-07T12:37:22Z

Logo

Show changes

Paulorcdo: testando

2022-04-07T12:16:14Z

testando

New page

[[Category:Complementary modules]]
[[Category:Module_PIXBrasil]]
{{TemplateDocDev}}
{{TemplateDocUtil}}
=Informations=
{{TemplateModuleInfo
|modulename=PIXBrasil
|editor=paulorcdo
|web=https://www.empresalivre.com/demo1
|webbuy=On [https://www.dolistore.com/en/modules/1133-Customize-Forms.html]
|status=stable
|minversion=8.0
|note=Module PIXBrasil
}}
=Logo=
[[Image:Logotipo500.jpg|200px|Logo]]
=Features=

'''PIXBrasil''' PIX is a model of banking interaction through QRcode that allows you to carry out banking transactions without any typing or writing.

1- Hide fields;

2- Make fields as mandatory (Javascript);

3- Disable fields;

4- Create Custom Header and Footer;

5- Define default values for fields (texts, lists, html, selection and categories);

6- Create tooltip with instructions on the fields;

7- Create auxiliary lists of preformatted texts and phrases to easily insert into the fields (text, html);

8- Change the presented names of the fields without changing the translations;
=Install=
1- To Install the module, simply unzip the files and place in the '''custom''' folder of the Dolibarr directory and then '''Activate''' the module.

2- The module is installed in the '''Tools''' menu of Dolibarr, click on the menu and on the left will appear the link Customize Forms.

3- Click on the '''Customize Forms''' link and you will be taken to the system home page.

=Permissions:=
1- Initial system permissions are set with access only to the System Administrator;

2- For new users, the administrator can configure read, edit, and delete permissions on the Dolibarr user or group permissions tab.

=Pages=

The '''Customize Forms''' Module is very simple to configure, has only 3 control pages:

==Page 1 - Home Page - List Forms==

*The Home Page lists all 24 Dolibarr forms that can be configured by Customizeforms.
*The Qty column tells you how many fields can be set on each form.
*To '''Customize''' a Form, just click the pencil on the right form.

[[Image:Pagina1.png|800px|HomePage]]

==Page 2 - List All Form Fields to Customize==

*In this example, we click on the '''Home Page''' in the '''New Commercial Proposal - Customer''' form.
*This page only displays fields with default values that have already been set. All fields of the form are displayed on this page.

1 - '''Extrafields''' that were created for this module will be inserted automatically when you open the page.

2 - The '''Header''' and '''footer''' fields are options that can be added to the form.

[[Image:Pagina2.png|800px|Form]]

'''Presentation the table: '''
The fields are listed in the columns as follows:

*'''Name''': Field Name
*'''Situation''': Current field status - Can be Visible, Invisible, Disabled, or Required.
*'''Default Value''': Value set to appear as default for the field (text fields, checkbox, selects, textarea).
*'''Tag''': New Name Defined for Field
*'''Auxiliary List''': List of Text separated by line breaks that can be added in any text field or textarea.
*'''Help Text''': Help text that appears when you approach the mouse.

==Page 3 - Customizing a form field==

In this example, we click in the '''New Commercial Proposal - Customer''' form (Page 1) and after we click on the '''Customer''' field (Page 2).

===To apply module functionality to the form example:===

*'''To Hide fields:'''
**Click in the combo box '''Define Visibility and Mandatory''' and select '''Invisible''' option (The entire line will be invisible);

*'''To Make fields as mandatory''' (Javascript):
**Click in the combo box '''Define Visibility and Mandatory''' and select '''Required''' option;

*'''To Disable field:'''
**Click in the combo box '''Define Visibility and Mandatory''' and select '''Disable''' option;

*'''To Define default values''' for field (texts, lists, html, selection and categories):
**Click in the combo box '''Set Default Value''' and select the desired option (Dolibarr options to combo box and checkbox, other field type only write the text to default value);

*'''To Change the presented name of the field''' without changing the translations:
**Digit new name text to '''Modify Field Name;'''

*'''To Create auxiliary lists''' of preformatted texts and phrases to easily insert into the fields (text, html):
**Digit List of Text separated by line breaks that can be added in any text field or textarea in '''Create Auxiliary List to insert into text or HTML fields''';

*'''To Create tooltip''' with instructions on the fields:
**Digit html text to '''Create Tooltip with Help Info;'''

*'''To put the date (future and past) in the date fields''' :
**It is possible to define '''future and past dates''' in all date fields, just put the text '''now(0)''' for the current day, '''now(+5)''' for 5 days later, or '''now(-5)''' for 5 days previous in the default value, for example;

[[Image:Pagina3.png|800px|CustomizeForms]]

===To create Headers and Footers on a form:===

1- Choose the form on the home page of the module (Page 1);

2- In the chosen form, click in the Header or Footer field (Page 2);

3- In Page 3:

*Click in the combo box '''Define Visibility and Mandatory''' and select '''Visible''' option;
*Digit new name text to '''Modify Field Name''', this field is a name of Header/Footer in the left table form;
*Digit html text in the field '''Set Default Value''' , this field is a content of Header/Footer in the right table form;

=Prerequisites=

Partial Features - Dolibarr ≥ 5.0.3

All Features - Dolibarr ≥ 9.0.3
=Demo=

View DEMO:https://trucolivre.com.br/dolibarr/ user:demo passw:demo
=Buy=
On https://www.dolistore.com/en/modules/1133-Customize-Forms.html

=Video=

View Video: https://www.youtube.com/watch?v=wTR9DMnpIck
='''Outros Módulos'''=

====Customize Interface====
https://wiki.dolibarr.org/index.php/Module_CustomizeInterface

====Categorize All====
https://wiki.dolibarr.org/index.php/Module_CategorizeAll