Roll over an expired Blanket Order to create a new order with selected items.

Error

A valid request URL is required to generate request examples

{
  "attributes": [
    {
      "attributeDefinitionId": 123,
      "auditInfo": {
        "createBy": "<string>",
        "createDate": "2023-11-07T05:31:56Z",
        "updateBy": "<string>",
        "updateDate": "2023-11-07T05:31:56Z"
      },
      "fullyQualifiedName": "<string>",
      "values": [
        "<unknown>"
      ]
    }
  ],
  "auditInfo": {
    "createBy": "<string>",
    "createDate": "2023-11-07T05:31:56Z",
    "updateBy": "<string>",
    "updateDate": "2023-11-07T05:31:56Z"
  },
  "availableActions": [
    "<string>"
  ],
  "buyerContact": {
    "emailAddress": "jsmith@example.com",
    "firstName": "<string>",
    "lastNameOrSurname": "<string>",
    "phoneNumber": "<string>"
  },
  "canceledReason": {
    "description": "<string>",
    "moreInfo": "<string>",
    "reasonCode": "<string>"
  },
  "cancelledDate": "2023-11-07T05:31:56Z",
  "changeMessages": [
    {
      "amount": 123,
      "appId": "<string>",
      "appKey": "<string>",
      "appName": "<string>",
      "attributes": {},
      "correlationId": "<string>",
      "createDate": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "identifier": "<string>",
      "message": "<string>",
      "metadata": "<unknown>",
      "newValue": "<string>",
      "oldValue": "<string>",
      "subject": "<string>",
      "subjectType": "<string>",
      "success": true,
      "userFirstName": "<string>",
      "userId": "<string>",
      "userLastName": "<string>",
      "userScopeType": "<string>",
      "verb": "<string>"
    }
  ],
  "channelCode": "<string>",
  "currencyCode": "<string>",
  "customerAccountId": 123,
  "data": {},
  "externalId": "<string>",
  "id": "<string>",
  "items": [
    {
      "attributes": [
        {
          "attributeDefinitionId": 123,
          "auditInfo": {
            "createBy": "<string>",
            "createDate": "2023-11-07T05:31:56Z",
            "updateBy": "<string>",
            "updateDate": "2023-11-07T05:31:56Z"
          },
          "fullyQualifiedName": "<string>",
          "values": [
            "<unknown>"
          ]
        }
      ],
      "auditInfo": {
        "createBy": "<string>",
        "createDate": "2023-11-07T05:31:56Z",
        "updateBy": "<string>",
        "updateDate": "2023-11-07T05:31:56Z"
      },
      "consumedQuantity": 123,
      "id": "<string>",
      "lineId": 123,
      "product": {
        "bundledProducts": [
          {
            "allocationExpiration": "2023-11-07T05:31:56Z",
            "allocationId": 123,
            "creditValue": 123,
            "deltaPrice": 123,
            "description": "<string>",
            "fulfillmentStatus": "<string>",
            "goodsType": "<string>",
            "imageUrl": "<string>",
            "isPackagedStandAlone": true,
            "measurements": {
              "height": {
                "unit": "<string>",
                "value": 123
              },
              "length": {
                "unit": "<string>",
                "value": 123
              },
              "weight": {
                "unit": "<string>",
                "value": 123
              },
              "width": {
                "unit": "<string>",
                "value": 123
              }
            },
            "name": "<string>",
            "optionAttributeFQN": "<string>",
            "optionValue": "<unknown>",
            "productCode": "<string>",
            "productReservationId": 123,
            "quantity": 123,
            "stock": {
              "aggregateInventory": 123,
              "availableDate": "2023-11-07T05:31:56Z",
              "availableFutureInventories": 123,
              "futureInventories": [
                {
                  "allocated": 123,
                  "available": 123,
                  "createDate": "2023-11-07T05:31:56Z",
                  "deliveryDate": "2023-11-07T05:31:56Z",
                  "futureInventoryID": 123,
                  "onhand": 123,
                  "pending": 123
                }
              ],
              "isOnBackOrder": true,
              "isSubstitutable": true,
              "manageStock": true,
              "stockAvailable": 123,
              "totalAvailableStock": 123
            }
          }
        ],
        "combinedProductCode": "<string>",
        "fulfillmentTypesSupported": [
          "<string>"
        ],
        "goodsType": "<string>",
        "isBundle": true,
        "name": "<string>",
        "options": [
          {
            "attributeFQN": "<string>",
            "dataType": "<string>",
            "name": "<string>",
            "shopperEnteredValue": "<unknown>",
            "stringValue": "<string>",
            "value": "<unknown>"
          }
        ],
        "productCode": "<string>",
        "productUsage": "<string>",
        "variationProductCode": "<string>"
      },
      "quantity": 123,
      "remainingQuantity": 123,
      "reservedQuantity": 123,
      "status": "<string>",
      "unitPrice": 123,
      "unreservedQuantity": 123
    }
  ],
  "notes": [
    {
      "auditInfo": {
        "createBy": "<string>",
        "createDate": "2023-11-07T05:31:56Z",
        "updateBy": "<string>",
        "updateDate": "2023-11-07T05:31:56Z"
      },
      "id": "<string>",
      "text": "<string>"
    }
  ],
  "number": 123,
  "priceListCode": "<string>",
  "pricingMode": "<string>",
  "reservationMode": "<string>",
  "sellerContact": {
    "emailAddress": "jsmith@example.com",
    "firstName": "<string>",
    "lastNameOrSurname": "<string>",
    "phoneNumber": "<string>"
  },
  "siteId": 123,
  "status": "<string>",
  "tenantId": 123,
  "userId": "<string>",
  "validityPeriod": {
    "endDate": "2023-11-07T05:31:56Z",
    "startDate": "2023-11-07T05:31:56Z"
  },
  "version": "<string>"
}

