and CSV messages implementation Guidelines

Transcription

1 and CSV messages implementation Guidelines

2 Table of contents Chapter 1 : SAM messages at a glance 3 Chapter 2 : Incoming messages 4 Incoming messages directly from SAM 4 Access to the upload function in SAM 4 Nomination file, CSV description 5 Quick guide to create a nomination file (csv format) 5 Incoming messages via Exchange platform(axway) 6 Quick guide to create a NOMINT message (edig@s format) 6 Chapter 3 : Incoming messages 8 Outgoing messages via Exchange platform(axway) 8 Quick guide for NOMRES messages 8 Quick guide for ALOCAT messages 9 Quick guide for Maintenance messages 10 Quick guide for forecast messages 11 Chapter 4 : Process to setup the connection 13 Chapter 5 : Files samples 14

3 Chapter 1 : SAM messages at a glance 1 SAM (Storage Access Management) is the front portal for customers to manage their storage products, the portal allows customers to : Enter nominations and re-nominations (Basic Contract and additional services) Track their gas movements Check their inventory levels Display their maximum daily capacities and their stock level Check scheduled and unscheduled maintenance The aim of this document is to describe all the IT messages used to communicate with SAM and the different steps to follow in order to setup a connection with Storengy IT system. Find below a reminder of existing and future messages : Function Messages Flow Timing Nominations and NOMINT (csv or edig@s) IN Each time you want to nominate re-nominations Track gas movements NOMRES and ALOCAT (edig@s) OUT NOMRES is sent at each scheduled cycle and ALOCAT when flow is delivered at the end of the day Inventory levels ACCPOS(not yet available) OUT Same as ALOCAT with inventory Daily capacities Forecast messages OUT Once a day after the calculation of the capacities Hourly capacities Not yet available OUT Every hours Maintenance Maintenance messages OUT Each time when a maintenance is published

4 Chapter 2 : Incoming messages 2 Incoming messages directly from SAM Access to the upload function in SAM If you want to use a file to nominate in SAM, you have to choose Upload Nomination Files in the drop down menu Nomination. You can then upload a nomination file under a CSV format

5 Nomination file, CSV description Quick guide to create a nomination file (csv format) Example Definition File name NOMINT_STXXXX_YYYYMMJJHHMMSSmmm.txt NOMINT : fix value to indicate it s a nomination STXXXX : customer code in SAM. 6 letters always beginning with ST YYYYMMJJHH24mmssnnn : generation date of the file Header File ATS;NOMINATION;;;;STXXXX;GDFATS;;;;;;; STXXXX : customer code in SAM. 6 letters always beginning with ST Nomination line STXXXX01;;PS000XX;04/02/2016;1234;I; STXXXX01 : customer contract code in SAM, begin like customer code with two digit after. Warning : this code will change every year PS000XX : product code in SAM, same code when you nominate via SAM 04/02/2016 : DD/MM/YYYY gas day on which you intend to nominate 1234 : quantity to nominate I : Flow direction (french code) o I : injection o S : withdrawal Nomination line STXXXX01;;PS000YY;05/02/2016;5678;I; Other lines are used to nominate on other product or to enter forecasting data UIOLI STXXXX01;U;PS000WW;05/02/2016;91111;S; Insert U between contract code and Nomination line product code if you want to nominate UIOLI value

6 Incoming messages via Exchange platform(axway) The following description is based on version 4 of edig@s, please get in contact with Storengy IT team if you want to implement other versions. Find below the complete definition of the nomint file v4. P2-1-nomint.pdf Quick guide to create a NOMINT message (edig@s format) Example Definition File name NOMINT_STXXXX_YYYYMMJJHHMMSSmmm.xml NOMINT : fix value to indicate it s a nomination YYYYMMJJHH24mmssnnn : generation date of the file Header File General information Nomination block UIOLI Nomination block Identification : Unique identification of the document describing the Nomination document 01G : Nomination STXXXX01 : customer contract code in SAM, begin like customer code with two digit after. Warning : this code will change every year ValidityPeriod : The start and end date and time of the period of validity covered in the document IssuerIdentification : customer code (same than customer code in SAM without ST) PS000XX : product code in SAM, same code when you nominate via SAM STXXXX : customer code in SAM. 6 letters always beginning with ST TimeInterval : Gas day concerned by the nomination Z02 = injection (Storengy) = take-off (GRTgaz) Z03 = withdrawal (Storengy) = delivery (GRTgaz) Model 1: Use the tag Decomposition to nominate UIOLI The current types permitted for this code are:

