Implementation Guideline for AUTHOR (1) Corporate egateway

Transcription

1 Implementation Guideline for AUTHOR (1) Corporate egateway

2 Table of contents 1 Introduction Document references AUTHOR message - payment types and identifications Segment table Specification of segments and segment groups... 5 Segment group 2 (D1)... 7 Segment group 3 (D2)... 8 Segment group 4 (M9999) Segment group 5 (R3) Segment group 6 (D1) Segment group 7 (D1) Segment group 8 (D1) Examples... 18

3 Document Title Implementation Guideline for AUTHOR(1) Date Version 1.5 1(20) Page Author Subject Department Project Authorization message from Customer to Nordea Based on AUTHOR UN/EDIFACT directory D.96 A Corporate egateway 1 Introduction The terms and definitions used in this document are defined in a separate document, Glossary for Corporate egateway, which can be found on the Nordea.com homepage: The purpose of this documentation is to define how information in multiple direct debit order Messages should be structured for the exchange between the Message sender and Nordea. This MIG fully complies with the international definitions for content and use of an UN/EDIFACT Authorization message (AUTHOR). This MIG does not include any technical issues such as security, retransmissions, duplicates. These issues as well as the service-segments related to the exchange, or business related issues, are described in Corporate egateway Service Documentation. For a full understanding of the use of the authorization message and this implementation guide we refer to documents: Functional Specification Nordea Direct debit (NDD) Message Flow and use of EDIFACT 2 Document references This chapter contains references to documents relevant for this MIG: [1] UN/EDIFACT directory D.96A. UN/ECE, March UNTDID, UN/ECE Geneva, [2] UN/EDIFACT United Nations Standard message. Authorization Message AUTHOR, Revision 2, dated , based on UN/EDIFACT UNTDID D.96A.

4 Version 1.5 2(20) Page 3 AUTHOR message - payment types and identifications An Authorization message, with authorization requests or cancellation requests for existing authorizations, for one of the direct debiting services provided in NDD, is sent by the Customer to the EDI Centre at Nordea. The EDI Centre converts the message to authorization requests in domestic formats and transmits the instructions to clearing houses in the different countries. NOTE: One AUTHOR message can only contain authorizations for ONE service and ONE creditor. Services for which this MIG is applicable Denmark BetalingsService (BS) LeverandørService (LS) Sweden Autogiro through Bankgiro Note: AUTHOR to clearinghouse is not supported for Avtalegiro Norway. Identification of parties The parties involved in the authorization are identified as described below. Position in type Message Description Creditor Creditor (party to whom payment is due). SG2, FII BF AutoGiro through Bankgiro SG3, NAD HS BetalingsService, LeverandørService Debtor SG5, RFF IT Debtor (party from whom payment is due). AutoGiro through Bankgiro, BetalingsService, LeverandørService

5 Version 1.5 3(20) Page 4 Segment table The table below lists all segments and segment groups included in the AUTHOR message. Segments and groups which are used according to this MIG, are listed in bold. The status and number of repeats are listed for EDIFACT and for usage according to this MIG under Nordea. Status/Repeats Tag Name EDIFACT Nordea Loop UNH Message header M1 M1 BGM Beginning of message M1 M1 DTM Date/time/period C1 R1 BUS Business function C1 R Segment group C RFF M1 0 DTM Date/time/period C Segment group C5 D FII Financial institution information M1 M1 CTA Contact information C1 0 COM Communication contact C Segment group C3 D NAD Name and address M1 M1 CTA Contact information C1 0 COM Communication contact C Segment group M9999 M LIN Line item M1 M Segment group C5 R RFF M1 M1 DTM Date/time/period C Segment group C9999 D SEQ Sequence details M1 M1 GIS General indicator M1 M1 DTM Date/time/period C2 D1 MOA Monetary amount C1 0 DOC Document/message details C Segment group C2 D FII Financial institution information M1 M1 CTA Contact information C1 0 COM Communication contact C

6 Version 1.5 4(20) Page Segment group C2 D NAD Name and address M1 M1 CTA Contact information C1 0 COM Communication contact C CNT Control total C Segment group C AUT Authentication result M1 0 DTM Date/time/period C UNT Message trailer M1 M1

