Part

A Part object represents a specific part that you add to an Order as part of a Service.

POST/v3/inventory_part/availability_search

Global Search Inventory Parts

Global search for inventory parts

Body parameters

Consumes

The following content type is required: application/json

Name
locationId
Type
one of: any, any
Description
locationId
Name
term
Type
string Required
Description
the search term

Produces

The response content type: application/json

`200` Response

Name
data
Type
array Required
Description
Name
success
Type
boolean Required
Description

`4xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

`5xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

POST

/v3/inventory_part/availability_search

curl https://api.shopmonkey.cloud/v3/inventory_part/availability_search \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data '{ "term" : "value" }'

Example Response
application/json

{
  "data": [
    {
      "binLocation": null,
      "brandName": null,
      "categoryName": null,
      "companyId": null,
      "id": null,
      "locationId": null,
      "name": null,
      "normalizedName": null,
      "normalizedSKU": null,
      "note": null,
      "number": null,
      "quantity": null,
      "retailCostCents": null,
      "type": null,
      "updatedDate": null,
      "vendorName": null,
      "wholesaleCostCents": null,
      "availableQuantity": null
    }
  ],
  "success": true
}

GET/v3/line_item_assignment

Find line item assignments to line items

Find line item assignments to parts and tires

Query String parameters

Name
laborIds
Type
array
Description
ids of labors to assign
Name
partIds
Type
array
Description
ids of parts to assign
Name
tireIds
Type
array
Description
ids of tires to assign
Name
userId
Type
string
Description

Produces

The response content type: application/json

`200` Response

Name
code
Type
string
Description
The error code
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if success = false
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message
Name
data
Type
object Required
Description

Properties for `data` object

Name
labors
Type
array Required
Description
Name
parts
Type
array Required
Description
Name
tires
Type
array Required
Description

`4xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

`5xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request

GET

/v3/line_item_assignment

curl https://api.shopmonkey.cloud/v3/line_item_assignment \
  -H "Authorization: Bearer ${SM_TOKEN}"

Example Response
application/json

{
  "success": true,
  "data": {
    "labors": [
      {
        "laborId": null,
        "userId": "userId"
      }
    ],
    "parts": [
      {
        "partId": null,
        "userId": "userId"
      }
    ],
    "tires": [
      {
        "tireId": null,
        "userId": "userId"
      }
    ]
  }
}

PUT/v3/line_item_assignment/bulk

Bulk line item assignments

Body parameters

Consumes

The following content type is required: application/json

Array of objects with the following properties:

Produces

The response content type: application/json

`200` Response

Name
code
Type
string
Description
The error code
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if success = false
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

`4xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

`5xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

PUT

/v3/line_item_assignment/bulk

curl https://api.shopmonkey.cloud/v3/line_item_assignment/bulk \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -X PUT -H 'Content-Type: application/json' \
  --data '{}'

Example Response
application/json

{
  "success": true
}

PUT/v3/order/:orderId/part_bulk

Update Bulk Parts

Update Bulk Parts for an Order

URL parameters

Name
orderId
Type
string Required
Description
the id for the order

Body parameters

Consumes

The following content type is required: application/json

Array of objects with the following properties:

Produces

The response content type: application/json

`200` Response

Name
code
Type
string
Description
The error code
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if success = false
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message
Name
data
Type
object Required
Description

Properties for `data` object

Name
order
Type
object Required
Description
Order schema

Properties for `order` object

Name
id
Type
string Required
Description
Name
publicId
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
locationId
Type
string Required
Description
Name
number
Type
string Required
Description
Name
externalNumber
Type
string Required
Description
allow user to override generated number
Name
vehicleId
Type
string Required
Description
Name
phoneNumberId
Type
string Required
Description
id of the phone number to use instead of the customer's default number
Name
emailId
Type
string Required
Description
id of the email to use instead of the customer's default email
Name
customerId
Type
string Required
Description
Name
name
Type
string Required
Description
Name
generatedName
Type
string Required
Description
Name
coalescedName
Type
string Required
Description
Name
complaint
Type
string Required
Description
Name
recommendation
Type
string Required
Description
Name
purchaseOrderNumber
Type
string Required
Description
Name
generatedVehicleName
Type
string Required
Description
"[year] [make] [model] [submodel]" pulled from the vehicle, if any
Name
generatedCustomerName
Type
string Required
Description
"[firstName] [lastName]" pulled from the customer, if any
Name
orderCreatedDate
Type
string Required
Description
allow user to override created date
Name
archived
Type
boolean Required
Description
Name
authorized
Type
boolean Required
Description
Name
authorizedDate
Type
string Required
Description
Name
invoiced
Type
boolean Required
Description
Name
sentToCarfax
Type
boolean Required
Description
Name
inspectionStatus
Type
one of: None, Completed, NotCompleted Required
Description
Name
inspectionCount
Type
integer Required
Description
Name
invoicedDate
Type
string Required
Description
Name
paid
Type
boolean Required
Description
Name
appointmentDates
Type
array Required
Description
Name
assignedTechnicianIds
Type
array Required
Description
Name
completedAuthorizedLaborHours
Type
number Required
Description
Name
completedLaborHours
Type
number Required
Description
Name
totalAuthorizedLaborHours
Type
number Required
Description
Name
totalLaborHours
Type
number Required
Description
Name
messageCount
Type
integer Required
Description
Name
shopUnreadMessageCount
Type
integer Required
Description
Name
totalCostCents
Type
integer Required
Description
Name
paidCostCents
Type
integer Required
Description
Name
remainingCostCents
Type
integer Required
Description
Name
partsCents
Type
integer Required
Description
Name
tiresCents
Type
integer Required
Description
Name
laborCents
Type
integer Required
Description
Name
subcontractsCents
Type
integer Required
Description
Name
epaCents
Type
integer Required
Description
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
feesCents
Type
integer Required
Description
Name
taxCents
Type
integer Required
Description
Name
gstCents
Type
integer Required
Description
Name
pstCents
Type
integer Required
Description
Name
hstCents
Type
integer Required
Description
Name
transactionalFeeTotalCents
Type
integer Required
Description
Name
transactionalFeeSubtotalCents
Type
integer Required
Description
// value before taxes
Name
requestedDepositCents
Type
integer Required
Description
Name
workflowStatusId
Type
string Required
Description
Name
workflowStatusPosition
Type
number Required
Description
Name
workflowStatusDate
Type
string Required
Description
Name
taxConfigId
Type
string Required
Description
Name
transactionFeeConfigId
Type
string Required
Description
Name
dueDate
Type
string Required
Description
Name
serviceWriterId
Type
string Required
Description
Name
mileageIn
Type
number Required
Description
Name
mileageOut
Type
number Required
Description
Name
conversationId
Type
string Required
Description
Name
completedDate
Type
string Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
readOnly
Type
boolean Required
Description
if this order should not be editable in the UI
Name
readOnlyReason
Type
string Required
Description
a friendly explanation of why (eg. "migrated from previous system")
Name
deferredServiceCount
Type
integer Required
Description
Name
statementId
Type
string Required
Description
a statement this order included in
Name
fullyPaidDate
Type
string Required
Description
Name
messagedDate
Type
string Required
Description
Name
paymentTermId
Type
string Required
Description
id of the payment term for the order
Name
paymentDueDate
Type
string Required
Description
Name
allowCollectPayment
Type
boolean Required
Description
Name
allowCustomerAuthorization
Type
boolean Required
Description
Name
allowCustomerViewMessages
Type
boolean Required
Description
Name
allowCustomerViewAuthorizations
Type
boolean Required
Description
Name
allowCustomerViewInspections
Type
boolean Required
Description
Name
allowCustomerViewActivity
Type
boolean Required
Description
Name
requireESignatureOnAuthorization
Type
boolean Required
Description
Name
requireESignatureOnInvoice
Type
boolean Required
Description
Name
updatedSinceSignedInvoice
Type
boolean Required
Description
Name
labels
Type
object Required
Description
Name
imported
Type
boolean Required
Description
Name
status
Type
one of: Estimate, RepairOrder, Invoice Required
Description
Name
repairOrderDate
Type
string Required
Description
// the date the order was moved into repair order status
Name
workflowStatusDuration
Type
object Required
Description
Stores how many time the order has been in each status
Name
appointments
Type
array Required
Description
Deprecated: will return []
Name
authorizations
Type
array Required
Description
Deprecated: will return []
Name
customFields
Type
object
Description
custom fields as JSON object
Name
customer
Type
object Required
Description
Name
files
Type
array
Description
Name
inspections
Type
array Required
Description
Deprecated: will return []
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
paymentTerm
Type
object Required
Description
Name
profitability
Type
object Required
Description
Name
services
Type
array Required
Description
Soon will be deprecated!
Name
vehicle
Type
object Required
Description
Name
workflowStatus
Type
object Required
Description
WorkflowStatus schema

Properties for `customer` object

Name
id
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
locationIds
Type
array Required
Description
Name
customerType
Type
one of: Customer, Fleet Required
Description
Name
firstName
Type
string Required
Description
Name
lastName
Type
string Required
Description
Name
companyName
Type
string Required
Description
Name
address1
Type
string Required
Description
Name
address2
Type
string Required
Description
Name
city
Type
string Required
Description
Name
state
Type
string Required
Description
Name
country
Type
one of: US, CA, MX, AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BQ, BA, BW, BV, BR, IO, VG, BN, BG, BF, BI, CV, KH, CM, KY, CF, TD, CL, CN, HK, MO, CX, CC, CO, KM, CG, CK, CR, HR, CU, CW, CY, CZ, CI, KP, CD, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, SZ, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, VA, HN, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, JM, JP, JE, JO, KZ, KE, KI, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, FM, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, NC, NZ, NI, NE, NG, NU, NF, MP, NO, OM, PK, PW, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, KR, MD, RO, RU, RW, RE, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SK, SI, SB, SO, ZA, GS, SS, ES, LK, PS, SD, SR, SJ, SE, CH, SY, TW, TJ, TH, MK, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, GB, TZ, UM, VI, UY, UZ, VU, VE, VN, WF, EH, YE, ZM, ZW Required
Description
Name
postalCode
Type
string Required
Description
Name
dotNumber
Type
string Required
Description
Name
paymentTermId
Type
string Required
Description
Name
publicId
Type
string Required
Description
Name
note
Type
string Required
Description
Name
marketingOptIn
Type
boolean Required
Description
Name
preferredContactMethod
Type
one of: SMS, Email, All Required
Description
Name
preferredLanguage
Type
one of: en, en_US, fr_CA Required
Description
Name
referralSourceId
Type
string Required
Description
Name
taxExempt
Type
boolean Required
Description
US specific
Name
gstExempt
Type
boolean Required
Description
CA specific
Name
hstExempt
Type
boolean Required
Description
CA specific
Name
pstExempt
Type
boolean Required
Description
CA specific
Name
discountPercent
Type
number Required
Description
Name
laborRateId
Type
string Required
Description
Name
laborMatrixId
Type
string Required
Description
Name
pricingMatrixId
Type
string Required
Description
Name
fleetId
Type
string Required
Description
Name
lastTimeOrderWorked
Type
string Required
Description
Name
statementCount
Type
integer Required
Description
Name
transactionCount
Type
integer Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
messageCount
Type
integer Required
Description
Name
website
Type
string Required
Description
Name
normalizedFirstName
Type
string Required
Description
Name
normalizedLastName
Type
string Required
Description
Name
normalizedName
Type
string Required
Description
if fleet, contains the normalized companyName, else normalized firstName lastName
Name
coalescedFirstNameOrCompanyName
Type
string Required
Description
Name
vehicleCount
Type
integer Required
Description
Name
orderCount
Type
integer Required
Description
Name
finixIdentityId
Type
string Required
Description
Name
labels
Type
object Required
Description
Name
externalId
Type
string Required
Description
an id that can be used to reference the customer in an external system
Name
originLocationId
Type
string Required
Description
the location that created the customer
Name
imported
Type
boolean Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
customFields
Type
object
Description
custom fields as JSON object
Name
emails
Type
array Required
Description
Name
phoneNumbers
Type
array Required
Description

Properties for `paymentTerm` object

Name
id
Type
string Required
Description
Name
name
Type
string Required
Description

Properties for `profitability` object

Name
labor
Type
object Required
Description
Name
parts
Type
object Required
Description
Name
subcontracts
Type
object Required
Description
Name
tires
Type
object Required
Description
Name
totalDiscountCents
Type
number Required
Description
Name
totalDiscountPercent
Type
number Required
Description
Name
totalProfitCents
Type
number Required
Description
Name
totalProfitPercent
Type
number Required
Description
Name
totalRetailCents
Type
number Required
Description
Name
totalWholesaleCents
Type
number Required
Description

Properties for `labor` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `parts` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `subcontracts` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `tires` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `vehicle` object

Name
id
Type
string Required
Description
()
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
locationIds
Type
array Required
Description
Name
baseId
Type
integer Required
Description
vcdb base id
Name
size
Type
one of: HeavyDuty, LightDuty, Other Required
Description
Name
preferredLaborGuide
Type
one of: HeavyDuty, LightDuty, Other Required
Description
Name
type
Type
one of: ATV, Bicycle, BigRig, Boat, ClassAMotorhome, ClassCMotorhome, Convertible, Coupe, FifthWheel, Hatchback, Jeep, Motorcycle, Other, PopUp, RV, SUV, Sedan, Trailer, TravelTrailer, Truck, TruckCamper, UTV, Van, Wagon Required
Description
Name
year
Type
integer Required
Description
Name
make
Type
string Required
Description
holds Hull make for vessel
Name
makeId
Type
integer Required
Description
vcdb make id
Name
model
Type
string Required
Description
Name
modelId
Type
integer Required
Description
vcdb model id
Name
submodel
Type
string Required
Description
Name
submodelId
Type
integer Required
Description
vcdb submodel id
Name
engine
Type
string Required
Description
Name
engineId
Type
integer Required
Description
vcdb engine id
Name
productionDate
Type
string Required
Description
Name
transmission
Type
one of: Automatic, Manual, AutomaticCVT, AutomaticDualClutch Required
Description
Name
transmissionId
Type
integer Required
Description
vcdb transmission id
Name
transmissionSpeed
Type
string Required
Description
Name
transmissionMfrCode
Type
string Required
Description
Name
drivetrain
Type
one of: RWD, FWD, FourWD, AWD Required
Description
Name
drivetype
Type
string Required
Description
Name
drivetypeId
Type
integer Required
Description
vcdb drivetype id
Name
bodyStyle
Type
string Required
Description
Name
bodyStyleId
Type
integer Required
Description
vcdb body style id
Name
bedLength
Type
string Required
Description
Name
configurationStatus
Type
one of: Custom, Incomplete, Invalid, NotSupported, Valid Required
Description
Name
vin
Type
string Required
Description
Name
color
Type
one of: White, Silver, Gray, Black, Blue, Red, Brown, Burgundy, Tan, Gold, Green, Yellow, Orange, Pink, Purple, Other Required
Description
Name
unit
Type
string Required
Description
Name
mileage
Type
number Required
Description
Name
mileageUnit
Type
one of: Mile, Kilometer Required
Description
Name
odometer
Type
boolean Required
Description
Name
licensePlate
Type
string Required
Description
Name
licensePlateState
Type
string Required
Description
Name
licensePlateCountry
Type
one of: US, CA, MX, AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BQ, BA, BW, BV, BR, IO, VG, BN, BG, BF, BI, CV, KH, CM, KY, CF, TD, CL, CN, HK, MO, CX, CC, CO, KM, CG, CK, CR, HR, CU, CW, CY, CZ, CI, KP, CD, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, SZ, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, VA, HN, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, JM, JP, JE, JO, KZ, KE, KI, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, FM, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, NC, NZ, NI, NE, NG, NU, NF, MP, NO, OM, PK, PW, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, KR, MD, RO, RU, RW, RE, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SK, SI, SB, SO, ZA, GS, SS, ES, LK, PS, SD, SR, SJ, SE, CH, SY, TW, TJ, TH, MK, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, GB, TZ, UM, VI, UY, UZ, VU, VE, VN, WF, EH, YE, ZM, ZW Required
Description
Name
note
Type
string Required
Description
Name
vcdbVehicleId
Type
string Required
Description
Name
ownerCount
Type
integer Required
Description
Name
orderCount
Type
integer Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
tirePressureLogCount
Type
integer Required
Description
Name
mileageLogCount
Type
integer Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
messageCount
Type
integer Required
Description
Name
computed_ymm
Type
string Required
Description
Name
customPhoto
Type
boolean Required
Description
Name
stockPhoto
Type
boolean Required
Description
Name
labels
Type
object Required
Description
Name
externalId
Type
string Required
Description
an id that can be used to reference the vehicle in an external system
Name
originLocationId
Type
string Required
Description
the location that created the vehicle
Name
imported
Type
boolean Required
Description
Name
length
Type
number Required
Description
Name
lengthUnit
Type
one of: Ft, M Required
Description
Name
hin
Type
string Required
Description
Vessel hull identification number
Name
serial
Type
string Required
Description
Name
name
Type
string Required
Description
Custom vehicle name / Vessel registered name
Name
coalescedVINorHIN
Type
string Required
Description
Name
lastServicedDate
Type
string Required
Description
Name
frontTireSize
Type
string Required
Description
custom front tire size override value
Name
rearTireSize
Type
string Required
Description
custom rear tire size override value
Name
drivingCondition
Type
one of: Normal, Severe Required
Description
Name
engines
Type
object Required
Description
an array of engines { id: string; make: string; model: string; hours: number; noHoursMeter: boolean; horsepower: number; serial: string; productionYear: number; productionMonth: number; }
Name
engineHoursLogs
Type
object Required
Description
an array of engine hours logs { engineId: string; inHours: number; outHours: number; orderId: string; }
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
customFields
Type
object
Description
custom fields as JSON object
Name
tirePressureLogs
Type
array
Description

Properties for `workflowStatus` object

Name
id
Type
string Required
Description
Name
name
Type
string Required
Description

`4xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

`5xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

PUT

/v3/order/:orderId/part_bulk

curl https://api.shopmonkey.cloud/v3/order/:orderId/part_bulk \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -X PUT -H 'Content-Type: application/json' \
  --data '{}'

Example Response
application/json

