Service Resale Item API

Create and manage services that are purchased from vendors and resold to customers.

---

Endpoints

Method	Endpoint	Description
GET	/record/v1/serviceResaleItem	List service resale items
GET	/record/v1/serviceResaleItem/{id}	Get specific item
POST	/record/v1/serviceResaleItem	Create item
PATCH	/record/v1/serviceResaleItem/{id}	Update item
DELETE	/record/v1/serviceResaleItem/{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 Service Resale Item

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

{
  "itemId": "RESALE-SERVICE",
  "displayName": "Resold Professional Services",
  "description": "Professional services resold to customers",
  "subsidiary": {
    "id": "1"
  },
  "incomeAccount": {
    "id": "400"
  },
  "cogsAccount": {
    "id": "500"
  },
  "salesDescription": "Professional consulting services",
  "purchaseDescription": "Third-party consulting services",
  "cost": 100.00,
  "basePrice": 175.00,
  "vendor": {
    "id": "456"
  },
  "taxSchedule": {
    "id": "1"
  }
}

Response:

{
  "id": "890",
  "itemId": "RESALE-SERVICE",
  "displayName": "Resold Professional Services",
  "description": "Professional services resold to customers",
  "subsidiary": {
    "id": "1",
    "refName": "Parent Company"
  },
  "incomeAccount": {
    "id": "400",
    "refName": "Service Revenue"
  },
  "cogsAccount": {
    "id": "500",
    "refName": "Cost of Services"
  },
  "salesDescription": "Professional consulting services",
  "purchaseDescription": "Third-party consulting services",
  "cost": 100.00,
  "basePrice": 175.00,
  "vendor": {
    "id": "456",
    "refName": "ABC Consulting"
  },
  "taxSchedule": {
    "id": "1",
    "refName": "Tax Schedule"
  },
  "isInactive": false,
  "lastModifiedDate": "2025-12-25T10:30:00Z"
}

---

Example: Update Service Resale Item

PATCH /record/v1/serviceResaleItem/890
Content-Type: application/json

{
  "cost": 110.00,
  "basePrice": 185.00,
  "salesDescription": "Premium professional consulting services"
}

Response:

{
  "id": "890",
  "itemId": "RESALE-SERVICE",
  "displayName": "Resold Professional Services",
  "cost": 110.00,
  "basePrice": 185.00,
  "salesDescription": "Premium professional consulting services",
  "lastModifiedDate": "2025-12-25T11:00:00Z"
}

---

Query Filters

Find Active Service Resale Items

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

Find by Item ID Pattern

GET /record/v1/serviceResaleItem?q=itemId LIKE 'RESALE%'

Find by Vendor

GET /record/v1/serviceResaleItem?q=vendor.id=456

Find by Price Range

GET /record/v1/serviceResaleItem?q=basePrice>=100 AND basePrice<=200

Find by Income Account

GET /record/v1/serviceResaleItem?q=incomeAccount.id=400

---

Important Notes

• Service resale items represent services 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
• Unlike Service Sale Items, resale items track the vendor relationship and purchase cost
• Unlike Service Purchase Items, resale items also track sales information (price, income account)
• Services do not track inventory quantity or use costing methods like physical items
• In OneWorld accounts, subsidiary assignment is mandatory
• Service resale items can have default department, class, and location dimensions
• Use salesDescription for what appears on customer invoices and purchaseDescription for vendor bills

---

See Also

• Service Purchase Item - Services purchased (not resold)
• Service Sale Item - Services sold (not purchased)
• Non-Inventory Resale Item - Non-service resale items