ESIDEL (European Steel Industry Data Exchange Language) Party information

Transcription

1 ESIDEL (European Steel Industry Data Exchange Language) Party information Version. EDIFER «XML Business Group» June 2005

2 Party information By EUROFER - EDIFER committee - Business working group Creation date: 0 June 2005 Last update: Reference: ESIDEL(v.)-08(Party information).doc Version:.

3 Table of contents. Party information 3 2. Data model of the party information Data model entities Data model attributes Attribute code lists 5 2

4 . Party information The party information is used between trading partners involved in administration, commerce and transport. The accurate and unambiguous identification of all trading partners and their operational parameters is an essential issue for e-commerce. This means that the party information is not limited to the customer organisation, but can also be used to provide details about the supplier organisation, and the third parties involved in a commercial area such as warehouses, carriers, freight forwarders, financial institutions (banks, insurance companies), etc The party information contain long term stable information related to physical and functional locations of a party, such as the name and address, financial institution information and relevant account numbers, contact information, a unique key to address the information and some information related to the physical receipt of goods. The information related to the physical receipt of goods can be provided in function of the allowed made and means of transport, such as the allowed types of vehicles, the maximum dimensions of the vehicles, unloading requirements, delivery limitation, maximum weight of the handling units and the opening or closing times of the party. The unique key to address a party together with the name, address is vital to the correct running relationship between the parties involved in other business transactions. 3

5 2. Data model of the party information Has sender as Party information - Party information number - Party information date/time - Party information free text Has receiver as Party details See details on the next page Has party information item as..n Party information item - Party information item sequence number - Party information item free text Has party details as Party role details Has party role as Party details Has parent child relationship as Party relation info - Party role, coded Has payment info as See details on the next page Has place of discharge details as Has financial institution as - Responsible agency - Party identification, coded - Hierarchical relationship - Party role, coded 0.. Additional information Place of discharge details Financial Institution - Market (NACE code) - Additional information free text - Place of discharge code - Place of discharge text - Unloading requirements - Special observations Has delivery requirements as - Institution branch name - Institution name - Bank identification SWIFT - Account holder number - Account holder name - IBAN number Has contact details as Has delivery requirements as Contact details Delivery requirements - Contact name - Contact function code - Contact Identifier - Telephone number - Extension number - Mobile telephone number - Fax number - address See details on the next page 4

6 Detailed Class diagram of the Delivery requirements Product classification - Product group coded - Product category coded - Product sub-category coded - Product form coded - Product shape coded - Rolling family - Product designation Delivery requirements Has global opening time as Has global delivery limitations as Has road transport requirements Opening time Has product type as Delivery limitations - Maximum quantity per day - Number of vehicles per day - Number of vehicles per week - Package orientation - Minimum handling space - Maximum handling unit weight - Axis orientation Has delivery limitations as 0.. Road transport data - Unloading requirement code - Maximum vehicle weight - Maximum vehicle height - Maximum vehicle length - Maximum loading height - Maximum Payload - Prohibited vehicle - Imposed vehicle - Unloading requirements - Special observations Has opening time as - Opening time period start date - Opening time period end date - Day of the week - Half day - Open/close indicator - Start time opening/closing - End time opening/closing - Opening time restriction text Has opening time as Has delivery limitations as Has rail transport requirements Has water transport requirements Rail transport data - Prohibited vehicle - Imposed vehicle - Unloading requirements - Special observations - Railway station name - Railway station code - Customer specific branch line 0.. Has opening time as Has contact address details Has delivery limitations as 0.. Water transport data - Maximum vessel length - Maximum vessel draught - Prohibited vehicle - Imposed vehicle - Maximum headroom - Unloading requirements - Special observations Has contact address details Contact address details See details on the next page Has contact address details 5