{
  "success": true,
  "data": {
    "order": {
      "id": "id",
      "publicId": "publicId",
      "createdDate": "createdDate",
      "updatedDate": null,
      "companyId": "companyId",
      "locationId": "locationId",
      "number": "number",
      "vehicleId": null,
      "phoneNumberId": null,
      "emailId": null,
      "customerId": null,
      "name": null,
      "generatedName": null,
      "coalescedName": null,
      "complaint": null,
      "recommendation": null,
      "purchaseOrderNumber": null,
      "generatedVehicleName": null,
      "generatedCustomerName": null,
      "orderCreatedDate": "orderCreatedDate",
      "archived": true,
      "authorized": true,
      "authorizedDate": null,
      "invoiced": true,
      "sentToCarfax": true,
      "inspectionStatus": "inspectionStatus",
      "inspectionCount": 1,
      "invoicedDate": null,
      "paid": true,
      "appointmentDates": "2023-12-19T16:28:46.112Z",
      "assignedTechnicianIds": [
        "assignedTechnicianIds"
      ],
      "messageCount": 1,
      "shopUnreadMessageCount": 1,
      "totalCostCents": 1,
      "paidCostCents": 1,
      "remainingCostCents": null,
      "partsCents": 1,
      "tiresCents": 1,
      "laborCents": 1,
      "subcontractsCents": 1,
      "epaCents": 1,
      "discountCents": 1,
      "discountPercent": 1,
      "shopSuppliesCents": 1,
      "feesCents": 1,
      "taxCents": 1,
      "gstCents": 1,
      "pstCents": 1,
      "hstCents": 1,
      "transactionalFeeTotalCents": 1,
      "transactionalFeeSubtotalCents": 1,
      "requestedDepositCents": 1,
      "workflowStatusId": "workflowStatusId",
      "workflowStatusPosition": 1,
      "workflowStatusDate": "workflowStatusDate",
      "taxConfigId": "taxConfigId",
      "transactionFeeConfigId": null,
      "dueDate": null,
      "serviceWriterId": null,
      "mileageIn": null,
      "mileageOut": null,
      "conversationId": null,
      "completedDate": null,
      "deleted": true,
      "deletedUserId": null,
      "deletedDate": null,
      "deletedReason": null,
      "readOnly": true,
      "readOnlyReason": null,
      "deferredServiceCount": 1,
      "statementId": null,
      "fullyPaidDate": null,
      "messagedDate": null,
      "paymentTermId": "paymentTermId",
      "paymentDueDate": null,
      "allowCollectPayment": true,
      "allowCustomerAuthorization": true,
      "allowCustomerViewMessages": true,
      "allowCustomerViewAuthorizations": true,
      "allowCustomerViewActivity": true,
      "requireESignatureOnAuthorization": true,
      "requireESignatureOnInvoice": true,
      "updatedSinceSignedInvoice": true,
      "appointments": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "name": "name",
          "startDate": "startDate",
          "endDate": "endDate",
          "duration": null,
          "rruleset": null,
          "customerId": null,
          "note": "note",
          "vehicleId": null,
          "orderId": null,
          "color": "color",
          "useEmail": true,
          "useSMS": true,
          "sendConfirmation": true,
          "sendReminder": true,
          "cancelationNote": null,
          "allDay": true,
          "removedFromRecurrency": true,
          "customerEmailId": null,
          "customerPhoneNumberId": null,
          "locationId": "locationId",
          "confirmationSubject": null,
          "confirmationText": null,
          "reminderSubject": null,
          "reminderText": null,
          "confirmationStatus": "confirmationStatus"
        }
      ],
      "authorizations": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "locationId": "locationId",
          "orderId": "orderId",
          "date": "date",
          "serviceWriterId": null,
          "customerId": null,
          "method": "method",
          "authorizedCostCents": 1,
          "note": "note"
        }
      ],
      "customFields": {},
      "customer": {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "customerType": "customerType",
        "firstName": null,
        "lastName": null,
        "companyName": null,
        "address1": null,
        "address2": null,
        "city": null,
        "state": null,
        "country": null,
        "postalCode": null,
        "dotNumber": null,
        "paymentTermId": null,
        "note": "note",
        "marketingOptIn": true,
        "preferredContactMethod": null,
        "referralSourceId": null,
        "taxExempt": true,
        "discountPercent": 1,
        "laborRateId": null,
        "laborMatrixId": null,
        "pricingMatrixId": null,
        "fleetId": null,
        "lastTimeOrderWorked": null,
        "statementCount": 1,
        "transactionCount": 1,
        "deferredServiceCount": 1,
        "appointmentCount": 1,
        "messageCount": 1,
        "website": null,
        "normalizedFirstName": null,
        "normalizedLastName": null,
        "normalizedName": null,
        "vehicleCount": 1,
        "orderCount": 1,
        "finixIdentityId": null,
        "deleted": true,
        "deletedUserId": null,
        "deletedDate": null,
        "deletedReason": null,
        "labelConnections": [
          {
            "label": {
              "id": "id",
              "name": "name",
              "color": "color",
              "entity": "entity",
              "saved": true
            }
          }
        ],
        "customFields": {},
        "emails": [
          {
            "id": "id",
            "email": "email",
            "primary": true
          }
        ],
        "phoneNumbers": [
          {
            "id": "id",
            "number": "number",
            "extension": null,
            "type": null,
            "userDefinedType": null,
            "primary": true
          }
        ]
      },
      "inspections": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "locationId": "locationId",
          "orderId": "orderId",
          "name": "name",
          "createdById": null,
          "templateId": null,
          "completed": true,
          "completedDate": null,
          "completedById": null,
          "ordinal": 1
        }
      ],
      "labelConnections": [
        {
          "label": {
            "id": "id",
            "name": "name",
            "color": "color",
            "entity": "entity",
            "saved": true
          }
        }
      ],
      "paymentTerm": {
        "id": "id",
        "name": "name"
      },
      "profitability": {
        "labor": {
          "discountCents": 1,
          "discountPercent": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "parts": {
          "discountCents": 1,
          "discountPercent": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "subcontracts": {
          "discountCents": 1,
          "discountPercent": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "tires": {
          "discountCents": 1,
          "discountPercent": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "totalDiscountCents": 1,
        "totalDiscountPercent": 1,
        "totalProfitCents": 1,
        "totalProfitPercent": 1,
        "totalRetailCents": 1,
        "totalWholesaleCents": 1
      },
      "services": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "locationId": "locationId",
          "name": "name",
          "note": "note",
          "orderId": "orderId",
          "lumpSum": true,
          "recommended": true,
          "epaPercent": 1,
          "epaCents": 1,
          "epaValueType": "epaValueType",
          "discountCents": 1,
          "discountPercent": 1,
          "discountValueType": "discountValueType",
          "taxCents": 1,
          "taxPercent": 1,
          "taxValueType": "taxValueType",
          "gstCents": 1,
          "gstPercent": 1,
          "gstValueType": "gstValueType",
          "pstCents": 1,
          "pstPercent": 1,
          "pstValueType": "pstValueType",
          "hstCents": 1,
          "hstPercent": 1,
          "hstValueType": "hstValueType",
          "shopSuppliesApplied": true,
          "shopSuppliesCents": 1,
          "shopSuppliesPercent": 1,
          "shopSuppliesValueType": "shopSuppliesValueType",
          "authorizationStatus": "authorizationStatus",
          "calculatedPartsCents": 1,
          "calculatedTiresCents": 1,
          "calculatedLaborCents": 1,
          "calculatedSubcontractsCents": 1,
          "calculatedFeeCents": 1,
          "calculatedEpaCents": 1,
          "calculatedDiscountCents": 1,
          "calculatedDiscountPercent": 1,
          "calculatedShopSuppliesCents": 1,
          "calculatedTaxCents": 1,
          "ordinal": 1,
          "hidden": true,
          "totalCents": 1,
          "sourceServiceId": null,
          "deferredDate": null,
          "deferredReason": null,
          "excludedFromDeferred": true,
          "revived": true,
          "revivedFromId": null,
          "lineItemInventoryStatus": "lineItemInventoryStatus",
          "motorApplicationId": null,
          "fees": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "companyId": "companyId",
              "locationId": "locationId",
              "serviceId": "serviceId",
              "orderId": "orderId",
              "feeType": "feeType",
              "percent": 1,
              "amountCents": 1,
              "subtotalCents": null,
              "lineItemEntity": null,
              "partId": null,
              "laborId": null,
              "subcontractId": null,
              "tireId": null,
              "name": "name",
              "ordinal": 1,
              "categoryId": null,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              }
            }
          ],
          "labors": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "companyId": "companyId",
              "locationId": "locationId",
              "serviceId": "serviceId",
              "orderId": "orderId",
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "name": null,
              "hours": 1,
              "rateCents": 1,
              "rateId": null,
              "technicianId": null,
              "showHours": true,
              "showNote": true,
              "ordinal": 1,
              "costHours": null,
              "costRateCents": null,
              "costTotalCents": null,
              "multiplier": 1,
              "multiplierType": "multiplierType",
              "note": "note",
              "completed": true,
              "completedDate": null,
              "categoryId": null,
              "skillRequired": null,
              "skillRequiredDescription": null,
              "taxable": true,
              "laborMatrixId": null,
              "laborMatrixDate": null,
              "applicationId": null,
              "motorApplicationId": null,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              },
              "laborMatrix": {
                "id": "id",
                "name": "name"
              },
              "laborRate": {
                "id": "id",
                "name": "name"
              }
            }
          ],
          "parts": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "companyId": "companyId",
              "locationId": "locationId",
              "serviceId": "serviceId",
              "orderId": "orderId",
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "quantity": 1,
              "retailCostCents": 1,
              "wholesaleCostCents": null,
              "showNote": true,
              "showPartNumber": true,
              "showCostAndQuantity": true,
              "reduceInventoryCount": true,
              "reserved": true,
              "inventoryStatus": "inventoryStatus",
              "taxable": true,
              "ordinal": 1,
              "name": "name",
              "note": "note",
              "partNumber": null,
              "binLocation": "binLocation",
              "vendorId": null,
              "inventoryPartId": null,
              "categoryId": null,
              "pricingMatrixId": null,
              "pricingMatrixDate": null,
              "sourceItemId": null,
              "motorApplicationId": null,
              "purchaseOrderPartId": null,
              "purchaseStatus": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              },
              "pricingMatrix": {
                "id": "id",
                "name": "name"
              },
              "vendor": {
                "id": "id",
                "name": "name"
              },
              "inventoryPart": {
                "availableQuantity": 1,
                "id": "id",
                "minCriticalQuantity": 1,
                "name": "name",
                "quantity": 1,
                "retailCostCents": 1
              }
            }
          ],
          "subcontracts": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "locationId": "locationId",
              "companyId": "companyId",
              "name": "name",
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "taxable": true,
              "costCents": 1,
              "retailCostCents": 1,
              "showNote": true,
              "note": null,
              "vendorId": null,
              "serviceId": "serviceId",
              "orderId": "orderId",
              "ordinal": 1,
              "categoryId": null,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              },
              "vendor": {
                "id": "id",
                "name": "name"
              }
            }
          ],
          "tires": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "locationId": "locationId",
              "companyId": "companyId",
              "name": "name",
              "note": null,
              "pricingMatrixId": null,
              "pricingMatrixDate": null,
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "quantity": 1,
              "retailCostCents": 1,
              "wholesaleCostCents": null,
              "ordinal": 1,
              "sizeFormat": "sizeFormat",
              "size": null,
              "partNumber": null,
              "binLocation": null,
              "tireModelId": null,
              "taxable": true,
              "showPartNumber": true,
              "showPriceAndQuantity": true,
              "showNote": true,
              "serviceId": "serviceId",
              "orderId": "orderId",
              "reduceInventoryCount": true,
              "reserved": true,
              "inventoryStatus": "inventoryStatus",
              "federalExciseTaxCents": 1,
              "wasteTireFee": 1,
              "purchaseOrderTireId": null,
              "purchaseStatus": null,
              "sourceItemId": null,
              "inventoryTireId": null,
              "tireIdentificationNumbers": [
                "tireIdentificationNumbers"
              ],
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "pricingMatrix": {
                "id": "id",
                "name": "name"
              },
              "inventoryTire": {
                "availableQuantity": 1,
                "id": "id",
                "minCriticalQuantity": 1,
                "name": "name",
                "quantity": 1,
                "retailCostCents": 1
              }
            }
          ]
        }
      ],
      "vehicle": {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "size": "size",
        "type": null,
        "year": null,
        "make": null,
        "makeId": null,
        "model": null,
        "modelId": null,
        "submodel": null,
        "submodelId": null,
        "engine": null,
        "productionDate": null,
        "transmission": null,
        "drivetrain": null,
        "bodyStyle": null,
        "bedLength": null,
        "vin": null,
        "color": null,
        "unit": null,
        "mileage": null,
        "mileageUnit": "mileageUnit",
        "odometer": true,
        "licensePlate": null,
        "licensePlateState": null,
        "licensePlateCountry": "licensePlateCountry",
        "note": "note",
        "vcdbVehicleId": null,
        "ownerCount": 1,
        "orderCount": 1,
        "appointmentCount": 1,
        "tirePressureLogCount": 1,
        "mileageLogCount": 1,
        "deferredServiceCount": 1,
        "messageCount": 1,
        "computed_ymm": null,
        "customPhoto": true,
        "stockPhoto": true,
        "deleted": true,
        "deletedUserId": null,
        "deletedDate": null,
        "deletedReason": null,
        "labelConnections": [
          {
            "label": {
              "id": "id",
              "name": "name",
              "color": "color",
              "entity": "entity",
              "saved": true
            }
          }
        ],
        "customFields": {},
        "tirePressureLogs": [
          {
            "id": "id",
            "createdDate": "createdDate",
            "updatedDate": null,
            "companyId": "companyId",
            "locationId": "locationId",
            "orderId": "orderId",
            "vehicleId": "vehicleId",
            "frontLeft": null,
            "frontRight": null,
            "rearLeft": null,
            "rearRight": null
          }
        ]
      },
      "workflowStatus": {
        "id": "id",
        "name": null
      }
    }
  }
}

PUT/v3/order/:orderId/bulk_reserve

Reserve multiple parts and tires

Reserve multiple parts and tires on an order

URL parameters

Name
orderId
Type
string Required
Description
the id for the order

Body parameters

Consumes

The following content type is required: application/json

Name
parts
Type
array
Description
Name
tires
Type
array
Description

Produces

The response content type: application/json

`200` Response

Name
code
Type
string
Description
The error code
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if success = false
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message
Name
data
Type
object Required
Description

Properties for `data` object

Name
order
Type
object Required
Description
Order schema

Properties for `order` object

Name
id
Type
string Required
Description
Name
publicId
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
locationId
Type
string Required
Description
Name
number
Type
string Required
Description
Name
externalNumber
Type
string Required
Description
allow user to override generated number
Name
vehicleId
Type
string Required
Description
Name
phoneNumberId
Type
string Required
Description
id of the phone number to use instead of the customer's default number
Name
emailId
Type
string Required
Description
id of the email to use instead of the customer's default email
Name
customerId
Type
string Required
Description
Name
name
Type
string Required
Description
Name
generatedName
Type
string Required
Description
Name
coalescedName
Type
string Required
Description
Name
complaint
Type
string Required
Description
Name
recommendation
Type
string Required
Description
Name
purchaseOrderNumber
Type
string Required
Description
Name
generatedVehicleName
Type
string Required
Description
"[year] [make] [model] [submodel]" pulled from the vehicle, if any
Name
generatedCustomerName
Type
string Required
Description
"[firstName] [lastName]" pulled from the customer, if any
Name
orderCreatedDate
Type
string Required
Description
allow user to override created date
Name
archived
Type
boolean Required
Description
Name
authorized
Type
boolean Required
Description
Name
authorizedDate
Type
string Required
Description
Name
invoiced
Type
boolean Required
Description
Name
sentToCarfax
Type
boolean Required
Description
Name
inspectionStatus
Type
one of: None, Completed, NotCompleted Required
Description
Name
inspectionCount
Type
integer Required
Description
Name
invoicedDate
Type
string Required
Description
Name
paid
Type
boolean Required
Description
Name
appointmentDates
Type
array Required
Description
Name
assignedTechnicianIds
Type
array Required
Description
Name
completedAuthorizedLaborHours
Type
number Required
Description
Name
completedLaborHours
Type
number Required
Description
Name
totalAuthorizedLaborHours
Type
number Required
Description
Name
totalLaborHours
Type
number Required
Description
Name
messageCount
Type
integer Required
Description
Name
shopUnreadMessageCount
Type
integer Required
Description
Name
totalCostCents
Type
integer Required
Description
Name
paidCostCents
Type
integer Required
Description
Name
remainingCostCents
Type
integer Required
Description
Name
partsCents
Type
integer Required
Description
Name
tiresCents
Type
integer Required
Description
Name
laborCents
Type
integer Required
Description
Name
subcontractsCents
Type
integer Required
Description
Name
epaCents
Type
integer Required
Description
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
feesCents
Type
integer Required
Description
Name
taxCents
Type
integer Required
Description
Name
gstCents
Type
integer Required
Description
Name
pstCents
Type
integer Required
Description
Name
hstCents
Type
integer Required
Description
Name
transactionalFeeTotalCents
Type
integer Required
Description
Name
transactionalFeeSubtotalCents
Type
integer Required
Description
// value before taxes
Name
requestedDepositCents
Type
integer Required
Description
Name
workflowStatusId
Type
string Required
Description
Name
workflowStatusPosition
Type
number Required
Description
Name
workflowStatusDate
Type
string Required
Description
Name
taxConfigId
Type
string Required
Description
Name
transactionFeeConfigId
Type
string Required
Description
Name
dueDate
Type
string Required
Description
Name
serviceWriterId
Type
string Required
Description
Name
mileageIn
Type
number Required
Description
Name
mileageOut
Type
number Required
Description
Name
conversationId
Type
string Required
Description
Name
completedDate
Type
string Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
readOnly
Type
boolean Required
Description
if this order should not be editable in the UI
Name
readOnlyReason
Type
string Required
Description
a friendly explanation of why (eg. "migrated from previous system")
Name
deferredServiceCount
Type
integer Required
Description
Name
statementId
Type
string Required
Description
a statement this order included in
Name
fullyPaidDate
Type
string Required
Description
Name
messagedDate
Type
string Required
Description
Name
paymentTermId
Type
string Required
Description
id of the payment term for the order
Name
paymentDueDate
Type
string Required
Description
Name
allowCollectPayment
Type
boolean Required
Description
Name
allowCustomerAuthorization
Type
boolean Required
Description
Name
allowCustomerViewMessages
Type
boolean Required
Description
Name
allowCustomerViewAuthorizations
Type
boolean Required
Description
Name
allowCustomerViewInspections
Type
boolean Required
Description
Name
allowCustomerViewActivity
Type
boolean Required
Description
Name
requireESignatureOnAuthorization
Type
boolean Required
Description
Name
requireESignatureOnInvoice
Type
boolean Required
Description
Name
updatedSinceSignedInvoice
Type
boolean Required
Description
Name
labels
Type
object Required
Description
Name
imported
Type
boolean Required
Description
Name
status
Type
one of: Estimate, RepairOrder, Invoice Required
Description
Name
repairOrderDate
Type
string Required
Description
// the date the order was moved into repair order status
Name
workflowStatusDuration
Type
object Required
Description
Stores how many time the order has been in each status
Name
appointments
Type
array Required
Description
Deprecated: will return []
Name
authorizations
Type
array Required
Description
Deprecated: will return []
Name
customFields
Type
object
Description
custom fields as JSON object
Name
customer
Type
object Required
Description
Name
files
Type
array
Description
Name
inspections
Type
array Required
Description
Deprecated: will return []
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
paymentTerm
Type
object Required
Description
Name
profitability
Type
object Required
Description
Name
services
Type
array Required
Description
Soon will be deprecated!
Name
vehicle
Type
object Required
Description
Name
workflowStatus
Type
object Required
Description
WorkflowStatus schema

Properties for `customer` object

Name
id
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
locationIds
Type
array Required
Description
Name
customerType
Type
one of: Customer, Fleet Required
Description
Name
firstName
Type
string Required
Description
Name
lastName
Type
string Required
Description
Name
companyName
Type
string Required
Description
Name
address1
Type
string Required
Description
Name
address2
Type
string Required
Description
Name
city
Type
string Required
Description
Name
state
Type
string Required
Description
Name
country
Type
one of: US, CA, MX, AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BQ, BA, BW, BV, BR, IO, VG, BN, BG, BF, BI, CV, KH, CM, KY, CF, TD, CL, CN, HK, MO, CX, CC, CO, KM, CG, CK, CR, HR, CU, CW, CY, CZ, CI, KP, CD, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, SZ, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, VA, HN, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, JM, JP, JE, JO, KZ, KE, KI, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, FM, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, NC, NZ, NI, NE, NG, NU, NF, MP, NO, OM, PK, PW, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, KR, MD, RO, RU, RW, RE, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SK, SI, SB, SO, ZA, GS, SS, ES, LK, PS, SD, SR, SJ, SE, CH, SY, TW, TJ, TH, MK, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, GB, TZ, UM, VI, UY, UZ, VU, VE, VN, WF, EH, YE, ZM, ZW Required
Description
Name
postalCode
Type
string Required
Description
Name
dotNumber
Type
string Required
Description
Name
paymentTermId
Type
string Required
Description
Name
publicId
Type
string Required
Description
Name
note
Type
string Required
Description
Name
marketingOptIn
Type
boolean Required
Description
Name
preferredContactMethod
Type
one of: SMS, Email, All Required
Description
Name
preferredLanguage
Type
one of: en, en_US, fr_CA Required
Description
Name
referralSourceId
Type
string Required
Description
Name
taxExempt
Type
boolean Required
Description
US specific
Name
gstExempt
Type
boolean Required
Description
CA specific
Name
hstExempt
Type
boolean Required
Description
CA specific
Name
pstExempt
Type
boolean Required
Description
CA specific
Name
discountPercent
Type
number Required
Description
Name
laborRateId
Type
string Required
Description
Name
laborMatrixId
Type
string Required
Description
Name
pricingMatrixId
Type
string Required
Description
Name
fleetId
Type
string Required
Description
Name
lastTimeOrderWorked
Type
string Required
Description
Name
statementCount
Type
integer Required
Description
Name
transactionCount
Type
integer Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
messageCount
Type
integer Required
Description
Name
website
Type
string Required
Description
Name
normalizedFirstName
Type
string Required
Description
Name
normalizedLastName
Type
string Required
Description
Name
normalizedName
Type
string Required
Description
if fleet, contains the normalized companyName, else normalized firstName lastName
Name
coalescedFirstNameOrCompanyName
Type
string Required
Description
Name
vehicleCount
Type
integer Required
Description
Name
orderCount
Type
integer Required
Description
Name
finixIdentityId
Type
string Required
Description
Name
labels
Type
object Required
Description
Name
externalId
Type
string Required
Description
an id that can be used to reference the customer in an external system
Name
originLocationId
Type
string Required
Description
the location that created the customer
Name
imported
Type
boolean Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
customFields
Type
object
Description
custom fields as JSON object
Name
emails
Type
array Required
Description
Name
phoneNumbers
Type
array Required
Description

