---
title: "Create call-off release rule"
method: POST
path: "/commerce/rules/calloffrelease"
tags: ["CallOffReleaseRules"]
---

# Create call-off release rule

`POST /commerce/rules/calloffrelease`

Creates a new call-off release rule.

## Query parameters

- `responseFields` string

## Request body

- CallOffReleaseRule — Call-Off Release Rule contract (CAT-7736). Tenant-owned, internally master-catalog-scoped ranked admin rule for the B2B Supply Chain OMS call-off order release pipeline.
  - `auditInfo` AdminUserAuditInfo
    - `createBy` string, nullable
    - `createDate` string, date-time, nullable
    - `updateBy` string, nullable
    - `updateDate` string, date-time, nullable
  - `callOffOrderRules` string[], nullable — Referenced Call-Off-Order Rule codes. Max 1 entry. At least one of ProductRules, CustomerRules, or CallOffOrderRules must be non-empty (FR-007, FR-008).
  - `code` string, nullable — Unique identifier. Auto-generated on create if not supplied. Immutable after creation. Max 30 characters; must match GeneralAlphaNumericCharactersRegex (FR-005, FR-016).
  - `customerRules` string[], nullable — Referenced Customer Rule codes. Max 1 entry (FR-007, FR-008).
  - `daysBeforeShipDate` integer — Days before the ship date within which this rule applies. Inclusive [0, 365] (FR-015).
  - `description` string, nullable — Optional description. Max 500 characters (FR-003).
  - `enabled` boolean, nullable — Whether the rule is active. Defaults to true on insert (FR-003, FR-011).
  - `metaData` unknown
  - `minimumFillRate` integer — Minimum fill rate threshold [0, 100] (integer percentage). 0 is valid (FR-027).
  - `name` string, nullable — Display name. Required. Max 200 characters (FR-003).
  - `productRules` ProductRuleCode[], nullable — Referenced Product Rule criteria. Max 1 entry. Each entry requires both code and masterCatalogId; the (code, masterCatalogId) pair must resolve to an existing ProductRule with RuleType=CallOffRelease (FR-007, FR-008).
    - `code` string, nullable — Unique identifier of the ProductRule. System-supplied and read-only.
    - `masterCatalogId` integer — Master Catalog Id of the ProductRule.
  - `rank` integer — Priority rank, unique per (TenantId, MasterCatalogId). Auto-assigned to MAX(Rank)+1 when omitted or ≤0 on create (FR-006, FR-017).
  - `sortAttribute` string, nullable — Optional tiebreaker attribute name used by the downstream call-off release engine. Max 50 characters. null, absent, and empty are all accepted (FR-026).
  - `validForAllSites` boolean, nullable — When true the rule applies to all tenant sites; ValidSites is ignored (FR-022).
  - `validSites` integer[], nullable — Site IDs this rule applies to. Each must be tenant-owned (FR-007, FR-022).

## Response `200`

OK

- CallOffReleaseRule — Call-Off Release Rule contract (CAT-7736). Tenant-owned, internally master-catalog-scoped ranked admin rule for the B2B Supply Chain OMS call-off order release pipeline.
  - `auditInfo` AdminUserAuditInfo
    - `createBy` string, nullable
    - `createDate` string, date-time, nullable
    - `updateBy` string, nullable
    - `updateDate` string, date-time, nullable
  - `callOffOrderRules` string[], nullable — Referenced Call-Off-Order Rule codes. Max 1 entry. At least one of ProductRules, CustomerRules, or CallOffOrderRules must be non-empty (FR-007, FR-008).
  - `code` string, nullable — Unique identifier. Auto-generated on create if not supplied. Immutable after creation. Max 30 characters; must match GeneralAlphaNumericCharactersRegex (FR-005, FR-016).
  - `customerRules` string[], nullable — Referenced Customer Rule codes. Max 1 entry (FR-007, FR-008).
  - `daysBeforeShipDate` integer — Days before the ship date within which this rule applies. Inclusive [0, 365] (FR-015).
  - `description` string, nullable — Optional description. Max 500 characters (FR-003).
  - `enabled` boolean, nullable — Whether the rule is active. Defaults to true on insert (FR-003, FR-011).
  - `metaData` unknown
  - `minimumFillRate` integer — Minimum fill rate threshold [0, 100] (integer percentage). 0 is valid (FR-027).
  - `name` string, nullable — Display name. Required. Max 200 characters (FR-003).
  - `productRules` ProductRuleCode[], nullable — Referenced Product Rule criteria. Max 1 entry. Each entry requires both code and masterCatalogId; the (code, masterCatalogId) pair must resolve to an existing ProductRule with RuleType=CallOffRelease (FR-007, FR-008).
    - `code` string, nullable — Unique identifier of the ProductRule. System-supplied and read-only.
    - `masterCatalogId` integer — Master Catalog Id of the ProductRule.
  - `rank` integer — Priority rank, unique per (TenantId, MasterCatalogId). Auto-assigned to MAX(Rank)+1 when omitted or ≤0 on create (FR-006, FR-017).
  - `sortAttribute` string, nullable — Optional tiebreaker attribute name used by the downstream call-off release engine. Max 50 characters. null, absent, and empty are all accepted (FR-026).
  - `validForAllSites` boolean, nullable — When true the rule applies to all tenant sites; ValidSites is ignored (FR-022).
  - `validSites` integer[], nullable — Site IDs this rule applies to. Each must be tenant-owned (FR-007, FR-022).

---

[API](https://skmtc.net/kibocommerce/apis/customer.md) · [All operations](https://skmtc.net/kibocommerce/apis/customer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kibocommerce/customer/versions/47c0cf7b75ab/schema)