7 o o ZXD : FIRM (base, flow+) ZXF : UIOLI Or Model 2: End of file Close the tag Nomination

8 Chapter 3 : Incoming messages 3 Outgoing messages via Exchange platform(axway) Quick guide for NOMRES messages Find below the complete definition of the nomres file in edig@s v4 : P2-2-nomres.pdf Example Definition File name NOMRES_STXXXX01_YYYYMMJJHHMM<SequenceNumber>.xml NOMRES: fix value to indicate it s a nomination STXXXX01 customer contract code in SAM Header File General informati on STXXXX01 : customer contract code in SAM IssuerIdentification : Storengy code RecipientIdentification : customer code Nominati on block End of file PS000XX : product code in SAM, same code when you nominate via SAM InternalShipperAccoun t: customer code in SAM AccountIdentification: contract code in GRTgaz Note that quantity will include base and UIOLI nomination Close the tag

9 Quick guide for ALOCAT messages Find below the complete definition of the Alocat message in v4 : P2-7-Alocat.pdf File name Header File General informati on Example ALOCATBXR_STXXXX01_YYYYMMJJHHMM<SequenceNumber>.xml Or ALOCATAVR_STXXXX01_YYYYMMJJHHMM<SequenceNumber>.xml Definition ALOCAT: fix value to indicate it s a nomination BXR if the file concerns more than 1 day AVR if the file concern only one day STXXXX01 customer contract code in SAM STXXXX01 : customer contract code in SAM IssuerIdentification : Storengy code RecipientIdentification : customer code Nominati on block PS000XX : product code in SAM, same code when you nominate via SAM InternalShipperAccount:cus tomer code in SAM Note that quantity will include base and UIOLI nomination End of file Close the tag Allocation

10 Quick guide for Maintenance messages The maintenance message corresponds to a specific maintenance on a PITS. This message will be generated at the creation of the reference and each time there is a modification on it. Note that the issue of the message has nothing to do with the gas day. Example Definition File name MNT_STXXXX_ XML STXXXX : customer code Header File Nomination line Nomination line Type (PLANIFIE, NON_PLANIFIE, CONTRAINTE_SAISONNI ERE, FORCE_MAJEURE, ASIO) CodePITS : GRTgaz PITS code DateDebut/DateFin : start and end date of the maintenance JourneeGaziere: Gas day concerned FacteurInjection : injection reduction factor Soutirage = withdrawal UIOLI Nomination line Close the tag

11 Quick guide for forecast messages Forecast messages correspond to the daily and the forecast capacities, the message is generated once a day. Example Definition File name PRV_STXXXX_ xml STXXXX : customer code Header File Nomination line Capacities for the PITS JourneeGaziere: Gas day CJBS : Daily Base withdrawal capacity CJBI : Daily Base injection capacity CJS : Daily withdrawal capacity CJI : Daily injection capacity CJDS : Daily available withdrawal firm capacity CJDI : Daily available injection firm capacity CJCDS : Daily available withdrawal conditional capacity CJCDI : Daily available injection conditional capacity CJSDS : Daily available withdrawal secondary market capacity CJSDI : Daily available injection secondary market capacity CJTS : Daily transport withdrawal capacity CJTI : Daily transport injection capacity

12

13 Chapter 4 : Process to setup the connection 4 Here is the global roadmap to follow in order to establish a link between customer IT and SAM. Exchange on the need Technical test Business test Go live Contact with your account manager in Storengy or send a mail to access@storengy.com - Specify your request regarding the connection protocol (SFTP, AS2 ), the requested files (NOMINT, NOMRES, ALOCAT ) and the version of the files You will then receive a response with the connection information on our side and a form to fill in your information If you request some specific file versions, there can be an additional period of time if a development is needed Ensure the connection is setup and working (security certificate, firewall setup ) End to end testing to validate format and network connection Specify a go live date

14 Chapter 5 : Example files 5 Here are some example files to help you implement the interface with our system. NOMINT_STXXXX_ xml NOMRES_STXXXXXX_ xml ALOCAT_STXXXX_ xml MNT_STXXXX_ XML PRV_STXXXX_ xml