Skip to navigation

Change Reservation Schedule

Moves reservation lines to new slots. Take systemId, admissionCode and scheduleNumber from Find Reschedule Options.

  • Send at most 100 lines, with only the admissions that move. All lines move, or none do.
  • Each changed line gets a new systemId. Call find again before the next change.
  • BC takes no payment. If the guest pays for the move, authorize the payment first, then call change. Capture it after a 200 and cancel the authorization on any error. This way a guest never pays for a move that did not happen, for example when someone else changed the same line first.
  • Errors:
    • 404: wrong token or pin. Change accepts only reservationToken.
    • 400 invalid_input: a bad body.
    • 400 invalid_reference: a line, admission or slot is not valid any more, or another request is changing the reservation. Call find again.
    • 400 capacity_exceeded: the new slot has no capacity for the line.
    • 400 reschedule_not_allowed: an admission cannot move. The message names the line, the admission and the reason.
  • E-ticket delivery errors do not fail a stored change. The answer is still 200.

Authentication

x-np-api-keystring
API Key authentication via header

Path parameters

tenantstringRequired

Your Entra Tenant ID. More details.

environmentstringRequired

Your Business Central Environment. More details.

companystringRequired

Your Business Central Company. More details.

Headers

x-api-versiondateOptional

Used for API versioning. More details.

Request

This endpoint expects an object.
reservationTokenstringRequired
The original or a change token of the reservation.
pinCodestringRequired
A pin code for the ticket, used to authorize rescheduling or revoking a confirmed ticket. Returned only for confirmed reservations. The format is configured per tenant, so do not validate it against a fixed length or pattern.
reservationLineslist of objectsRequired

1 to 100 lines, each systemId once.

Response

This endpoint returns an object.
reservationLineslist of objects

Errors

400
Bad Request Error
404
Not Found Error