Book a pre-order

POST/api/v1/revenue-schedules/preorders

Collect pre-order cash to deferred revenue (releases on fulfillment).

Operation ID: book_preorder_api_v1_revenue_schedules_preorders_post·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Request body

Schema: PreorderBookRequest

order_referencestringrequired: Stable pre-order identifier (idempotency key)
amount_centsintegerrequired: Merchandise amount in cents
order_datestring · date: Cash-collection date (defaults to today)
receive_viastring: Debit account for the booking: 'cash', 'ar', or 'clearing'
revenue_ledger_namestring: Revenue ledger credited on fulfillment
currencystring
reference_idstring: Originating object id

Responses

201Successful Response

Schema: SuccessEnvelope_RevenueScheduleResponse_

successboolean
messagestring
codestring
dataRevenueScheduleResponse

400Bad Request - Invalid input

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

422Validation Error

Schema: HTTPValidationError

detailarray · ValidationErrorValidationError

5 fields

locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject

Code samples

POST/api/v1/revenue-schedules/preorders

bash

curl -X POST 'https://api.ondayzero.com/api/v1/revenue-schedules/preorders' \
  -H 'Authorization: Bearer dz_your_token' \
  -H 'x-business-id: YOUR_BUSINESS_ID' \
  -H 'Content-Type: application/json' \
  -d '{
  "order_reference": "string",
  "amount_cents": 0
}'