7 Version 1.5 5(20) Page 5 Specification of segments and segment groups UNH - Message header (M1) A service segment starting and uniquely identifying the message MESSAGE REFERENCE NUMBER M an..14 M Sender s unique identification of the message S009 MESSAGE IDENTIFIER M M Message type M an..6 M AUTHOR Message version number M an..3 M D Message release number M an..3 M 96A Controlling agency M an..2 M UN United Nations Association assigned code C an..6 N COMMON ACCESS REFERENCE C an..35 N S010 STATUS OF THE TRANSFER C N Sequence message transfer number M n First/last sequence message transfer indication C a1 UNH+1+AUTHOR:D:96A:UN' BGM - Beginning of message (M1) A segment for unique identification of the Authorization message. C002 DOCUMENT/MESSAGE NAME C R Document/message name, coded C an..3 R 149 Basic agreement Code list qualifier C an..3 N Code list responsible agency, coded C an..3 N Document/message name C an..35 N DOCUMENT/MESSAGE NUMBER C an..35 R <Authorization message number> MESSAGE FUNCTION, CODED C an..3 N RESPONS TYPE, CODED C an..3 N BGM '

8 Version 1.5 6(20) Page DTM - Date/time/period (R1) A segment containing the creation date of the Authorization message. C507 DATE/TIME/PERIOD M M Date/time/period qualifier M an..3 M 137 Document/message-date Date/time/period C an..35 R <Message date> Date/time/period format qualifier C an..3 R 102 CCYYMMDD 203 CCYYMMDDHHMM DTM+137: :102' BUS - Business function (R1) A segment providing information for routing of the message. This segment is used to specify the direct debit service, which this authorization request message is intended for. This segment is mandatory, and without the service type the authorization request will not be processed. C521 BUSINESS FUNCTION C N Business function qualifier M an Business function, coded M an Code list qualifier C an Code list responsible agency, coded C an Business description C an GEOGRAPHIC ENVIRONMENT, CODED TYPE OF FINANCIAL TRANSACTION, CODED C an..3 N C an..3 N C551 BANK OPERATION C R Bank operation, coded M an..3 M See table below! Code list qualifier C an..3 N Code list responsible agency, coded C an..3 N INTRA-COMPANY PAYMENT, CODED C an..3 N BUS++++XAB' Service Service code to be used in 4383 Autogiro, Sweden XAB LeverandørService, Denmark XLS BetalingsService incl. Transfer XBT forms (FIK), Denmark BetalingsService, Denmark XBB

9 Version 1.5 7(20) Page Segment group 2 (D1) A group of segments identifying the financial institutions involved in the Authorization message. A group identifying the creditor for Sweden, and the creditor s account number for LeverandørService in Denmark. FII Financial Institution Information (M1) Segment group 2 Denmark: A segment identifying the Ordered Bank acting for the Ordering Customer and the relevant account number. Bank account number must be stated for LeverandørService. For BetalingsService it may be stated, but will not be used in processing. Bank account number must be14 digits. The first 4 digits of the bank account number must be the bank registration number. If the bank registration number is shorter than 4 digits, it must be right aligned within the first 4 positions and padded with leading zeroes. The last 10 digits must be the account number. If the account number is shorter than 10 digits it must be right aligned and padded with leading zeroes. Sweden: For Autogiro through Bankgiro, bankgiro number must always be stated. The bankgiro number is the creditor identification. Bankgiro number must not exceed 8 digits PARTY QUALIFIER M an..3 M BF Beneficiary s bank C078 ACCOUNT IDENTIFICATION C R Account holder number C an..35 R <Bank account number/ bankgiro number> Account holder name C an..35 N Account holder name C an..35 N Currency, coded C an..3 N C088 INSTITUTION IDENTIFICATION C N Institution name identification C an Code list qualifier C an Code list responsible agency, coded C an Institution branch number C an Code list qualifier C an Code list responsible agency, coded C an Institution name C an Institution branch place C an COUNTRY, CODED C an..3 N FII+BF '

