Overview
With the add-on FCFS Shipper API Service, you can book Regular FCFS capacity at different network points. You can test this functionality on the Swagger platform. For those purposes, the KON (TEST) environment will be made available to you.
Instructions
First, go to the Swagger page and click on "Authorize;"
If you don't know the network point at which you'd like to book regular FCFS capacity, you can refer to this article.
I. Regular FCFS Availability Check
Once you know the network point at which you'd like to book regular FCFS capacity, you can submit an availability query.
Before testing the feature, you can check which entries are available and which fields are mandatory by click on "Model" above the parameters field in the expanded "Post/FCFSBooking/Regular/Check-Availability" tab:
Of all the parameters, Network Point ID, Quantity Value, Quantity Unit, Runtime Start and End and User Email are mandatory.
Now, to check the availability, do as follows:
1. After authorizing your use of Swagger, expand the "Post/FCFSBooking/Regular/Check-Availability" tab and click on "Try It Out;"
2. Then, freely edit the parameters in the JSON file and delete the irrelevant lines in accordance with your needs.
3. Finally, click on "Execute."
If your availability query is successful, you will receive a Code 200 message with a Booking Process ID.
The Booking Process ID is the code found in the "Response Body" field:
II. Booking Process Status Check
With the Booking Process ID, you must then submit a status check message. This is a necessary step to retrieve the Alternative ID - that is, the message with an offer from the TSO. This message may take up to three minutes to reach the PRISMA system.
To do a process status check, do as follows:
1. After authorizing your use of Swagger, expand the "Get/fcfs-booking/regular/fcfs-process-state/{bookingprocessID}" and click on "Try It Out;"
2. Enter the Booking Process ID in the appropriate field;
3. Enter the email under which you submitted the availability check;
4. Finally, click on "Execute."
As before, the results will be displayed in the Response section. If your query is successful, you will receive a Code 200 message with one or more Alternative ID. One of those could be your original request, but if such a request is impossible to fulfill, other alternatives might be presented to you.
Then, choose the Alternative ID that best suits your needs and proceed to the next step:
tst.DEV+direct-fcfs-JAO-admin@prisma-capacity.eu
At the top of the response, you can also view whether a Balancing Group or Portfolio Code are mandatory to proceed with the booking request as well as which code can be used:
III. Regular FCFS Booking Request
With the Alternative ID of the offer you wish to book, you can proceed to the regular FCFS booking request, properly so called. If the TSO from which you wish to book regular FCFS capacity does not require manual approval, your transaction will be concluded within three minutes. If, in contrast, the TSO requires manual approval, the process may take longer.
As in step II, you can check which details are available and/or mandatory in the "Post/fcfs-booking/regular/book-capacity" by clicking on "Model:"
All fields marked with a red asterisk are mandatory. At this stage, the user email, the Network Point ID, the Booking Process ID and the Alternative ID are mandatory. If you do not wish to request capacity upgrade, you may delete those lines from the json file.
Now, to submit your regular FCFS booking request, do as follows:
1. After authorizing your use of Swagger, expand the "Post/fcfs-booking/regular/book-capacity" tab and click on "Try It Out;
2. Now, edit the values in the json message with the correct details and delete the irrelevant lines in accordance with your needs;
3. Finally, click on "Execute."
The resulting message can be viewed in the "Response" section:
IV. Final Booking Status Check
At last, you must once again check the status of your booking request to disclose the TSO's final resolution. By doing so, you can ascertain whether your booking request was ultimately approved.
To do a process status check, do as follows:
1. After authorizing your use of Swagger, expand the Get/fcfs-booking/regular/fcfs-process-state/{bookingprocessID} and click on "Try It Out;"
2. Enter the Booking Process ID in the appropriate field;
3. Enter the email under which you submitted the availability check;
4. Finally, click on "Execute."
If the booking is successfully processed by the TSO, the status in the response will be "Booked:"