7 Detailed Class diagram of the Party details Address Unstructured details Address Structured details Contact details Additional Identification - Address line - Address line 2 - Address line 3 - Address line 4 - Address line 5 - Postal code - City name - State or Province name - Country code - Country name - Location identifier - Building name - Street name - District name - District sub-division name - Postal code - City name - State or Province name - Country code - Country name - Location identifier - Contact name - Contact function code - Contact Identifier - Telephone number - Extension number - Mobile telephone number - Fax number - address - Responsible agency - Party identification, coded Has contact details as Has additional identification as Address Postbox details Has unstructured address details as Has structured address details as - Post office box - Postal code - City name - Country code - Country name 0.. Has postbox details as Party Identification - Party name - Responsible agency - Party identification, coded PARTY DETAILS Detailed Class diagram of the Contact address details Address Unstructured details Address Structured details - Address line - Address line 2 - Address line 3 - Address line 4 - Address line 5 - Postal code - City name - State or Province name - Country code - Country name - Location identifier - Building name - Street name - District name - District sub-division name - Postal code - City name - State or Province name - Country code - Country name - Location identifier Address Postbox details Has unstructured address details as Has structured address details as Contact details - Post office box - Postal code - City name - Country code - Country name 0.. Has postbox details as - Contact name - Contact function code - Contact Identifier - Telephone number - Extension number - Mobile telephone number - Fax number - address CONTACT ADDRESS DETAILS 6

8 2.. Data model entities The following entities are contained within the data model. Entity Party information Party information item Party relation info Party role details Financial institution Additional information Place of discharge details Contact details Party identification Additional identification Address - unstructured details Address - structured details Address post box details Contact details Rail transport data Road transport data Water transport data Delivery limitations Product classification Opening time Contact details Address - unstructured details Address - structured details Address post box details Description The entity contains the identification and the date of the party information message. The entity contains the information about an item of the party information message. The entity contains the name, the role and the identification of another party to whom the party has a certain relationship (Parent company or daughter company). The entity contains a role valid for the party. The entity contains information of the financial institution and the account holder name and number of the payee. The entity contains the additional information such as details of the market and textual information. The entity contains the details of a place of discharge of a party. The entity contains the contact details of a person or a department of a party. Classes part of Party Details The entity contains the name and the prime identification of a party. The entity contains the additional identification of a party. The entity contains the details of the address in the unstructured format. The entity contains the details of the address in the structured format. The entity contains the details of the post office box. The entity contains the contact details of a person or a department of a party. Classes part of Delivery requirements The entity contains the relevant information to organise rail transport for the delivery by rail The entity contains the relevant information to organise road transport for the delivery by road The entity contains the relevant information to organise fluvial transport for the delivery by sea or waterways The entity contains the relevant limitations about the delivery, such as the maximum receiving capacity and maximum unloading capacity. The entity contains the specifications of the product classification. The entity contains information about the opening times for reception of deliveries Classes part of Contact address Details The entity contains the contact details of a person or a department of a party. The entity contains the details of the address in the unstructured format. The entity contains the details of the address in the structured format. The entity contains the details of the post office box. 7

9 2.2. Data model attributes For each entity specified a list of attributes and a description is given. Remark: Based on the Core Component Types (CCT) specified in the UN/CEFACT Core Components Technical Specifications (CCTS), the CCT supplementary components such as Date Time format, Amount currency code, Measure unit code and Quantity unit code are not mentioned as attributes. Party information Party information number Party information date/time Party information free text The unique number given by the issuer to identify a party information message. The date/time when the party information message is issued. The free text information related to the complete party information. M an..35 M an..35 C an..999 Party information item Party information item sequence number Party information item free text The unique number given by the issuer to identify a party information item. The free text information related to the complete party information item. M an..35 C an..999 Party relation info Responsible agency The code identifying the agency responsible for the Yes M an..3 attribution of the identification. Party identification, coded Code identifying a party involved in a transaction. M an..7 Hierarchical relationship The hierarchical structure between two parties. Yes M an..3 Party role, coded The type specifying the role of the party. Yes C an..3 Party role details Party role, coded The type specifying the role of the party. Yes M an..3 8