10 Version 1.5 8(20) Page Segment group 3 (D2) A group of segments identifying the parties involved in the exchange of the message. A group identifying the creditor for BetalingsService and LeverandørService in Denmark, and/or the service bureau customer number. NAD Name and address (M1) Segment group 3 A segment identifying the name and address of the non-financial parties involved in the exchange of this message. The creditor number is the creditor s number with PBS. For BetalingsService it can be maximum 8 positions, and for LeverandørService maximum 5 positions. Creditor number must always be stated, and must be numeric. Creditor number must be sent with qualifier HS. When used with qualifier OF this segment identifies the creditor (message sender), if the sender of the message is a Service Bureau (or similar) and the senders address does not identify a unique customer. Note: Only identifications registered by Nordea will be provided in this segment.

11 Version 1.5 9(20) Page PARTY QUALIFIER M an..3 M HS Creditor OF On behalf of C082 PARTY IDENTIFICATION DETAILS C R Party id. identification M an..35 M <Creditor number > / <Service Bureau Customer number> Code list qualifier C an..3 N Code list responsible agency, coded C an..3 N C058 NAME AND ADDRESS C N Name and address line M an Name and address line C an Name and address line C an Name and address line C an Name and address line C an..35 C080 PARTY NAME C N 3036 Party name M an Party name C an Party name C an Party name C an Party name C an Party name format, coded C an..3 C059 STREET C N Street and number/p.o. box M an Street and number/p.o. box C an Street and number/p.o. box C an Street and number/p.o. box C an CITY NAME C an..35 N COUNTRY SUB-ENTITY IDENTIFICATION C an..9 N POSTCODE IDENTIFICATION C an..9 N COUNTRY, CODED C an..3 N Creditor number BetalingsService: NAD+HS '

12 Version (20) Page Segment group 4 (M9999) A group of segments identifying a message or a group of transactions in a message or a specific transaction in a multiple message. LIN - Line item (M1) Segment group 4 Sweden: A segment specifying the beginning of details referring to the message/transaction to be authorized. This segment specifies whether this is a request for a new authorization (39) or a request for cancellation of an authorization (37). Codes 5 and 7 are only used for Autogiro, Sweden. For Autogiro through Bankgiro, codes 5 respectively 7 are used for accepting or rejecting a received Authorization via internet bank in an AUTHOR2 message LINE ITEM NUMBER O n..6 R <Sequential number> ACTION REQUEST/NOTIFICATION, CODED C an..3 R 39 New 37 Cancelled 5 Accepted (SE) 7 Not accepted (SE) C212 ITEM NUMBER IDENTIFICATION C N Item number C an Item number type, coded C an Code list qualifier C an Code list responsible agency, coded C an..3 C829 SUB-LINE INFORMATION C N Sub-line indicator, coded C an Line item number C n CONFIGURATION LEVEL C n..2 N CONFIGURATION, CODED C an..3 N LIN+1+39'

13 Version (20) Page Segment group 5 (R3) A groups of segments specifying reference numbers, dates and/or times needed to identify a referenced message or transaction. RFF- (M1) Segment group 5 Denmark: A segment indicating reference number(s) for the message or transaction to be authorized. Qualifiers AST and AJS can only be used for BetalingsService Denmark. In Denmark the debtor s identification with the creditor is requested, and must be stated with qualifier IT. It can be maximum 15 positions. For BetalingsService the current debtor group number must always be stated with qualifier AST. The debtor group number may be 5 positions long, and must be numeric. AJS identifies the agreement between Creditor and Debtor. For BetalingsService the agreement number must be stated with requests for cancellation (LIN = 37 Cancelled) of an existing authorization. The agreement number may be 9 positions long, and must be numeric. Sweden: The debtors payor number (which can be a bankgiro number, a payor number, an account number etc.) must be stated with qualifier IT. The debtors payor number can be maximum 16 positions and must be numeric. C506 REFERENCE M M qualifier M an..3 M AST Group reference number AJS Agreement number IT Internal customer number number C an..35 R </Identification> Line number C an..6 N version number C an..35 N Examples: New authorization Denmark: RFF+IT: ' RFF+AST:12345' Cancellation of authorization Denmark: RFF+IT: ' RFF+AST:12345' RFF+AJS: ' New authorization Sweden: RFF+IT: '

