evaluate_customer is a JSON-RPC method provided by SPMM™ Web Service working under BINETIX® AGE™ node. Evaluates an input string with customer data encoded in SWIFT Information Service Character Set, and returns the evaluated result as structured JSON object with variety of fields. The Evaluation Process requires the meaning parts (lines) of the input string to be preliminary separated by on of the following ASCII separators despite the character set of the content: •TAB (0x9) - Horizontal Tab •LF (0x10) - Line Feed •VT (0x11) - Vertical Tab •CR (0x13) - Carriage Return •FS (0x28) - File Separator •GS (0x29) - Group Separator •RS (0x30) - Record Separator •US (0x31) - Unit Separator •| (0x124) - Vertical bar
For reference, the SWIFT Information Service Character Set, or the new "Z" Character set (SR 2018), consist of: a b c d e f g h i j k l m n o p q r s t u v w x y z For better and more controlled recognition, the evaluation algorithm supports also the following optional tags positioned at the beginning of each line (separated part) from the input string: •/<account> - Client's account number evaluation: oStrict search of IBAN - The IBAN sequence is evaluated WITH slash symbol prefix. The slash symbol SHOULD BE followed by a strictly formatted IBAN string sequence. oRelaxed search of IBAN - The IBAN sequence is evaluated WITHOUT slash symbol prefix. The sequence is normalized (capitalized, trimmed, etc.) and validated. Only valid IBAN sequence shall be returned as a result. oThe strict search has higher priority over the relaxed search, and the strict search is essential when you are expecting an IBAN to be found at particular line, meaning also that when you're searching strictly any normalizations will be omitted. oThe relax search is useful in those use-cases when you're looking for a string sequence eventually similar to IBAN sequence but the content could be also different one. When the sequence is not a valid IBAN then the Evaluation process shall proceed with other findings. •1/<name> - Contains the full name of the customer (Individual or Company). •2/<address> - The address line contains a full description of a postal address, like city, zip, street name, street number and more. •3/<country_code>/<city> - Contains the ISO country code and the city name. •4/<DOB> - Date of Birth must be encoded in format YYYYMMDD. •5/<country_code>/<POB> - Contains the ISO country code and POB (Place of Birth). •6/<country_code>/<issuer>/<CIN> - Contains the ISO country code, Issuer authority, and CIN (customer identification number). •7/<country_code>/<NIN> - Contains the ISO country code and NIN (National Identity Number). •/ARNU/<country_code>/<number> - Contains the ISO country code and Alien Registration Number. •/CCPT/<country_code>/<number> - Contains the ISO country code and Passport Number. •/CUST/<country_code>/<issuer>/<number> - Contains the ISO country code, Issuer authority, and Customer Identification Number. •/DRLC/<country_code>/<issuer>/<number> - Contains the ISO country code, Issuer authority, and Driver's Licence Number. •/EMPL/<country_code>/<issuer>/<number> - Contains the ISO country code, Issuer authority, and the Employer Number. •/NIDN/<country_code>/<number> - Contains the ISO country code and the National Identity Number. •/ZIP/<code> - Integer value of postal code.
Note: Take into consideration that most of the tags listed above, are related to client's information and are compliant with the SWIFT standard. Consequently, no need of special string transformation is required when the method is used with SWIFT MT documents. The Evaluation Process is trying to recognize three more field types using additional heuristical algorithms and fuzzy comparisons at the following priority order: •Company Data - the company name SHOULD be followed by some typical company type identifier, like LTD, LLC, PLC, and more. •Address Line - the free-text address line SHOULD have kind of punctuation marks and numbers. •Individual Name - a free-text representation of the full name of individual which SHOULD not contain Arabic digits and punctuation marks except those used for compound names. |
|
|
This JSON object contains fields and sub-fields generated as a result of the evaluation process. All findings, relevant to the final result, including all possible duplications, will be included into the Data Object as dedicated fields. Currently the evaluation process COULD produce one or more of the following fields: 1)customer_account includes the result of evaluated IBAN data. 2)customer_name includes: a.full_name_en - the full name of the customer in Latin b.full_name_bg - the full name of the customer transliterated to Cyrillic c.hash_type d.hash_en - the calculated hash value of the Latin representation of the customer name e.hash_bg - the calculated hash value of the Cyrillic representation of the customer name 3)customer_address includes: a.postal_code - integer value of postal code b.city_en - city name in Latin c.city_bg - city name transliterated to Cyrillic d.street_en - street name in Latin e.street_bg - street name transliterated to Cyrillic f.address_en - the full address in Latin g.address_bg - the full address transliterated to Cyrillic 4)country_location includes: a.country_code b.city_en - city name in Latin c.city_bg - city name transliterated to Cyrillic 5)customer_dob (Date of Birth) includes: a.dob_year b.dob_month c.dob_day d.dob_date - the complete date constructed as dob_year - dob_month - dob_day 6)customer_pob (Place of Birth) includes: a.country_code b.region_en - Region title in Latin c.region_bg - Region title transliterated to Cyrillic 7)customer_cin (Customer Identification Number) includes: a.country_code b.issuer_id c.id_number 8)customer_nin (National Identity Number) includes: a.country_code b.national_id 9)customer_arnu includes: a.country_code b.registration_number 10)customer_ccpt includes: a.country_code b.passport_number 11)customer_drlc includes: a.country_code b.issuer_id c.id_number - this SHOULD be the Customer Identification Number (CIN) 12)customer_empl includes: a.country_code b.driver_licence 13)customer_nidn includes: a.country_code b.national_identity 14)company_data includes: a.name_en - name of the company in Latin b.name_bg - name of the company transliterated to Cyrillic c.type_en - form of company management in Lating d.type_bg - form of company management transliterated to Cyrillic e.hash_type f.hash_en - the calculated hash value of the Latin representation of the company name (without the management form) g.hash_bg - the calculated hash value of the Cyrillic representation of the company name (without the management form) |
https://localhost:8061/binetix/spmm |
{ |
{ |