10 Financial institution Institution branch name The name of the financial branch. C an..70 Institution name The name of the financial institution. C an..70 Bank identification SWIFT The identification of the financial institution (bank) C an..7 given by SWIFT. Account holder number The account number of the holder of an account. Account holder name The name of the holder of the account. C an..70 IBAN number The international bank account number uniquely identifying the account number of the holder of an account. Additional information Market (NACE code) Additional information free text The code specifying the business market of the party (NACE code). The free text information related to the party details. Yes C an..3 C an..999 Place of discharge details Place of discharge code The code specifying the place of discharge. Seaport, airport, freight terminal, rail station or other place at which the goods (cargo) are unloaded from the means of transport having been used for their carriage. Place of discharge text The text specifying the place of discharge. C an..70 Seaport, airport, freight terminal, rail station or other place at which the goods (cargo) are unloaded from the means of transport having been used for their carriage. Unloading requirements Text giving the customer's unloading requirements C an..999 Special Observations Text giving the customer s observations C an..999 Contact data Contact name The Name of a contact person or department. M an..35 Contact function code The code specifying the function of a contact (e.g. Yes C an..3 department or person). Contact Identifier The unique identifier of a contact person or department Telephone number The telephone number including the country code. Extension number The number of the telephone extension. Mobile telephone number The mobile telephone number including the country code. Fax number The facsimile number including the country code. address The address. C an..52 9

11 Party identification Classes part of Party Details Party name The name of the party involved in a transaction. Responsible agency The code identifying the agency responsible for the Yes M an..3 attribution of the identification. Party identification, coded The code identifying a party involved in a transaction. M an..35 Additional i.d. identification Responsible agency Party identification, coded The code identifying the agency responsible for the attribution of the identification. The code identifying a party involved in the transaction. Yes M an..3 M an..35 Address - Unstructured details Address line The first line of the address. M an..35 Address line 2 The second line of the address. Address line 3 The third line of the address. Address line 4 The fourth line of the address. Address line 5 The fifth line of the address. Postal code The national postal code (ZIP code) of the address. C an..7 City name The name of a city. State or province name The name of a state or province in a country. Country Code The Country code specified in ISO C an..2 (2 alpha positions) Country name The name of the country. Location identifier The unique identification of a location based on the Duns (Duns & Bradstreet) number of the company followed by four numeric digits. Address - Structured details Building name The name of a building. C an..70 Street name The name of a street. C an..70 District name The name of a part of a city. District sub-division name The name of a sub-division of a district of a city.. Postal code The national postal code (ZIP code) of the address. C an..7 City name The name of a city. State or province name The name of a state or province in a country. Country Code The Country code specified in ISO C an..2 (2 alpha positions) Country name The name of the country. Location identifier The unique identification of a location based on the Duns (Duns & Bradstreet) number of the company followed by four numeric digits. 0

12 Address Post box details Post office box The post office box identifier. M an..7 Postal code The national postal code (ZIP code) of the address. M an..7 City name The name of a city. State or province name The name of a state or province in a country. Country Code The Country code specified in ISO C an..2 (2 alpha positions) Country name The name of the country. Contact data Contact name The Name of a contact person or department. M an..35 Contact function code The code specifying the function of a contact (e.g. Yes C an..3 department or person). Contact Identifier The unique identifier of a contact person or department Telephone number The telephone number including the country code. Extension number The number of the telephone extension. Mobile telephone number The mobile telephone number including the country code. Fax number The facsimile number including the country code. address The address. C an..52 Rail transport data Classes part of Delivery requirements Prohibited vehicle Text giving the prohibited vehicles (type of C an..99 wagons) not to be used for the delivery of the goods by rail transport. Imposed vehicle Text giving the imposed vehicles (type of wagons) C an..99 to be used for the delivery of the goods by rail transport. Unloading Requirements Text giving the customer's unloading requirements C an..999 Special Observations Text giving the customer s observations C an..999 Railway station name Name of the railway station to deliver goods Railway station code Code given by the railway company to identify the Customer specific branch line name railway station at the customer Name given by the railway company to identify a customer internal connection to the railway