14 Version (20) Page Segment group 6 (D1) A group of segments identifying the authorization of the message/transaction. This segment group is only used for BetalingsService in Denmark. SEQ Sequence details (M1) Segment group 6 A segment identifying the beginning of the details needed to give the authorization STATUS INDICATOR, CODED C an..3 N C286 SEQUENCE INFORMATION C R Sequence number M an..6 M Sequence number source, coded C an..3 N Code list qualifier C an..3 N Code list responsible agency, coded C an..3 N SEQ++1' GIS General indicator (M1) Segment group 6 A segment specifying the kind of authorization given to the referenced message/transaction in a coded form. Note that this whole segment group may only be used for BetalingsService in Denmark. This segment must contain specifications of the type of cancellation, when this is a cancelled authorization (LIN = 37 Cancelled). A regular cancellation of an authorization is stated with qualifier XC1 normal cancellation. When a received authorization from PBS is cancelled due to the fact that the debtor number (debtor s identification with the creditor) is unknown to the creditor, the cancellation request must be stated with qualifier XC2 to inform PBS that the sent debtor number was unknown to the creditor. For other transactions than cancellations the segment must contain qualifier ZZZ since this is a mandatory segment.

15 Version (20) Page C529 PROCESSING INDICATOR M M Processing indicator, coded M an..3 M XC1 Normal cancellation XC2 Unknown customer number ZZZ Other transactions Code list qualifier C an..3 N Code list responsible agency, coded C an..3 N Process type identification C an..17 N GIS+XC1' DTM - Date/time/period (D1) Segment group 6 A segment identifying dates related to the referenced message/transaction. For new authorizations, the date the authorizations becomes effective (7) can be given. If this segment is not used, the authorization will take effect as soon as it is possible. For cancelled authorizations the expiry date of the authorization (36) must be given. C507 DATE/TIME/PERIOD M M Date/time/period qualifier M an..3 M 7 Effective date 36 Expiry date Date/time/period C an..35 R <Date> Date/time/period format qualifier C an..3 R 102 CCYYMMDD DTM+7: :102'

16 Version (20) Page Segment group 7 (D1) A group of segments identifying the financial institutions associated with the referenced message/transaction. A group identifying the Debtor s or Debit Account Holder s account number. FII Financial Institution Information (M1) Segment group 7 Denmark: A segment identifying a financial institution related to the referenced message/transaction. Bank account numbers (3194) must consist of digits only. See examples for account numbers below. Bank account number is not requested for cancellations. Bank account number must be 14 digits. The first 4 digits of the bank account number must be the bank registration number. If the bank registration number is shorter than 4 digits, it must be right aligned within the first 4 positions and padded with leading zeroes. The last 10 digits must be the account number. If the account number is shorter than 10 digits it must be right aligned and padded with leading zeroes. (For Giro numbers the registration number is always 1199.) Sweden: If the payor number is not a bankgiro number, bank account number must be stated. Bank account number (3194) must include a 4 digit clearing code. Bank account number must not exceed 16 digits including clearing code. (For Nordea Personal accounts (Personkonto) the clearing code is always 3300 ) PARTY QUALIFIER M an..3 M PH Payer s financial institution C078 ACCOUNT IDENTIFICATION C R Account holder number C an..35 R <Bank account number> Account holder name C an..35 N Account holder name C an..35 N Currency, coded C an..3 N C088 INSTITUTION IDENTIFICATION C N Institution name identification C an Code list qualifier C an Code list responsible agency, coded C an Institution branch number C an Code list qualifier C an Code list responsible agency, coded C an Institution name C an Institution branch place C an COUNTRY, CODED C an..3 N FII+PH '

17 Version (20) Page Segment group 8 (D1) A group of segments identifying the name and address of non-financial parties associated with the referenced message/transaction. NAD Name and address (M1) Segment group 8 Denmark: A segment identifying a non-financial party related to the referenced message/transaction. This segment identifies the debtor involved in the authorization. Debtor s official id number (3039) must contain the debtor s SE-number with PBS for LeverandørService. SE-number (organization number) can be maximum 8 positions and must be numeric. For BetalingsService CPR-number (personal number) or SE-number (organization number) must be stated in The CPR-number can be maximum 10 positions and must be numeric. SE-number can be maximum 8 positions and must be numeric. Sweden: For new authorizations, if the payor number is not a bankgiro number, debtor s official id number (3039) must contain the debtor s personal identity number or organization number. This information is not requested for cancellations. A personal identity number must start with the year including century and be numeric (e.g. YYYYMMDDNNNN). An organization number must be padded with two zeroes in the beginning and be numeric (e.g. 00NNNNNNNNNN).