Properties for `paymentTerm` object

Name
id
Type
string Required
Description
Name
name
Type
string Required
Description

Properties for `profitability` object

Name
labor
Type
object Required
Description
Name
parts
Type
object Required
Description
Name
subcontracts
Type
object Required
Description
Name
tires
Type
object Required
Description
Name
totalDiscountCents
Type
number Required
Description
Name
totalDiscountPercent
Type
number Required
Description
Name
totalProfitCents
Type
number Required
Description
Name
totalProfitPercent
Type
number Required
Description
Name
totalRetailCents
Type
number Required
Description
Name
totalWholesaleCents
Type
number Required
Description

Properties for `labor` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `parts` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `subcontracts` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `tires` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `vehicle` object

Name
id
Type
string Required
Description
()
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
locationIds
Type
array Required
Description
Name
baseId
Type
integer Required
Description
vcdb base id
Name
size
Type
one of: HeavyDuty, LightDuty, Other Required
Description
Name
preferredLaborGuide
Type
one of: HeavyDuty, LightDuty, Other Required
Description
Name
type
Type
one of: ATV, Bicycle, BigRig, Boat, ClassAMotorhome, ClassCMotorhome, Convertible, Coupe, FifthWheel, Hatchback, Jeep, Motorcycle, Other, PopUp, RV, SUV, Sedan, Trailer, TravelTrailer, Truck, TruckCamper, UTV, Van, Wagon Required
Description
Name
year
Type
integer Required
Description
Name
make
Type
string Required
Description
holds Hull make for vessel
Name
makeId
Type
integer Required
Description
vcdb make id
Name
model
Type
string Required
Description
Name
modelId
Type
integer Required
Description
vcdb model id
Name
submodel
Type
string Required
Description
Name
submodelId
Type
integer Required
Description
vcdb submodel id
Name
engine
Type
string Required
Description
Name
engineId
Type
integer Required
Description
vcdb engine id
Name
productionDate
Type
string Required
Description
Name
transmission
Type
one of: Automatic, Manual, AutomaticCVT, AutomaticDualClutch Required
Description
Name
transmissionId
Type
integer Required
Description
vcdb transmission id
Name
transmissionSpeed
Type
string Required
Description
Name
transmissionMfrCode
Type
string Required
Description
Name
drivetrain
Type
one of: RWD, FWD, FourWD, AWD Required
Description
Name
drivetype
Type
string Required
Description
Name
drivetypeId
Type
integer Required
Description
vcdb drivetype id
Name
bodyStyle
Type
string Required
Description
Name
bodyStyleId
Type
integer Required
Description
vcdb body style id
Name
bedLength
Type
string Required
Description
Name
configurationStatus
Type
one of: Custom, Incomplete, Invalid, NotSupported, Valid Required
Description
Name
vin
Type
string Required
Description
Name
color
Type
one of: White, Silver, Gray, Black, Blue, Red, Brown, Burgundy, Tan, Gold, Green, Yellow, Orange, Pink, Purple, Other Required
Description
Name
unit
Type
string Required
Description
Name
mileage
Type
number Required
Description
Name
mileageUnit
Type
one of: Mile, Kilometer Required
Description
Name
odometer
Type
boolean Required
Description
Name
licensePlate
Type
string Required
Description
Name
licensePlateState
Type
string Required
Description
Name
licensePlateCountry
Type
one of: US, CA, MX, AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BQ, BA, BW, BV, BR, IO, VG, BN, BG, BF, BI, CV, KH, CM, KY, CF, TD, CL, CN, HK, MO, CX, CC, CO, KM, CG, CK, CR, HR, CU, CW, CY, CZ, CI, KP, CD, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, SZ, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, VA, HN, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, JM, JP, JE, JO, KZ, KE, KI, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, FM, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, NC, NZ, NI, NE, NG, NU, NF, MP, NO, OM, PK, PW, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, KR, MD, RO, RU, RW, RE, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SK, SI, SB, SO, ZA, GS, SS, ES, LK, PS, SD, SR, SJ, SE, CH, SY, TW, TJ, TH, MK, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, GB, TZ, UM, VI, UY, UZ, VU, VE, VN, WF, EH, YE, ZM, ZW Required
Description
Name
note
Type
string Required
Description
Name
vcdbVehicleId
Type
string Required
Description
Name
ownerCount
Type
integer Required
Description
Name
orderCount
Type
integer Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
tirePressureLogCount
Type
integer Required
Description
Name
mileageLogCount
Type
integer Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
messageCount
Type
integer Required
Description
Name
computed_ymm
Type
string Required
Description
Name
customPhoto
Type
boolean Required
Description
Name
stockPhoto
Type
boolean Required
Description
Name
labels
Type
object Required
Description
Name
externalId
Type
string Required
Description
an id that can be used to reference the vehicle in an external system
Name
originLocationId
Type
string Required
Description
the location that created the vehicle
Name
imported
Type
boolean Required
Description
Name
length
Type
number Required
Description
Name
lengthUnit
Type
one of: Ft, M Required
Description
Name
hin
Type
string Required
Description
Vessel hull identification number
Name
serial
Type
string Required
Description
Name
name
Type
string Required
Description
Custom vehicle name / Vessel registered name
Name
coalescedVINorHIN
Type
string Required
Description
Name
lastServicedDate
Type
string Required
Description
Name
frontTireSize
Type
string Required
Description
custom front tire size override value
Name
rearTireSize
Type
string Required
Description
custom rear tire size override value
Name
drivingCondition
Type
one of: Normal, Severe Required
Description
Name
engines
Type
object Required
Description
an array of engines { id: string; make: string; model: string; hours: number; noHoursMeter: boolean; horsepower: number; serial: string; productionYear: number; productionMonth: number; }
Name
engineHoursLogs
Type
object Required
Description
an array of engine hours logs { engineId: string; inHours: number; outHours: number; orderId: string; }
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
customFields
Type
object
Description
custom fields as JSON object
Name
tirePressureLogs
Type
array
Description

Properties for `workflowStatus` object

Name
id
Type
string Required
Description
Name
name
Type
string Required
Description

`4xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

`5xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

PUT

/v3/order/:orderId/bulk_reserve

curl https://api.shopmonkey.cloud/v3/order/:orderId/bulk_reserve \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -X PUT -H 'Content-Type: application/json' \
  --data '{}'

Example Response
application/json

{
  "success": true,
  "data": {
    "order": {
      "id": "id",
      "publicId": "publicId",
      "createdDate": "createdDate",
      "updatedDate": null,
      "companyId": "companyId",
      "locationId": "locationId",
      "number": "number",
      "vehicleId": null,
      "phoneNumberId": null,
      "emailId": null,
      "customerId": null,
      "name": null,
      "generatedName": null,
      "coalescedName": null,
      "complaint": null,
      "recommendation": null,
      "purchaseOrderNumber": null,
      "generatedVehicleName": null,
      "generatedCustomerName": null,
      "orderCreatedDate": "orderCreatedDate",
      "archived": true,
      "authorized": true,
      "authorizedDate": null,
      "invoiced": true,
      "sentToCarfax": true,
      "inspectionStatus": "inspectionStatus",
      "inspectionCount": 1,
      "invoicedDate": null,
      "paid": true,
      "appointmentDates": "2023-12-19T16:28:46.112Z",
      "assignedTechnicianIds": [
        "assignedTechnicianIds"
      ],
      "messageCount": 1,
      "shopUnreadMessageCount": 1,
      "totalCostCents": 1,
      "paidCostCents": 1,
      "remainingCostCents": null,
      "partsCents": 1,
      "tiresCents": 1,
      "laborCents": 1,
      "subcontractsCents": 1,
      "epaCents": 1,
      "discountCents": 1,
      "discountPercent": 1,
      "shopSuppliesCents": 1,
      "feesCents": 1,
      "taxCents": 1,
      "gstCents": 1,
      "pstCents": 1,
      "hstCents": 1,
      "transactionalFeeTotalCents": 1,
      "transactionalFeeSubtotalCents": 1,
      "requestedDepositCents": 1,
      "workflowStatusId": "workflowStatusId",
      "workflowStatusPosition": 1,
      "workflowStatusDate": "workflowStatusDate",
      "taxConfigId": "taxConfigId",
      "transactionFeeConfigId": null,
      "dueDate": null,
      "serviceWriterId": null,
      "mileageIn": null,
      "mileageOut": null,
      "conversationId": null,
      "completedDate": null,
      "deleted": true,
      "deletedUserId": null,
      "deletedDate": null,
      "deletedReason": null,
      "readOnly": true,
      "readOnlyReason": null,
      "deferredServiceCount": 1,
      "statementId": null,
      "fullyPaidDate": null,
      "messagedDate": null,
      "paymentTermId": "paymentTermId",
      "paymentDueDate": null,
      "allowCollectPayment": true,
      "allowCustomerAuthorization": true,
      "allowCustomerViewMessages": true,
      "allowCustomerViewAuthorizations": true,
      "allowCustomerViewActivity": true,
      "requireESignatureOnAuthorization": true,
      "requireESignatureOnInvoice": true,
      "updatedSinceSignedInvoice": true,
      "appointments": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "name": "name",
          "startDate": "startDate",
          "endDate": "endDate",
          "duration": null,
          "rruleset": null,
          "customerId": null,
          "note": "note",
          "vehicleId": null,
          "orderId": null,
          "color": "color",
          "useEmail": true,
          "useSMS": true,
          "sendConfirmation": true,
          "sendReminder": true,
          "cancelationNote": null,
          "allDay": true,
          "removedFromRecurrency": true,
          "customerEmailId": null,
          "customerPhoneNumberId": null,
          "locationId": "locationId",
          "confirmationSubject": null,
          "confirmationText": null,
          "reminderSubject": null,
          "reminderText": null,
          "confirmationStatus": "confirmationStatus"
        }
      ],
      "authorizations": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "locationId": "locationId",
          "orderId": "orderId",
          "date": "date",
          "serviceWriterId": null,
          "customerId": null,
          "method": "method",
          "authorizedCostCents": 1,
          "note": "note"
        }
      ],
      "customFields": {},
      "customer": {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "customerType": "customerType",
        "firstName": null,
        "lastName": null,
        "companyName": null,
        "address1": null,
        "address2": null,
        "city": null,
        "state": null,
        "country": null,
        "postalCode": null,
        "dotNumber": null,
        "paymentTermId": null,
        "note": "note",
        "marketingOptIn": true,
        "preferredContactMethod": null,
        "referralSourceId": null,
        "taxExempt": true,
        "discountPercent": 1,
        "laborRateId": null,
        "laborMatrixId": null,
        "pricingMatrixId": null,
        "fleetId": null,
        "lastTimeOrderWorked": null,
        "statementCount": 1,
        "transactionCount": 1,
        "deferredServiceCount": 1,
        "appointmentCount": 1,
        "messageCount": 1,
        "website": null,
        "normalizedFirstName": null,
        "normalizedLastName": null,
        "normalizedName": null,
        "vehicleCount": 1,
        "orderCount": 1,
        "finixIdentityId": null,
        "deleted": true,
        "deletedUserId": null,
        "deletedDate": null,
        "deletedReason": null,
        "labelConnections": [
          {
            "label": {
              "id": "id",
              "name": "name",
              "color": "color",
              "entity": "entity",
              "saved": true
            }
          }
        ],
        "customFields": {},
        "emails": [
          {
            "id": "id",
            "email": "email",
            "primary": true
          }
        ],
        "phoneNumbers": [
          {
            "id": "id",
            "number": "number",
            "extension": null,
            "type": null,
            "userDefinedType": null,
            "primary": true
          }
        ]
      },
      "inspections": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "locationId": "locationId",
          "orderId": "orderId",
          "name": "name",
          "createdById": null,
          "templateId": null,
          "completed": true,
          "completedDate": null,
          "completedById": null,
          "ordinal": 1
        }
      ],
      "labelConnections": [
        {
          "label": {
            "id": "id",
            "name": "name",
            "color": "color",
            "entity": "entity",
            "saved": true
          }
        }
      ],
      "paymentTerm": {
        "id": "id",
        "name": "name"
      },
      "profitability": {
        "labor": {
          "discountCents": 1,
          "discountPercent": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "parts": {
          "discountCents": 1,
          "discountPercent": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "subcontracts": {
          "discountCents": 1,
          "discountPercent": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "tires": {
          "discountCents": 1,
          "discountPercent": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "totalDiscountCents": 1,
        "totalDiscountPercent": 1,
        "totalProfitCents": 1,
        "totalProfitPercent": 1,
        "totalRetailCents": 1,
        "totalWholesaleCents": 1
      },
      "services": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "locationId": "locationId",
          "name": "name",
          "note": "note",
          "orderId": "orderId",
          "lumpSum": true,
          "recommended": true,
          "epaPercent": 1,
          "epaCents": 1,
          "epaValueType": "epaValueType",
          "discountCents": 1,
          "discountPercent": 1,
          "discountValueType": "discountValueType",
          "taxCents": 1,
          "taxPercent": 1,
          "taxValueType": "taxValueType",
          "gstCents": 1,
          "gstPercent": 1,
          "gstValueType": "gstValueType",
          "pstCents": 1,
          "pstPercent": 1,
          "pstValueType": "pstValueType",
          "hstCents": 1,
          "hstPercent": 1,
          "hstValueType": "hstValueType",
          "shopSuppliesApplied": true,
          "shopSuppliesCents": 1,
          "shopSuppliesPercent": 1,
          "shopSuppliesValueType": "shopSuppliesValueType",
          "authorizationStatus": "authorizationStatus",
          "calculatedPartsCents": 1,
          "calculatedTiresCents": 1,
          "calculatedLaborCents": 1,
          "calculatedSubcontractsCents": 1,
          "calculatedFeeCents": 1,
          "calculatedEpaCents": 1,
          "calculatedDiscountCents": 1,
          "calculatedDiscountPercent": 1,
          "calculatedShopSuppliesCents": 1,
          "calculatedTaxCents": 1,
          "ordinal": 1,
          "hidden": true,
          "totalCents": 1,
          "sourceServiceId": null,
          "deferredDate": null,
          "deferredReason": null,
          "excludedFromDeferred": true,
          "revived": true,
          "revivedFromId": null,
          "lineItemInventoryStatus": "lineItemInventoryStatus",
          "motorApplicationId": null,
          "fees": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "companyId": "companyId",
              "locationId": "locationId",
              "serviceId": "serviceId",
              "orderId": "orderId",
              "feeType": "feeType",
              "percent": 1,
              "amountCents": 1,
              "subtotalCents": null,
              "lineItemEntity": null,
              "partId": null,
              "laborId": null,
              "subcontractId": null,
              "tireId": null,
              "name": "name",
              "ordinal": 1,
              "categoryId": null,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              }
            }
          ],
          "labors": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "companyId": "companyId",
              "locationId": "locationId",
              "serviceId": "serviceId",
              "orderId": "orderId",
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "name": null,
              "hours": 1,
              "rateCents": 1,
              "rateId": null,
              "technicianId": null,
              "showHours": true,
              "showNote": true,
              "ordinal": 1,
              "costHours": null,
              "costRateCents": null,
              "costTotalCents": null,
              "multiplier": 1,
              "multiplierType": "multiplierType",
              "note": "note",
              "completed": true,
              "completedDate": null,
              "categoryId": null,
              "skillRequired": null,
              "skillRequiredDescription": null,
              "taxable": true,
              "laborMatrixId": null,
              "laborMatrixDate": null,
              "applicationId": null,
              "motorApplicationId": null,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              },
              "laborMatrix": {
                "id": "id",
                "name": "name"
              },
              "laborRate": {
                "id": "id",
                "name": "name"
              }
            }
          ],
          "parts": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "companyId": "companyId",
              "locationId": "locationId",
              "serviceId": "serviceId",
              "orderId": "orderId",
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "quantity": 1,
              "retailCostCents": 1,
              "wholesaleCostCents": null,
              "showNote": true,
              "showPartNumber": true,
              "showCostAndQuantity": true,
              "reduceInventoryCount": true,
              "reserved": true,
              "inventoryStatus": "inventoryStatus",
              "taxable": true,
              "ordinal": 1,
              "name": "name",
              "note": "note",
              "partNumber": null,
              "binLocation": "binLocation",
              "vendorId": null,
              "inventoryPartId": null,
              "categoryId": null,
              "pricingMatrixId": null,
              "pricingMatrixDate": null,
              "sourceItemId": null,
              "motorApplicationId": null,
              "purchaseOrderPartId": null,
              "purchaseStatus": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              },
              "pricingMatrix": {
                "id": "id",
                "name": "name"
              },
              "vendor": {
                "id": "id",
                "name": "name"
              },
              "inventoryPart": {
                "availableQuantity": 1,
                "id": "id",
                "minCriticalQuantity": 1,
                "name": "name",
                "quantity": 1,
                "retailCostCents": 1
              }
            }
          ],
          "subcontracts": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "locationId": "locationId",
              "companyId": "companyId",
              "name": "name",
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "taxable": true,
              "costCents": 1,
              "retailCostCents": 1,
              "showNote": true,
              "note": null,
              "vendorId": null,
              "serviceId": "serviceId",
              "orderId": "orderId",
              "ordinal": 1,
              "categoryId": null,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              },
              "vendor": {
                "id": "id",
                "name": "name"
              }
            }
          ],
          "tires": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "locationId": "locationId",
              "companyId": "companyId",
              "name": "name",
              "note": null,
              "pricingMatrixId": null,
              "pricingMatrixDate": null,
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "quantity": 1,
              "retailCostCents": 1,
              "wholesaleCostCents": null,
              "ordinal": 1,
              "sizeFormat": "sizeFormat",
              "size": null,
              "partNumber": null,
              "binLocation": null,
              "tireModelId": null,
              "taxable": true,
              "showPartNumber": true,
              "showPriceAndQuantity": true,
              "showNote": true,
              "serviceId": "serviceId",
              "orderId": "orderId",
              "reduceInventoryCount": true,
              "reserved": true,
              "inventoryStatus": "inventoryStatus",
              "federalExciseTaxCents": 1,
              "wasteTireFee": 1,
              "purchaseOrderTireId": null,
              "purchaseStatus": null,
              "sourceItemId": null,
              "inventoryTireId": null,
              "tireIdentificationNumbers": [
                "tireIdentificationNumbers"
              ],
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "pricingMatrix": {
                "id": "id",
                "name": "name"
              },
              "inventoryTire": {
                "availableQuantity": 1,
                "id": "id",
                "minCriticalQuantity": 1,
                "name": "name",
                "quantity": 1,
                "retailCostCents": 1
              }
            }
          ]
        }
      ],
      "vehicle": {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "size": "size",
        "type": null,
        "year": null,
        "make": null,
        "makeId": null,
        "model": null,
        "modelId": null,
        "submodel": null,
        "submodelId": null,
        "engine": null,
        "productionDate": null,
        "transmission": null,
        "drivetrain": null,
        "bodyStyle": null,
        "bedLength": null,
        "vin": null,
        "color": null,
        "unit": null,
        "mileage": null,
        "mileageUnit": "mileageUnit",
        "odometer": true,
        "licensePlate": null,
        "licensePlateState": null,
        "licensePlateCountry": "licensePlateCountry",
        "note": "note",
        "vcdbVehicleId": null,
        "ownerCount": 1,
        "orderCount": 1,
        "appointmentCount": 1,
        "tirePressureLogCount": 1,
        "mileageLogCount": 1,
        "deferredServiceCount": 1,
        "messageCount": 1,
        "computed_ymm": null,
        "customPhoto": true,
        "stockPhoto": true,
        "deleted": true,
        "deletedUserId": null,
        "deletedDate": null,
        "deletedReason": null,
        "labelConnections": [
          {
            "label": {
              "id": "id",
              "name": "name",
              "color": "color",
              "entity": "entity",
              "saved": true
            }
          }
        ],
        "customFields": {},
        "tirePressureLogs": [
          {
            "id": "id",
            "createdDate": "createdDate",
            "updatedDate": null,
            "companyId": "companyId",
            "locationId": "locationId",
            "orderId": "orderId",
            "vehicleId": "vehicleId",
            "frontLeft": null,
            "frontRight": null,
            "rearLeft": null,
            "rearRight": null
          }
        ]
      },
      "workflowStatus": {
        "id": "id",
        "name": null
      }
    }
  }
}