13 Road transport data Unloading requirement code The code specifying the requirement that the vehicle must be foreseen to unload by the side or top Yes C an..3 Maximum vehicle weight Maximum weight allowed of the vehicle in tons C n..5 Maximum vehicle height Maximum height allowed of the vehicle in C n..5 centimetres Maximum vehicle length Maximum length allowed of the vehicle in meters C n..5 Maximum loading height Maximum height of the loading in centimetres Maximum payload Maximum payload of the vehicle allowed in tons C n..5 Prohibited vehicle Text giving the prohibited vehicles (type of lorries) C an..99 not to be used for the delivery of the goods by road transport. Imposed vehicle Text giving the imposed vehicles (type of lorries) to C an..99 be used for the delivery of the goods by road transport. Unloading Requirements Text giving the customer's unloading requirements C an..999 Special Observations Text giving the customer s observations C an..999 Water transport data Maximum length of the vessel Maximum length of the vessel allowed in meters C n..5 Maximum draught of the vessel Maximum draught of the vessel allowed in meters C n..5 Prohibited vehicle Text giving the prohibited vehicles (type of vessels) C an..99 not to be used for the delivery of the goods by water transport. Imposed vehicle Text giving the imposed vehicles (type of vessels) to be used for the delivery of the goods by water transport. C an..99 Maximum Headroom Maximum Headroom in centimetres C n..5 Unloading Requirements Text giving the customer's unloading requirements C an..999 Special Observations Text giving the customer s observations C an..999 Delivery limitations Maximum quantity per day Maximum quantity per day allowed C n..5 Number of vehicles per day Maximum number of vehicles per day allowed C n..5 Number of vehicles per week Maximum number of vehicles per week allowed C n..5 Package orientation The orientation of the package in the vehicle Yes C an.. Minimum handling space Minimum handling space allowed between the C n..5 transport units for the unloading Maximum transport unit weight Maximum weight of the transport units allowed C n..5 Axis orientation Axis orientation imposed of the transport units on the vehicle Yes C an.. 2

14 Product classification Product group code Code specifying the steel product mean group (long Yes products, flat carbon steel products,.) Product category code Code identifying the main condition category of Yes steel products (rolled, heat treated, drawn, rolled..). Product sub-category code Code identifying the sub category of the main Yes condition category of steel products. Product form code Code identifying the product form of steel products. Yes Product shape code Code identifying the product shape of steel Yes products. Rolling family The text identifying the rolling family of steel C an..70 products. Product designation, coded The text identifying the product designation of steel products. C an..70 Opening time Opening time period The start date of an opening/ closing period start date Opening time period The end date of an opening/ closing period end date Day of the week Number of the day in the week Yes C n.. Half-day Half-day period Yes C an..2 Open/close indicator Indication if the reception of goods is open or closed during the Yes C an.. day or half day specified in Day of the week or Half-day Start time opening/ closing The start time when the reception of goods is open or closed (depending on the open/close indication) during a day or a half- End time opening/ closing Opening time restriction text day (24 hour clock) The end time when the reception of goods is open or closed (depending on the open/close indication) during a day or a halfday (24 hour clock) The free text information providing a restriction related to the opening time. C an..999 Contact data Classes part of Contact address Details Contact name The Name of a contact person or department. M an..35 Contact function code The code specifying the function of a contact (e.g. Yes C an..3 department or person). Contact Identifier The unique identifier of a contact person or department Telephone number The telephone number including the country code. Extension number The number of the telephone extension. Mobile telephone number The mobile telephone number including the country code. Fax number The facsimile number including the country code. address The address. C an..52 3

15 Address - Unstructured details Address line The first line of the address. M an..35 Address line 2 The second line of the address. Address line 3 The third line of the address. Address line 4 The fourth line of the address. Address line 5 The fifth line of the address. Postal code The national postal code (ZIP code) of the address. C an..7 City name The name of a city. State or province name The name of a state or province in a country. Country Code The Country code specified in ISO C an..2 (2 alpha positions) Country name The name of the country. Location identifier The unique identification of a location based on the Duns (Duns & Bradstreet) number of the company followed by four numeric digits. Address - Structured details Building name The name of a building. C an..70 Street name The name of a street. C an..70 District name The name of a part of a city. District sub-division name The name of a sub-division of a district of a city.. Postal code The national postal code (ZIP code) of the address. C an..7 City name The name of a city. State or province name The name of a state or province in a country. Country Code The Country code specified in ISO C an..2 (2 alpha positions) Country name The name of the country. Location identifier The unique identification of a location based on the Duns (Duns & Bradstreet) number of the company followed by four numeric digits. Address Post box details Post office box The post office box identifier. M an..7 Postal code The national postal code (ZIP code) of the address. M an..7 City name The name of a city. State or province name The name of a state or province in a country. Country Code The Country code specified in ISO C an..2 (2 alpha positions) Country name The name of the country. 4