18 Version (20) Page PARTY QUALIFIER M an..3 M HX Debtor C082 PARTY IDENTIFICATION DETAILS C D Party id. identification M an..35 M <Debtor s official id number> Code list qualifier C an..3 N Code list responsible agency, coded C an..3 N C058 NAME AND ADDRESS C N Name and address line M an..35 N Name and address line C an..35 N Name and address line C an..35 N Name and address line C an..35 N Name and address line C an..35 N C080 PARTY NAME C N 3036 Party name M an Party name C an Party name C an Party name C an Party name C an Party name format, coded C an..3 C059 STREET C N Street and number/p.o. box M an Street and number/p.o. box C an Street and number/p.o. box C an Street and number/p.o. box C an CITY NAME C an..35 N COUNTRY SUB-ENTITY IDENTIFICATION C an..9 N POSTCODE IDENTIFICATION C an..9 N COUNTRY, CODED C an..3 N Examples: Debtor identification in LeverandørServic : NAD+HX ' Debtor identification in BetalingsService : NAD+HX ' Debtor identification Autogiro: NAD+HX '

19 Version (20) Page UNT - Message trailer (M1) A service segment ending a message, giving the total number of segments in the message and the control reference number of the message. The control reference number in element 0062 must be the same as in UNH, and the total number of segments in the message, including UNH- and UNT-segments, must be stated in element The segment is used to verify a correctly transmitted message NUMBER OF SEGMENTS IN A M n..6 M Total number of segments in the message MESSAGE 0062 MESSAGE REFERENCE NUMBER M an..14 M Message reference no UNT+20+1'

20 Version (20) Page 6 Examples New authorization Autogiro Sweden (when payor number differs from bankgiro number): UNH+1+AUTHOR:D:96A:UN' BGM ' DTM+137: :102' BUS++++XAB' FII+BF ' LIN+1+39' RFF+IT: ' FII+PH ' NAD+HX ' UNT+10+1' Cancelled authorization Autogiro Sweden: UNH+1+AUTHOR:D:96A:UN' BGM ' DTM+137: :102' BUS++++XAB' FII+BF ' LIN+1+37' RFF+IT: ' UNT+8+1' New authorization Autogiro Sweden (when payor number is bankgiro number): UNH+1+AUTHOR:D:96A:UN' BGM ' DTM+137: :102' BUS++++XAB' FII+BF ' LIN+1+39' RFF+IT: ' UNT+10+1'

21 Version (20) Page New authorization BetalingsService Denmark: UNH+1+AUTHOR:D:96A:UN' BGM ' DTM+137: :102' BUS++++XBB' NAD+HS ' LIN+1+39' RFF+IT: ' RFF+AST:12345' SEQ++1' GIS+ZZZ' DTM+7: :102' FII+PH ' NAD+HX ' UNT+14+1' Cancelled authorization BetalingsService Denmark: UNH+1+AUTHOR:D:96A:UN' BGM ' DTM+137: :102' BUS++++XBB' NAD+HS ' LIN+1+37' RFF+IT: ' RFF+AST:12345' RFF+AJS: ' SEQ++1' GIS+XC1' DTM+36: :102' NAD+HX ' UNT+14+1' New authorization LeverandørService Denmark: UNH+1+AUTHOR:D:96A:UN' BGM ' DTM+137: :102' BUS++++XLS' FII+BF ' NAD+HS+12345' LIN+1+39' RFF+IT: ' FII+PH ' NAD+HX ' UNT+11+1'

22 Version (20) Page Cancelled authorization LeverandørService Denmark: UNH+1+AUTHOR:D:96A:UN' BGM ' DTM+137: :102' BUS++++XLS' FII+BF ' NAD+HS+12345' LIN+1+37' RFF+IT: ' NAD+HX ' UNT+10+1'