Skip to main content

Update Send Network Rules

PUT 
/api/send-planner/networks/:warehouse

Save the planning rules for one network destination. Applies to plans calculated from now on; existing plans keep the rules they ran with.

Required scope: send-plans:write

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

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

Body fields (all optional; null falls back to the network default):

  • enabled (boolean): include this network in plans.
  • target_days (integer, 1-365): days of cover to aim for.
  • floor_days (integer, 0-365; when target_days is sent in the same request, floor_days must not exceed it): minimum cover filled first when stock is short.
  • max_days (integer, 1-730): never send beyond this cover.
  • weight (number, 0.1-10): priority weight when stock is shared.
  • lead_days_override (integer, 0-180): replace the measured transit + check-in time.
  • rounding_mode (string): nearest | down | up | none.
  • min_line_qty (integer, 0-100000): skip lines smaller than this.
  • seed_units (integer, 0-100000): units to send for a new listing with no sales history.
  • buffer_days (integer, 0-180): safety days of cover on top of the target.
  • floor_strategy (string): days (the floor is floor_days of cover) | service_level (the floor is lead-time demand plus safety stock at service_level).
  • service_level (number, 0.5-0.999): in-stock probability for the service_level floor.
  • channel_priority (string): protect_other_channels | favor_network — a favored network may use stock kept for forecast self-fulfilled demand (orders the merchant ships from their own warehouses).
  • seed_strategy (string): fixed (send seed_units) | proxy (a share of a sibling network's velocity) for new listings.
  • seed_proxy_pct (number, 1-500): share of the sibling network's velocity to seed with.
  • seed_proxy_destination_warehouse_id (integer): the sibling network to copy from; must exist and must not be this network.
  • min_shelf_life_days (integer, 0-1095): only send lots with at least this many days of shelf life left.
  • blackouts (array, max 20): periods the network does not receive. Each: start (Y-m-d, required), end (Y-m-d, on or after start, required), label (string, max 80).

Response: the full network list, as in List Send Networks.

Request​

Responses​

OK

Response Headers
    Content-Type