Price schedules

Price schedules are pricing groups that you can assign to one or more customers.

List price schedules

get/objects/order-entry/price-schedule

Returns a collection with a key, ID, and link for each order entry price schedule.

SecurityOAuth2
Responses
200

OK

400

Bad Request

Request samples 
Response samples 
application/json
{
  • "ia::result": [
    • {
      • "key": "1",
      • "id": "M100",
      • "href": "/objects/order-entry/price-schedule/1"
      },
    • {
      • "key": "2",
      • "id": "10 Percent",
      • "href": "/objects/order-entry/price-schedule/2"
      },
    • {
      • "key": "3",
      • "id": "5 Percent",
      • "href": "/objects/order-entry/price-schedule/3"
      }
    ],
  • "ia::meta": {
    • "pageSize": 100,
    • "start": 1,
    • "totalCount": 3
    }
}
Create a price schedule
post/objects/order-entry/price-schedule
Creates a new order entry price schedule.


SecurityOAuth2 
Request 
Request Body schema: application/json
required
id
required
string  <= 10 characters 
Unique identifier for the price schedule.


 
 Example:  "Price23"
description
string
Description of the price schedule.


 
 Example:  "Price schedule code description"
object
Associated price list.


 
key
string
System-assigned key for the order entry price list.


 
 Example:  "23"
id
string
Unique identifier for the price list.


 
 Example:  "Sales Price List"
discountPercent
string <decimal-precision-2> 
Discount percentage for all items in the associated price list. A positive value decreases prices; a negative value increases prices.


 
 Example:  "10"
status
string
 Default:  "active"
Object status. Active objects are fully functional. Inactive objects are essentially hidden and cannot be used or referenced.


 Enum: "active" "inactive"  
 Example:  "active"
Responses 
201
Created


400
Bad Request


Request samples 
application/json
{
  • "id": "Acme Price",
  • "description": "Acme Discount Schedule",
  • "discountPercent": "10"
}
Response samples 
application/json
{
  • "ia::result": {
    • "key": "9",
    • "id": "Acme Price",
    • "href": "/objects/order-entry/price-schedule/9"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalError": 0,
    • "totalSuccess": 1
    }
}
Get a price schedule
get/objects/order-entry/price-schedule/{key}
Returns detailed information for a specified order entry price schedule.


SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned unique key for the price schedule.


 
 Example:  99
Responses 
200
OK


400
Bad Request


Request samples 
Response samples 
application/json
{
  • "ia::result": {
    • "key": "9",
    • "id": "Acme Price",
    • "href": "/objects/order-entry/price-schedule/9",
    • "description": "Acme Discount Schedule",
    • "discountPercent": "10.00",
    • "entity": {
      • "id": null,
      • "key": null,
      • "name": null
      },
    • "priceList": {
      • "id": null,
      • "key": null
      },
    • "status": "active",
    • "audit": {
      • "createdBy": "1",
      • "createdByUser": {
        },
      • "createdDateTime": "2025-05-07T06:49:22Z",
      • "modifiedBy": "1",
      • "modifiedByUser": {
        },
      • "modifiedDateTime": "2025-05-07T06:49:22Z"
      }
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalError": 0,
    • "totalSuccess": 1
    }
}
Update a price schedule
patch/objects/order-entry/price-schedule/{key}
Updates an existing order entry price schedule by setting field values. Any fields not provided remain unchanged.


SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned unique key for the price schedule.


 
 Example:  99
Request Body schema: application/json
description
string
Description of the price schedule.


 
 Example:  "Price schedule code description"
object
Associated price list.


 
key
string
System-assigned key for the order entry price list.


 
 Example:  "23"
id
string
Unique identifier for the price list.


 
 Example:  "Sales Price List"
discountPercent
string <decimal-precision-2> 
Discount percentage for all items in the associated price list. A positive value decreases prices; a negative value increases prices.


 
 Example:  "10"
status
string
 Default:  "active"
Object status. Active objects are fully functional. Inactive objects are essentially hidden and cannot be used or referenced.


 Enum: "active" "inactive"  
 Example:  "active"
Responses 
200
OK


400
Bad Request


Request samples 
application/json
{
  • "discountPercent": "15"
}
Response samples 
application/json
{
  • "ia::result": {
    • "key": "9",
    • "id": "Acme Price",
    • "href": "/objects/order-entry/price-schedule/9"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalError": 0,
    • "totalSuccess": 1
    }
}
Delete a price schedule
delete/objects/order-entry/price-schedule/{key}
Deletes an order entry price schedule.


SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned unique key for the price schedule.


 
 Example:  99
Responses 
204
No Content


400
Bad Request


Request samples 
Response samples 
application/json
{
  • "ia::result": {
    • "ia::error": {
      • "code": "invalidRequest",
      • "message": "A POST request requires a payload",
      • "errorId": "REST-1028",
      • "additionalInfo": {
        },
      • "supportId": "Kxi78%7EZuyXBDEGVHD2UmO1phYXDQAAAAo"
      }
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 0,
    • "totalError": 1
    }
}