Skip to main content

Get Send Planner Settings

GET 

/api/send-planner/settings

Get the account-wide send planner defaults.

Required scope: send-plans:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Authentication: Bearer Personal Access Token with the send-plans:read scope. The token's user also needs permission to view the send planner.

Settings:

  • reserve_days: days of self-fulfilled demand (orders you ship from your own warehouses: web store, eBay, Amazon FBM, wholesale…) kept back at the source warehouses.
  • protect_local: when false only open orders and backorders are protected, not forecast demand.
  • include_inbound_days: count open purchase / manufacturing orders arriving within this many days as sendable supply (0 = on hand only).
  • velocity_window_days: sales window used for velocity.
  • stale_inventory_hours: a network stock snapshot older than this fails the plan unless plan_anyway is set.
  • hold_ttl_hours: how long a stock hold lasts before it expires if not handed to a draft.
  • rounding_mode: nearest | down | up | none — default case-pack rounding.
  • run_day_of_week (0 = Sunday … 6 = Saturday, null = off) and run_time (HH:MM): the weekly send run.
  • run_auto_draft_clean_lines: on a send run, automatically draft lines with no exceptions.
  • run_digest_user_ids: users who receive the send run's exception digest.
  • transfer_destination_warehouse_ids: your own warehouses stocked by transfer (see Get Transfer Destinations).
  • next_run_at: when the next weekly send run starts (ISO 8601, UTC), or null when none is scheduled.

Request​

Responses​

OK

Response Headers
    Content-Type