POST

commerce

blanketorders

{sourceBlanketOrderId}

rollover

Error

A valid request URL is required to generate request examples

{
  "attributes": [
    {
      "attributeDefinitionId": 123,
      "auditInfo": {
        "createBy": "<string>",
        "createDate": "2023-11-07T05:31:56Z",
        "updateBy": "<string>",
        "updateDate": "2023-11-07T05:31:56Z"
      },
      "fullyQualifiedName": "<string>",
      "values": [
        "<unknown>"
      ]
    }
  ],
  "auditInfo": {
    "createBy": "<string>",
    "createDate": "2023-11-07T05:31:56Z",
    "updateBy": "<string>",
    "updateDate": "2023-11-07T05:31:56Z"
  },
  "availableActions": [
    "<string>"
  ],
  "buyerContact": {
    "emailAddress": "jsmith@example.com",
    "firstName": "<string>",
    "lastNameOrSurname": "<string>",
    "phoneNumber": "<string>"
  },
  "canceledReason": {
    "description": "<string>",
    "moreInfo": "<string>",
    "reasonCode": "<string>"
  },
  "cancelledDate": "2023-11-07T05:31:56Z",
  "changeMessages": [
    {
      "amount": 123,
      "appId": "<string>",
      "appKey": "<string>",
      "appName": "<string>",
      "attributes": {},
      "correlationId": "<string>",
      "createDate": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "identifier": "<string>",
      "message": "<string>",
      "metadata": "<unknown>",
      "newValue": "<string>",
      "oldValue": "<string>",
      "subject": "<string>",
      "subjectType": "<string>",
      "success": true,
      "userFirstName": "<string>",
      "userId": "<string>",
      "userLastName": "<string>",
      "userScopeType": "<string>",
      "verb": "<string>"
    }
  ],
  "channelCode": "<string>",
  "currencyCode": "<string>",
  "customerAccountId": 123,
  "data": {},
  "externalId": "<string>",
  "id": "<string>",
  "items": [
    {
      "attributes": [
        {
          "attributeDefinitionId": 123,
          "auditInfo": {
            "createBy": "<string>",
            "createDate": "2023-11-07T05:31:56Z",
            "updateBy": "<string>",
            "updateDate": "2023-11-07T05:31:56Z"
          },
          "fullyQualifiedName": "<string>",
          "values": [
            "<unknown>"
          ]
        }
      ],
      "auditInfo": {
        "createBy": "<string>",
        "createDate": "2023-11-07T05:31:56Z",
        "updateBy": "<string>",
        "updateDate": "2023-11-07T05:31:56Z"
      },
      "consumedQuantity": 123,
      "id": "<string>",
      "lineId": 123,
      "product": {
        "bundledProducts": [
          {
            "allocationExpiration": "2023-11-07T05:31:56Z",
            "allocationId": 123,
            "creditValue": 123,
            "deltaPrice": 123,
            "description": "<string>",
            "fulfillmentStatus": "<string>",
            "goodsType": "<string>",
            "imageUrl": "<string>",
            "isPackagedStandAlone": true,
            "measurements": {
              "height": {
                "unit": "<string>",
                "value": 123
              },
              "length": {
                "unit": "<string>",
                "value": 123
              },
              "weight": {
                "unit": "<string>",
                "value": 123
              },
              "width": {
                "unit": "<string>",
                "value": 123
              }
            },
            "name": "<string>",
            "optionAttributeFQN": "<string>",
            "optionValue": "<unknown>",
            "productCode": "<string>",
            "productReservationId": 123,
            "quantity": 123,
            "stock": {
              "aggregateInventory": 123,
              "availableDate": "2023-11-07T05:31:56Z",
              "availableFutureInventories": 123,
              "futureInventories": [
                {
                  "allocated": 123,
                  "available": 123,
                  "createDate": "2023-11-07T05:31:56Z",
                  "deliveryDate": "2023-11-07T05:31:56Z",
                  "futureInventoryID": 123,
                  "onhand": 123,
                  "pending": 123
                }
              ],
              "isOnBackOrder": true,
              "isSubstitutable": true,
              "manageStock": true,
              "stockAvailable": 123,
              "totalAvailableStock": 123
            }
          }
        ],
        "combinedProductCode": "<string>",
        "fulfillmentTypesSupported": [
          "<string>"
        ],
        "goodsType": "<string>",
        "isBundle": true,
        "name": "<string>",
        "options": [
          {
            "attributeFQN": "<string>",
            "dataType": "<string>",
            "name": "<string>",
            "shopperEnteredValue": "<unknown>",
            "stringValue": "<string>",
            "value": "<unknown>"
          }
        ],
        "productCode": "<string>",
        "productUsage": "<string>",
        "variationProductCode": "<string>"
      },
      "quantity": 123,
      "remainingQuantity": 123,
      "reservedQuantity": 123,
      "status": "<string>",
      "unitPrice": 123,
      "unreservedQuantity": 123
    }
  ],
  "notes": [
    {
      "auditInfo": {
        "createBy": "<string>",
        "createDate": "2023-11-07T05:31:56Z",
        "updateBy": "<string>",
        "updateDate": "2023-11-07T05:31:56Z"
      },
      "id": "<string>",
      "text": "<string>"
    }
  ],
  "number": 123,
  "priceListCode": "<string>",
  "pricingMode": "<string>",
  "reservationMode": "<string>",
  "sellerContact": {
    "emailAddress": "jsmith@example.com",
    "firstName": "<string>",
    "lastNameOrSurname": "<string>",
    "phoneNumber": "<string>"
  },
  "siteId": 123,
  "status": "<string>",
  "tenantId": 123,
  "userId": "<string>",
  "validityPeriod": {
    "endDate": "2023-11-07T05:31:56Z",
    "startDate": "2023-11-07T05:31:56Z"
  },
  "version": "<string>"
}

