- Maintainer: Carlos Ruiz - Quality Systems & Solutions GlobalQSS
- Status: Production, up to date with release 8.2
- License: GPLv2
- P2 Repository: site.p2
- Sources: github
- JAR file: org.globalqss.idempiere.LCO.detailednames-8.2.0-SNAPSHOT.jar
Description
This functionality adds six fields in the Business Partner window: Tax ID Type, First Name 1/2, Last Name 1/2, Verification Digit
The tax ID type defines if one name is captured, or first and last names are captured. It also defines if a verification digit must be calculated or verified for the Tax ID field.
Note that functionality adds two first names and two last names, in case you want to use just one is easy to hide the corresponding second fields using the Window Customization
If you want to provide additional comments, please use the Discussion page
There is a simpler subset of this plugin that simply provides First/Last names, you can find it in Plugin: LCO First Name
Configuration
SysConfig Parameters
The following System Configurator parameters can be used to modify the behavior of this functionality:
- LCO_USE_DETAILED_NAMES
- If you define this parameter as N in a client then the whole functionality of detailed names will be disabled for this client
- Default: Y
- Scope: Client
- QSSLCO_FillValueWithTaxID
- This is used to fill by default the Search Key of a Business Partner from the TaxID field
- Default: N
- Scope: Client
- QSSLCO_NameSeparator
- When using detailed names, it defines here the separator for the Name field on business partner when concatenating the first names with last names
- Default: WhiteSpace
- Scope: Client
- QSSLCO_NamesFirst
- When using detailed names, it defines if the first names will be first, otherwise the last names will be first
- Default: Y
- Scope: Client
Tax ID Type Window
The Tax Id Type let you define the different types of tax IDs that you want to manage as well as some configuration:
- Use Tax ID Digit: It defines if a tax ID Digit must be shown on the Business Partner window
- Is Digit Checked: It defines how is the tax ID Digit checked:
- Callout: digit check is generated automatically and immediately after the tax ID field is filled
- Generate: digit check is generated when the record is saved
- Check: digit check is not generated, but compared and validated against user captured value
- Country: The country is required to define the digit check validation, the LCO plugin implements the validation for Colombia and Ecuador, this can be OSGi extended for other countries implementing the interface org.globalqss.util.ILCO_TaxIDDigit and defining the property country with the corresponding country code that it implements.
- Detailed Names: It defines if the business partner must allow capturing first/last name(s) - used for persons
- Minimum/Maximum Length: It defines the minimum and maximum length allowed for this document type, zero means no validation
- Tax Code: External code for this tax ID type - for reporting purposes
- Default: Used to define which is the default tax ID type
Usage
Business Partner
How to Install
P2 Repository - Single Plugin
The recommended way to install the plugin is using the p2 repository.
REPO=https://jenkins.idempiere.org/job/globalqss-iDempiere-LCO/ws/org.globalqss.idempiere.LCO.p2.site/target/repository/ cd /opt/idempiere-server # Where your iDempiere server is installed bash update-prd.sh $REPO org.globalqss.idempiere.LCO.detailednames
OSGi console
You can install the single plugin from the OSGi console too.
From the OSGi console (usually accessible using telnet localhost 12612) you can execute the following commands:
install https://jenkins.idempiere.org/job/globalqss-iDempiere-LCO/ws/org.globalqss.idempiere.LCO.detailednames/target/org.globalqss.idempiere.LCO.detailednames-8.2.0-SNAPSHOT.jar setbsl 5 org.globalqss.idempiere.LCO.detailednames # to set the start level of the plugin sta org.globalqss.idempiere.LCO.detailednames # to start the plugin
Felix console
To install the plugin using the felix console (not recommended) you can download the plugin jar from org.globalqss.idempiere.LCO.detailednames-8.2.0-SNAPSHOT.jar and use the felix console to install as usual, assign a start level of 5.
P2 Repository - Full LCO
You can also install the complete Localization Colombia using the feature syntax:
REPO=https://jenkins.idempiere.org/job/globalqss-iDempiere-LCO/ws/org.globalqss.idempiere.LCO.p2.site/target/repository/ cd /opt/idempiere-server # Where your iDempiere server is installed bash update-prd.sh $REPO org.globalqss.idempiere.LCO.feature.feature.group
This will install the five plugins of the LCO (as well as other required additional plugins):
- org.globalqss.idempiere.LCO.detailednames
- org.globalqss.idempiere.LCO.electronicinvoice
- org.globalqss.idempiere.LCO.invoicenumbercontrol
- org.globalqss.idempiere.LCO.magneticmedia
- org.globalqss.idempiere.LCO.withholdings