PUT/v3/order/:orderId/service/:serviceId/part/:id

Update Order Line Item

Update an Order Line Item for part

URL parameters

Name
id
Type
string Required
Description
the id for part
Name
orderId
Type
string Required
Description
the id for the order
Name
serviceId
Type
string Required
Description
the id for the service

Query String parameters

Name
includeOrder
Type
boolean
Description
include the updated order in the response (default true)

Body parameters

Consumes

The following content type is required: application/json

Name
serviceId
Type
string
Description
Name
orderId
Type
string
Description
Name
discountCents
Type
integer
Description
Name
discountPercent
Type
number
Description
Name
discountValueType
Type
one of: Percent, FixedCents
Description
Name
quantity
Type
number
Description
Name
retailCostCents
Type
integer
Description
Name
wholesaleCostCents
Type
integer
Description
Name
showNote
Type
boolean
Description
Name
showPartNumber
Type
boolean
Description
Name
showCostAndQuantity
Type
boolean
Description
Name
reduceInventoryCount
Type
boolean
Description
Name
reserved
Type
boolean
Description
Name
inventoryStatus
Type
one of: OnEstimate, InventoryReduced, None
Description
Name
taxable
Type
boolean
Description
US specific
Name
taxableGST
Type
boolean
Description
CA specific
Name
taxableHST
Type
boolean
Description
CA specific
Name
taxablePST
Type
boolean
Description
CA specific
Name
ordinal
Type
number
Description
Name
name
Type
string
Description
Name
note
Type
string
Description
Name
partNumber
Type
string
Description
Name
binLocation
Type
string
Description
Name
vendorId
Type
string
Description
Name
inventoryPartId
Type
string
Description
Name
categoryId
Type
string
Description
Name
pricingMatrixId
Type
string
Description
Name
sourceItemId
Type
string
Description
Name
motorApplicationId
Type
integer
Description
Name
labels
Type
object
Description
Name
url
Type
string
Description
Name
pcDbTerminologyId
Type
integer
Description
product classification database terminology id for aftermarket parts, etc
Name
fixedPriceLimitType
Type
one of: None, Quantity, Price
Description
Name
fixedPriceLimitQuantity
Type
number
Description
Quantities exceeding the amount will be charged based on their individual part price as an addition to the fixed price canned service.
Name
fixedPriceLimitPriceCents
Type
integer
Description
Part prices exceeding the amount will have their difference charged in addition to the fixed price canned service.

Produces

The response content type: application/json

`200` Response

Name
code
Type
string
Description
The error code
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if success = false
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message
Name
data
Type
object Required
Description

Properties for `data` object

Name
order
Type
object
Description
Order schema

Properties for `order` object

Name
id
Type
string Required
Description
Name
publicId
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
locationId
Type
string Required
Description
Name
number
Type
string Required
Description
Name
externalNumber
Type
string Required
Description
allow user to override generated number
Name
vehicleId
Type
string Required
Description
Name
phoneNumberId
Type
string Required
Description
id of the phone number to use instead of the customer's default number
Name
emailId
Type
string Required
Description
id of the email to use instead of the customer's default email
Name
customerId
Type
string Required
Description
Name
name
Type
string Required
Description
Name
generatedName
Type
string Required
Description
Name
coalescedName
Type
string Required
Description
Name
complaint
Type
string Required
Description
Name
recommendation
Type
string Required
Description
Name
purchaseOrderNumber
Type
string Required
Description
Name
generatedVehicleName
Type
string Required
Description
"[year] [make] [model] [submodel]" pulled from the vehicle, if any
Name
generatedCustomerName
Type
string Required
Description
"[firstName] [lastName]" pulled from the customer, if any
Name
orderCreatedDate
Type
string Required
Description
allow user to override created date
Name
archived
Type
boolean Required
Description
Name
authorized
Type
boolean Required
Description
Name
authorizedDate
Type
string Required
Description
Name
invoiced
Type
boolean Required
Description
Name
sentToCarfax
Type
boolean Required
Description
Name
inspectionStatus
Type
one of: None, Completed, NotCompleted Required
Description
Name
inspectionCount
Type
integer Required
Description
Name
invoicedDate
Type
string Required
Description
Name
paid
Type
boolean Required
Description
Name
appointmentDates
Type
array Required
Description
Name
assignedTechnicianIds
Type
array Required
Description
Name
completedAuthorizedLaborHours
Type
number Required
Description
Name
completedLaborHours
Type
number Required
Description
Name
totalAuthorizedLaborHours
Type
number Required
Description
Name
totalLaborHours
Type
number Required
Description
Name
messageCount
Type
integer Required
Description
Name
shopUnreadMessageCount
Type
integer Required
Description
Name
totalCostCents
Type
integer Required
Description
Name
paidCostCents
Type
integer Required
Description
Name
remainingCostCents
Type
integer Required
Description
Name
partsCents
Type
integer Required
Description
Name
tiresCents
Type
integer Required
Description
Name
laborCents
Type
integer Required
Description
Name
subcontractsCents
Type
integer Required
Description
Name
epaCents
Type
integer Required
Description
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
feesCents
Type
integer Required
Description
Name
taxCents
Type
integer Required
Description
Name
gstCents
Type
integer Required
Description
Name
pstCents
Type
integer Required
Description
Name
hstCents
Type
integer Required
Description
Name
transactionalFeeTotalCents
Type
integer Required
Description
Name
transactionalFeeSubtotalCents
Type
integer Required
Description
// value before taxes
Name
requestedDepositCents
Type
integer Required
Description
Name
workflowStatusId
Type
string Required
Description
Name
workflowStatusPosition
Type
number Required
Description
Name
workflowStatusDate
Type
string Required
Description
Name
taxConfigId
Type
string Required
Description
Name
transactionFeeConfigId
Type
string Required
Description
Name
dueDate
Type
string Required
Description
Name
serviceWriterId
Type
string Required
Description
Name
mileageIn
Type
number Required
Description
Name
mileageOut
Type
number Required
Description
Name
conversationId
Type
string Required
Description
Name
completedDate
Type
string Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
readOnly
Type
boolean Required
Description
if this order should not be editable in the UI
Name
readOnlyReason
Type
string Required
Description
a friendly explanation of why (eg. "migrated from previous system")
Name
deferredServiceCount
Type
integer Required
Description
Name
statementId
Type
string Required
Description
a statement this order included in
Name
fullyPaidDate
Type
string Required
Description
Name
messagedDate
Type
string Required
Description
Name
paymentTermId
Type
string Required
Description
id of the payment term for the order
Name
paymentDueDate
Type
string Required
Description
Name
allowCollectPayment
Type
boolean Required
Description
Name
allowCustomerAuthorization
Type
boolean Required
Description
Name
allowCustomerViewMessages
Type
boolean Required
Description
Name
allowCustomerViewAuthorizations
Type
boolean Required
Description
Name
allowCustomerViewInspections
Type
boolean Required
Description
Name
allowCustomerViewActivity
Type
boolean Required
Description
Name
requireESignatureOnAuthorization
Type
boolean Required
Description
Name
requireESignatureOnInvoice
Type
boolean Required
Description
Name
updatedSinceSignedInvoice
Type
boolean Required
Description
Name
labels
Type
object Required
Description
Name
imported
Type
boolean Required
Description
Name
status
Type
one of: Estimate, RepairOrder, Invoice Required
Description
Name
repairOrderDate
Type
string Required
Description
// the date the order was moved into repair order status
Name
workflowStatusDuration
Type
object Required
Description
Stores how many time the order has been in each status
Name
appointments
Type
array Required
Description
Deprecated: will return []
Name
authorizations
Type
array Required
Description
Deprecated: will return []
Name
customFields
Type
object
Description
custom fields as JSON object
Name
customer
Type
object Required
Description
Name
files
Type
array
Description
Name
inspections
Type
array Required
Description
Deprecated: will return []
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
paymentTerm
Type
object Required
Description
Name
profitability
Type
object Required
Description
Name
services
Type
array Required
Description
Soon will be deprecated!
Name
vehicle
Type
object Required
Description
Name
workflowStatus
Type
object Required
Description
WorkflowStatus schema

Properties for `customer` object

Name
id
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
locationIds
Type
array Required
Description
Name
customerType
Type
one of: Customer, Fleet Required
Description
Name
firstName
Type
string Required
Description
Name
lastName
Type
string Required
Description
Name
companyName
Type
string Required
Description
Name
address1
Type
string Required
Description
Name
address2
Type
string Required
Description
Name
city
Type
string Required
Description
Name
state
Type
string Required
Description
Name
country
Type
one of: US, CA, MX, AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BQ, BA, BW, BV, BR, IO, VG, BN, BG, BF, BI, CV, KH, CM, KY, CF, TD, CL, CN, HK, MO, CX, CC, CO, KM, CG, CK, CR, HR, CU, CW, CY, CZ, CI, KP, CD, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, SZ, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, VA, HN, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, JM, JP, JE, JO, KZ, KE, KI, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, FM, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, NC, NZ, NI, NE, NG, NU, NF, MP, NO, OM, PK, PW, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, KR, MD, RO, RU, RW, RE, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SK, SI, SB, SO, ZA, GS, SS, ES, LK, PS, SD, SR, SJ, SE, CH, SY, TW, TJ, TH, MK, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, GB, TZ, UM, VI, UY, UZ, VU, VE, VN, WF, EH, YE, ZM, ZW Required
Description
Name
postalCode
Type
string Required
Description
Name
dotNumber
Type
string Required
Description
Name
paymentTermId
Type
string Required
Description
Name
publicId
Type
string Required
Description
Name
note
Type
string Required
Description
Name
marketingOptIn
Type
boolean Required
Description
Name
preferredContactMethod
Type
one of: SMS, Email, All Required
Description
Name
preferredLanguage
Type
one of: en, en_US, fr_CA Required
Description
Name
referralSourceId
Type
string Required
Description
Name
taxExempt
Type
boolean Required
Description
US specific
Name
gstExempt
Type
boolean Required
Description
CA specific
Name
hstExempt
Type
boolean Required
Description
CA specific
Name
pstExempt
Type
boolean Required
Description
CA specific
Name
discountPercent
Type
number Required
Description
Name
laborRateId
Type
string Required
Description
Name
laborMatrixId
Type
string Required
Description
Name
pricingMatrixId
Type
string Required
Description
Name
fleetId
Type
string Required
Description
Name
lastTimeOrderWorked
Type
string Required
Description
Name
statementCount
Type
integer Required
Description
Name
transactionCount
Type
integer Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
messageCount
Type
integer Required
Description
Name
website
Type
string Required
Description
Name
normalizedFirstName
Type
string Required
Description
Name
normalizedLastName
Type
string Required
Description
Name
normalizedName
Type
string Required
Description
if fleet, contains the normalized companyName, else normalized firstName lastName
Name
coalescedFirstNameOrCompanyName
Type
string Required
Description
Name
vehicleCount
Type
integer Required
Description
Name
orderCount
Type
integer Required
Description
Name
finixIdentityId
Type
string Required
Description
Name
labels
Type
object Required
Description
Name
externalId
Type
string Required
Description
an id that can be used to reference the customer in an external system
Name
originLocationId
Type
string Required
Description
the location that created the customer
Name
imported
Type
boolean Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
customFields
Type
object
Description
custom fields as JSON object
Name
emails
Type
array Required
Description
Name
phoneNumbers
Type
array Required
Description

Properties for `paymentTerm` object

Name
id
Type
string Required
Description
Name
name
Type
string Required
Description

Properties for `profitability` object

Name
labor
Type
object Required
Description
Name
parts
Type
object Required
Description
Name
subcontracts
Type
object Required
Description
Name
tires
Type
object Required
Description
Name
totalDiscountCents
Type
number Required
Description
Name
totalDiscountPercent
Type
number Required
Description
Name
totalProfitCents
Type
number Required
Description
Name
totalProfitPercent
Type
number Required
Description
Name
totalRetailCents
Type
number Required
Description
Name
totalWholesaleCents
Type
number Required
Description

Properties for `labor` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `parts` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `subcontracts` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `tires` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `vehicle` object

Name
id
Type
string Required
Description
()
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
locationIds
Type
array Required
Description
Name
baseId
Type
integer Required
Description
vcdb base id
Name
size
Type
one of: HeavyDuty, LightDuty, Other Required
Description
Name
preferredLaborGuide
Type
one of: HeavyDuty, LightDuty, Other Required
Description
Name
type
Type
one of: ATV, Bicycle, BigRig, Boat, ClassAMotorhome, ClassCMotorhome, Convertible, Coupe, FifthWheel, Hatchback, Jeep, Motorcycle, Other, PopUp, RV, SUV, Sedan, Trailer, TravelTrailer, Truck, TruckCamper, UTV, Van, Wagon Required
Description
Name
year
Type
integer Required
Description
Name
make
Type
string Required
Description
holds Hull make for vessel
Name
makeId
Type
integer Required
Description
vcdb make id
Name
model
Type
string Required
Description
Name
modelId
Type
integer Required
Description
vcdb model id
Name
submodel
Type
string Required
Description
Name
submodelId
Type
integer Required
Description
vcdb submodel id
Name
engine
Type
string Required
Description
Name
engineId
Type
integer Required
Description
vcdb engine id
Name
productionDate
Type
string Required
Description
Name
transmission
Type
one of: Automatic, Manual, AutomaticCVT, AutomaticDualClutch Required
Description
Name
transmissionId
Type
integer Required
Description
vcdb transmission id
Name
transmissionSpeed
Type
string Required
Description
Name
transmissionMfrCode
Type
string Required
Description
Name
drivetrain
Type
one of: RWD, FWD, FourWD, AWD Required
Description
Name
drivetype
Type
string Required
Description
Name
drivetypeId
Type
integer Required
Description
vcdb drivetype id
Name
bodyStyle
Type
string Required
Description
Name
bodyStyleId
Type
integer Required
Description
vcdb body style id
Name
bedLength
Type
string Required
Description
Name
configurationStatus
Type
one of: Custom, Incomplete, Invalid, NotSupported, Valid Required
Description
Name
vin
Type
string Required
Description
Name
color
Type
one of: White, Silver, Gray, Black, Blue, Red, Brown, Burgundy, Tan, Gold, Green, Yellow, Orange, Pink, Purple, Other Required
Description
Name
unit
Type
string Required
Description
Name
mileage
Type
number Required
Description
Name
mileageUnit
Type
one of: Mile, Kilometer Required
Description
Name
odometer
Type
boolean Required
Description
Name
licensePlate
Type
string Required
Description
Name
licensePlateState
Type
string Required
Description
Name
licensePlateCountry
Type
one of: US, CA, MX, AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BQ, BA, BW, BV, BR, IO, VG, BN, BG, BF, BI, CV, KH, CM, KY, CF, TD, CL, CN, HK, MO, CX, CC, CO, KM, CG, CK, CR, HR, CU, CW, CY, CZ, CI, KP, CD, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, SZ, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, VA, HN, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, JM, JP, JE, JO, KZ, KE, KI, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, FM, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, NC, NZ, NI, NE, NG, NU, NF, MP, NO, OM, PK, PW, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, KR, MD, RO, RU, RW, RE, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SK, SI, SB, SO, ZA, GS, SS, ES, LK, PS, SD, SR, SJ, SE, CH, SY, TW, TJ, TH, MK, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, GB, TZ, UM, VI, UY, UZ, VU, VE, VN, WF, EH, YE, ZM, ZW Required
Description
Name
note
Type
string Required
Description
Name
vcdbVehicleId
Type
string Required
Description
Name
ownerCount
Type
integer Required
Description
Name
orderCount
Type
integer Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
tirePressureLogCount
Type
integer Required
Description
Name
mileageLogCount
Type
integer Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
messageCount
Type
integer Required
Description
Name
computed_ymm
Type
string Required
Description
Name
customPhoto
Type
boolean Required
Description
Name
stockPhoto
Type
boolean Required
Description
Name
labels
Type
object Required
Description
Name
externalId
Type
string Required
Description
an id that can be used to reference the vehicle in an external system
Name
originLocationId
Type
string Required
Description
the location that created the vehicle
Name
imported
Type
boolean Required
Description
Name
length
Type
number Required
Description
Name
lengthUnit
Type
one of: Ft, M Required
Description
Name
hin
Type
string Required
Description
Vessel hull identification number
Name
serial
Type
string Required
Description
Name
name
Type
string Required
Description
Custom vehicle name / Vessel registered name
Name
coalescedVINorHIN
Type
string Required
Description
Name
lastServicedDate
Type
string Required
Description
Name
frontTireSize
Type
string Required
Description
custom front tire size override value
Name
rearTireSize
Type
string Required
Description
custom rear tire size override value
Name
drivingCondition
Type
one of: Normal, Severe Required
Description
Name
engines
Type
object Required
Description
an array of engines { id: string; make: string; model: string; hours: number; noHoursMeter: boolean; horsepower: number; serial: string; productionYear: number; productionMonth: number; }
Name
engineHoursLogs
Type
object Required
Description
an array of engine hours logs { engineId: string; inHours: number; outHours: number; orderId: string; }
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
customFields
Type
object
Description
custom fields as JSON object
Name
tirePressureLogs
Type
array
Description

Properties for `workflowStatus` object

Name
id
Type
string Required
Description
Name
name
Type
string Required
Description

`4xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

`5xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

PUT

/v3/order/:orderId/service/:serviceId/part/:id

curl https://api.shopmonkey.cloud/v3/order/:orderId/service/:serviceId/part/:id \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -X PUT -H 'Content-Type: application/json' \
  --data '{}'

Example Response
application/json

{
  "success": true,
  "data": {
    "order": {
      "id": "id",
      "publicId": "publicId",
      "createdDate": "createdDate",
      "updatedDate": null,
      "companyId": "companyId",
      "locationId": "locationId",
      "number": 1,
      "vehicleId": null,
      "phoneNumberId": null,
      "emailId": null,
      "customerId": null,
      "name": null,
      "generatedName": null,
      "coalescedName": null,
      "complaint": null,
      "recommendation": null,
      "purchaseOrderNumber": null,
      "generatedVehicleName": null,
      "generatedCustomerName": null,
      "orderCreatedDate": "orderCreatedDate",
      "archived": true,
      "authorized": true,
      "authorizedDate": null,
      "invoiced": true,
      "sentToCarfax": true,
      "inspectionStatus": "inspectionStatus",
      "inspectionCount": 1,
      "invoicedDate": null,
      "paid": true,
      "appointmentDates": "2023-01-29T16:43:58.402Z",
      "assignedTechnicianIds": [
        "assignedTechnicianIds"
      ],
      "messageCount": 1,
      "shopUnreadMessageCount": 1,
      "totalCostCents": 1,
      "paidCostCents": 1,
      "remainingCostCents": null,
      "partsCents": 1,
      "tiresCents": 1,
      "laborCents": 1,
      "subcontractsCents": 1,
      "epaCents": 1,
      "discountCents": 1,
      "discountPercent": 1,
      "shopSuppliesCents": 1,
      "feesCents": 1,
      "taxCents": 1,
      "gstCents": 1,
      "pstCents": 1,
      "hstCents": 1,
      "workflowStatusId": "workflowStatusId",
      "workflowStatusPosition": 1,
      "taxConfigId": "taxConfigId",
      "dueDate": null,
      "serviceWriterId": null,
      "mileageIn": null,
      "mileageOut": null,
      "conversationId": "conversationId",
      "completedDate": null,
      "deleted": true,
      "deletedUserId": null,
      "deletedDate": null,
      "deletedReason": null,
      "readOnly": true,
      "readOnlyReason": null,
      "deferredServiceCount": 1,
      "statementId": null,
      "customFields": {},
      "profitability": {
        "parts": {
          "discountPercent": 1,
          "discountCents": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "labor": {
          "discountPercent": 1,
          "discountCents": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "subcontracts": {
          "discountPercent": 1,
          "discountCents": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "tires": {
          "discountPercent": 1,
          "discountCents": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "totalProfitPercent": 1,
        "totalProfitCents": 1,
        "totalRetailCents": 1,
        "totalWholesaleCents": 1,
        "totalDiscountCents": 1,
        "totalDiscountPercent": 1
      },
      "labelConnections": [
        {
          "label": {
            "id": "id",
            "name": "name",
            "color": "color",
            "entity": "entity",
            "saved": true
          }
        }
      ],
      "customer": {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "customerType": "customerType",
        "firstName": null,
        "lastName": null,
        "companyName": null,
        "address1": null,
        "address2": null,
        "city": null,
        "state": null,
        "country": null,
        "postalCode": null,
        "dotNumber": null,
        "paymentTermId": "paymentTermId",
        "note": "note",
        "marketingOptIn": true,
        "preferredContactMethod": null,
        "referralSourceId": null,
        "taxExempt": true,
        "discountPercent": 1,
        "laborRateId": null,
        "laborMatrixId": null,
        "pricingMatrixId": null,
        "fleetId": null,
        "lastTimeOrderWorked": null,
        "statementCount": 1,
        "transactionCount": 1,
        "deferredServiceCount": 1,
        "appointmentCount": 1,
        "messageCount": 1,
        "labelConnections": [
          {
            "label": {
              "id": "id",
              "name": "name",
              "color": "color",
              "entity": "entity",
              "saved": true
            }
          }
        ],
        "emails": [
          {
            "id": "id",
            "createdDate": "createdDate",
            "updatedDate": null,
            "locationId": "locationId",
            "companyId": "companyId",
            "email": "email",
            "subscribed": true,
            "customerId": "customerId",
            "primary": true
          }
        ],
        "phoneNumbers": [
          {
            "id": "id",
            "createdDate": "createdDate",
            "updatedDate": null,
            "locationId": "locationId",
            "companyId": "companyId",
            "customerId": "customerId",
            "number": "number",
            "extension": null,
            "country": null,
            "type": null,
            "userDefinedType": null,
            "carrierName": null,
            "optInVerifiedDate": null,
            "optIn": true,
            "lastVerifiedDate": null,
            "primary": true,
            "mobileCountryCode": null,
            "mobileNetworkCode": null
          }
        ],
        "customFields": {}
      },
      "vehicle": {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "size": "size",
        "type": null,
        "year": null,
        "make": null,
        "makeId": null,
        "model": null,
        "modelId": null,
        "submodel": null,
        "submodelId": null,
        "engine": null,
        "productionDate": null,
        "transmission": null,
        "drivetrain": null,
        "vin": null,
        "color": null,
        "unit": null,
        "mileage": null,
        "mileageUnit": "mileageUnit",
        "odometer": true,
        "licensePlate": null,
        "licensePlateState": null,
        "licensePlateCountry": "licensePlateCountry",
        "note": "note",
        "vcdbVehicleId": null,
        "ownerCount": 1,
        "orderCount": 1,
        "appointmentCount": 1,
        "tirePressureLogCount": 1,
        "mileageLogCount": 1,
        "deferredServiceCount": 1,
        "messageCount": 1,
        "customPhoto": true,
        "stockPhoto": true,
        "labelConnections": [
          {
            "label": {
              "id": "id",
              "name": "name",
              "color": "color",
              "entity": "entity",
              "saved": true
            }
          }
        ],
        "tirePressureLogs": [
          {
            "id": "id",
            "createdDate": "createdDate",
            "updatedDate": null,
            "companyId": "companyId",
            "locationId": "locationId",
            "orderId": "orderId",
            "vehicleId": "vehicleId",
            "frontLeft": null,
            "frontRight": null,
            "rearLeft": null,
            "rearRight": null
          }
        ],
        "customFields": {}
      },
      "appointments": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "name": "name",
          "startDate": "startDate",
          "endDate": "endDate",
          "rruleset": null,
          "customerId": null,
          "note": "note",
          "vehicleId": null,
          "orderId": null,
          "color": "color",
          "useEmail": true,
          "useSMS": true,
          "sendConfirmation": true,
          "sendReminder": true,
          "cancelationNote": null,
          "pendingConfirmation": true,
          "confirmed": true,
          "allDay": true,
          "removedFromRecurrency": true,
          "customerEmailId": null,
          "customerPhoneNumberId": null,
          "locationId": "locationId"
        }
      ],
      "inspections": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "locationId": "locationId",
          "orderId": "orderId",
          "name": "name",
          "createdById": null,
          "templateId": null,
          "completed": true,
          "completedDate": null,
          "completedById": null,
          "ordinal": 1
        }
      ],
      "authorizations": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "locationId": "locationId",
          "orderId": "orderId",
          "date": "date",
          "serviceWriterId": null,
          "customerId": null,
          "method": "method",
          "authorizedCostCents": 1,
          "note": "note"
        }
      ],
      "workflowStatus": {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "name": null,
        "position": 1,
        "daysToArchive": 1,
        "archiveWhenInactive": true,
        "invoiceWorkflow": true
      },
      "services": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "locationId": "locationId",
          "name": "name",
          "note": "note",
          "orderId": "orderId",
          "lumpSum": true,
          "recommended": true,
          "epaPercent": 1,
          "epaCents": 1,
          "epaValueType": "epaValueType",
          "discountCents": 1,
          "discountPercent": 1,
          "discountValueType": "discountValueType",
          "taxCents": 1,
          "taxPercent": 1,
          "taxValueType": "taxValueType",
          "gstCents": 1,
          "gstPercent": 1,
          "gstValueType": "gstValueType",
          "pstCents": 1,
          "pstPercent": 1,
          "pstValueType": "pstValueType",
          "hstCents": 1,
          "hstPercent": 1,
          "hstValueType": "hstValueType",
          "shopSuppliesApplied": true,
          "shopSuppliesCents": 1,
          "shopSuppliesPercent": 1,
          "shopSuppliesValueType": "shopSuppliesValueType",
          "authorizationStatus": "authorizationStatus",
          "calculatedPartsCents": 1,
          "calculatedTiresCents": 1,
          "calculatedLaborCents": 1,
          "calculatedSubcontractsCents": 1,
          "calculatedFeeCents": 1,
          "calculatedEpaCents": 1,
          "calculatedDiscountCents": 1,
          "calculatedDiscountPercent": 1,
          "calculatedShopSuppliesCents": 1,
          "calculatedTaxCents": 1,
          "ordinal": 1,
          "hidden": true,
          "totalCents": 1,
          "sourceServiceId": null,
          "deferredDate": null,
          "deferredReason": null,
          "excludedFromDeferred": true,
          "revived": true,
          "revivedFromId": null,
          "fees": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "companyId": "companyId",
              "locationId": "locationId",
              "serviceId": "serviceId",
              "orderId": "orderId",
              "feeType": "feeType",
              "percent": 1,
              "amountCents": 1,
              "subtotalCents": null,
              "lineItemEntity": null,
              "partId": null,
              "laborId": null,
              "subcontractId": null,
              "tireId": null,
              "name": "name",
              "ordinal": 1,
              "categoryId": null,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              }
            }
          ],
          "labors": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "companyId": "companyId",
              "locationId": "locationId",
              "serviceId": "serviceId",
              "orderId": "orderId",
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "name": null,
              "hours": 1,
              "rateCents": 1,
              "rateId": null,
              "technicianId": null,
              "showHours": true,
              "showNote": true,
              "ordinal": 1,
              "costHours": null,
              "costRateCents": null,
              "costTotalCents": null,
              "multiplier": 1,
              "multiplierType": "multiplierType",
              "note": "note",
              "completed": true,
              "completedDate": null,
              "categoryId": null,
              "skillRequired": null,
              "skillRequiredDescription": null,
              "taxable": true,
              "laborMatrixId": null,
              "laborMatrixDate": null,
              "applicationId": null,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              },
              "laborMatrix": {
                "id": "id",
                "name": "name"
              },
              "laborRate": {
                "id": "id",
                "name": "name"
              }
            }
          ],
          "parts": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "companyId": "companyId",
              "locationId": "locationId",
              "serviceId": "serviceId",
              "orderId": "orderId",
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "quantity": 1,
              "retailCostCents": 1,
              "wholesaleCostCents": null,
              "showNote": true,
              "showPartNumber": true,
              "showCostAndQuantity": true,
              "reduceInventoryCount": true,
              "taxable": true,
              "ordinal": 1,
              "name": "name",
              "note": "note",
              "partNumber": "partNumber",
              "binLocation": "binLocation",
              "vendorId": null,
              "inventoryPartId": null,
              "categoryId": null,
              "pricingMatrixId": null,
              "pricingMatrixDate": null,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              },
              "pricingMatrix": {
                "id": "id",
                "name": "name"
              },
              "vendor": {
                "id": "id",
                "name": "name"
              }
            }
          ],
          "subcontracts": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "locationId": "locationId",
              "companyId": "companyId",
              "name": "name",
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "taxable": true,
              "costCents": 1,
              "retailCostCents": 1,
              "showNote": true,
              "note": null,
              "vendorId": null,
              "serviceId": "serviceId",
              "orderId": "orderId",
              "ordinal": 1,
              "categoryId": null,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              },
              "vendor": {
                "id": "id",
                "name": "name"
              }
            }
          ],
          "tires": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "locationId": "locationId",
              "companyId": "companyId",
              "name": "name",
              "note": null,
              "pricingMatrixId": null,
              "pricingMatrixDate": null,
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "quantity": 1,
              "retailCostCents": 1,
              "wholesaleCostCents": null,
              "ordinal": 1,
              "sizeFormat": "sizeFormat",
              "size": null,
              "partNumber": null,
              "binLocation": null,
              "brandId": null,
              "model": null,
              "vendorId": null,
              "seasonality": null,
              "taxable": true,
              "showPartNumber": true,
              "showPriceAndQuantity": true,
              "showNote": true,
              "categoryId": null,
              "serviceId": "serviceId",
              "orderId": "orderId",
              "reduceInventoryCount": true,
              "federalExciseTaxCents": 1,
              "wasteTireFee": 1,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              },
              "brand": {
                "id": "id",
                "name": "name"
              },
              "pricingMatrix": {
                "id": "id",
                "name": "name"
              },
              "vendor": {
                "id": "id",
                "name": "name"
              }
            }
          ]
        }
      ]
    }
  }
}

POST/v3/order/:orderId/service/:serviceId/part

Add Part to Service

Add a Part to a Service for an Order

URL parameters

Name
orderId
Type
string Required
Description
the id for the order
Name
serviceId
Type
string Required
Description
the id for the service

Query String parameters

Name
includeOrder
Type
boolean
Description
include the updated order in the response (default true)

Body parameters

Consumes

The following content type is required: application/json

Name
discountCents
Type
integer
Description
Name
discountPercent
Type
number
Description
Name
discountValueType
Type
one of: Percent, FixedCents
Description
Name
quantity
Type
number
Description
Name
retailCostCents
Type
integer
Description
Name
wholesaleCostCents
Type
integer
Description
Name
showNote
Type
boolean
Description
Name
showPartNumber
Type
boolean
Description
Name
showCostAndQuantity
Type
boolean
Description
Name
reduceInventoryCount
Type
boolean
Description
Name
reserved
Type
boolean
Description
Name
inventoryStatus
Type
one of: OnEstimate, InventoryReduced, None
Description
Name
taxableGST
Type
boolean
Description
CA specific
Name
taxableHST
Type
boolean
Description
CA specific
Name
taxablePST
Type
boolean
Description
CA specific
Name
ordinal
Type
number
Description
Name
name
Type
string
Description
Name
note
Type
string
Description
Name
partNumber
Type
string
Description
Name
binLocation
Type
string
Description
Name
vendorId
Type
string
Description
Name
inventoryPartId
Type
string
Description
Name
categoryId
Type
string
Description
Name
sourceItemId
Type
string
Description
Name
motorApplicationId
Type
integer
Description
Name
labels
Type
object
Description
Name
url
Type
string
Description
Name
pcDbTerminologyId
Type
integer
Description
product classification database terminology id for aftermarket parts, etc
Name
fixedPriceLimitType
Type
one of: None, Quantity, Price
Description
Name
fixedPriceLimitQuantity
Type
number
Description
Quantities exceeding the amount will be charged based on their individual part price as an addition to the fixed price canned service.
Name
fixedPriceLimitPriceCents
Type
integer
Description
Part prices exceeding the amount will have their difference charged in addition to the fixed price canned service.
Name
locationId
Type
string
Description
the id for the location

Produces

The response content type: application/json

`200` Response

Name
code
Type
string
Description
The error code
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if success = false
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message
Name
data
Type
object Required
Description

Properties for `data` object

Name
order
Type
object
Description
Order schema
Name
part
Type
object Required
Description
Part schema

Properties for `order` object

Name
id
Type
string Required
Description
Name
publicId
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
locationId
Type
string Required
Description
Name
number
Type
string Required
Description
Name
externalNumber
Type
string Required
Description
allow user to override generated number
Name
vehicleId
Type
string Required
Description
Name
phoneNumberId
Type
string Required
Description
id of the phone number to use instead of the customer's default number
Name
emailId
Type
string Required
Description
id of the email to use instead of the customer's default email
Name
customerId
Type
string Required
Description
Name
name
Type
string Required
Description
Name
generatedName
Type
string Required
Description
Name
coalescedName
Type
string Required
Description
Name
complaint
Type
string Required
Description
Name
recommendation
Type
string Required
Description
Name
purchaseOrderNumber
Type
string Required
Description
Name
generatedVehicleName
Type
string Required
Description
"[year] [make] [model] [submodel]" pulled from the vehicle, if any
Name
generatedCustomerName
Type
string Required
Description
"[firstName] [lastName]" pulled from the customer, if any
Name
orderCreatedDate
Type
string Required
Description
allow user to override created date
Name
archived
Type
boolean Required
Description
Name
authorized
Type
boolean Required
Description
Name
authorizedDate
Type
string Required
Description
Name
invoiced
Type
boolean Required
Description
Name
sentToCarfax
Type
boolean Required
Description
Name
inspectionStatus
Type
one of: None, Completed, NotCompleted Required
Description
Name
inspectionCount
Type
integer Required
Description
Name
invoicedDate
Type
string Required
Description
Name
paid
Type
boolean Required
Description
Name
appointmentDates
Type
array Required
Description
Name
assignedTechnicianIds
Type
array Required
Description
Name
completedAuthorizedLaborHours
Type
number Required
Description
Name
completedLaborHours
Type
number Required
Description
Name
totalAuthorizedLaborHours
Type
number Required
Description
Name
totalLaborHours
Type
number Required
Description
Name
messageCount
Type
integer Required
Description
Name
shopUnreadMessageCount
Type
integer Required
Description
Name
totalCostCents
Type
integer Required
Description
Name
paidCostCents
Type
integer Required
Description
Name
remainingCostCents
Type
integer Required
Description
Name
partsCents
Type
integer Required
Description
Name
tiresCents
Type
integer Required
Description
Name
laborCents
Type
integer Required
Description
Name
subcontractsCents
Type
integer Required
Description
Name
epaCents
Type
integer Required
Description
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
feesCents
Type
integer Required
Description
Name
taxCents
Type
integer Required
Description
Name
gstCents
Type
integer Required
Description
Name
pstCents
Type
integer Required
Description
Name
hstCents
Type
integer Required
Description
Name
transactionalFeeTotalCents
Type
integer Required
Description
Name
transactionalFeeSubtotalCents
Type
integer Required
Description
// value before taxes
Name
requestedDepositCents
Type
integer Required
Description
Name
workflowStatusId
Type
string Required
Description
Name
workflowStatusPosition
Type
number Required
Description
Name
workflowStatusDate
Type
string Required
Description
Name
taxConfigId
Type
string Required
Description
Name
transactionFeeConfigId
Type
string Required
Description
Name
dueDate
Type
string Required
Description
Name
serviceWriterId
Type
string Required
Description
Name
mileageIn
Type
number Required
Description
Name
mileageOut
Type
number Required
Description
Name
conversationId
Type
string Required
Description
Name
completedDate
Type
string Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
readOnly
Type
boolean Required
Description
if this order should not be editable in the UI
Name
readOnlyReason
Type
string Required
Description
a friendly explanation of why (eg. "migrated from previous system")
Name
deferredServiceCount
Type
integer Required
Description
Name
statementId
Type
string Required
Description
a statement this order included in
Name
fullyPaidDate
Type
string Required
Description
Name
messagedDate
Type
string Required
Description
Name
paymentTermId
Type
string Required
Description
id of the payment term for the order
Name
paymentDueDate
Type
string Required
Description
Name
allowCollectPayment
Type
boolean Required
Description
Name
allowCustomerAuthorization
Type
boolean Required
Description
Name
allowCustomerViewMessages
Type
boolean Required
Description
Name
allowCustomerViewAuthorizations
Type
boolean Required
Description
Name
allowCustomerViewInspections
Type
boolean Required
Description
Name
allowCustomerViewActivity
Type
boolean Required
Description
Name
requireESignatureOnAuthorization
Type
boolean Required
Description
Name
requireESignatureOnInvoice
Type
boolean Required
Description
Name
updatedSinceSignedInvoice
Type
boolean Required
Description
Name
labels
Type
object Required
Description
Name
imported
Type
boolean Required
Description
Name
status
Type
one of: Estimate, RepairOrder, Invoice Required
Description
Name
repairOrderDate
Type
string Required
Description
// the date the order was moved into repair order status
Name
workflowStatusDuration
Type
object Required
Description
Stores how many time the order has been in each status
Name
appointments
Type
array Required
Description
Deprecated: will return []
Name
authorizations
Type
array Required
Description
Deprecated: will return []
Name
customFields
Type
object
Description
custom fields as JSON object
Name
customer
Type
object Required
Description
Name
files
Type
array
Description
Name
inspections
Type
array Required
Description
Deprecated: will return []
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
paymentTerm
Type
object Required
Description
Name
profitability
Type
object Required
Description
Name
services
Type
array Required
Description
Soon will be deprecated!
Name
vehicle
Type
object Required
Description
Name
workflowStatus
Type
object Required
Description
WorkflowStatus schema

Properties for `customer` object

