Plugin: LCO Detailed Names

• 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