Skip to content

Scopes & Permissions

Scopes are independent; read never implies write. Location-owned resources also require an explicit location grant.

Scope Permits Location grants
merchant.read Merchant profile No
locations.read Granted locations Filters results
catalog.read / catalog.write Products and categories; simple catalog writes Writes to products require every active location grant
inventory.read / inventory.write Levels, movements, and adjustments Yes
customers.read / customers.write Redacted customer contact records No; merchant-wide
orders.read / orders.write Orders and unpaid draft creation Yes
payments.read Persisted tender evidence Yes
suppliers.read Supplier summaries and details No; merchant-wide
purchases.read Purchase orders Yes
fiscal.read Approved invoice/credit-note status metadata Yes

No public scope currently authorizes payment capture, refunds, completed-sale injection, fiscal mutation, provider credentials, or workforce mutation.