Name
id
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
locationIds
Type
array Required
Description
Name
customerType
Type
one of: Customer, Fleet Required
Description
Name
firstName
Type
string Required
Description
Name
lastName
Type
string Required
Description
Name
companyName
Type
string Required
Description
Name
address1
Type
string Required
Description
Name
address2
Type
string Required
Description
Name
city
Type
string Required
Description
Name
state
Type
string Required
Description
Name
country
Type
one of: US, CA, MX, AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BQ, BA, BW, BV, BR, IO, VG, BN, BG, BF, BI, CV, KH, CM, KY, CF, TD, CL, CN, HK, MO, CX, CC, CO, KM, CG, CK, CR, HR, CU, CW, CY, CZ, CI, KP, CD, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, SZ, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, VA, HN, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, JM, JP, JE, JO, KZ, KE, KI, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, FM, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, NC, NZ, NI, NE, NG, NU, NF, MP, NO, OM, PK, PW, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, KR, MD, RO, RU, RW, RE, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SK, SI, SB, SO, ZA, GS, SS, ES, LK, PS, SD, SR, SJ, SE, CH, SY, TW, TJ, TH, MK, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, GB, TZ, UM, VI, UY, UZ, VU, VE, VN, WF, EH, YE, ZM, ZW Required
Description
Name
postalCode
Type
string Required
Description
Name
dotNumber
Type
string Required
Description
Name
paymentTermId
Type
string Required
Description
Name
publicId
Type
string Required
Description
Name
note
Type
string Required
Description
Name
marketingOptIn
Type
boolean Required
Description
Name
preferredContactMethod
Type
one of: SMS, Email, All Required
Description
Name
preferredLanguage
Type
one of: en, en_US, fr_CA Required
Description
Name
referralSourceId
Type
string Required
Description
Name
taxExempt
Type
boolean Required
Description
US specific
Name
gstExempt
Type
boolean Required
Description
CA specific
Name
hstExempt
Type
boolean Required
Description
CA specific
Name
pstExempt
Type
boolean Required
Description
CA specific
Name
discountPercent
Type
number Required
Description
Name
laborRateId
Type
string Required
Description
Name
laborMatrixId
Type
string Required
Description
Name
pricingMatrixId
Type
string Required
Description
Name
fleetId
Type
string Required
Description
Name
lastTimeOrderWorked
Type
string Required
Description
Name
statementCount
Type
integer Required
Description
Name
transactionCount
Type
integer Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
messageCount
Type
integer Required
Description
Name
website
Type
string Required
Description
Name
normalizedFirstName
Type
string Required
Description
Name
normalizedLastName
Type
string Required
Description
Name
normalizedName
Type
string Required
Description
if fleet, contains the normalized companyName, else normalized firstName lastName
Name
coalescedFirstNameOrCompanyName
Type
string Required
Description
Name
vehicleCount
Type
integer Required
Description
Name
orderCount
Type
integer Required
Description
Name
finixIdentityId
Type
string Required
Description
Name
labels
Type
object Required
Description
Name
externalId
Type
string Required
Description
an id that can be used to reference the customer in an external system
Name
originLocationId
Type
string Required
Description
the location that created the customer
Name
imported
Type
boolean Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
customFields
Type
object
Description
custom fields as JSON object
Name
emails
Type
array Required
Description
Name
phoneNumbers
Type
array Required
Description

Properties for `paymentTerm` object

Name
id
Type
string Required
Description
Name
name
Type
string Required
Description

Properties for `profitability` object

Name
labor
Type
object Required
Description
Name
parts
Type
object Required
Description
Name
subcontracts
Type
object Required
Description
Name
tires
Type
object Required
Description
Name
totalDiscountCents
Type
number Required
Description
Name
totalDiscountPercent
Type
number Required
Description
Name
totalProfitCents
Type
number Required
Description
Name
totalProfitPercent
Type
number Required
Description
Name
totalRetailCents
Type
number Required
Description
Name
totalWholesaleCents
Type
number Required
Description

Properties for `labor` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `parts` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `subcontracts` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `tires` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `vehicle` object

Name
id
Type
string Required
Description
()
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
locationIds
Type
array Required
Description
Name
baseId
Type
integer Required
Description
vcdb base id
Name
size
Type
one of: HeavyDuty, LightDuty, Other Required
Description
Name
preferredLaborGuide
Type
one of: HeavyDuty, LightDuty, Other Required
Description
Name
type
Type
one of: ATV, Bicycle, BigRig, Boat, ClassAMotorhome, ClassCMotorhome, Convertible, Coupe, FifthWheel, Hatchback, Jeep, Motorcycle, Other, PopUp, RV, SUV, Sedan, Trailer, TravelTrailer, Truck, TruckCamper, UTV, Van, Wagon Required
Description
Name
year
Type
integer Required
Description
Name
make
Type
string Required
Description
holds Hull make for vessel
Name
makeId
Type
integer Required
Description
vcdb make id
Name
model
Type
string Required
Description
Name
modelId
Type
integer Required
Description
vcdb model id
Name
submodel
Type
string Required
Description
Name
submodelId
Type
integer Required
Description
vcdb submodel id
Name
engine
Type
string Required
Description
Name
engineId
Type
integer Required
Description
vcdb engine id
Name
productionDate
Type
string Required
Description
Name
transmission
Type
one of: Automatic, Manual, AutomaticCVT, AutomaticDualClutch Required
Description
Name
transmissionId
Type
integer Required
Description
vcdb transmission id
Name
transmissionSpeed
Type
string Required
Description
Name
transmissionMfrCode
Type
string Required
Description
Name
drivetrain
Type
one of: RWD, FWD, FourWD, AWD Required
Description
Name
drivetype
Type
string Required
Description
Name
drivetypeId
Type
integer Required
Description
vcdb drivetype id
Name
bodyStyle
Type
string Required
Description
Name
bodyStyleId
Type
integer Required
Description
vcdb body style id
Name
bedLength
Type
string Required
Description
Name
configurationStatus
Type
one of: Custom, Incomplete, Invalid, NotSupported, Valid Required
Description
Name
vin
Type
string Required
Description
Name
color
Type
one of: White, Silver, Gray, Black, Blue, Red, Brown, Burgundy, Tan, Gold, Green, Yellow, Orange, Pink, Purple, Other Required
Description
Name
unit
Type
string Required
Description
Name
mileage
Type
number Required
Description
Name
mileageUnit
Type
one of: Mile, Kilometer Required
Description
Name
odometer
Type
boolean Required
Description
Name
licensePlate
Type
string Required
Description
Name
licensePlateState
Type
string Required
Description
Name
licensePlateCountry
Type
one of: US, CA, MX, AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BQ, BA, BW, BV, BR, IO, VG, BN, BG, BF, BI, CV, KH, CM, KY, CF, TD, CL, CN, HK, MO, CX, CC, CO, KM, CG, CK, CR, HR, CU, CW, CY, CZ, CI, KP, CD, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, SZ, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, VA, HN, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, JM, JP, JE, JO, KZ, KE, KI, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, FM, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, NC, NZ, NI, NE, NG, NU, NF, MP, NO, OM, PK, PW, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, KR, MD, RO, RU, RW, RE, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SK, SI, SB, SO, ZA, GS, SS, ES, LK, PS, SD, SR, SJ, SE, CH, SY, TW, TJ, TH, MK, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, GB, TZ, UM, VI, UY, UZ, VU, VE, VN, WF, EH, YE, ZM, ZW Required
Description
Name
note
Type
string Required
Description
Name
vcdbVehicleId
Type
string Required
Description
Name
ownerCount
Type
integer Required
Description
Name
orderCount
Type
integer Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
tirePressureLogCount
Type
integer Required
Description
Name
mileageLogCount
Type
integer Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
messageCount
Type
integer Required
Description
Name
computed_ymm
Type
string Required
Description
Name
customPhoto
Type
boolean Required
Description
Name
stockPhoto
Type
boolean Required
Description
Name
labels
Type
object Required
Description
Name
externalId
Type
string Required
Description
an id that can be used to reference the vehicle in an external system
Name
originLocationId
Type
string Required
Description
the location that created the vehicle
Name
imported
Type
boolean Required
Description
Name
length
Type
number Required
Description
Name
lengthUnit
Type
one of: Ft, M Required
Description
Name
hin
Type
string Required
Description
Vessel hull identification number
Name
serial
Type
string Required
Description
Name
name
Type
string Required
Description
Custom vehicle name / Vessel registered name
Name
coalescedVINorHIN
Type
string Required
Description
Name
lastServicedDate
Type
string Required
Description
Name
frontTireSize
Type
string Required
Description
custom front tire size override value
Name
rearTireSize
Type
string Required
Description
custom rear tire size override value
Name
drivingCondition
Type
one of: Normal, Severe Required
Description
Name
engines
Type
object Required
Description
an array of engines { id: string; make: string; model: string; hours: number; noHoursMeter: boolean; horsepower: number; serial: string; productionYear: number; productionMonth: number; }
Name
engineHoursLogs
Type
object Required
Description
an array of engine hours logs { engineId: string; inHours: number; outHours: number; orderId: string; }
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
customFields
Type
object
Description
custom fields as JSON object
Name
tirePressureLogs
Type
array
Description

Properties for `workflowStatus` object

Name
id
Type
string Required
Description
Name
name
Type
string Required
Description

Properties for `part` object

Name
id
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
locationId
Type
string Required
Description
Name
serviceId
Type
string Required
Description
Name
orderId
Type
string Required
Description
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
quantity
Type
number Required
Description
Name
retailCostCents
Type
integer Required
Description
Name
wholesaleCostCents
Type
integer Required
Description
Name
showNote
Type
boolean Required
Description
Name
showPartNumber
Type
boolean Required
Description
Name
showCostAndQuantity
Type
boolean Required
Description
Name
reduceInventoryCount
Type
boolean Required
Description
Name
reserved
Type
boolean Required
Description
Name
inventoryStatus
Type
one of: OnEstimate, InventoryReduced, None Required
Description
Name
taxable
Type
boolean Required
Description
US specific
Name
taxableGST
Type
boolean Required
Description
CA specific
Name
taxableHST
Type
boolean Required
Description
CA specific
Name
taxablePST
Type
boolean Required
Description
CA specific
Name
ordinal
Type
number Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
partNumber
Type
string Required
Description
Name
binLocation
Type
string Required
Description
Name
vendorId
Type
string Required
Description
Name
inventoryPartId
Type
string Required
Description
Name
categoryId
Type
string Required
Description
Name
pricingMatrixId
Type
string Required
Description
Name
pricingMatrixDate
Type
string Required
Description
datetime when pricingMatrixId was set, for determining if matrix has been changed
Name
sourceItemId
Type
string Required
Description
Name
motorApplicationId
Type
integer Required
Description
Name
labels
Type
object Required
Description
Name
purchaseOrderPartId
Type
string Required
Description
Name
purchaseStatus
Type
one of: Cancelled, Draft, Fulfilled, Ordered, Received Required
Description
Name
url
Type
string Required
Description
Name
pcDbTerminologyId
Type
integer Required
Description
product classification database terminology id for aftermarket parts, etc
Name
fixedPriceLimitType
Type
one of: None, Quantity, Price Required
Description
Name
fixedPriceLimitQuantity
Type
number Required
Description
Quantities exceeding the amount will be charged based on their individual part price as an addition to the fixed price canned service.
Name
fixedPriceLimitPriceCents
Type
integer Required
Description
Part prices exceeding the amount will have their difference charged in addition to the fixed price canned service.

`4xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

`5xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

POST

/v3/order/:orderId/service/:serviceId/part

curl https://api.shopmonkey.cloud/v3/order/:orderId/service/:serviceId/part \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data '{}'

Example Response
application/json

{
  "success": true,
  "data": {
    "order": {
      "id": "id",
      "publicId": "publicId",
      "createdDate": "createdDate",
      "updatedDate": null,
      "companyId": "companyId",
      "locationId": "locationId",
      "number": 1,
      "vehicleId": null,
      "phoneNumberId": null,
      "emailId": null,
      "customerId": null,
      "name": null,
      "generatedName": null,
      "coalescedName": null,
      "complaint": null,
      "recommendation": null,
      "purchaseOrderNumber": null,
      "generatedVehicleName": null,
      "generatedCustomerName": null,
      "orderCreatedDate": "orderCreatedDate",
      "archived": true,
      "authorized": true,
      "authorizedDate": null,
      "invoiced": true,
      "sentToCarfax": true,
      "inspectionStatus": "inspectionStatus",
      "inspectionCount": 1,
      "invoicedDate": null,
      "paid": true,
      "appointmentDates": "2023-01-29T16:43:58.403Z",
      "assignedTechnicianIds": [
        "assignedTechnicianIds"
      ],
      "messageCount": 1,
      "shopUnreadMessageCount": 1,
      "totalCostCents": 1,
      "paidCostCents": 1,
      "remainingCostCents": null,
      "partsCents": 1,
      "tiresCents": 1,
      "laborCents": 1,
      "subcontractsCents": 1,
      "epaCents": 1,
      "discountCents": 1,
      "discountPercent": 1,
      "shopSuppliesCents": 1,
      "feesCents": 1,
      "taxCents": 1,
      "gstCents": 1,
      "pstCents": 1,
      "hstCents": 1,
      "workflowStatusId": "workflowStatusId",
      "workflowStatusPosition": 1,
      "taxConfigId": "taxConfigId",
      "dueDate": null,
      "serviceWriterId": null,
      "mileageIn": null,
      "mileageOut": null,
      "conversationId": "conversationId",
      "completedDate": null,
      "deleted": true,
      "deletedUserId": null,
      "deletedDate": null,
      "deletedReason": null,
      "readOnly": true,
      "readOnlyReason": null,
      "deferredServiceCount": 1,
      "statementId": null,
      "customFields": {},
      "profitability": {
        "parts": {
          "discountPercent": 1,
          "discountCents": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "labor": {
          "discountPercent": 1,
          "discountCents": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "subcontracts": {
          "discountPercent": 1,
          "discountCents": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "tires": {
          "discountPercent": 1,
          "discountCents": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "totalProfitPercent": 1,
        "totalProfitCents": 1,
        "totalRetailCents": 1,
        "totalWholesaleCents": 1,
        "totalDiscountCents": 1,
        "totalDiscountPercent": 1
      },
      "labelConnections": [
        {
          "label": {
            "id": "id",
            "name": "name",
            "color": "color",
            "entity": "entity",
            "saved": true
          }
        }
      ],
      "customer": {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "customerType": "customerType",
        "firstName": null,
        "lastName": null,
        "companyName": null,
        "address1": null,
        "address2": null,
        "city": null,
        "state": null,
        "country": null,
        "postalCode": null,
        "dotNumber": null,
        "paymentTermId": "paymentTermId",
        "note": "note",
        "marketingOptIn": true,
        "preferredContactMethod": null,
        "referralSourceId": null,
        "taxExempt": true,
        "discountPercent": 1,
        "laborRateId": null,
        "laborMatrixId": null,
        "pricingMatrixId": null,
        "fleetId": null,
        "lastTimeOrderWorked": null,
        "statementCount": 1,
        "transactionCount": 1,
        "deferredServiceCount": 1,
        "appointmentCount": 1,
        "messageCount": 1,
        "labelConnections": [
          {
            "label": {
              "id": "id",
              "name": "name",
              "color": "color",
              "entity": "entity",
              "saved": true
            }
          }
        ],
        "emails": [
          {
            "id": "id",
            "createdDate": "createdDate",
            "updatedDate": null,
            "locationId": "locationId",
            "companyId": "companyId",
            "email": "email",
            "subscribed": true,
            "customerId": "customerId",
            "primary": true
          }
        ],
        "phoneNumbers": [
          {
            "id": "id",
            "createdDate": "createdDate",
            "updatedDate": null,
            "locationId": "locationId",
            "companyId": "companyId",
            "customerId": "customerId",
            "number": "number",
            "extension": null,
            "country": null,
            "type": null,
            "userDefinedType": null,
            "carrierName": null,
            "optInVerifiedDate": null,
            "optIn": true,
            "lastVerifiedDate": null,
            "primary": true,
            "mobileCountryCode": null,
            "mobileNetworkCode": null
          }
        ],
        "customFields": {}
      },
      "vehicle": {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "size": "size",
        "type": null,
        "year": null,
        "make": null,
        "makeId": null,
        "model": null,
        "modelId": null,
        "submodel": null,
        "submodelId": null,
        "engine": null,
        "productionDate": null,
        "transmission": null,
        "drivetrain": null,
        "vin": null,
        "color": null,
        "unit": null,
        "mileage": null,
        "mileageUnit": "mileageUnit",
        "odometer": true,
        "licensePlate": null,
        "licensePlateState": null,
        "licensePlateCountry": "licensePlateCountry",
        "note": "note",
        "vcdbVehicleId": null,
        "ownerCount": 1,
        "orderCount": 1,
        "appointmentCount": 1,
        "tirePressureLogCount": 1,
        "mileageLogCount": 1,
        "deferredServiceCount": 1,
        "messageCount": 1,
        "customPhoto": true,
        "stockPhoto": true,
        "labelConnections": [
          {
            "label": {
              "id": "id",
              "name": "name",
              "color": "color",
              "entity": "entity",
              "saved": true
            }
          }
        ],
        "tirePressureLogs": [
          {
            "id": "id",
            "createdDate": "createdDate",
            "updatedDate": null,
            "companyId": "companyId",
            "locationId": "locationId",
            "orderId": "orderId",
            "vehicleId": "vehicleId",
            "frontLeft": null,
            "frontRight": null,
            "rearLeft": null,
            "rearRight": null
          }
        ],
        "customFields": {}
      },
      "appointments": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "name": "name",
          "startDate": "startDate",
          "endDate": "endDate",
          "rruleset": null,
          "customerId": null,
          "note": "note",
          "vehicleId": null,
          "orderId": null,
          "color": "color",
          "useEmail": true,
          "useSMS": true,
          "sendConfirmation": true,
          "sendReminder": true,
          "cancelationNote": null,
          "pendingConfirmation": true,
          "confirmed": true,
          "allDay": true,
          "removedFromRecurrency": true,
          "customerEmailId": null,
          "customerPhoneNumberId": null,
          "locationId": "locationId"
        }
      ],
      "inspections": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "locationId": "locationId",
          "orderId": "orderId",
          "name": "name",
          "createdById": null,
          "templateId": null,
          "completed": true,
          "completedDate": null,
          "completedById": null,
          "ordinal": 1
        }
      ],
      "authorizations": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "locationId": "locationId",
          "orderId": "orderId",
          "date": "date",
          "serviceWriterId": null,
          "customerId": null,
          "method": "method",
          "authorizedCostCents": 1,
          "note": "note"
        }
      ],
      "workflowStatus": {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "name": null,
        "position": 1,
        "daysToArchive": 1,
        "archiveWhenInactive": true,
        "invoiceWorkflow": true
      },
      "services": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "locationId": "locationId",
          "name": "name",
          "note": "note",
          "orderId": "orderId",
          "lumpSum": true,
          "recommended": true,
          "epaPercent": 1,
          "epaCents": 1,
          "epaValueType": "epaValueType",
          "discountCents": 1,
          "discountPercent": 1,
          "discountValueType": "discountValueType",
          "taxCents": 1,
          "taxPercent": 1,
          "taxValueType": "taxValueType",
          "gstCents": 1,
          "gstPercent": 1,
          "gstValueType": "gstValueType",
          "pstCents": 1,
          "pstPercent": 1,
          "pstValueType": "pstValueType",
          "hstCents": 1,
          "hstPercent": 1,
          "hstValueType": "hstValueType",
          "shopSuppliesApplied": true,
          "shopSuppliesCents": 1,
          "shopSuppliesPercent": 1,
          "shopSuppliesValueType": "shopSuppliesValueType",
          "authorizationStatus": "authorizationStatus",
          "calculatedPartsCents": 1,
          "calculatedTiresCents": 1,
          "calculatedLaborCents": 1,
          "calculatedSubcontractsCents": 1,
          "calculatedFeeCents": 1,
          "calculatedEpaCents": 1,
          "calculatedDiscountCents": 1,
          "calculatedDiscountPercent": 1,
          "calculatedShopSuppliesCents": 1,
          "calculatedTaxCents": 1,
          "ordinal": 1,
          "hidden": true,
          "totalCents": 1,
          "sourceServiceId": null,
          "deferredDate": null,
          "deferredReason": null,
          "excludedFromDeferred": true,
          "revived": true,
          "revivedFromId": null,
          "fees": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "companyId": "companyId",
              "locationId": "locationId",
              "serviceId": "serviceId",
              "orderId": "orderId",
              "feeType": "feeType",
              "percent": 1,
              "amountCents": 1,
              "subtotalCents": null,
              "lineItemEntity": null,
              "partId": null,
              "laborId": null,
              "subcontractId": null,
              "tireId": null,
              "name": "name",
              "ordinal": 1,
              "categoryId": null,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              }
            }
          ],
          "labors": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "companyId": "companyId",
              "locationId": "locationId",
              "serviceId": "serviceId",
              "orderId": "orderId",
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "name": null,
              "hours": 1,
              "rateCents": 1,
              "rateId": null,
              "technicianId": null,
              "showHours": true,
              "showNote": true,
              "ordinal": 1,
              "costHours": null,
              "costRateCents": null,
              "costTotalCents": null,
              "multiplier": 1,
              "multiplierType": "multiplierType",
              "note": "note",
              "completed": true,
              "completedDate": null,
              "categoryId": null,
              "skillRequired": null,
              "skillRequiredDescription": null,
              "taxable": true,
              "laborMatrixId": null,
              "laborMatrixDate": null,
              "applicationId": null,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              },
              "laborMatrix": {
                "id": "id",
                "name": "name"
              },
              "laborRate": {
                "id": "id",
                "name": "name"
              }
            }
          ],
          "parts": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "companyId": "companyId",
              "locationId": "locationId",
              "serviceId": "serviceId",
              "orderId": "orderId",
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "quantity": 1,
              "retailCostCents": 1,
              "wholesaleCostCents": null,
              "showNote": true,
              "showPartNumber": true,
              "showCostAndQuantity": true,
              "reduceInventoryCount": true,
              "taxable": true,
              "ordinal": 1,
              "name": "name",
              "note": "note",
              "partNumber": "partNumber",
              "binLocation": "binLocation",
              "vendorId": null,
              "inventoryPartId": null,
              "categoryId": null,
              "pricingMatrixId": null,
              "pricingMatrixDate": null,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              },
              "pricingMatrix": {
                "id": "id",
                "name": "name"
              },
              "vendor": {
                "id": "id",
                "name": "name"
              }
            }
          ],
          "subcontracts": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "locationId": "locationId",
              "companyId": "companyId",
              "name": "name",
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "taxable": true,
              "costCents": 1,
              "retailCostCents": 1,
              "showNote": true,
              "note": null,
              "vendorId": null,
              "serviceId": "serviceId",
              "orderId": "orderId",
              "ordinal": 1,
              "categoryId": null,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              },
              "vendor": {
                "id": "id",
                "name": "name"
              }
            }
          ],
          "tires": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "locationId": "locationId",
              "companyId": "companyId",
              "name": "name",
              "note": null,
              "pricingMatrixId": null,
              "pricingMatrixDate": null,
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "quantity": 1,
              "retailCostCents": 1,
              "wholesaleCostCents": null,
              "ordinal": 1,
              "sizeFormat": "sizeFormat",
              "size": null,
              "partNumber": null,
              "binLocation": null,
              "brandId": null,
              "model": null,
              "vendorId": null,
              "seasonality": null,
              "taxable": true,
              "showPartNumber": true,
              "showPriceAndQuantity": true,
              "showNote": true,
              "categoryId": null,
              "serviceId": "serviceId",
              "orderId": "orderId",
              "reduceInventoryCount": true,
              "federalExciseTaxCents": 1,
              "wasteTireFee": 1,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              },
              "brand": {
                "id": "id",
                "name": "name"
              },
              "pricingMatrix": {
                "id": "id",
                "name": "name"
              },
              "vendor": {
                "id": "id",
                "name": "name"
              }
            }
          ]
        }
      ]
    }
  }
}

