Price list entries

A purchasing price list entry contains the pricing for a selected item within a selected price list. You can create price list entries for items whose prices are determined based on an amount, a discount or mark up percentage, the quantity sold, and more. See Price list entries — Purchasing in the Sage Intacct Help Center for more information.

List price list entries

get/objects/purchasing/price-list-entry

Returns a collection with a key, ID, and link for each price list entry. This operation is mostly for use in testing; use the query service to find objects that meet certain criteria and to specify properties that are returned.

SecurityOAuth2
Responses
200

OK

400

Bad Request

Request samples 
Response samples 
application/json
{
  • "ia::result": [
    • {
      • "key": "1",
      • "id": "1",
      • "href": "/objects/purchasing/price-list-entry/1"
      },
    • {
      • "key": "2",
      • "id": "2",
      • "href": "/objects/purchasing/price-list-entry/2"
      }
    ],
  • "ia::meta": {
    • "totalCount": 2,
    • "totalSuccess": 2,
    • "totalError": 0
    }
}
Create a price list entry
post/objects/purchasing/price-list-entry
Creates a new price list entry. See About price list entries in the Sage Intacct Help Center for more information.


SecurityOAuth2 
Request 
Request Body schema: application/json
required
startDate
required
string <date> 
Provide the date on which the price becomes effective. You can enter past or future dates.


 
 Example:  "2024-01-01"
endDate
required
string <date> 
Provide the date on which the price ends. You can enter past or future dates.


 
 Example:  "2024-01-01"
value
required
string <decimal-precision-10> 
The value to provide for this field depends on the type set in the valueType field:


    

  • actual: Provide the price.  For example, if the item is $500.00, specify 500.00
    • 

  • dollarMarkup: Provide the amount by which to mark up the price. For example, to mark up the price by $25.00, specify 25.00.
    • 

  • dollarDiscount: Provide the amount to subtract from the price. For example, to give a $10.00 discount, specify 10.00.
    • 

  • markupPercent: Provide the percentage by which to mark up the price. For example, to mark up the price by 20%, specify 20.
    • 

  • discountPercent: Provide the percentage by which to discount the price. For example, to give a 5% discount, specify 5.
    • 



 
 Example:  "60.56"
valueType
required
string
 Default:  "actual"
The value type for the purchasing price list entry.


 Enum: "actual" "discountPercent" "dollarDiscount" "dollarMarkup" "markupPercent"  
 Example:  "actual"
required
object
Price list associated with the price list entry.


 
key
string
Unique key for the purchasing price list.


 
 Example:  "1"
id
string  <= 20 characters 
Unique ID for the purchasing price list.


 
 Example:  "Base Price List"
required
object
Item to which the price list entry applies.


 
key
string
Unique key for item.


 
 Example:  "89"
id
string
Unique ID for the item.


 
 Example:  "Battery"
name
string
Name of the item.


 
 Example:  "Battery for Car"
required
object
The product line to which the item belongs.


 
key
string  <= 8 characters 
Unique key for the product line.


 
 Example:  "25"
id
string  <= 20 characters 
Unique name or other ID for the product line.


 
 Example:  "Office_Supplies"
id
string  <= 8 characters 
Unique ID for the price list entry.


 
 Example:  "38"
currency
string
Provide the currency in which the price will be evaluated. This field is only applicable to multi-currency companies.


 
 Example:  "USD"
minimumQuantity
string <decimal-precision-8> 
Specify a minimum quantity if you want to give or get price breaks according to the quantity ordered. With this type of pricing, the system multiplies the transaction quantity by the rate mapped to the quantity range in which the transaction quantity falls. Quantities cannot be negative.


 
 Example:  "1"
maximumQuantity
string <decimal-precision-8> 
Specify a maximum quantity if you want to give or get price breaks according to the quantity ordered. With this type of pricing, the system multiplies the transaction quantity by the rate mapped to the quantity range in which the transaction quantity falls. Quantities cannot be negative.


 
 Example:  "100"
isFixedPrice
boolean
 Default:  "true"
Indicates whether the price is a fixed price. In a cascading (or layered) price list structure, the first time Sage Intacct finds isFixedPrice set to true for an item, it presents that price as the suggested price on the transaction regardless of any other price defined for that item in other price lists.


 
 Example:  "false"
object
This field is only applicable to companies subscribed to Projects and Time and Expenses.To define a project billing rate, use a combination of employee and item. Sage Intacct uses the price associated with this item-employee combination for applicable timesheets when invoices are generated for time and materials projects.


 
key
string  <= 8 characters 
Unique key for the employee.


 
 Example:  "25"
