Call OrderRetrieve with the current order reference to obtain the latest order version and ticket coupons before any reshop attempt.
Submit an OrderReshop request referencing the order ID, the specific segments to change, and the new travel dates; the response returns repriced offer options for the changed segments.
Parse the ReshopOffers in the OrderReshopRS — each offer includes a ChangePriceQuote showing the residual value of the original ticket and the fare difference (positive or negative).
Once the customer selects an offer, issue OrderChange with the chosen offer ID, traveller details, and a payment element covering any fare difference; include FOID and ticketing metadata as required by Iberia.
Handle the OrderChangeRS: confirm new ticket numbers are present and that old coupons are marked as exchanged (status X).
Store the new OrderID and updated coupon numbers; trigger downstream notifications and update your PNR mirror.
Known gotchas
Always call OrderRetrieve immediately before OrderReshop — using a stale order version reference causes a version conflict error.
Iberia NDC requires the full traveller identity document details in OrderChange even if they were already present in the original order; omitting them causes validation failures.
Fare difference calculations are in the ticketing currency; handle multi-currency carefully if your platform settles in a different currency.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp