Skip to main content

Replenishment Grid

GET 
/api/amazon/:integrationInstance/replenishment

Paginated FBA replenishment grid for an Amazon integration instance. Rows start from listed Amazon products (so products without existing FBA inventory or a restock report still appear), enriched with:

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

  • FBA stock position (available, inbound, reserved) from the FBA inventory report
  • Amazon restock recommendation data (GET_RESTOCK_INVENTORY_RECOMMENDATIONS_REPORT) when present
  • Channel-scoped sales velocity (this instance's sales channel) and other-channel velocity
  • Origin warehouse availability + other-warehouse stock (warehouse transfer mode)
  • Supplier stock, MOQ and lead time (purchase order mode)
  • Quantity already committed on open draft inbound plans and open backorders
  • A calculated suggestion: TargetUnits = ceil(velocity x (target_days + lead_time + buffer)) minus net at Amazon, capped by origin/supplier availability, rounded down to case packs, with MOQ handling in PO mode

Sorted by Amazon's recommended replenishment quantity (desc, nulls last), then product SKU.

Authentication: Bearer token.

Validation: source_mode is required; origin_warehouse_id is required for WAREHOUSE_TRANSFER; supplier_id is required for PURCHASE_ORDER.

Each row includes amazon_product_id (the AmazonProduct row id) for deep-linking to the Amazon product detail page.

Supports server sort and advanced filter_groups (GroupedFilterSupport). In PURCHASE_ORDER mode with supplier_id, rows are scoped to that supplier's catalog and each row carries is_default_supplier (false = supplier carries the product but isn't its default). Rows also include amazon_fnsku_product_id, unit_weight_lb, and unit_volume_cuft (for cart weight/volume/pallet estimates). Each row's case_pack_qty / case_pack_rounding come from the product's replenishment settings override, falling back to the instance default. Rows also carry the product's master-carton data — units_per_case, case_weight_lb, case_volume_cuft (normalized from the product's case-pack dimensions) — used to estimate cartons, pallet weight and pallet count in the cart.

Lead time: lead_time_days is the coverage lead the suggestion uses. It is the measured lead time of the route that restocks the row's FBA region (manual override, else the measured median of at least 3 received shipments, else the route default). In WAREHOUSE_TRANSFER mode the region's primary route applies; in PURCHASE_ORDER mode the supplier route of the chosen supplier applies, and a measured supplier leg is added to the supplier's own lead time (inbound_lead_days is that leg). inbound_lead_route is supplier | own_warehouse | third_party_warehouse | awd; inbound_lead_source is measured | manual | default.

FBA minimums: fba_floor_region_code is the row's FBA region (EU for every Pan-European pool country). fba_floor_units and fba_floor_status (ok | recovering | below | out | no_floor | no_demand | stale | unmapped) are the last evaluated FBA minimum stock level for the product in that region, or null when none has been evaluated; fba_floor_below is true when status is below or out. Users without the fba_stock_floors.view permission get fba_floor_region_code, fba_floor_units and fba_floor_status as null and fba_floor_below false.

Request​

Responses​

OK

Response Headers
    Content-Type