id
string
Unique ID for the employee.


 
 Example:  "123"
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
{
  • "startDate": "2024-07-01",
  • "endDate": "2025-09-31",
  • "minimumQuantity": "1",
  • "maximumQuantity": "9999999",
  • "value": "10.00000000",
  • "valueType": "actual",
  • "isFixedPrice": "true",
  • "status": "active",
  • "priceList": {
    • "id": "Poolplay price list"
    },
  • "item": {
    • "id": "Unicorn float"
    },
  • "currency": "USD"
}
Response samples 
application/json
{
  • "ia::result": {
    • "id": "421",
    • "key": "421",
    • "href": "/objects/purchasing/price-list-entry/421"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}
Get a price list entry
get/objects/purchasing/price-list-entry/{key}
Returns detailed information for a specified price list entry.


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


 
 Example:  421
Responses 
200
OK


400
Bad Request


Request samples 
Response samples 
application/json
{
  • "ia::result": {
    • "id": "451",
    • "key": "451",
    • "priceList": {
      • "id": "Base Price List",
      • "key": "1",
      • "href": "/objects/purchasing/price-list/1"
      },
    • "item": {
      • "key": "90",
      • "id": "Car_Bulbs",
      • "name": "Bulbs for Car",
      • "href": "/objects/inventory-control/item/90"
      },
    • "productLine": {
      • "key": "19",
      • "id": "Accessories",
      • "href": "/objects/purchasing/product-line/19"
      },
    • "startDate": "2025-05-01",
    • "endDate": "2025-05-31",
    • "minimumQuantity": "1",
    • "maximumQuantity": "999999999",
    • "value": "10.00000000",
    • "valueType": "actual",
    • "isFixedPrice": "true",
    • "status": "active",
    • "currency": "USD",
    • "employee": {
      • "key": "25",
      • "id": "123",
      • "href": "/objects/company-config/employee/25"
      },
    • "audit": {
      • "createdDateTime": "2025-02-12T04:46:56Z",
      • "modifiedDateTime": "2025-02-12T04:46:56Z",
      • "createdByUser": {
        },
      • "modifiedByUser": {
        },
      • "createdBy": "2nd, 4th, 6th Level Approver",
      • "modifiedBy": "2nd, 4th, 6th Level Approver"
      },
    • "href": "/objects/purchasing/price-list-entry/451",
    • "ia::meta": {
      • "totalCount": 1,
      • "totalSuccess": 1,
      • "totalError": 0
      }
    }
}
Update a price list entry
patch/objects/purchasing/price-list-entry/{key}
Updates an existing price list entry by setting field values. Any fields not provided remain unchanged. If there are changes to an item's price, it will be immediately available to all new or modified transactions that occur after the price revision. Changing a price will not affect existing transactions.


Alternatively, to keep a history of price changes, add a new price list entry that has a new price, new start date, and new end date, and then update the end date of the existing price list entry to end one day before the new price list entry starts. For more information, see Edit a price list entry in the Sage Intacct Help Center.  


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


 
 Example:  421
Request Body schema: application/json
object
The product line to which the item belongs.


 
key
string  <= 8 characters 
Unique key for the product line.


 
 Example:  "25"
id
string  <= 20 characters 
Unique name or other ID for the product line.


 
 Example:  "Office_Supplies"
currency
string
Provide the currency in which the price will be evaluated. This field is only applicable to multi-currency companies.


 
 Example:  "USD"
startDate
string <date> 
Provide the date on which the price becomes effective. You can enter past or future dates.


 
 Example:  "2024-01-01"
endDate
string <date> 
Provide the date on which the price ends. You can enter past or future dates.


 
 Example:  "2024-01-01"
minimumQuantity
string <decimal-precision-8> 
Specify a minimum quantity if you want to give or get price breaks according to the quantity ordered. With this type of pricing, the system multiplies the transaction quantity by the rate mapped to the quantity range in which the transaction quantity falls. Quantities cannot be negative.


 
 Example:  "1"
maximumQuantity
string <decimal-precision-8> 
Specify a maximum quantity if you want to give or get price breaks according to the quantity ordered. With this type of pricing, the system multiplies the transaction quantity by the rate mapped to the quantity range in which the transaction quantity falls. Quantities cannot be negative.


 
 Example:  "100"
value
string <decimal-precision-10> 
The value to provide for this field depends on the type set in the valueType field:


    

  • actual: Provide the price.  For example, if the item is $500.00, specify 500.00
    • 

  • dollarMarkup: Provide the amount by which to mark up the price. For example, to mark up the price by $25.00, specify 25.00.
    • 

  • dollarDiscount: Provide the amount to subtract from the price. For example, to give a $10.00 discount, specify 10.00.
    • 

  • markupPercent: Provide the percentage by which to mark up the price. For example, to mark up the price by 20%, specify 20.
    • 

  • discountPercent: Provide the percentage by which to discount the price. For example, to give a 5% discount, specify 5.
    • 



 
 Example:  "60.56"
valueType
string
 Default:  "actual"
The value type for the purchasing price list entry.


 Enum: "actual" "discountPercent" "dollarDiscount" "dollarMarkup" "markupPercent"  
 Example:  "actual"
isFixedPrice
boolean
 Default:  "true"
Indicates whether the price is a fixed price. In a cascading (or layered) price list structure, the first time Sage Intacct finds isFixedPrice set to true for an item, it presents that price as the suggested price on the transaction regardless of any other price defined for that item in other price lists.


 
 Example:  "false"
object
This field is only applicable to companies subscribed to Projects and Time and Expenses.To define a project billing rate, use a combination of employee and item. Sage Intacct uses the price associated with this item-employee combination for applicable timesheets when invoices are generated for time and materials projects.


 
key
string  <= 8 characters 
Unique key for the employee.


 
 Example:  "25"
id
string
Unique ID for the employee.


 
 Example:  "123"
object
Item to which the price list entry applies.


 
key
string
Unique key for item.


 
 Example:  "89"
id
string
Unique ID for the item.


 
 Example:  "Battery"
name
string
Name of the item.


 
 Example:  "Battery for Car"
object
Price list associated with the price list entry.


 
key
string
Unique key for the purchasing price list.


 
 Example:  "1"
id
string  <= 20 characters 
Unique ID for the purchasing price list.


 
 Example:  "Base Price List"
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
{
  • "startDate": "2025-02-01"
}
Response samples 
application/json
{
  • "ia::result": {
    • "id": "435",
    • "key": "435",
    • "href": "/objects/purchasing/price-list-entry/435"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}
Delete a price list entry
delete/objects/purchasing/price-list-entry/{key}
Deletes a price list entry. A price list entry can be deleted if it has not been used by any transactions. This removes the price list entry from the system. 


Alternatively, a price list entry can be deactivated by changing the status to inactive, which prevents it from displaying in any selection lists but retains the price for historical purposes.


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


 
 Example:  421
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
    }
}