search

UnionInternationalCheminsdeFer / OSDM

Projects related to an open sales & distribution API for public transportation.
https://osdm.io
Apache License 2.0
50 stars 21 forks source link

Financial documents after adding a new offerPart, refunding or exchanging the booking #564

Open Azurab opened 1 month ago

Azurab commented 1 month ago

Hi.

I have another question about general transaction flow. Is an API consumer obligated to POST bookings/{bookingId}/documents (subsequent) after confirming the booking change?

jspetrak commented 1 month ago

No, this is an optional flow when you want to obtain optional types of documents for booking, The ticket documents are Fulfillments under OSDM, and are generated automatically.

CGantert345 commented 1 month ago

Documents are listed in the booking after the confirmation of the refund or exchange. The booking must be retrieved to get the documents.

CGantert345 commented 1 month ago

TODO: add documentation in the general flow for refund / exchange

Azurab commented 1 month ago

My proposal of clarification to the after sale flow (btw, general hint: separate after-sales processes into a separate flow diagram):

Please be advised that following the confirmation of the refund and exchange operation or addition of an offerPart to the booking, the distributor must update the fulfilments and documents (e.g. receipts) and the API consumer is required to take an action to retrieve the full booking to retrieve it.