Other Charge Resale Item API
Create and manage miscellaneous fees and charges purchased from vendors and resold to customers.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /record/v1/otherChargeResaleItem | List other charge resale items |
GET | /record/v1/otherChargeResaleItem/{id} | Get specific item |
POST | /record/v1/otherChargeResaleItem | Create item |
PATCH | /record/v1/otherChargeResaleItem/{id} | Update item |
DELETE | /record/v1/otherChargeResaleItem/{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) |
incomeAccount | object | Income account | Yes |
cogsAccount | object | COGS account | Yes |
salesDescription | string | Sales description | No |
purchaseDescription | string | Purchase description | No |
cost | number | Purchase cost | No |
basePrice | number | Base selling price | 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 Resale Item
POST /record/v1/otherChargeResaleItem
Content-Type: application/json
{
"itemId": "SHIPPING-RESALE",
"displayName": "Shipping Charge (Resale)",
"description": "Shipping charges passed through to customers",
"subsidiary": {
"id": "1"
},
"incomeAccount": {
"id": "400"
},
"cogsAccount": {
"id": "500"
},
"salesDescription": "Shipping and handling",
"purchaseDescription": "Third-party shipping costs",
"cost": 15.00,
"basePrice": 25.00,
"vendor": {
"id": "789"
},
"taxSchedule": {
"id": "1"
},
"department": {
"id": "20"
}
}
Response:
{
"id": "923",
"itemId": "SHIPPING-RESALE",
"displayName": "Shipping Charge (Resale)",
"description": "Shipping charges passed through to customers",
"subsidiary": {
"id": "1",
"refName": "Parent Company"
},
"incomeAccount": {
"id": "400",
"refName": "Other Revenue"
},
"cogsAccount": {
"id": "500",
"refName": "Cost of Other Charges"
},
"salesDescription": "Shipping and handling",
"purchaseDescription": "Third-party shipping costs",
"cost": 15.00,
"basePrice": 25.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 Resale Item
PATCH /record/v1/otherChargeResaleItem/923
Content-Type: application/json
{
"cost": 18.00,
"basePrice": 30.00,
"salesDescription": "Express shipping and handling"
}
Response:
{
"id": "923",
"itemId": "SHIPPING-RESALE",
"displayName": "Shipping Charge (Resale)",
"cost": 18.00,
"basePrice": 30.00,
"salesDescription": "Express shipping and handling",
"lastModifiedDate": "2025-12-25T11:00:00Z"
}
Query Filters
Find Active Other Charge Resale Items
GET /record/v1/otherChargeResaleItem?q=isInactive=false
Find by Item ID Pattern
GET /record/v1/otherChargeResaleItem?q=itemId LIKE 'SHIPPING%'
Find by Vendor
GET /record/v1/otherChargeResaleItem?q=vendor.id=789
Find by Price Range
GET /record/v1/otherChargeResaleItem?q=basePrice>=20 AND basePrice<=50
Find by Income Account
GET /record/v1/otherChargeResaleItem?q=incomeAccount.id=400
Important Notes
- Other charge resale items represent miscellaneous fees you purchase from vendors and resell to customers with a markup
- These items appear in both purchase transactions (purchase orders, vendor bills) and sales transactions (invoices, sales orders)
- Both incomeAccount and cogsAccount are required to track revenue and costs separately
- The difference between cost and basePrice represents your markup/margin
- Common use cases include:
- Shipping and freight charges passed through to customers
- Handling fees
- Installation charges
- Setup and configuration fees
- Processing fees
- Special packaging charges
- Rush order fees
- Unlike Other Charge Sale Items, resale items track the vendor relationship and purchase cost
- Unlike Other Charge Purchase Items, resale items also track sales information (price, income account)
- Other charge resale items do not track inventory quantity or use costing methods
- In OneWorld accounts, subsidiary assignment is mandatory
- Other charge resale items can have default department, class, and location dimensions
- Use salesDescription for what appears on customer invoices and purchaseDescription for vendor bills
- These items are useful for tracking pass-through charges where you want to maintain margin visibility
See Also
- Other Charge Purchase Item - Charges purchased (not resold)
- Other Charge Sale Item - Charges sold (not purchased)
- Service Resale Item - Services purchased and resold