Other Charge Purchase Item API

Create and manage miscellaneous fees and charges purchased from vendors (shipping, handling, setup fees, etc.).

---

Endpoints

Method	Endpoint	Description
GET	/record/v1/otherChargePurchaseItem	List other charge purchase items
GET	/record/v1/otherChargePurchaseItem/{id}	Get specific item
POST	/record/v1/otherChargePurchaseItem	Create item
PATCH	/record/v1/otherChargePurchaseItem/{id}	Update item
DELETE	/record/v1/otherChargePurchaseItem/{id}	Delete item

---

Key Fields

Field	Type	Description	Required
itemId	string	Item name/number	Yes (if not auto)
displayName	string	Display name	No
description	string	Item description	No
subsidiary	object	Subsidiary assignment	Yes (OneWorld)
expenseAccount	object	Expense account	Yes
purchaseDescription	string	Purchase description	No
cost	number	Purchase cost	No
vendor	object	Preferred vendor	No
taxSchedule	object	Tax schedule	No
department	object	Default department	No
class	object	Default class	No
location	object	Default location	No
isInactive	boolean	Inactive flag	No

---

Example: Create Other Charge Purchase Item

POST /record/v1/otherChargePurchaseItem
Content-Type: application/json

{
  "itemId": "FREIGHT-IN",
  "displayName": "Inbound Freight Charges",
  "description": "Freight and shipping charges from suppliers",
  "subsidiary": {
    "id": "1"
  },
  "expenseAccount": {
    "id": "620"
  },
  "purchaseDescription": "Freight charges for inbound shipments",
  "cost": 50.00,
  "vendor": {
    "id": "789"
  },
  "taxSchedule": {
    "id": "1"
  },
  "department": {
    "id": "20"
  }
}

Response:

{
  "id": "912",
  "itemId": "FREIGHT-IN",
  "displayName": "Inbound Freight Charges",
  "description": "Freight and shipping charges from suppliers",
  "subsidiary": {
    "id": "1",
    "refName": "Parent Company"
  },
  "expenseAccount": {
    "id": "620",
    "refName": "Freight & Shipping"
  },
  "purchaseDescription": "Freight charges for inbound shipments",
  "cost": 50.00,
  "vendor": {
    "id": "789",
    "refName": "XYZ Logistics"
  },
  "taxSchedule": {
    "id": "1",
    "refName": "Tax Schedule"
  },
  "department": {
    "id": "20",
    "refName": "Logistics"
  },
  "isInactive": false,
  "lastModifiedDate": "2025-12-25T10:30:00Z"
}

---

Example: Update Other Charge Purchase Item

PATCH /record/v1/otherChargePurchaseItem/912
Content-Type: application/json

{
  "cost": 75.00,
  "purchaseDescription": "Updated freight charges - expedited shipping"
}

Response:

{
  "id": "912",
  "itemId": "FREIGHT-IN",
  "displayName": "Inbound Freight Charges",
  "cost": 75.00,
  "purchaseDescription": "Updated freight charges - expedited shipping",
  "lastModifiedDate": "2025-12-25T11:00:00Z"
}

---

Query Filters

Find Active Other Charge Purchase Items

GET /record/v1/otherChargePurchaseItem?q=isInactive=false

Find by Item ID Pattern

GET /record/v1/otherChargePurchaseItem?q=itemId LIKE 'FREIGHT%'

Find by Vendor

GET /record/v1/otherChargePurchaseItem?q=vendor.id=789

Find by Expense Account

GET /record/v1/otherChargePurchaseItem?q=expenseAccount.id=620

Find by Cost Range

GET /record/v1/otherChargePurchaseItem?q=cost>=50 AND cost<=100

---

Important Notes

• Other charge purchase items represent miscellaneous fees and charges you purchase from vendors
• These items appear on purchase transactions (purchase orders, vendor bills) only
• The expenseAccount is required and determines where the charge is posted when received
• Unlike service items, other charges typically represent one-time or occasional fees rather than regular services
• Common use cases include:
  • Freight and shipping charges
  • Handling fees
  • Installation charges
  • Setup fees
  • Processing fees
  • Customs and duties
  • Special packaging charges
• Other charge purchase items do not track inventory quantity or use costing methods
• The vendor field is optional but recommended for setting a preferred vendor
• In OneWorld accounts, subsidiary assignment is mandatory
• Other charge purchase items can have default department, class, and location dimensions
• These items help track and categorize various incidental costs in purchasing operations

---

See Also

• Other Charge Resale Item - Charges purchased and resold
• Other Charge Sale Item - Charges sold (not purchased)
• Service Purchase Item - Services purchased from vendors