Overview
With the add-on FCFS Shipper API Service, you can book Direct 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 direct FCFS capacity, you can refer to this article.
I. Availability Check
With the network point ID, you can check which products are available at that network point.
To do so, do the following:
1. Expand the "Get/fcfs-booking/direct/available-products" tab and click on "Try It Out;"
2. Enter the shipper user email in the appropriate field;
3. Enter the network point ID in the appropriate field;
4. Last, click on "Execute."
The available products will then be displayed in the response field:
Note the relevant details of the offer you'd like to request and go on to the next step.
II. Offer Request
Once you retrieve the details of the available product at a particular network point, you can proceed to request an offer. It's possible for you to see the mandatory fields (marked by asterisks) by clicking on "Model" in the "Post/fcfs-booking/direct/request-offer" tab:
To request an offer, do as follows:
1. Expand the "Post/fcfs-booking/direct/request-offer" tab and click on "Try It Out;"
2. Edit the json file with the necessary details;
3. Then, click on "Execute."
The response message will then be displayed in the response field below:
This message includes all the necessary details for the submission of a direct FCFS booking. Note that TTPC/Transmed offers do not include a total price. In such bookings, the total price will be determined later based on the assessment of the regulators.
III. Booking Request
Once you have the necessary details of the offer, you can submit your direct FCFS booking. The mandatory fields of this json message (marked by an asterisk) can be viewed in the "Post/fcfs-booking/direct/booking" tab after you click on "Model:"
If, however, the price was not provided in the offer request (step III), you can delete those lines from the json file. Likewise, if the product is unbundled, you can delete the PeerTotalPrice lines. In contrast, if the price is provided in the offer, then you must include it in the booking request.
Now, to submit a booking request, do as follows:
1. After authorizing your use of Swagger, expand the "Post/fcfs-booking/direct/booking" tab and click on "Try It Out;"
2. Then, edit the json file with the mandatory details of your booking request;
3. Finally, click on "Execute."
The resulting message will be displayed in the "Response" field. It contains all the details of your booking request including the Request Identifier, which you can use to check the status of your Direct FCFS Booking:
IV. Successful Booking Retrieval
After you successfully submit your Direct FCFS booking, the TSO will process your request. You can use the details of your booking to check its status.
To do so, do as follows:
1. Expand the "Get/fcfs-booking/direct/bookings" tab and click on "Try It Out;"
2. Enter the email with which you booked Direct FCFS capacity (this field is mandatory);
3. Then, enter one or more of the booking details in the fields below. If you're looking for a specific booking, the Request Identifier is the most straightforward method to retrieve it. If you're looking for bookings at a specific network point, then use the Network Point ID, and so forth;
4. Finally, Click on "Execute."
The resulting message can be viewed in the "Response" field. The status of your booking will be displayed in the "Status" line:
