Skip to main content

Other Charge Resale Item API

Create and manage miscellaneous fees and charges purchased from vendors and resold to customers.


Endpoints

MethodEndpointDescription
GET/record/v1/otherChargeResaleItemList other charge resale items
GET/record/v1/otherChargeResaleItem/{id}Get specific item
POST/record/v1/otherChargeResaleItemCreate item
PATCH/record/v1/otherChargeResaleItem/{id}Update item
DELETE/record/v1/otherChargeResaleItem/{id}Delete item

Key Fields

FieldTypeDescriptionRequired
itemIdstringItem name/numberYes (if not auto)
displayNamestringDisplay nameNo
descriptionstringItem descriptionNo
subsidiaryobjectSubsidiary assignmentYes (OneWorld)
incomeAccountobjectIncome accountYes
cogsAccountobjectCOGS accountYes
salesDescriptionstringSales descriptionNo
purchaseDescriptionstringPurchase descriptionNo
costnumberPurchase costNo
basePricenumberBase selling priceNo
vendorobjectPreferred vendorNo
taxScheduleobjectTax scheduleNo
departmentobjectDefault departmentNo
classobjectDefault classNo
locationobjectDefault locationNo
isInactivebooleanInactive flagNo

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