DELETE/v3/order/:orderId/service/:serviceId/part/:id

Delete Order Line Item

Delete an Order Line Item for part

URL parameters

Name
id
Type
string Required
Description
the id for part
Name
orderId
Type
string Required
Description
the id for the order
Name
serviceId
Type
string Required
Description
the id for the service

Query String parameters

Name
includeOrder
Type
boolean
Description
include the updated order in the response (default true)

Produces

The response content type: application/json

`200` Response

Name
code
Type
string
Description
The error code
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if success = false
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message
Name
data
Type
object Required
Description

Properties for `data` object

Name
order
Type
object
Description
Order schema

Properties for `order` object

Name
id
Type
string Required
Description
Name
publicId
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
locationId
Type
string Required
Description
Name
number
Type
string Required
Description
Name
externalNumber
Type
string Required
Description
allow user to override generated number
Name
vehicleId
Type
string Required
Description
Name
phoneNumberId
Type
string Required
Description
id of the phone number to use instead of the customer's default number
Name
emailId
Type
string Required
Description
id of the email to use instead of the customer's default email
Name
customerId
Type
string Required
Description
Name
name
Type
string Required
Description
Name
generatedName
Type
string Required
Description
Name
coalescedName
Type
string Required
Description
Name
complaint
Type
string Required
Description
Name
recommendation
Type
string Required
Description
Name
purchaseOrderNumber
Type
string Required
Description
Name
generatedVehicleName
Type
string Required
Description
"[year] [make] [model] [submodel]" pulled from the vehicle, if any
Name
generatedCustomerName
Type
string Required
Description
"[firstName] [lastName]" pulled from the customer, if any
Name
orderCreatedDate
Type
string Required
Description
allow user to override created date
Name
archived
Type
boolean Required
Description
Name
authorized
Type
boolean Required
Description
Name
authorizedDate
Type
string Required
Description
Name
invoiced
Type
boolean Required
Description
Name
sentToCarfax
Type
boolean Required
Description
Name
inspectionStatus
Type
one of: None, Completed, NotCompleted Required
Description
Name
inspectionCount
Type
integer Required
Description
Name
invoicedDate
Type
string Required
Description
Name
paid
Type
boolean Required
Description
Name
appointmentDates
Type
array Required
Description
Name
assignedTechnicianIds
Type
array Required
Description
Name
completedAuthorizedLaborHours
Type
number Required
Description
Name
completedLaborHours
Type
number Required
Description
Name
totalAuthorizedLaborHours
Type
number Required
Description
Name
totalLaborHours
Type
number Required
Description
Name
messageCount
Type
integer Required
Description
Name
shopUnreadMessageCount
Type
integer Required
Description
Name
totalCostCents
Type
integer Required
Description
Name
paidCostCents
Type
integer Required
Description
Name
remainingCostCents
Type
integer Required
Description
Name
partsCents
Type
integer Required
Description
Name
tiresCents
Type
integer Required
Description
Name
laborCents
Type
integer Required
Description
Name
subcontractsCents
Type
integer Required
Description
Name
epaCents
Type
integer Required
Description
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
feesCents
Type
integer Required
Description
Name
taxCents
Type
integer Required
Description
Name
gstCents
Type
integer Required
Description
Name
pstCents
Type
integer Required
Description
Name
hstCents
Type
integer Required
Description
Name
transactionalFeeTotalCents
Type
integer Required
Description
Name
transactionalFeeSubtotalCents
Type
integer Required
Description
// value before taxes
Name
requestedDepositCents
Type
integer Required
Description
Name
workflowStatusId
Type
string Required
Description
Name
workflowStatusPosition
Type
number Required
Description
Name
workflowStatusDate
Type
string Required
Description
Name
taxConfigId
Type
string Required
Description
Name
transactionFeeConfigId
Type
string Required
Description
Name
dueDate
Type
string Required
Description
Name
serviceWriterId
Type
string Required
Description
Name
mileageIn
Type
number Required
Description
Name
mileageOut
Type
number Required
Description
Name
conversationId
Type
string Required
Description
Name
completedDate
Type
string Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
readOnly
Type
boolean Required
Description
if this order should not be editable in the UI
Name
readOnlyReason
Type
string Required
Description
a friendly explanation of why (eg. "migrated from previous system")
Name
deferredServiceCount
Type
integer Required
Description
Name
statementId
Type
string Required
Description
a statement this order included in
Name
fullyPaidDate
Type
string Required
Description
Name
messagedDate
Type
string Required
Description
Name
paymentTermId
Type
string Required
Description
id of the payment term for the order
Name
paymentDueDate
Type
string Required
Description
Name
allowCollectPayment
Type
boolean Required
Description
Name
allowCustomerAuthorization
Type
boolean Required
Description
Name
allowCustomerViewMessages
Type
boolean Required
Description
Name
allowCustomerViewAuthorizations
Type
boolean Required
Description
Name
allowCustomerViewInspections
Type
boolean Required
Description
Name
allowCustomerViewActivity
Type
boolean Required
Description
Name
requireESignatureOnAuthorization
Type
boolean Required
Description
Name
requireESignatureOnInvoice
Type
boolean Required
Description
Name
updatedSinceSignedInvoice
Type
boolean Required
Description
Name
labels
Type
object Required
Description
Name
imported
Type
boolean Required
Description
Name
status
Type
one of: Estimate, RepairOrder, Invoice Required
Description
Name
repairOrderDate
Type
string Required
Description
// the date the order was moved into repair order status
Name
workflowStatusDuration
Type
object Required
Description
Stores how many time the order has been in each status
Name
appointments
Type
array Required
Description
Deprecated: will return []
Name
authorizations
Type
array Required
Description
Deprecated: will return []
Name
customFields
Type
object
Description
custom fields as JSON object
Name
customer
Type
object Required
Description
Name
files
Type
array
Description
Name
inspections
Type
array Required
Description
Deprecated: will return []
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
paymentTerm
Type
object Required
Description
Name
profitability
Type
object Required
Description
Name
services
Type
array Required
Description
Soon will be deprecated!
Name
vehicle
Type
object Required
Description
Name
workflowStatus
Type
object Required
Description
WorkflowStatus schema

Properties for `customer` object

Name
id
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
locationIds
Type
array Required
Description
Name
customerType
Type
one of: Customer, Fleet Required
Description
Name
firstName
Type
string Required
Description
Name
lastName
Type
string Required
Description
Name
companyName
Type
string Required
Description
Name
address1
Type
string Required
Description
Name
address2
Type
string Required
Description
Name
city
Type
string Required
Description
Name
state
Type
string Required
Description
Name
country
Type
one of: US, CA, MX, AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BQ, BA, BW, BV, BR, IO, VG, BN, BG, BF, BI, CV, KH, CM, KY, CF, TD, CL, CN, HK, MO, CX, CC, CO, KM, CG, CK, CR, HR, CU, CW, CY, CZ, CI, KP, CD, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, SZ, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, VA, HN, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, JM, JP, JE, JO, KZ, KE, KI, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, FM, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, NC, NZ, NI, NE, NG, NU, NF, MP, NO, OM, PK, PW, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, KR, MD, RO, RU, RW, RE, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SK, SI, SB, SO, ZA, GS, SS, ES, LK, PS, SD, SR, SJ, SE, CH, SY, TW, TJ, TH, MK, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, GB, TZ, UM, VI, UY, UZ, VU, VE, VN, WF, EH, YE, ZM, ZW Required
Description
Name
postalCode
Type
string Required
Description
Name
dotNumber
Type
string Required
Description
Name
paymentTermId
Type
string Required
Description
Name
publicId
Type
string Required
Description
Name
note
Type
string Required
Description
Name
marketingOptIn
Type
boolean Required
Description
Name
preferredContactMethod
Type
one of: SMS, Email, All Required
Description
Name
preferredLanguage
Type
one of: en, en_US, fr_CA Required
Description
Name
referralSourceId
Type
string Required
Description
Name
taxExempt
Type
boolean Required
Description
US specific
Name
gstExempt
Type
boolean Required
Description
CA specific
Name
hstExempt
Type
boolean Required
Description
CA specific
Name
pstExempt
Type
boolean Required
Description
CA specific
Name
discountPercent
Type
number Required
Description
Name
laborRateId
Type
string Required
Description
Name
laborMatrixId
Type
string Required
Description
Name
pricingMatrixId
Type
string Required
Description
Name
fleetId
Type
string Required
Description
Name
lastTimeOrderWorked
Type
string Required
Description
Name
statementCount
Type
integer Required
Description
Name
transactionCount
Type
integer Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
messageCount
Type
integer Required
Description
Name
website
Type
string Required
Description
Name
normalizedFirstName
Type
string Required
Description
Name
normalizedLastName
Type
string Required
Description
Name
normalizedName
Type
string Required
Description
if fleet, contains the normalized companyName, else normalized firstName lastName
Name
coalescedFirstNameOrCompanyName
Type
string Required
Description
Name
vehicleCount
Type
integer Required
Description
Name
orderCount
Type
integer Required
Description
Name
finixIdentityId
Type
string Required
Description
Name
labels
Type
object Required
Description
Name
externalId
Type
string Required
Description
an id that can be used to reference the customer in an external system
Name
originLocationId
Type
string Required
Description
the location that created the customer
Name
imported
Type
boolean Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
customFields
Type
object
Description
custom fields as JSON object
Name
emails
Type
array Required
Description
Name
phoneNumbers
Type
array Required
Description

Properties for `paymentTerm` object

Name
id
Type
string Required
Description
Name
name
Type
string Required
Description

Properties for `profitability` object

Name
labor
Type
object Required
Description
Name
parts
Type
object Required
Description
Name
subcontracts
Type
object Required
Description
Name
tires
Type
object Required
Description
Name
totalDiscountCents
Type
number Required
Description
Name
totalDiscountPercent
Type
number Required
Description
Name
totalProfitCents
Type
number Required
Description
Name
totalProfitPercent
Type
number Required
Description
Name
totalRetailCents
Type
number Required
Description
Name
totalWholesaleCents
Type
number Required
Description

Properties for `labor` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `parts` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `subcontracts` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `tires` object

Name
discountCents
Type
number Required
Description
Name
discountPercent
Type
number Required
Description
Name
profitCents
Type
number Required
Description
Name
profitPercent
Type
number Required
Description
Name
retailCents
Type
number Required
Description
Name
wholesaleCents
Type
number Required
Description

Properties for `vehicle` object

Name
id
Type
string Required
Description
()
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
locationIds
Type
array Required
Description
Name
baseId
Type
integer Required
Description
vcdb base id
Name
size
Type
one of: HeavyDuty, LightDuty, Other Required
Description
Name
preferredLaborGuide
Type
one of: HeavyDuty, LightDuty, Other Required
Description
Name
type
Type
one of: ATV, Bicycle, BigRig, Boat, ClassAMotorhome, ClassCMotorhome, Convertible, Coupe, FifthWheel, Hatchback, Jeep, Motorcycle, Other, PopUp, RV, SUV, Sedan, Trailer, TravelTrailer, Truck, TruckCamper, UTV, Van, Wagon Required
Description
Name
year
Type
integer Required
Description
Name
make
Type
string Required
Description
holds Hull make for vessel
Name
makeId
Type
integer Required
Description
vcdb make id
Name
model
Type
string Required
Description
Name
modelId
Type
integer Required
Description
vcdb model id
Name
submodel
Type
string Required
Description
Name
submodelId
Type
integer Required
Description
vcdb submodel id
Name
engine
Type
string Required
Description
Name
engineId
Type
integer Required
Description
vcdb engine id
Name
productionDate
Type
string Required
Description
Name
transmission
Type
one of: Automatic, Manual, AutomaticCVT, AutomaticDualClutch Required
Description
Name
transmissionId
Type
integer Required
Description
vcdb transmission id
Name
transmissionSpeed
Type
string Required
Description
Name
transmissionMfrCode
Type
string Required
Description
Name
drivetrain
Type
one of: RWD, FWD, FourWD, AWD Required
Description
Name
drivetype
Type
string Required
Description
Name
drivetypeId
Type
integer Required
Description
vcdb drivetype id
Name
bodyStyle
Type
string Required
Description
Name
bodyStyleId
Type
integer Required
Description
vcdb body style id
Name
bedLength
Type
string Required
Description
Name
configurationStatus
Type
one of: Custom, Incomplete, Invalid, NotSupported, Valid Required
Description
Name
vin
Type
string Required
Description
Name
color
Type
one of: White, Silver, Gray, Black, Blue, Red, Brown, Burgundy, Tan, Gold, Green, Yellow, Orange, Pink, Purple, Other Required
Description
Name
unit
Type
string Required
Description
Name
mileage
Type
number Required
Description
Name
mileageUnit
Type
one of: Mile, Kilometer Required
Description
Name
odometer
Type
boolean Required
Description
Name
licensePlate
Type
string Required
Description
Name
licensePlateState
Type
string Required
Description
Name
licensePlateCountry
Type
one of: US, CA, MX, AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BQ, BA, BW, BV, BR, IO, VG, BN, BG, BF, BI, CV, KH, CM, KY, CF, TD, CL, CN, HK, MO, CX, CC, CO, KM, CG, CK, CR, HR, CU, CW, CY, CZ, CI, KP, CD, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, SZ, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, VA, HN, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, JM, JP, JE, JO, KZ, KE, KI, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, FM, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, NC, NZ, NI, NE, NG, NU, NF, MP, NO, OM, PK, PW, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, KR, MD, RO, RU, RW, RE, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SK, SI, SB, SO, ZA, GS, SS, ES, LK, PS, SD, SR, SJ, SE, CH, SY, TW, TJ, TH, MK, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, GB, TZ, UM, VI, UY, UZ, VU, VE, VN, WF, EH, YE, ZM, ZW Required
Description
Name
note
Type
string Required
Description
Name
vcdbVehicleId
Type
string Required
Description
Name
ownerCount
Type
integer Required
Description
Name
orderCount
Type
integer Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
tirePressureLogCount
Type
integer Required
Description
Name
mileageLogCount
Type
integer Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
messageCount
Type
integer Required
Description
Name
computed_ymm
Type
string Required
Description
Name
customPhoto
Type
boolean Required
Description
Name
stockPhoto
Type
boolean Required
Description
Name
labels
Type
object Required
Description
Name
externalId
Type
string Required
Description
an id that can be used to reference the vehicle in an external system
Name
originLocationId
Type
string Required
Description
the location that created the vehicle
Name
imported
Type
boolean Required
Description
Name
length
Type
number Required
Description
Name
lengthUnit
Type
one of: Ft, M Required
Description
Name
hin
Type
string Required
Description
Vessel hull identification number
Name
serial
Type
string Required
Description
Name
name
Type
string Required
Description
Custom vehicle name / Vessel registered name
Name
coalescedVINorHIN
Type
string Required
Description
Name
lastServicedDate
Type
string Required
Description
Name
frontTireSize
Type
string Required
Description
custom front tire size override value
Name
rearTireSize
Type
string Required
Description
custom rear tire size override value
Name
drivingCondition
Type
one of: Normal, Severe Required
Description
Name
engines
Type
object Required
Description
an array of engines { id: string; make: string; model: string; hours: number; noHoursMeter: boolean; horsepower: number; serial: string; productionYear: number; productionMonth: number; }
Name
engineHoursLogs
Type
object Required
Description
an array of engine hours logs { engineId: string; inHours: number; outHours: number; orderId: string; }
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
customFields
Type
object
Description
custom fields as JSON object
Name
tirePressureLogs
Type
array
Description

Properties for `workflowStatus` object

Name
id
Type
string Required
Description
Name
name
Type
string Required
Description

`4xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

`5xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

DELETE

/v3/order/:orderId/service/:serviceId/part/:id

curl https://api.shopmonkey.cloud/v3/order/:orderId/service/:serviceId/part/:id \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -X DELETE -H 'Content-Type: application/json' \
  --data '{}'

Example Response
application/json

