ALERT®
SSI UTILITY CHARACTER SET SPECIFICATIONS
APRIL 03, 2018 ALERT SI Utility Character Set Specifications
Copyright © 2018 DTCC. All rights reserved. This work (including, without limitation, all text, images, logos, compilation and design) is proprietary and protected by copyright, and is for the exclusive use of users authorized by DTCC. If this work is received from DTCC in any electronic medium, authorized users of this work are granted a limited, non-exclusive, non- transferable, non-sublicensable and freely revocable license to make reproductions and transmissions necessary for downloading and storage of this work on the users' computers and to print one or more paper copies from the electronic version for their own use. Other than to this limited extent, no part of this work (including any paper copies thereof or print versions thereof) may be printed, copied, altered, modified, posted, reproduced, displayed, published, sold, licensed, used or distributed (including by transmission) in any form or by any means, or stored in any information storage and retrieval system, without DTCC's prior written permission.
All product or service names are the property of their respective owners.
The services described herein are provided under the “DTCC” brand name by certain affiliates of The Depository Trust & Clearing Corporation (“DTCC”). DTCC itself does not provide such services. Each of these affiliates is a separate legal entity, subject to the laws and regulations of the particular country or countries in which such entity operates. Please see www.dtcc.com for more information on DTCC, its affiliates and the services they offer.
Publication Code: AL440 Service: ALERT® Title: SSI Utility Character Set Specifications
book_copyright 2 TABLE OF CONTENTS
1. Preface 4
Audience 4
Documentation and website reference 4
Related Documents and Training 4
Questions? 4
2. Overview 5
Introduction 5
What is ISO 8859-1? 5
What is SWIFT MT? 5
3. SSI Utility Character Requirements 6
Introduction 6
Character Set Requirements 6
Error Handling 6
Unsupported Encoded Exception Error 6
Datanomic Field Error Message 6
A. SWIFT standards supported characters 7
B. ISO 8859-1 character set list 8 ALERT SI Utility Character Set Specifications
1. PREFACE
This document contains information on character sets permitted in all ALERT platform/ SSI Utility components : Broker Direct , Global Custodian Direct, and the ALERT platform's web interface. Audience This document is for business/systems analysts, programmers, and others who are involved with the ALERT platform. Documentation and website reference
Table 1.1 Documentation and website reference Document/Website Name Description http://www.fileformat.info/info/charset/ISO- Website containing the complete character list for ISO-8859- 8859-1/list.htm 1.
Standards MX - General Information.pdf SWIFT Standards MX document which details the special characters permitted for SWIFT MT messages, from http://www.swift.com/assets/corporates/documents/our_ solution/implementing_your_project_2011_standards_mx_ general_information.pdf. http://www.iso.org/iso/home/store/catalogue_ ISO/IEC 8859-1 published document. tc/catalogue_detail.htm?csnumber=28245 Related Documents and Training For related documents and videos, and all documents referenced in this document, go to the Institutional Trade Processing - ALERT section of the Learning Center. Questions? The DTCC Client Center provides general assistance and technical help. Visit www.dtcc.com/client-center to: l Enter a service request or check l Search the knowledge base l Obtain contact information
Preface 4 ALERT SI Utility Character Set Specifications
2. OVERVIEW Introduction This chapter introduces the character sets permitted for all of the SSI Utility components. What is ISO 8859-1? ISO (International Organization for Standardization) 8859-1 standard contains 8-bit (ASCII) single-byte coded graphic character sets (http://www.iso.org/iso/home/store/catalogue_tc/catalogue_ detail.htm?csnumber=28245). ISO 8859-1 is utilized primarily for Western European languages containing the Latin alphabet. It supports 255 character sets. What is SWIFT MT? SWIFT (Society for Worldwide Interbank Financial Telecommunication) maintains a propriety communications platform for transmitting financial transaction messages. Institutions utilizing SWIFT’s communications platform are required to develop messages (Standards MT and/or MX) adhering to SWIFT Standards. SWIFT MT supports 89 character sets in messaging.
Overview 5 ALERT SI Utility Character Set Specifications
3. SSI UTILITY CHARACTER REQUIREMENTS Introduction This section summarizes the character requirements for all components of SSI Utility. Character Set Requirements The SSI Utility should adhere to ISO 8859-1 character sets (SSI Utility Character Requirements above) where applicable. The SSI Utility will limit character sets to SWIFT Standards (SWIFT standards supported characters on page 7) only for Standing Settlement Instruction (SSI) fields. The 89 character sets in SWIFT Standards is a subset of the 255 character sets permitted under ISO 8859-1. Limiting SSI Utility to SWIFT Standards for SSIs greatly reduces risk of downstream issues, particularly with the Broker/Direct Direct interface. 1. Any SSI field in the ALERT platform where the user can directly enter a data set, should be validated against the SWIFT Standards character set. 2. Any non-SSI field in the ALERT platform where the user can directly enter a data set, should be validated against the ISO 8859-1 character sets. 3. Any fields inthe ALERT platform where the data is fed from another application (either internal or external), should be validated against the ISO 8859-1 character sets. 4. Any drop-down menus should be validated against the ISO 8859-1 character sets. Error Handling The SSI Utility returns an error message when a field fails character set validation.
Note
Broker Direct validation is not presently available, except in the instance of a new password containing an invalid character (Error Code 20045=Invalid character in new password).
Unsupported Encoded Exception Error All incoming messages to the REST API will be confirmed ISO-8859-1 (Latin-1) compliant. The first failure instance will throw the following error message. l Error message=The data provided contains characters that do not conform to the ISO-8859-1 (Latin 1) character set. Datanomic Field Error Message The SSI Utility returns a datanomic error message when a specific SSI field fails character set validation. l Error Code 1359= Field contains a character which is invalid for SWIFT. o This datanomic error is dependent on the country-method-security selected; however, this rule is broadly based across all fields of country-method-security combinations.
SSI Utility Character Requirements 6 ALERT SI Utility Character Set Specifications
A. SWIFT STANDARDS SUPPORTED CHARACTERS
DTCC uses the character set permitted for SWIFT’s core messaging service, SWIFTNet FIN. Table A.1 contains all characters permitted for SWIFT MT Standards. This material is referenced from the SWIFT website.
Table A.1 Basic Latin Character Set Character Description a - z 26 lower case letters of the Latin alphabet A - Z 26 upper case letters of the Latin alphabet 0 - 9 10 numerical characters / slash - hyphen ? question mark : colon ( open parentheses ) close parentheses . full stop , comma ` apostrophe + plus space = equals ! exclamation mark " quotation mark % percent And & ampersand * asterisk > less than < greater than ; semi-colon @ at # hash { open curly bracket CR carriage return LF line feed
SWIFT standards supported characters 7 ALERT SI Utility Character Set Specifications
B. ISO 8859-1 CHARACTER SET LIST
This list in Table B.1 is from http://www.fileformat.info/info/charset/ISO-8859-1/list.htm. Click the links in the Description column to open the page specific to that character.
Table B.1 Character set list Character Description Encoded Byte � NULL (U+0000) 0
START OF HEADING (U+0001) 1
START OF TEXT (U+0002) 2
END OF TEXT (U+0003) 3
END OF TRANSMISSION (U+0004) 4
ENCRYPT (U+0005) 5
ACKNOWLEDGE (U+0006) 6
BELL (U+0007) 7
BACKSPACE (U+0008) 8
CHARACTER TABULATION (U+0009) 9
LINE FEED (LF) (U+000A) 0a
LINE TABULATION (U+000B) 0b
FORM FEED (FF) (U+000C) 0c
CARRIAGE RETURN (CR) (U+000D) 0d
SHIFT OUT (U+000E) 0e
SHIFT IN (U+000F) 0f
DATA LINK ESCAPE (U+0010) 10
DEVICE CONTROL ONE (U+0011) 11
DEVICE CONTROL TWO (U+0012) 12
DEVICE CONTROL THREE (U+0013) 13
ISO 8859-1 character set list 8 ALERT SI Utility Character Set Specifications
Table B.1 Character set list (continued) Character Description Encoded Byte DEVICE CONTROL FOUR (U+0014) 14
NEGATIVE ACKNOWLEDGE (U+0015) 15
SYNCHRONOUS IDLE (U+0016) 16
END OF TRANSMISSION BLOCK (U+0017) 17
CANCEL (U+0018) 18
END OF MEDIUM (U+0019) 19
SUBSTITUTE (U+001A) 1a
ESCAPE (U+001B) 1b
INFORMATION SEPARATOR FOUR (U+001C) 1c
INFORMATION SEPARATOR THREE (U+001D) 1d
- INFORMATION SEPARATOR TWO (U+001E) 1e
INFORMATION SEPARATOR ONE (U+001F) 1f
SPACE (U+0020) 20
! EXCLAMATION MARK (U+0021) 21
" QUOTATION MARK (U+0022) 22
# NUMBER SIGN (U+0023) 23
$ DOLLAR SIGN (U+0024) 24
% PERCENT SIGN (U+0025) 25
& AMPERSAND (U+0026) 26
' APOSTROPHE (U+0027) 27
( LEFT PARENTHESIS (U+0028) 28
) RIGHT PARENTHESIS (U+0029) 29
* ASTERISK (U+002A) 2a
ISO 8859-1 character set list 9 ALERT SI Utility Character Set Specifications
Table B.1 Character set list (continued) Character Description Encoded Byte + PLUS SIGN (U+002B) 2b
, COMMA (U+002C) 2c
- HYPHEN-MINUS (U+002D) 2d
. FULL STOP (U+002E) 2e
/ SOLIDUS (U+002F) 2f
0 DIGIT ZERO (U+0030) 30
1 DIGIT ONE (U+0031) 31
2 DIGIT TWO (U+0032) 32
3 DIGIT THREE (U+0033) 33
4 DIGIT FOUR (U+0034) 34
5 DIGIT FIVE (U+0035) 35
6 DIGIT SIX (U+0036) 36
7 DIGIT SEVEN (U+0037) 37
8 DIGIT EIGHT (U+0038) 38
9 DIGIT NINE (U+0039) 39
: COLON (U+003A) 3a
; SEMICOLON (U+003B) 3b
< LESS-THAN SIGN (U+003C) 3c
= EQUALS SIGN (U+003D) 3d
> GREATER-THAN SIGN (U+003E) 3e
? QUESTION MARK (U+003F) 3f
@ COMMERCIAL AT (U+0040) 40
A LATIN CAPITAL LETTER A (U+0041) 41
ISO 8859-1 character set list 10 ALERT SI Utility Character Set Specifications
Table B.1 Character set list (continued) Character Description Encoded Byte B LATIN CAPITAL LETTER B (U+0042) 42
C LATIN CAPITAL LETTER C (U+0043) 43
D LATIN CAPITAL LETTER D (U+0044) 44
E LATIN CAPITAL LETTER E (U+0045) 45
F LATIN CAPITAL LETTER F (U+0046) 46
G LATIN CAPITAL LETTER G (U+0047) 47
H LATIN CAPITAL LETTER H (U+0048) 48
I LATIN CAPITAL LETTER I (U+0049) 49
J LATIN CAPITAL LETTER J (U+004A) 4a
K LATIN CAPITAL LETTER K (U+004B) 4b
L LATIN CAPITAL LETTER L (U+004C) 4c
M LATIN CAPITAL LETTER M (U+004D) 4d
N LATIN CAPITAL LETTER N (U+004E) 4e
O LATIN CAPITAL LETTER O (U+004F) 4f
P LATIN CAPITAL LETTER P (U+0050) 50
Q LATIN CAPITAL LETTER Q (U+0051) 51
R LATIN CAPITAL LETTER R (U+0052) 52
S LATIN CAPITAL LETTER S (U+0053) 53
T LATIN CAPITAL LETTER T (U+0054) 54
U LATIN CAPITAL LETTER U (U+0055) 55
V LATIN CAPITAL LETTER V (U+0056) 56
W LATIN CAPITAL LETTER W (U+0057) 57
X LATIN CAPITAL LETTER X (U+0058) 58
ISO 8859-1 character set list 11 ALERT SI Utility Character Set Specifications
Table B.1 Character set list (continued) Character Description Encoded Byte Y LATIN CAPITAL LETTER Y (U+0059) 59
Z LATIN CAPITAL LETTER Z (U+005A) 5a
[ LEFT SQUARE BRACKET (U+005B) 5b
\ REVERSE SOLIDUS (U+005C) 5c
] RIGHT SQUARE BRACKET (U+005D) 5d
^ CIRCUMFLEX ACCENT (U+005E) 5e
_ LOW LINE (U+005F) 5f
` GRAVE ACCENT (U+0060) 60 a LATIN SMALL LETTER A (U+0061) 61 b LATIN SMALL LETTER B (U+0062) 62 c LATIN SMALL LETTER C (U+0063) 63 d LATIN SMALL LETTER D (U+0064) 64 e LATIN SMALL LETTER E (U+0065) 65 f LATIN SMALL LETTER F (U+0066) 66 g LATIN SMALL LETTER G (U+0067) 67 h LATIN SMALL LETTER H (U+0068) 68 i LATIN SMALL LETTER I (U+0069) 69 j LATIN SMALL LETTER J (U+006A) 6a k LATIN SMALL LETTER K (U+006B) 6b l LATIN SMALL LETTER L (U+006C) 6c m LATIN SMALL LETTER M (U+006D) 6d n LATIN SMALL LETTER N (U+006E) 6e o LATIN SMALL LETTER O (U+006F) 6f
ISO 8859-1 character set list 12 ALERT SI Utility Character Set Specifications
Table B.1 Character set list (continued) Character Description Encoded Byte p LATIN SMALL LETTER P (U+0070) 70 q LATIN SMALL LETTER Q (U+0071) 71 r LATIN SMALL LETTER R (U+0072) 72 s LATIN SMALL LETTER S (U+0073) 73 t LATIN SMALL LETTER T (U+0074) 74 u LATIN SMALL LETTER U (U+0075) 75 v LATIN SMALL LETTER V (U+0076) 76 w LATIN SMALL LETTER W (U+0077) 77 x LATIN SMALL LETTER X (U+0078) 78 y LATIN SMALL LETTER Y (U+0079) 79 z LATIN SMALL LETTER Z (U+007A) 7a
{ LEFT CURLY BRACKET (U+007B) 7b
| VERTICAL LINE (U+007C) 7c
} RIGHT CURLY BRACKET (U+007D) 7d
~ TILDE (U+007E) 7e
DELETE (U+007F) 7f
€
‚ BREAK PERMITTED HERE (U+0082) 82
ƒ NO BREAK HERE (U+0083) 83
„
… NEXT LINE (NEL) (U+0085) 85
† START OF SELECTED AREA (U+0086) 86
ISO 8859-1 character set list 13 ALERT SI Utility Character Set Specifications
Table B.1 Character set list (continued) Character Description Encoded Byte ‡ END OF SELECTED AREA (U+0087) 87
ˆ CHARACTER TABULATION SET (U+0088) 88
‰ CHARACTER TABULATION WITH JUSTIFICATION 89 (U+0089) Š LINE TABULATION SET (U+008A) 8a
‹ PARTIAL LINE FORWARD (U+008B) 8b
ΠPARTIAL LINE BACKWARD (U+008C) 8c
REVERSE LINE FEED (U+008D) 8d
Ž SINGLE SHIFT TWO (U+008E) 8e
SINGLE SHIFT THREE (U+008F) 8f
DEVICE CONTROL STRING (U+0090) 90
‘ PRIVATE USE ONE (U+0091) 91
’ PRIVATE USE TWO (U+0092) 92
“ SET TRANSMIT STATE (U+0093) 93
” CANCEL CHARACTER (U+0094) 94
• MESSAGE WAITING (U+0095) 95
– START OF GUARDED AREA (U+0096) 96
— END OF GUARDED AREA (U+0097) 97
˜ START OF STRING (U+0098) 98
™
š SINGLE CHARACTER INTRODUCER (U+009A) 9a
› CONTROL SEQUENCE INTRODUCER (U+009B) 9b
œ STRING TERMINATOR (U+009C) 9c
OPERATING SYSTEM COMMAND (U+009D) 9d
ISO 8859-1 character set list 14 ALERT SI Utility Character Set Specifications
Table B.1 Character set list (continued) Character Description Encoded Byte ž PRIVACY MESSAGE (U+009E) 9e
Ÿ APPLICATION PROGRAM COMMAND (U+009F) 9f
NO-BREAK SPACE (U+00A0) a0
¡ INVERTED EXCLAMATION MARK (U+00A1) a1
¢ CENT SIGN (U+00A2) a2
£ POUND SIGN (U+00A3) a3
¤ CURRENCY SIGN (U+00A4) a4
¥ YEN SIGN (U+00A5) a5
¦ BROKEN BAR (U+00A6) a6
§ SECTION SIGN (U+00A7) a7
¨ DIAERESIS (U+00A8) a8
© COPYRIGHT SIGN (U+00A9) a9
ª FEMININE ORDINAL INDICATOR (U+00AA) aa
« LEFT-POINTING DOUBLE ANGLE QUOTATION MARK ab (U+00AB) ¬ NOT SIGN (U+00AC) ac
SOFT HYPHEN (U+00AD) ad
® REGISTERED SIGN (U+00AE) ae
¯ MACRON (U+00AF) af
° DEGREE SIGN (U+00B0) b0
± PLUS-MINUS SIGN (U+00B1) b1
² SUPERSCRIPT TWO (U+00B2) b2
³ SUPERSCRIPT THREE (U+00B3) b3
´ ACUTE ACCENT (U+00B4) b4
ISO 8859-1 character set list 15 ALERT SI Utility Character Set Specifications
Table B.1 Character set list (continued) Character Description Encoded Byte µ MICRO SIGN (U+00B5) b5
¶ PILCROW SIGN (U+00B6) b6
· MIDDLE DOT (U+00B7) b7
¸ CEDILLA (U+00B8) b8
¹ SUPERSCRIPT ONE (U+00B9) b9
º MASCULINE ORDINAL INDICATOR (U+00BA) ba
» RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK bb (U+00BB) ¼ VULGAR FRACTION ONE QUARTER (U+00BC) bc
½ VULGAR FRACTION ONE HALF (U+00BD) bd
¾ VULGAR FRACTION THREE QUARTERS (U+00BE) be
¿ INVERTED QUESTION MARK (U+00BF) bf
À LATIN CAPITAL LETTER A WITH GRAVE (U+00C0) c0
Á LATIN CAPITAL LETTER A WITH ACUTE (U+00C1) c1
 LATIN CAPITAL LETTER A WITH CIRCUMFLEX (U+00C2) c2
à LATIN CAPITAL LETTER A WITH TILDE (U+00C3) c3
Ä LATIN CAPITAL LETTER A WITH DIAERESIS (U+00C4) c4
Å LATIN CAPITAL LETTER A WITH RING ABOVE (U+00C5) c5
Æ LATIN CAPITAL LETTER AE (U+00C6) c6
Ç LATIN CAPITAL LETTER C WITH CEDILLA (U+00C7) c7
È LATIN CAPITAL LETTER E WITH GRAVE (U+00C8) c8
É LATIN CAPITAL LETTER E WITH ACUTE (U+00C9) c9
Ê LATIN CAPITAL LETTER E WITH CIRCUMFLEX (U+00CA) ca
Ë LATIN CAPITAL LETTER E WITH DIAERESIS (U+00CB) cb
ISO 8859-1 character set list 16 ALERT SI Utility Character Set Specifications
Table B.1 Character set list (continued) Character Description Encoded Byte Ì LATIN CAPITAL LETTER I WITH GRAVE (U+00CC) cc
Í LATIN CAPITAL LETTER I WITH ACUTE (U+00CD) cd
Î LATIN CAPITAL LETTER I WITH CIRCUMFLEX (U+00CE) ce
Ï LATIN CAPITAL LETTER I WITH DIAERESIS (U+00CF) cf
Ð LATIN CAPITAL LETTER ETH (U+00D0) d0
Ñ LATIN CAPITAL LETTER N WITH TILDE (U+00D1) d1
Ò LATIN CAPITAL LETTER O WITH GRAVE (U+00D2) d2
Ó LATIN CAPITAL LETTER O WITH ACUTE (U+00D3) d3
Ô LATIN CAPITAL LETTER O WITH CIRCUMFLEX (U+00D4) d4
Õ LATIN CAPITAL LETTER O WITH TILDE (U+00D5) d5
Ö LATIN CAPITAL LETTER O WITH DIAERESIS (U+00D6) d6
× MULTIPLICATION SIGN (U+00D7) d7
Ø LATIN CAPITAL LETTER O WITH STROKE (U+00D8) d8
Ù LATIN CAPITAL LETTER U WITH GRAVE (U+00D9) d9
Ú LATIN CAPITAL LETTER U WITH ACUTE (U+00DA) da
Û LATIN CAPITAL LETTER U WITH CIRCUMFLEX (U+00DB) db
Ü LATIN CAPITAL LETTER U WITH DIAERESIS (U+00DC) dc
Ý LATIN CAPITAL LETTER Y WITH ACUTE (U+00DD) dd
Þ LATIN CAPITAL LETTER THORN (U+00DE) de
ß LATIN SMALL LETTER SHARP S (U+00DF) df
à LATIN SMALL LETTER A WITH GRAVE (U+00E0) e0
á LATIN SMALL LETTER A WITH ACUTE (U+00E1) e1
â LATIN SMALL LETTER A WITH CIRCUMFLEX (U+00E2) e2
ISO 8859-1 character set list 17 ALERT SI Utility Character Set Specifications
Table B.1 Character set list (continued) Character Description Encoded Byte ã LATIN SMALL LETTER A WITH TILDE (U+00E3) e3
ä LATIN SMALL LETTER A WITH DIAERESIS (U+00E4) e4
å LATIN SMALL LETTER A WITH RING ABOVE (U+00E5) e5
æ LATIN SMALL LETTER AE (U+00E6) e6
ç LATIN SMALL LETTER C WITH CEDILLA (U+00E7) e7
è LATIN SMALL LETTER E WITH GRAVE (U+00E8) e8
é LATIN SMALL LETTER E WITH ACUTE (U+00E9) e9
ê LATIN SMALL LETTER E WITH CIRCUMFLEX (U+00EA) ea
ë LATIN SMALL LETTER E WITH DIAERESIS (U+00EB) eb
ì LATIN SMALL LETTER I WITH GRAVE (U+00EC) ec
í LATIN SMALL LETTER I WITH ACUTE (U+00ED) ed
î LATIN SMALL LETTER I WITH CIRCUMFLEX (U+00EE) ee
ï LATIN SMALL LETTER I WITH DIAERESIS (U+00EF) ef
ð LATIN SMALL LETTER ETH (U+00F0) f0
ñ LATIN SMALL LETTER N WITH TILDE (U+00F1) f1
ò LATIN SMALL LETTER O WITH GRAVE (U+00F2) f2
ó LATIN SMALL LETTER O WITH ACUTE (U+00F3) f3
ô LATIN SMALL LETTER O WITH CIRCUMFLEX (U+00F4) f4
õ LATIN SMALL LETTER O WITH TILDE (U+00F5) f5
ö LATIN SMALL LETTER O WITH DIAERESIS (U+00F6) f6
÷ DIVISION SIGN (U+00F7) f7
ø LATIN SMALL LETTER O WITH STROKE (U+00F8) f8
ù LATIN SMALL LETTER U WITH GRAVE (U+00F9) f9
ISO 8859-1 character set list 18 ALERT SI Utility Character Set Specifications
Table B.1 Character set list (continued) Character Description Encoded Byte ú LATIN SMALL LETTER U WITH ACUTE (U+00FA) fa
û LATIN SMALL LETTER U WITH CIRCUMFLEX (U+00FB) fb
ü LATIN SMALL LETTER U WITH DIAERESIS (U+00FC) fc
ý LATIN SMALL LETTER Y WITH ACUTE (U+00FD) fd
þ LATIN SMALL LETTER THORN (U+00FE) fe
ÿ LATIN SMALL LETTER Y WITH DIAERESIS (U+00FF) ff
ISO 8859-1 character set list 19