sale updated v1

wbhk

sale.updated.v1

Emitted when any order ingested by Flipdish is materially updated (e.g. items, charges, or discounts changed). Carries the full post-update sale payload inline, so no follow-up GET is required. Read the Sale events guide to understand how sale.updated.v1 differs from other sale events. Beta feature: this event is in closed beta — request access by emailing [email protected].

Payload

Emitted when a sale is materially updated (e.g. items, charges, or discounts changed).

orgId

string

required

^org\d+$

Org ID in standard format

brandId

string

required

length ≥ 1

Brand ID string. Most brands use the format br (e.g. br123). Legacy brands may use the fd format (e.g. fd123) or a plain alphanumeric slug (e.g. mexicancafe). No format is enforced — any non-empty string is accepted.

propertyId

string

required

^p\d+$

Property ID in standard format

salesChannelId

string

required

length ≥ 1

Sales channel ID string. Most sales channels use the format sc (e.g. sc123). Legacy sales channels may be a plain integer without the sc prefix (e.g. 123). No format is enforced — any non-empty string is accepted.

salesChannelType

string

enum

required

Identifies the platform that originated the sale (e.g. UberEats, FlipdishKIOSK, POS).

saleId

string

required

Flipdish sale identifier (Crockford base32 encoding of a global counter, e.g. 3N356).

externalId

string

Partner/platform's own identifier for the sale, when supplied (e.g. an UberEats order ID).

sale

object

required

Full public sale payload reflecting the sale after the update (items, charges, discounts, etc.). items may be empty when all active lines were voided.

Response

200

Your server must return a 2xx to acknowledge