16 2.3. Attribute code lists Date time format Use the date time format of the international standard ISO 860 Hierarchical Use the code list UN-EDIFACT data element 77 relationship Parent 2 Child Party role, coded Use the code list UN-EDIFACT data element 3035 AL Principal BY Buyer CN Consignee CZ Consignor DP Delivery party FW Freight forwarder IV Invoicee OY Ordering customer PX Party to receive all documents SU Supplier SE Seller UD Ultimate customer Market (NACE Code) Use the official code list of Nace Extraction of crude petroleum and natural gas 5 Manufacture of food products and beverages 24 Manufacture of chemicals and chemical products 25 Manufacture of rubber and plastic products 27 Manufacture of basic metals 28 Manufacture of fabricated metal products, except machinery and equipment 29 Manufacture of machinery and equipment 3 Manufacture of electrical machinery and apparatus 33 Manufacture of medical, precision and optical instruments, watches and clocks 34 Manufacture of motor vehicles, trailers and semi trailers 35 Manufacture of other transport equipment 36 Manufacture of furniture 40 Electricity, gas and water supply 45 Construction 60 Land transport and transport via pipelines 75 Public administration and defence 00 Others 5

17 Contact function code Use the code list UN-EDIFACT data element 339 AE Contract contact AT Technical audit BD New development contact BJ Department or person responsible for processing purchase order CR Customer relations DL Delivery contact GR Goods receiving contact OC Order contact IC Information contact MC Material control contact SA Sales administration SU Supplier contact TI Technical document recipient (certificates, ) Unloading requirement code This is not an official ISO-, UN- or Eurofer code list. The presented codes are provided as examples and have not been approved by Eurofer Unloading by side required Unloading by the top required Unloading by side or top allowed Package orientation This is not an official ISO-, UN- or Eurofer code list. The presented codes are provided as examples and have not been approved by Eurofer Packages oriented in parallel of the driving direction Packages oriented in perpendicular of the driving direction Axis orientation This is not an official ISO-, UN- or Eurofer code list. The presented codes are provided as examples and have not been approved by Eurofer Axis of the coils in horizontal position Axis of the coils in vertical position Day of the week Day of the week This is not an official ISO-, UN- or Eurofer code list. The presented codes are provided as examples and have not been approved by Eurofer Monday Tuesday Wednesday Thursday Friday Saturday Sunday 6

18 Half-day PM AM This is an official approved Eurofer code list Afternoon Morning Open/close indication This is not an official ISO-, UN- or Eurofer code list. The presented codes are provided as examples and have not been approved by Eurofer Closed Open Responsible agency Use the code list UN-EDIFACT data element ISO (International Organisation for Standardisation) 9 EAN/UCC 0 ODETTE 6 US, D&B (Dun & Bradstreet Corporation) 7 S.W.I.F.T. 58 EUROFER 90 Assigned by manufacturer 9 Assigned by seller or seller s agent 92 Assigned by buyer or buyer s agent Product group, coded Product category, coded Product sub-category, coded Product form, coded Product shape, coded Rolling family Product designation See the code list present in the manual of Product information. 7

19 All information provided in this documentation is provided "as is" without any warranties of any kind including warranties of accuracy, fitness for a particular purpose, or non-infringement or intellectual property. EUROFER shall not be held responsible for any errors or any loss resulting from any use of this document or the specification herein. The materials contained in this document may be copied provided that ALL copies retain the copyright and any other proprietary notices contained on the materials. No material may be modified, edited or taken out of context such that its use creates a false or misleading statement or impression as to the positions, statements or actions of the publisher EUROFER. All rights reserved. All countries 8