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:

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

  • 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.

Request​

Responses​

OK

Response Headers
    Content-Type