{
  "success": true,
  "data": {
    "order": {
      "id": "id",
      "publicId": "publicId",
      "createdDate": "createdDate",
      "updatedDate": null,
      "companyId": "companyId",
      "locationId": "locationId",
      "number": 1,
      "vehicleId": null,
      "phoneNumberId": null,
      "emailId": null,
      "customerId": null,
      "name": null,
      "generatedName": null,
      "coalescedName": null,
      "complaint": null,
      "recommendation": null,
      "purchaseOrderNumber": null,
      "generatedVehicleName": null,
      "generatedCustomerName": null,
      "orderCreatedDate": "orderCreatedDate",
      "archived": true,
      "authorized": true,
      "authorizedDate": null,
      "invoiced": true,
      "sentToCarfax": true,
      "inspectionStatus": "inspectionStatus",
      "inspectionCount": 1,
      "invoicedDate": null,
      "paid": true,
      "appointmentDates": "2023-01-29T16:43:58.403Z",
      "assignedTechnicianIds": [
        "assignedTechnicianIds"
      ],
      "messageCount": 1,
      "shopUnreadMessageCount": 1,
      "totalCostCents": 1,
      "paidCostCents": 1,
      "remainingCostCents": null,
      "partsCents": 1,
      "tiresCents": 1,
      "laborCents": 1,
      "subcontractsCents": 1,
      "epaCents": 1,
      "discountCents": 1,
      "discountPercent": 1,
      "shopSuppliesCents": 1,
      "feesCents": 1,
      "taxCents": 1,
      "gstCents": 1,
      "pstCents": 1,
      "hstCents": 1,
      "workflowStatusId": "workflowStatusId",
      "workflowStatusPosition": 1,
      "taxConfigId": "taxConfigId",
      "dueDate": null,
      "serviceWriterId": null,
      "mileageIn": null,
      "mileageOut": null,
      "conversationId": "conversationId",
      "completedDate": null,
      "deleted": true,
      "deletedUserId": null,
      "deletedDate": null,
      "deletedReason": null,
      "readOnly": true,
      "readOnlyReason": null,
      "deferredServiceCount": 1,
      "statementId": null,
      "customFields": {},
      "profitability": {
        "parts": {
          "discountPercent": 1,
          "discountCents": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "labor": {
          "discountPercent": 1,
          "discountCents": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "subcontracts": {
          "discountPercent": 1,
          "discountCents": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "tires": {
          "discountPercent": 1,
          "discountCents": 1,
          "profitCents": 1,
          "profitPercent": 1,
          "retailCents": 1,
          "wholesaleCents": 1
        },
        "totalProfitPercent": 1,
        "totalProfitCents": 1,
        "totalRetailCents": 1,
        "totalWholesaleCents": 1,
        "totalDiscountCents": 1,
        "totalDiscountPercent": 1
      },
      "labelConnections": [
        {
          "label": {
            "id": "id",
            "name": "name",
            "color": "color",
            "entity": "entity",
            "saved": true
          }
        }
      ],
      "customer": {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "customerType": "customerType",
        "firstName": null,
        "lastName": null,
        "companyName": null,
        "address1": null,
        "address2": null,
        "city": null,
        "state": null,
        "country": null,
        "postalCode": null,
        "dotNumber": null,
        "paymentTermId": "paymentTermId",
        "note": "note",
        "marketingOptIn": true,
        "preferredContactMethod": null,
        "referralSourceId": null,
        "taxExempt": true,
        "discountPercent": 1,
        "laborRateId": null,
        "laborMatrixId": null,
        "pricingMatrixId": null,
        "fleetId": null,
        "lastTimeOrderWorked": null,
        "statementCount": 1,
        "transactionCount": 1,
        "deferredServiceCount": 1,
        "appointmentCount": 1,
        "messageCount": 1,
        "labelConnections": [
          {
            "label": {
              "id": "id",
              "name": "name",
              "color": "color",
              "entity": "entity",
              "saved": true
            }
          }
        ],
        "emails": [
          {
            "id": "id",
            "createdDate": "createdDate",
            "updatedDate": null,
            "locationId": "locationId",
            "companyId": "companyId",
            "email": "email",
            "subscribed": true,
            "customerId": "customerId",
            "primary": true
          }
        ],
        "phoneNumbers": [
          {
            "id": "id",
            "createdDate": "createdDate",
            "updatedDate": null,
            "locationId": "locationId",
            "companyId": "companyId",
            "customerId": "customerId",
            "number": "number",
            "extension": null,
            "country": null,
            "type": null,
            "userDefinedType": null,
            "carrierName": null,
            "optInVerifiedDate": null,
            "optIn": true,
            "lastVerifiedDate": null,
            "primary": true,
            "mobileCountryCode": null,
            "mobileNetworkCode": null
          }
        ],
        "customFields": {}
      },
      "vehicle": {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "size": "size",
        "type": null,
        "year": null,
        "make": null,
        "makeId": null,
        "model": null,
        "modelId": null,
        "submodel": null,
        "submodelId": null,
        "engine": null,
        "productionDate": null,
        "transmission": null,
        "drivetrain": null,
        "vin": null,
        "color": null,
        "unit": null,
        "mileage": null,
        "mileageUnit": "mileageUnit",
        "odometer": true,
        "licensePlate": null,
        "licensePlateState": null,
        "licensePlateCountry": "licensePlateCountry",
        "note": "note",
        "vcdbVehicleId": null,
        "ownerCount": 1,
        "orderCount": 1,
        "appointmentCount": 1,
        "tirePressureLogCount": 1,
        "mileageLogCount": 1,
        "deferredServiceCount": 1,
        "messageCount": 1,
        "customPhoto": true,
        "stockPhoto": true,
        "labelConnections": [
          {
            "label": {
              "id": "id",
              "name": "name",
              "color": "color",
              "entity": "entity",
              "saved": true
            }
          }
        ],
        "tirePressureLogs": [
          {
            "id": "id",
            "createdDate": "createdDate",
            "updatedDate": null,
            "companyId": "companyId",
            "locationId": "locationId",
            "orderId": "orderId",
            "vehicleId": "vehicleId",
            "frontLeft": null,
            "frontRight": null,
            "rearLeft": null,
            "rearRight": null
          }
        ],
        "customFields": {}
      },
      "appointments": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "name": "name",
          "startDate": "startDate",
          "endDate": "endDate",
          "rruleset": null,
          "customerId": null,
          "note": "note",
          "vehicleId": null,
          "orderId": null,
          "color": "color",
          "useEmail": true,
          "useSMS": true,
          "sendConfirmation": true,
          "sendReminder": true,
          "cancelationNote": null,
          "pendingConfirmation": true,
          "confirmed": true,
          "allDay": true,
          "removedFromRecurrency": true,
          "customerEmailId": null,
          "customerPhoneNumberId": null,
          "locationId": "locationId"
        }
      ],
      "inspections": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "locationId": "locationId",
          "orderId": "orderId",
          "name": "name",
          "createdById": null,
          "templateId": null,
          "completed": true,
          "completedDate": null,
          "completedById": null,
          "ordinal": 1
        }
      ],
      "authorizations": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "locationId": "locationId",
          "orderId": "orderId",
          "date": "date",
          "serviceWriterId": null,
          "customerId": null,
          "method": "method",
          "authorizedCostCents": 1,
          "note": "note"
        }
      ],
      "workflowStatus": {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "name": null,
        "position": 1,
        "daysToArchive": 1,
        "archiveWhenInactive": true,
        "invoiceWorkflow": true
      },
      "services": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "locationId": "locationId",
          "name": "name",
          "note": "note",
          "orderId": "orderId",
          "lumpSum": true,
          "recommended": true,
          "epaPercent": 1,
          "epaCents": 1,
          "epaValueType": "epaValueType",
          "discountCents": 1,
          "discountPercent": 1,
          "discountValueType": "discountValueType",
          "taxCents": 1,
          "taxPercent": 1,
          "taxValueType": "taxValueType",
          "gstCents": 1,
          "gstPercent": 1,
          "gstValueType": "gstValueType",
          "pstCents": 1,
          "pstPercent": 1,
          "pstValueType": "pstValueType",
          "hstCents": 1,
          "hstPercent": 1,
          "hstValueType": "hstValueType",
          "shopSuppliesApplied": true,
          "shopSuppliesCents": 1,
          "shopSuppliesPercent": 1,
          "shopSuppliesValueType": "shopSuppliesValueType",
          "authorizationStatus": "authorizationStatus",
          "calculatedPartsCents": 1,
          "calculatedTiresCents": 1,
          "calculatedLaborCents": 1,
          "calculatedSubcontractsCents": 1,
          "calculatedFeeCents": 1,
          "calculatedEpaCents": 1,
          "calculatedDiscountCents": 1,
          "calculatedDiscountPercent": 1,
          "calculatedShopSuppliesCents": 1,
          "calculatedTaxCents": 1,
          "ordinal": 1,
          "hidden": true,
          "totalCents": 1,
          "sourceServiceId": null,
          "deferredDate": null,
          "deferredReason": null,
          "excludedFromDeferred": true,
          "revived": true,
          "revivedFromId": null,
          "fees": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "companyId": "companyId",
              "locationId": "locationId",
              "serviceId": "serviceId",
              "orderId": "orderId",
              "feeType": "feeType",
              "percent": 1,
              "amountCents": 1,
              "subtotalCents": null,
              "lineItemEntity": null,
              "partId": null,
              "laborId": null,
              "subcontractId": null,
              "tireId": null,
              "name": "name",
              "ordinal": 1,
              "categoryId": null,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              }
            }
          ],
          "labors": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "companyId": "companyId",
              "locationId": "locationId",
              "serviceId": "serviceId",
              "orderId": "orderId",
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "name": null,
              "hours": 1,
              "rateCents": 1,
              "rateId": null,
              "technicianId": null,
              "showHours": true,
              "showNote": true,
              "ordinal": 1,
              "costHours": null,
              "costRateCents": null,
              "costTotalCents": null,
              "multiplier": 1,
              "multiplierType": "multiplierType",
              "note": "note",
              "completed": true,
              "completedDate": null,
              "categoryId": null,
              "skillRequired": null,
              "skillRequiredDescription": null,
              "taxable": true,
              "laborMatrixId": null,
              "laborMatrixDate": null,
              "applicationId": null,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              },
              "laborMatrix": {
                "id": "id",
                "name": "name"
              },
              "laborRate": {
                "id": "id",
                "name": "name"
              }
            }
          ],
          "parts": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "companyId": "companyId",
              "locationId": "locationId",
              "serviceId": "serviceId",
              "orderId": "orderId",
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "quantity": 1,
              "retailCostCents": 1,
              "wholesaleCostCents": null,
              "showNote": true,
              "showPartNumber": true,
              "showCostAndQuantity": true,
              "reduceInventoryCount": true,
              "taxable": true,
              "ordinal": 1,
              "name": "name",
              "note": "note",
              "partNumber": "partNumber",
              "binLocation": "binLocation",
              "vendorId": null,
              "inventoryPartId": null,
              "categoryId": null,
              "pricingMatrixId": null,
              "pricingMatrixDate": null,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              },
              "pricingMatrix": {
                "id": "id",
                "name": "name"
              },
              "vendor": {
                "id": "id",
                "name": "name"
              }
            }
          ],
          "subcontracts": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "locationId": "locationId",
              "companyId": "companyId",
              "name": "name",
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "taxable": true,
              "costCents": 1,
              "retailCostCents": 1,
              "showNote": true,
              "note": null,
              "vendorId": null,
              "serviceId": "serviceId",
              "orderId": "orderId",
              "ordinal": 1,
              "categoryId": null,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              },
              "vendor": {
                "id": "id",
                "name": "name"
              }
            }
          ],
          "tires": [
            {
              "id": "id",
              "createdDate": "createdDate",
              "updatedDate": null,
              "locationId": "locationId",
              "companyId": "companyId",
              "name": "name",
              "note": null,
              "pricingMatrixId": null,
              "pricingMatrixDate": null,
              "discountCents": 1,
              "discountPercent": 1,
              "discountValueType": "discountValueType",
              "quantity": 1,
              "retailCostCents": 1,
              "wholesaleCostCents": null,
              "ordinal": 1,
              "sizeFormat": "sizeFormat",
              "size": null,
              "partNumber": null,
              "binLocation": null,
              "brandId": null,
              "model": null,
              "vendorId": null,
              "seasonality": null,
              "taxable": true,
              "showPartNumber": true,
              "showPriceAndQuantity": true,
              "showNote": true,
              "categoryId": null,
              "serviceId": "serviceId",
              "orderId": "orderId",
              "reduceInventoryCount": true,
              "federalExciseTaxCents": 1,
              "wasteTireFee": 1,
              "sourceItemId": null,
              "labelConnections": [
                {
                  "label": {
                    "id": "id",
                    "name": "name",
                    "color": "color",
                    "entity": "entity",
                    "saved": true
                  }
                }
              ],
              "category": {
                "id": "id",
                "name": "name",
                "parent": {
                  "id": "id",
                  "name": "name"
                }
              },
              "brand": {
                "id": "id",
                "name": "name"
              },
              "pricingMatrix": {
                "id": "id",
                "name": "name"
              },
              "vendor": {
                "id": "id",
                "name": "name"
              }
            }
          ]
        }
      ]
    }
  }
}

GET/v3/order/:orderId/part

Find Services Parts

Find all Services Parts and Purchase order

URL parameters

Name
orderId
Type
string Required
Description
the id for the order

Query String parameters

Name
ids
Type
array
Description
Name
limit
Type
number
Description
the limit on the number of records to return
Name
orderby
Type
string
Description
the order instructions for the result
Name
params
Type
string
Description
additional request specific params
Name
skip
Type
number
Description
the number of records to skip for a paginated result
Name
where
Type
string
Description
an object to use for filtering the results

Produces

The response content type: application/json

`200` Response

Name
code
Type
string
Description
The error code
Name
data
Type
array Required
Description
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if success = false
Name
meta
Type
object
Description
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

Properties for `meta` object

Name
hasMore
Type
boolean
Description
if there are more records available
Name
sums
Type
object
Description
Name
total
Type
number
Description
the total number of records

`4xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

`5xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request

GET

/v3/order/:orderId/part

curl https://api.shopmonkey.cloud/v3/order/:orderId/part \
  -H "Authorization: Bearer ${SM_TOKEN}"

Example Response
application/json

{
  "data": [
    {
      "id": "id",
      "quantity": 1,
      "retailCostCents": 1,
      "wholesaleCostCents": null,
      "reserved": true,
      "name": "name",
      "partNumber": null,
      "inventoryPartId": null,
      "purchaseOrderPartId": null,
      "purchaseStatus": null,
      "inventoryPart": {
        "availableQuantity": 1,
        "id": "id",
        "name": "name",
        "quantity": 1
      },
      "labelConnections": [
        {
          "label": {
            "color": "color",
            "id": "id",
            "name": "name"
          }
        }
      ],
      "purchaseOrderPart": {
        "id": "id",
        "name": "name",
        "purchaseOrder": {
          "id": "id",
          "number": 1,
          "provider": null,
          "status": "status",
          "vendor": {
            "name": "name"
          }
        }
      },
      "service": {
        "id": "id",
        "name": "name"
      },
      "vendor": {
        "id": "id",
        "name": "name"
      }
    }
  ],
  "success": true
}

POST/v3/part/search

Search Part

Search for a Part

Body parameters

Consumes

The following content type is required: application/json

Name
inventory
Type
object
Description
Name
locationIds
Type
array
Description
Name
motorLightDuty
Type
object
Description
Name
term
Type
string Required
Description
Name
vcdbVehicleId
Type
string
Description

Properties for `inventory` object

Name
limit
Type
number Required
Description
Name
page
Type
number Required
Description

Properties for `motorLightDuty` object

Name
limit
Type
number Required
Description
Name
page
Type
number Required
Description

Produces

The response content type: application/json

`200` Response

Name
code
Type
string
Description
The error code
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if success = false
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message
Name
data
Type
object Required
Description

Properties for `data` object

Name
inventory
Type
array Required
Description
Name
motorLightDuty
Type
array Required
Description

`4xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

`5xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

POST

/v3/part/search

curl https://api.shopmonkey.cloud/v3/part/search \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data '{ "term" : "value" }'

Example Response
application/json

{
  "success": true,
  "data": {
    "inventory": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "name": "name",
        "note": null,
        "categoryId": null,
        "vendorId": null,
        "quantity": 1,
        "number": "number",
        "binLocation": null,
        "retailCostCents": 1,
        "wholesaleCostCents": 1,
        "taxable": true,
        "deleted": true,
        "deletedUserId": null,
        "deletedDate": null,
        "deletedReason": null,
        "userId": null
      }
    ],
    "motorLightDuty": [
      {
        "applicationId": 1,
        "catalogId": 1,
        "catalogName": "catalogName",
        "description": "description",
        "manufacturerLabel": "manufacturerLabel",
        "name": "name",
        "partNumber": "partNumber",
        "price": 1,
        "quantity": 1,
        "compatiblePartId": 1
      }
    ]
  },
  "meta": {
    "inventory": {
      "hasMore": true,
      "total": 1
    },
    "motorLightDuty": {
      "hasMore": true,
      "total": 1
    }
  }
}

POST/v3/part/compatible_options

Find Compatible Options

Find all compatible options for a Part

Body parameters

Consumes

The following content type is required: application/json

Name
compatibleId
Type
number Required
Description
Name
inventory
Type
object
Description
Name
locationIds
Type
array
Description
Name
motorLightDuty
Type
object
Description
Name
vcdbVehicleId
Type
string Required
Description

Properties for `inventory` object

Name
limit
Type
number Required
Description
Name
page
Type
number Required
Description

Properties for `motorLightDuty` object

Name
limit
Type
number Required
Description
Name
page
Type
number Required
Description

Produces

The response content type: application/json

`200` Response

Name
code
Type
string
Description
The error code
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if success = false
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message
Name
data
Type
object Required
Description

Properties for `data` object

Name
inventory
Type
array Required
Description
Name
motorLightDuty
Type
array Required
Description

`4xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

`5xx` Response

Name
code
Type
string
Description
The error code
Name
data
Type
object
Description
An optional object containing relevant error data
Name
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

POST

/v3/part/compatible_options

curl https://api.shopmonkey.cloud/v3/part/compatible_options \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data '{ "compatibleId" : 0, "vcdbVehicleId" : "value" }'

Example Response
application/json

{
  "success": true,
  "data": {
    "inventory": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "name": "name",
        "note": null,
        "categoryId": null,
        "vendorId": null,
        "quantity": 1,
        "number": "number",
        "binLocation": null,
        "retailCostCents": 1,
        "wholesaleCostCents": 1,
        "taxable": true,
        "deleted": true,
        "deletedUserId": null,
        "deletedDate": null,
        "deletedReason": null,
        "userId": null
      }
    ],
    "motorLightDuty": [
      {
        "applicationId": 1,
        "catalogId": 1,
        "catalogName": "catalogName",
        "description": "description",
        "manufacturerLabel": "manufacturerLabel",
        "name": "name",
        "partNumber": "partNumber",
        "price": 1,
        "quantity": 1,
        "compatiblePartId": 1
      }
    ]
  },
  "meta": {
    "inventory": {
      "hasMore": true,
      "total": 1
    },
    "motorLightDuty": {
      "hasMore": true,
      "total": 1
    }
  }
}

Part

Body parameters

Consumes

Produces

200 Response

4xx Response

5xx Response

Example Requestapplication/json

Example Responseapplication/json

Query String parameters

Produces

200 Response

Properties for data object

4xx Response

5xx Response

Example Request

Example Responseapplication/json

Body parameters

Consumes

Produces

200 Response

4xx Response

5xx Response

Example Requestapplication/json

Example Responseapplication/json

URL parameters

Body parameters

Consumes

Produces

200 Response

Properties for data object

Properties for order object

Properties for customer object

Properties for paymentTerm object

Properties for profitability object

Properties for labor object

Properties for parts object

Properties for subcontracts object

Properties for tires object

Properties for vehicle object

Properties for workflowStatus object

4xx Response

5xx Response

Example Requestapplication/json

Example Responseapplication/json

URL parameters

Body parameters

Consumes

Produces

200 Response

Properties for data object

Properties for order object

Properties for customer object

Properties for paymentTerm object

Properties for profitability object

Properties for labor object

Properties for parts object

Properties for subcontracts object

Properties for tires object

Properties for vehicle object

Properties for workflowStatus object

4xx Response

5xx Response

Example Requestapplication/json

Example Responseapplication/json

URL parameters

Query String parameters

Body parameters

Consumes

Produces

200 Response

Properties for data object

Properties for order object

Properties for customer object

Properties for paymentTerm object

Properties for profitability object

Properties for labor object

Properties for parts object

Properties for subcontracts object

Properties for tires object

`200` Response

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json

`200` Response

Properties for `data` object

`4xx` Response

`5xx` Response

Example Response
application/json

`200` Response

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json

`200` Response

Properties for `data` object

Properties for `order` object

Properties for `customer` object

Properties for `paymentTerm` object

Properties for `profitability` object

Properties for `labor` object

Properties for `parts` object

Properties for `subcontracts` object

Properties for `tires` object

Properties for `vehicle` object

Properties for `workflowStatus` object

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json

`200` Response

Properties for `data` object

Properties for `order` object

Properties for `customer` object

Properties for `paymentTerm` object

Properties for `profitability` object

Properties for `labor` object

Properties for `parts` object

Properties for `subcontracts` object

Properties for `tires` object

Properties for `vehicle` object

Properties for `workflowStatus` object

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json

`200` Response

Properties for `data` object

Properties for `order` object

Properties for `customer` object

Properties for `paymentTerm` object

Properties for `profitability` object

Properties for `labor` object

Properties for `parts` object

Properties for `subcontracts` object

Properties for `tires` object

Properties for `vehicle` object

Properties for `workflowStatus` object

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json

`200` Response

Properties for `data` object

Properties for `order` object

Properties for `customer` object

Properties for `paymentTerm` object

Properties for `profitability` object

Properties for `labor` object

Properties for `parts` object

Properties for `subcontracts` object

Properties for `tires` object

Properties for `vehicle` object

Properties for `workflowStatus` object

Properties for `part` object

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json