Change offer state
POST/v1/offers/:id/state
Transition an offer's state (e.g. publish or accept). The DB trigger materializes the published/accepted snapshot. Offers move DRAFT → PUBLISHED → ACCEPTED/DECLINED: a draft is published before it can be accepted or declined (409 offer_not_published), and once an offer left DRAFT it cannot go back to DRAFT (409 offer_not_draft) — create a new offer instead. An offer can be accepted until the end of its validTo day (German time); after that, accepting answers 409 offer_expired — publish a new offer instead. Accepting here takes the offer as it was offered: the recommended module variant of each roof, the offered battery, wallbox and emergency power, and no optional extras. An offer whose roof has several module variants and none marked as the offered one cannot be accepted here (409 offer_selection_required). A draft is checked before it is published: with its validTo day over (valid_to_past) or a price of zero or less (price_not_positive) publishing answers 409 offer_not_publishable, and the message names what stands in the way.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 500
The offer with its new state.
validation_error
invalid_api_key
insufficient_scope
not_found
offer_not_draft, offer_not_published, offer_expired, offer_selection_required, offer_not_publishable
db_error