Authorizations

Authorization

string

header

required

JWT Authorization header using the Bearer scheme.

Path Parameters

sourceBlanketOrderId

string

required

Query Parameters

responseFields

string

limits which fields are returned in the response body

Body

application/json

Request DTO for rolling over an expired Blanket Order to a new order. Used by POST /blanketorders/{blanketOrderId}/rollover endpoint. ICKY-2647: Blanket Order Rollover

endDate

string<date-time>

End date for the new Blanket Order's validity period. Must be after StartDate.

selectedLineItemIds

string[] | null

Line item IDs to include in the new Blanket Order. Only Open status items are eligible for rollover.

startDate

string<date-time>

Start date for the new Blanket Order's validity period.

Response

Represents a contractual commitment between the seller and a B2B Account to supply goods at predetermined prices and quantities over a specified period.

attributes

object[] | null

Custom attributes at the header level.

Show child attributes

auditInfo

object

Show child attributes

availableActions

string[] | null

Available lifecycle actions from the current status. Populated on read.

buyerContact

object

Show child attributes

canceledReason

object

Show child attributes

cancelledDate

string<date-time> | null

Date when the order was cancelled. System-supplied, read-only.

changeMessages

object[] | null

Change messages associated with this Blanket Order. Hydrated from a separate collection.

Show child attributes

channelCode

string | null

Channel code for multi-channel context.

currencyCode

string | null

Currency code (default "USD").

customerAccountId

integer<int32> | null

data

object | null

Extensibility data bag for tenant-specific custom data.

externalId

string | null

External reference identifier for integration with external systems.

string | null

items

object[] | null

Product commitment Items for this Blanket Order.

Show child attributes

notes

object[] | null

Internal notes for merchant use.

Show child attributes

number

integer<int32> | null

Auto-generated sequential Blanket Order number. System-supplied, read-only.

priceListCode

string | null

Price list code for pricing context. Resolved and locked at create. Immutable.

pricingMode

string | null

Pricing mode: Kibo (default — prices resolved from catalog/price list) or External (caller-supplied prices stored as-is). Immutable after create. See Mozu.CommerceRuntime.Contracts.PricingModeConst.

reservationMode

string | null

Reservation mode for this blanket order. Values: NetworkLevel | CallOffLevel (default). When NetworkLevel, the blanket's uncalled balance is tracked in a ledger used for network-wide ATS/ATP netting. Immutable after creation.

sellerContact

object

Show child attributes

siteId

integer<int32>

status

string | null

Current status managed by the StatusEngine transition table.

tenantId

integer<int32>

userId

string | null

validityPeriod

object

Represents the validity window for a Blanket Order. Call-off orders can only be placed while the current date is within this period.

Show child attributes

version

string | null

Optimistic concurrency token. System-supplied.

Developers

API reference

AI Tools

Roll over an expired Blanket Order to create a new order with selected items.

Authorizations

Path Parameters

Query Parameters

Body

Response