API Quick Reference

This page aggregates all Buying Policies and related Orders endpoints used across the feature. Every label ends with the operationId. All paths below are admin scope.

Headers (standard)

  • dj-client: OPERATOR
  • dj-api-key: required
  • dj-store, dj-store-view: optional, for scoping where applicable

Credit Control — settings

  • GET /v1/buying-policies/credit-control - ADM-BUYING-POLICY-500
  • PATCH /v1/buying-policies/credit-control - ADM-BUYING-POLICY-200
  • PATCH /v1/buying-policies/credit-control/credit-limit - ADM-BUYING-POLICY-201

Grace Amounts (per account)

  • GET /v1/buying-policies/credit-control/grace-amounts - ADM-BUYING-POLICY-551
  • POST /v1/buying-policies/credit-control/grace-amounts - ADM-BUYING-POLICY-151
  • PUT /v1/buying-policies/credit-control/grace-amounts/:graceAmountId - ADM-BUYING-POLICY-203
  • DELETE /v1/buying-policies/credit-control/grace-amounts/:graceAmountId - ADM-BUYING-POLICY-301

Credit Holds (manual blocks)

  • GET /v1/buying-policies/credit-control/holds - ADM-BUYING-POLICY-550
  • POST /v1/buying-policies/credit-control/holds - ADM-BUYING-POLICY-150
  • PUT /v1/buying-policies/credit-control/holds/:creditHoldId - ADM-BUYING-POLICY-202
  • DELETE /v1/buying-policies/credit-control/holds/:creditHoldId - ADM-BUYING-POLICY-300

Quotas — settings and defaults

  • GET /v1/buying-policies/quotas - ADM-BUYING-POLICY-501
  • PATCH /v1/buying-policies/quotas - ADM-BUYING-POLICY-204
  • PATCH /v1/buying-policies/quotas/min-value - ADM-BUYING-POLICY-205

Quotas Rules (per Account, Supplier, optional Store)

  • POST /v1/buying-policies/quotas/rules - ADM-BUYING-POLICY-152
  • GET /v1/buying-policies/quotas/rules - ADM-BUYING-POLICY-553
  • PUT /v1/buying-policies/quotas/rules/:ruleId - ADM-BUYING-POLICY-206
  • DELETE /v1/buying-policies/quotas/rules/:ruleId - ADM-BUYING-POLICY-302

Co-validation Groups

  • POST /v1/buying-policies/quotas/groups - ADM-BUYING-POLICY-153
  • GET /v1/buying-policies/quotas/groups - ADM-BUYING-POLICY-554
  • PUT /v1/buying-policies/quotas/groups/:groupId - ADM-BUYING-POLICY-207
  • DELETE /v1/buying-policies/quotas/groups/:groupId - ADM-BUYING-POLICY-303

Blocking Reasons and Unblock (Orders)

  • Blocking reasons
    • GET /v1/buying-policies/blocking-reasons - ADM-BUYING-POLICY-552
  • Orders list with policy filters
    • GET /v1/logistic-orders - ADM-ORDER-551
  • Force validation and audit history
    • POST /v1/logistic-orders/unblock - ADM-ORDER-150
    • GET /v1/logistic-orders/:logisticOrderId/unblock-history - ADM-ORDER-550

Notes & conventions

  • OperationId suffix: every label includes the canonical operationId to simplify cross-checking and tooling.
  • No new params: all endpoints follow your existing authentication, scoping, and pagination model.
  • Shop scope: Buying Policies affect buyers indirectly; there are no shop endpoints for configuring policies.