Service

A Service object is a set of items that you perform as part of an Order. An Order can have multiple Services associated with it.

GET/v3/order/:orderId/service

Get Services

Get Services for an Order

URL parameters

Name
orderId
Type
string Required
Description
the id for the order

`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
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/order/:orderId/service

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

Example Response
application/json

{
  "success": true,
  "data": [
    {
      "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,
          "inventoryTireId": null,
          "tireIdentificationNumbers": [
            "tireIdentificationNumbers"
          ],
          "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"
          }
        }
      ]
    }
  ]
}

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

Update Service

Update a Service for an Order

URL parameters

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

Query String parameters

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

Body parameters

Name
authorizationStatus
Type
one of: NotAuthorized, Authorized, Declined
Description
Name
categoryId
Type
string
Description
Name
discountCents
Type
integer
Description
Name
discountPercent
Type
number
Description
Name
discountValueType
Type
one of: Percent, FixedCents
Description
Name
epaCents
Type
integer
Description
Name
epaPercent
Type
number
Description
Name
epaValueType
Type
one of: Percent, FixedCents
Description
Name
excludedFromDeferred
Type
boolean
Description
service that has been removed from the deferred list
Name
fixedPriceCents
Type
integer
Description
the pre-tax cost of the service when pricing is FixedPrice
Name
gstCents
Type
integer
Description
Name
gstPercent
Type
number
Description
Name
gstValueType
Type
one of: Percent, FixedCents
Description
Name
hidden
Type
boolean
Description
Name
hideLineItemPricing
Type
boolean
Description
Name
hstCents
Type
integer
Description
Name
hstPercent
Type
number
Description
Name
hstValueType
Type
one of: Percent, FixedCents
Description
Name
lumpSum
Type
boolean
Description
Name
motorApplicationId
Type
integer
Description
use providerApplicationId
Name
name
Type
string
Description
Name
note
Type
string
Description
Name
orderId
Type
string
Description
Name
ordinal
Type
number
Description
Name
pricing
Type
one of: FixedPrice, LineItem
Description
Name
provider
Type
one of: Motor, Alldata
Description
Name
providerApplicationId
Type
string
Description
Name
pstCents
Type
integer
Description
Name
pstPercent
Type
number
Description
Name
pstValueType
Type
one of: Percent, FixedCents
Description
Name
recommended
Type
boolean
Description
Name
revivedFromId
Type
string
Description
service that was deferred and then re-added, used for chain of deferment tracing
Name
shopSuppliesApplied
Type
boolean
Description
if SS max cap percentage should apply, always true if taxConfig SS setting is NoCap
Name
shopSuppliesCents
Type
integer
Description
Name
shopSuppliesPercent
Type
number
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents
Description
Name
sourceServiceId
Type
string
Description
Name
taxCents
Type
integer
Description
Name
taxPercent
Type
number
Description
Name
taxValueType
Type
one of: Percent, FixedCents
Description
Name
totalCents
Type
integer
Description

`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
allowCollectPayment
Type
boolean Required
Description
Name
allowCustomerApplyCoupon
Type
boolean Required
Description
Name
allowCustomerAuthorization
Type
boolean Required
Description
Name
allowCustomerViewActivity
Type
boolean Required
Description
Name
allowCustomerViewAuthorizations
Type
boolean Required
Description
Name
allowCustomerViewInspections
Type
boolean Required
Description
Name
allowCustomerViewMessages
Type
boolean Required
Description
Name
appliedDiscountCents
Type
integer Required
Description
the total discount applied to the order in cents
Name
appliedDiscountPercent
Type
number Required
Description
the total discount applied to the order in percent
Name
appliedDiscountValueType
Type
one of: Percent, FixedCents Required
Description
Name
appointmentDates
Type
array Required
Description
Name
archived
Type
boolean Required
Description
Name
assignedTechnicianIds
Type
array Required
Description
Name
attributionMessageId
Type
string Required
Description
Name
attributionSource
Type
one of: WorkRequestForm, AppointmentScheduler, Manual, FuzzyCampaignSMSDelivered, FuzzyCampaignEmailRead Required
Description
Name
authorized
Type
boolean Required
Description
Name
authorizedDate
Type
string Required
Description
Name
automatedCampaignId
Type
string Required
Description
Name
coalescedName
Type
string Required
Description
, "generatedName"
Name
companyId
Type
string Required
Description
Name
complaint
Type
string Required
Description
Name
completedAuthorizedLaborHours
Type
number Required
Description
Name
completedDate
Type
string Required
Description
Name
completedLaborHours
Type
number Required
Description
Name
conversationId
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
customerId
Type
string Required
Description
Name
deferredServiceCount
Type
integer Required
Description
// number of services that were deferred, excluding hidden, revived, and maually excluded
Name
deleted
Type
boolean Required
Description
if the record has been 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
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
depositFullyPaid
Type
boolean Required
Description
Name
depositFullyPaidDate
Type
string Required
Description
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
dueDate
Type
string Required
Description
Name
emailId
Type
string Required
Description
id of the email to use instead of the customer's default email
Name
epaCents
Type
integer Required
Description
Name
externalNumber
Type
string Required
Description
allow user to override generated number
Name
feesCents
Type
integer Required
Description
Name
fullyPaidDate
Type
string Required
Description
Name
generatedCustomerName
Type
string Required
Description
"[firstName] [lastName]" pulled from the customer, if any
Name
generatedName
Type
string Required
Description
Name
generatedVehicleName
Type
string Required
Description
"[year] [make] [model] [submodel]" pulled from the vehicle, if any
Name
gstCents
Type
integer Required
Description
Name
hasPayments
Type
boolean Required
Description
if the order has any payments associated with it
Name
hstCents
Type
integer Required
Description
Name
id
Type
string Required
Description
Name
imported
Type
boolean Required
Description
Name
inspectionCount
Type
integer Required
Description
Name
inspectionReviewStatus
Type
one of: None, Reviewed, NotReviewed Required
Description
Name
inspectionStatus
Type
one of: None, Completed, NotCompleted Required
Description
Name
invoiced
Type
boolean Required
Description
Name
invoicedDate
Type
string Required
Description
Name
invoiceLockState
Type
one of: Unlocked, Locked, PreviouslyLocked Required
Description
Name
labels
Type
object Required
Description
Name
laborCents
Type
integer Required
Description
Name
locationId
Type
string Required
Description
Name
messageCount
Type
integer Required
Description
Name
messagedDate
Type
string Required
Description
Name
mileageIn
Type
number Required
Description
Name
mileageOut
Type
number Required
Description
Name
name
Type
string Required
Description
Name
number
Type
string Required
Description
COLLATE "en-u-kn-true"
Name
oneTimeCampaignId
Type
string Required
Description
Name
orderCreatedDate
Type
string Required
Description
allow user to override created date
Name
paid
Type
boolean Required
Description
Name
paidCostCents
Type
integer Required
Description
Name
partsCents
Type
integer Required
Description
Name
paymentDueDate
Type
string Required
Description
Name
paymentTermId
Type
string Required
Description
id of the payment term for the order
Name
phoneNumberId
Type
string Required
Description
id of the phone number to use instead of the customer's default number
Name
pstCents
Type
integer Required
Description
Name
publicId
Type
string Required
Description
Name
purchaseOrderNumber
Type
string Required
Description
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
recommendation
Type
string Required
Description
Name
remainingCostCents
Type
integer Required
Description
Name
repairOrderDate
Type
string Required
Description
// the date the order was moved into repair order status
Name
requestedDepositCents
Type
integer Required
Description
Name
requireESignatureOnAuthorization
Type
boolean Required
Description
Name
requireESignatureOnInspection
Type
boolean Required
Description
Name
requireESignatureOnInvoice
Type
boolean Required
Description
Name
sentToCarfax
Type
boolean Required
Description
Name
serviceWriterId
Type
string Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopUnreadMessageCount
Type
integer Required
Description
Name
statementId
Type
string Required
Description
a statement this order included in
Name
status
Type
one of: Estimate, RepairOrder, Invoice Required
Description
Name
subcontractsCents
Type
integer Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxConfigId
Type
string Required
Description
Name
tiresCents
Type
integer Required
Description
Name
totalAuthorizedLaborHours
Type
number Required
Description
Name
totalCostCents
Type
integer Required
Description
Name
totalLaborHours
Type
number Required
Description
Name
transactionalFeeSubtotalCents
Type
integer Required
Description
// value before taxes
Name
transactionalFeeTotalCents
Type
integer Required
Description
Name
transactionFeeConfigId
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
updatedSinceSignedInvoice
Type
boolean Required
Description
Name
vehicleId
Type
string Required
Description
Name
workflowStatusDate
Type
string Required
Description
Name
workflowStatusDuration
Type
object Required
Description
Stores how many time the order has been in each status
Name
workflowStatusId
Type
string Required
Description
Name
workflowStatusPosition
Type
number Required
Description
Name
appointments
Type
array Required
Description
Deprecated: will return []
Name
authorizations
Type
array Required
Description
Deprecated: will return []
Name
automatedCampaign
Type
object Required
Description
AutomatedCampaign schema
Name
couponOrderDiscount
Type
object Required
Description
CouponOrderDiscount schema
Name
customFields
Type
object Deprecated
Description
DEPRECATED: custom fields as JSON object. This is no longer supported.
Name
customer
Type
object Required
Description
Name
files
Type
array
Description
Name
inspections
Type
array Required
Description
Deprecated: will return []
Name
oneTimeCampaign
Type
object Required
Description
OneTimeCampaign schema
Name
paymentTerm
Type
object
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 `automatedCampaign` object

Name
activatedByUserId
Type
string Required
Description
Name
activatedDate
Type
string Required
Description
Name
campaignContentId
Type
string Required
Description
Name
cannedServiceId
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
contactMethod
Type
one of: SMS, Email, All Required
Description
Name
contentType
Type
one of: PlainText, HTML Required
Description
Name
createdDate
Type
string Required
Description
Name
deferredServiceId
Type
string Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been 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
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
errorMessage
Type
string Required
Description
Name
id
Type
string Required
Description
Name
internalScheduledJobId
Type
string Required
Description
Name
locationId
Type
string Required
Description
Name
name
Type
string Required
Description
Name
normalizedName
Type
string Required
Description
Name
reminderType
Type
one of: Days, Weeks, Months, Years Required
Description
Name
reminderValue
Type
integer Required
Description
Name
status
Type
one of: Draft, Error, Paused, Active Required
Description
Name
type
Type
one of: CannedServiceReminder, DeferredServiceReminder, CustomerLastServiceDate, AnyServiceFollowUp Required
Description
Name
updatedDate
Type
string Required
Description

Properties for `couponOrderDiscount` object

Name
appliedByCustomerId
Type
string Required
Description
the customer that applied the discount
Name
appliedByUserId
Type
string Required
Description
the user that applied the discount
Name
appliedDate
Type
string Required
Description
the time the discount was applied
Name
appliedDiscountCents
Type
integer Required
Description
The discount amount applied when the coupon was redeemed
Name
companyId
Type
string Required
Description
Name
couponId
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
id
Type
string Required
Description
Name
locationId
Type
string Required
Description
Name
orderId
Type
string Required
Description
Name
redeemedDate
Type
string Required
Description
the time the discount was redeemed
Name
redeemedOrderTotalCents
Type
integer Required
Description
Name
status
Type
one of: Applied, Invalid, Redeemed Required
Description
Name
statusDate
Type
string Required
Description
the time the status was last updated
Name
statusInvalidReason
Type
one of: Expired, NotStarted, NotApplicable, MinimumSpend, MaxRedemptions Required
Description
Name
updatedDate
Type
string Required
Description

Properties for `customer` object

Name
address1
Type
string Required
Description
Name
address2
Type
string Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
city
Type
string Required
Description
Name
coalescedFirstNameOrCompanyName
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
companyName
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
createdDate
Type
string Required
Description
Name
customerType
Type
one of: Customer, Fleet Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been 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
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
discountPercent
Type
number Required
Description
Name
dotNumber
Type
string Required
Description
Name
externalId
Type
string Required
Description
an id that can be used to reference the customer in an external system
Name
finixIdentityId
Type
string Required
Description
Name
firstName
Type
string Required
Description
Name
fleetId
Type
string Required
Description
Name
gstExempt
Type
boolean Required
Description
CA specific
Name
hstExempt
Type
boolean Required
Description
CA specific
Name
id
Type
string Required
Description
Name
imported
Type
boolean Required
Description
Name
labels
Type
object Required
Description
Name
laborMatrixId
Type
string Required
Description
Name
laborRateId
Type
string Required
Description
Name
lastName
Type
string Required
Description
Name
lastTimeOrderWorked
Type
string Required
Description
Name
locationIds
Type
array Required
Description
Name
marketingOptIn
Type
boolean Required
Description
was never used
Name
messageCount
Type
integer 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
note
Type
string Required
Description
Name
orderCount
Type
integer Required
Description
Name
originLocationId
Type
string Required
Description
the location that created the customer
Name
paymentTermId
Type
string Required
Description
Name
postalCode
Type
string Required
Description
Name
preferredContactMethod
Type
one of: SMS, Email, All Required
Description
Name
preferredLanguage
Type
one of: en, en_US, fr_CA, es_MX Required
Description
Name
pricingMatrixId
Type
string Required
Description
Name
pstExempt
Type
boolean Required
Description
CA specific
Name
publicId
Type
string Required
Description
Name
referralSourceId
Type
string Required
Description
Name
showLaborHours
Type
boolean Required
Description
visibility overrides for labor hours, taking precedence over location configuration settings
Name
showLaborNote
Type
boolean Required
Description
visibility overrides for labor note, taking precedence over location configuration settings
Name
showPartCostAndQuantity
Type
boolean Required
Description
visibility overrides for part and tire price and quantity, taking precedence over location configuration settings
Name
showPartNote
Type
boolean Required
Description
visibility overrides for part and tire note, taking precedence over location configuration settings
Name
showPartNumber
Type
boolean Required
Description
visibility overrides for part and tire part number, taking precedence over location configuration settings
Name
showSubcontractNote
Type
boolean Required
Description
visibility overrides for subcontract note, taking precedence over location configuration settings
Name
state
Type
string Required
Description
Name
statementCount
Type
integer Required
Description
Name
taxExempt
Type
boolean Required
Description
US specific
Name
transactionCount
Type
integer Required
Description
Name
updatedDate
Type
string Required
Description
Name
vehicleCount
Type
integer Required
Description
Name
website
Type
string Required
Description
Name
bnplPrequalificationData
Type
one of: any, null, any
Description
Sunbit pre-qualification results; amount, date, etc.
Name
customFields
Type
object Deprecated
Description
DEPRECATED: custom fields as JSON object. This is no longer supported.
Name
emails
Type
array Required
Description
Name
phoneNumbers
Type
array Required
Description

Properties for `oneTimeCampaign` object

Name
campaignContentId
Type
string Required
Description
Name
campaignSegmentationId
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
contactMethod
Type
one of: SMS, Email, All Required
Description
Name
contentType
Type
one of: PlainText, HTML Required
Description
Name
createdDate
Type
string Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been 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
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
errorMessage
Type
string Required
Description
Name
id
Type
string Required
Description
Name
locationId
Type
string Required
Description
Name
name
Type
string Required
Description
Name
normalizedName
Type
string Required
Description
Name
sentByUserId
Type
string Required
Description
Name
sentDate
Type
string Required
Description
Name
status
Type
one of: Draft, Error, Sending, Sent Required
Description
Name
updatedDate
Type
string 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
appointmentCount
Type
integer Required
Description
Name
baseId
Type
integer Required
Description
vcdb base id
Name
bedLength
Type
string Required
Description
Name
bodyStyle
Type
string Required
Description
Name
bodyStyleId
Type
integer Required
Description
vcdb body style id
Name
coalescedVINorHIN
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
companyId
Type
string Required
Description
Name
computed_ymm
Type
string Required
Description
Name
configurationStatus
Type
one of: Custom, Incomplete, Invalid, NotSupported, Valid Required
Description
Name
createdDate
Type
string Required
Description
Name
customPhoto
Type
boolean Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been 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
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
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
drivingCondition
Type
one of: Normal, Severe Required
Description
Name
engine
Type
string Required
Description
Name
engineHoursLogs
Type
object Required
Description
an array of engine hours logs { engineId: string; inHours: number; outHours: number; orderId: string; }
Name
engineId
Type
integer Required
Description
vcdb engine id
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
externalId
Type
string Required
Description
an id that can be used to reference the vehicle in an external system
Name
frontTireSize
Type
string Required
Description
custom front tire size override value
Name
hin
Type
string Required
Description
Vessel hull identification number
Name
id
Type
string Required
Description
Name
imported
Type
boolean Required
Description
Name
labels
Type
object Required
Description
Name
lastServicedDate
Type
string Required
Description
Name
length
Type
number Required
Description
Name
lengthUnit
Type
one of: Ft, M Required
Description
Name
licensePlate
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
licensePlateState
Type
string Required
Description
Name
locationIds
Type
array Required
Description
Name
make
Type
string Required
Description
holds Hull make for vessel
Name
makeId
Type
integer Required
Description
vcdb make id
Name
messageCount
Type
integer Required
Description
Name
mileage
Type
number Required
Description
Name
mileageLogCount
Type
integer Required
Description
Name
mileageUnit
Type
one of: Mile, Kilometer Required
Description
Name
model
Type
string Required
Description
Name
modelId
Type
integer Required
Description
vcdb model id
Name
name
Type
string Required
Description
Custom vehicle name / Vessel registered name
Name
note
Type
string Required
Description
Name
odometer
Type
boolean Required
Description
Name
orderCount
Type
integer Required
Description
Name
originLocationId
Type
string Required
Description
the location that created the vehicle
Name
ownerCount
Type
integer Required
Description
Name
preferredLaborGuide
Type
one of: HeavyDuty, LightDuty, Other Required
Description
Name
productionDate
Type
string Required
Description
Name
rearTireSize
Type
string Required
Description
custom rear tire size override value
Name
region
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
serial
Type
string Required
Description
Name
size
Type
one of: HeavyDuty, LightDuty, Other Required
Description
Name
stockPhoto
Type
boolean Required
Description
Name
submodel
Type
string Required
Description
Name
submodelId
Type
integer Required
Description
vcdb submodel id
Name
tirePressureLogCount
Type
integer Required
Description
Name
transmission
Type
one of: Automatic, Manual, AutomaticCVT, AutomaticDualClutch Required
Description
Name
transmissionId
Type
integer Required
Description
vcdb transmission id
Name
transmissionMfrCode
Type
string Required
Description
Name
transmissionSpeed
Type
string Required
Description
Name
type
Type
one of: ATV, Bicycle, BigRig, Boat, CamperTopper, ClassAMotorhome, ClassBMotorhome, ClassCMotorhome, ClassSuperCMotorhome, Convertible, Coupe, FifthWheel, Hatchback, Jeep, Motorcycle, Other, PopUp, RV, SUV, Sedan, Trailer, TravelTrailer, Truck, TruckCamper, UTV, Van, Wagon Required
Description
Name
unit
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
vcdbId
Type
integer Required
Description
vcdb id
Name
vcdbVehicleId
Type
string Required
Description
id of vcdb_vehicle record
Name
vin
Type
string Required
Description
Name
year
Type
integer Required
Description
Name
customFields
Type
object Deprecated
Description
DEPRECATED: custom fields as JSON object. This is no longer supported.
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/:id

curl https://api.shopmonkey.cloud/v3/order/:orderId/service/: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.400Z",
      "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

Add Services

Add Service(s) to an Order

URL parameters

Name
orderId
Type
string Required
Description
the id for the order

Query String parameters

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

Body parameters

Array with the following properties:

Name
fromCannedServiceId
Type
string Required
Description
the id for the service
Name
ordinal
Type
number
Description
the desired ordinal for the service created from a canned service

Name
fromDeferredServiceId
Type
string Required
Description
the id for the service
Name
ordinal
Type
number
Description
the desired ordinal for the service created from a deferred service

Name
authorizationStatus
Type
one of: NotAuthorized, Authorized, Declined
Description
Name
categoryId
Type
string
Description
Name
discountCents
Type
integer
Description
Name
discountPercent
Type
number
Description
Name
discountValueType
Type
one of: Percent, FixedCents
Description
Name
epaCents
Type
integer
Description
Name
epaPercent
Type
number
Description
Name
epaValueType
Type
one of: Percent, FixedCents
Description
Name
excludedFromDeferred
Type
boolean
Description
service that has been removed from the deferred list
Name
fixedPriceCents
Type
integer
Description
the pre-tax cost of the service when pricing is FixedPrice
Name
gstCents
Type
integer
Description
Name
gstPercent
Type
number
Description
Name
gstValueType
Type
one of: Percent, FixedCents
Description
Name
hidden
Type
boolean
Description
Name
hideLineItemPricing
Type
boolean
Description
Name
hstCents
Type
integer
Description
Name
hstPercent
Type
number
Description
Name
hstValueType
Type
one of: Percent, FixedCents
Description
Name
lumpSum
Type
boolean
Description
Name
motorApplicationId
Type
integer
Description
use providerApplicationId
Name
name
Type
string
Description
Name
note
Type
string
Description
Name
ordinal
Type
number
Description
Name
pricing
Type
one of: FixedPrice, LineItem
Description
Name
provider
Type
one of: Motor, Alldata
Description
Name
providerApplicationId
Type
string
Description
Name
pstCents
Type
integer
Description
Name
pstPercent
Type
number
Description
Name
pstValueType
Type
one of: Percent, FixedCents
Description
Name
recommended
Type
boolean
Description
Name
revivedFromId
Type
string
Description
service that was deferred and then re-added, used for chain of deferment tracing
Name
shopSuppliesApplied
Type
boolean
Description
if SS max cap percentage should apply, always true if taxConfig SS setting is NoCap
Name
shopSuppliesCents
Type
integer
Description
Name
shopSuppliesPercent
Type
number
Description
Name
sourceServiceId
Type
string
Description
Name
taxCents
Type
integer
Description
Name
taxPercent
Type
number
Description
Name
taxValueType
Type
one of: Percent, FixedCents
Description
Name
totalCents
Type
integer
Description
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description
Name
locationId
Type
string
Description
the id for the location
Name
cannedServiceId
Type
string
Description
Name
fromCannedServiceLineItemId
Type
string
Description

`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
services
Type
array Required
Description

Properties for `order` object

Name
allowCollectPayment
Type
boolean Required
Description
Name
allowCustomerApplyCoupon
Type
boolean Required
Description
Name
allowCustomerAuthorization
Type
boolean Required
Description
Name
allowCustomerViewActivity
Type
boolean Required
Description
Name
allowCustomerViewAuthorizations
Type
boolean Required
Description
Name
allowCustomerViewInspections
Type
boolean Required
Description
Name
allowCustomerViewMessages
Type
boolean Required
Description
Name
appliedDiscountCents
Type
integer Required
Description
the total discount applied to the order in cents
Name
appliedDiscountPercent
Type
number Required
Description
the total discount applied to the order in percent
Name
appliedDiscountValueType
Type
one of: Percent, FixedCents Required
Description
Name
appointmentDates
Type
array Required
Description
Name
archived
Type
boolean Required
Description
Name
assignedTechnicianIds
Type
array Required
Description
Name
attributionMessageId
Type
string Required
Description
Name
attributionSource
Type
one of: WorkRequestForm, AppointmentScheduler, Manual, FuzzyCampaignSMSDelivered, FuzzyCampaignEmailRead Required
Description
Name
authorized
Type
boolean Required
Description
Name
authorizedDate
Type
string Required
Description
Name
automatedCampaignId
Type
string Required
Description
Name
coalescedName
Type
string Required
Description
, "generatedName"
Name
companyId
Type
string Required
Description
Name
complaint
Type
string Required
Description
Name
completedAuthorizedLaborHours
Type
number Required
Description
Name
completedDate
Type
string Required
Description
Name
completedLaborHours
Type
number Required
Description
Name
conversationId
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
customerId
Type
string Required
Description
Name
deferredServiceCount
Type
integer Required
Description
// number of services that were deferred, excluding hidden, revived, and maually excluded
Name
deleted
Type
boolean Required
Description
if the record has been 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
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
depositFullyPaid
Type
boolean Required
Description
Name
depositFullyPaidDate
Type
string Required
Description
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
dueDate
Type
string Required
Description
Name
emailId
Type
string Required
Description
id of the email to use instead of the customer's default email
Name
epaCents
Type
integer Required
Description
Name
externalNumber
Type
string Required
Description
allow user to override generated number
Name
feesCents
Type
integer Required
Description
Name
fullyPaidDate
Type
string Required
Description
Name
generatedCustomerName
Type
string Required
Description
"[firstName] [lastName]" pulled from the customer, if any
Name
generatedName
Type
string Required
Description
Name
generatedVehicleName
Type
string Required
Description
"[year] [make] [model] [submodel]" pulled from the vehicle, if any
Name
gstCents
Type
integer Required
Description
Name
hasPayments
Type
boolean Required
Description
if the order has any payments associated with it
Name
hstCents
Type
integer Required
Description
Name
id
Type
string Required
Description
Name
imported
Type
boolean Required
Description
Name
inspectionCount
Type
integer Required
Description
Name
inspectionReviewStatus
Type
one of: None, Reviewed, NotReviewed Required
Description
Name
inspectionStatus
Type
one of: None, Completed, NotCompleted Required
Description
Name
invoiced
Type
boolean Required
Description
Name
invoicedDate
Type
string Required
Description
Name
invoiceLockState
Type
one of: Unlocked, Locked, PreviouslyLocked Required
Description
Name
labels
Type
object Required
Description
Name
laborCents
Type
integer Required
Description
Name
locationId
Type
string Required
Description
Name
messageCount
Type
integer Required
Description
Name
messagedDate
Type
string Required
Description
Name
mileageIn
Type
number Required
Description
Name
mileageOut
Type
number Required
Description
Name
name
Type
string Required
Description
Name
number
Type
string Required
Description
COLLATE "en-u-kn-true"
Name
oneTimeCampaignId
Type
string Required
Description
Name
orderCreatedDate
Type
string Required
Description
allow user to override created date
Name
paid
Type
boolean Required
Description
Name
paidCostCents
Type
integer Required
Description
Name
partsCents
Type
integer Required
Description
Name
paymentDueDate
Type
string Required
Description
Name
paymentTermId
Type
string Required
Description
id of the payment term for the order
Name
phoneNumberId
Type
string Required
Description
id of the phone number to use instead of the customer's default number
Name
pstCents
Type
integer Required
Description
Name
publicId
Type
string Required
Description
Name
purchaseOrderNumber
Type
string Required
Description
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
recommendation
Type
string Required
Description
Name
remainingCostCents
Type
integer Required
Description
Name
repairOrderDate
Type
string Required
Description
// the date the order was moved into repair order status
Name
requestedDepositCents
Type
integer Required
Description
Name
requireESignatureOnAuthorization
Type
boolean Required
Description
Name
requireESignatureOnInspection
Type
boolean Required
Description
Name
requireESignatureOnInvoice
Type
boolean Required
Description
Name
sentToCarfax
Type
boolean Required
Description
Name
serviceWriterId
Type
string Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopUnreadMessageCount
Type
integer Required
Description
Name
statementId
Type
string Required
Description
a statement this order included in
Name
status
Type
one of: Estimate, RepairOrder, Invoice Required
Description
Name
subcontractsCents
Type
integer Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxConfigId
Type
string Required
Description
Name
tiresCents
Type
integer Required
Description
Name
totalAuthorizedLaborHours
Type
number Required
Description
Name
totalCostCents
Type
integer Required
Description
Name
totalLaborHours
Type
number Required
Description
Name
transactionalFeeSubtotalCents
Type
integer Required
Description
// value before taxes
Name
transactionalFeeTotalCents
Type
integer Required
Description
Name
transactionFeeConfigId
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
updatedSinceSignedInvoice
Type
boolean Required
Description
Name
vehicleId
Type
string Required
Description
Name
workflowStatusDate
Type
string Required
Description
Name
workflowStatusDuration
Type
object Required
Description
Stores how many time the order has been in each status
Name
workflowStatusId
Type
string Required
Description
Name
workflowStatusPosition
Type
number Required
Description
Name
appointments
Type
array Required
Description
Deprecated: will return []
Name
authorizations
Type
array Required
Description
Deprecated: will return []
Name
automatedCampaign
Type
object Required
Description
AutomatedCampaign schema
Name
couponOrderDiscount
Type
object Required
Description
CouponOrderDiscount schema
Name
customFields
Type
object Deprecated
Description
DEPRECATED: custom fields as JSON object. This is no longer supported.
Name
customer
Type
object Required
Description
Name
files
Type
array
Description
Name
inspections
Type
array Required
Description
Deprecated: will return []
Name
oneTimeCampaign
Type
object Required
Description
OneTimeCampaign schema
Name
paymentTerm
Type
object
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 `automatedCampaign` object

Name
activatedByUserId
Type
string Required
Description
Name
activatedDate
Type
string Required
Description
Name
campaignContentId
Type
string Required
Description
Name
cannedServiceId
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
contactMethod
Type
one of: SMS, Email, All Required
Description
Name
contentType
Type
one of: PlainText, HTML Required
Description
Name
createdDate
Type
string Required
Description
Name
deferredServiceId
Type
string Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been 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
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
errorMessage
Type
string Required
Description
Name
id
Type
string Required
Description
Name
internalScheduledJobId
Type
string Required
Description
Name
locationId
Type
string Required
Description
Name
name
Type
string Required
Description
Name
normalizedName
Type
string Required
Description
Name
reminderType
Type
one of: Days, Weeks, Months, Years Required
Description
Name
reminderValue
Type
integer Required
Description
Name
status
Type
one of: Draft, Error, Paused, Active Required
Description
Name
type
Type
one of: CannedServiceReminder, DeferredServiceReminder, CustomerLastServiceDate, AnyServiceFollowUp Required
Description
Name
updatedDate
Type
string Required
Description

Properties for `couponOrderDiscount` object

Name
appliedByCustomerId
Type
string Required
Description
the customer that applied the discount
Name
appliedByUserId
Type
string Required
Description
the user that applied the discount
Name
appliedDate
Type
string Required
Description
the time the discount was applied
Name
appliedDiscountCents
Type
integer Required
Description
The discount amount applied when the coupon was redeemed
Name
companyId
Type
string Required
Description
Name
couponId
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
id
Type
string Required
Description
Name
locationId
Type
string Required
Description
Name
orderId
Type
string Required
Description
Name
redeemedDate
Type
string Required
Description
the time the discount was redeemed
Name
redeemedOrderTotalCents
Type
integer Required
Description
Name
status
Type
one of: Applied, Invalid, Redeemed Required
Description
Name
statusDate
Type
string Required
Description
the time the status was last updated
Name
statusInvalidReason
Type
one of: Expired, NotStarted, NotApplicable, MinimumSpend, MaxRedemptions Required
Description
Name
updatedDate
Type
string Required
Description

Properties for `customer` object

Name
address1
Type
string Required
Description
Name
address2
Type
string Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
city
Type
string Required
Description
Name
coalescedFirstNameOrCompanyName
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
companyName
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
createdDate
Type
string Required
Description
Name
customerType
Type
one of: Customer, Fleet Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been 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
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
discountPercent
Type
number Required
Description
Name
dotNumber
Type
string Required
Description
Name
externalId
Type
string Required
Description
an id that can be used to reference the customer in an external system
Name
finixIdentityId
Type
string Required
Description
Name
firstName
Type
string Required
Description
Name
fleetId
Type
string Required
Description
Name
gstExempt
Type
boolean Required
Description
CA specific
Name
hstExempt
Type
boolean Required
Description
CA specific
Name
id
Type
string Required
Description
Name
imported
Type
boolean Required
Description
Name
labels
Type
object Required
Description
Name
laborMatrixId
Type
string Required
Description
Name
laborRateId
Type
string Required
Description
Name
lastName
Type
string Required
Description
Name
lastTimeOrderWorked
Type
string Required
Description
Name
locationIds
Type
array Required
Description
Name
marketingOptIn
Type
boolean Required
Description
was never used
Name
messageCount
Type
integer 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
note
Type
string Required
Description
Name
orderCount
Type
integer Required
Description
Name
originLocationId
Type
string Required
Description
the location that created the customer
Name
paymentTermId
Type
string Required
Description
Name
postalCode
Type
string Required
Description
Name
preferredContactMethod
Type
one of: SMS, Email, All Required
Description
Name
preferredLanguage
Type
one of: en, en_US, fr_CA, es_MX Required
Description
Name
pricingMatrixId
Type
string Required
Description
Name
pstExempt
Type
boolean Required
Description
CA specific
Name
publicId
Type
string Required
Description
Name
referralSourceId
Type
string Required
Description
Name
showLaborHours
Type
boolean Required
Description
visibility overrides for labor hours, taking precedence over location configuration settings
Name
showLaborNote
Type
boolean Required
Description
visibility overrides for labor note, taking precedence over location configuration settings
Name
showPartCostAndQuantity
Type
boolean Required
Description
visibility overrides for part and tire price and quantity, taking precedence over location configuration settings
Name
showPartNote
Type
boolean Required
Description
visibility overrides for part and tire note, taking precedence over location configuration settings
Name
showPartNumber
Type
boolean Required
Description
visibility overrides for part and tire part number, taking precedence over location configuration settings
Name
showSubcontractNote
Type
boolean Required
Description
visibility overrides for subcontract note, taking precedence over location configuration settings
Name
state
Type
string Required
Description
Name
statementCount
Type
integer Required
Description
Name
taxExempt
Type
boolean Required
Description
US specific
Name
transactionCount
Type
integer Required
Description
Name
updatedDate
Type
string Required
Description
Name
vehicleCount
Type
integer Required
Description
Name
website
Type
string Required
Description
Name
bnplPrequalificationData
Type
one of: any, null, any
Description
Sunbit pre-qualification results; amount, date, etc.
Name
customFields
Type
object Deprecated
Description
DEPRECATED: custom fields as JSON object. This is no longer supported.
Name
emails
Type
array Required
Description
Name
phoneNumbers
Type
array Required
Description

Properties for `oneTimeCampaign` object

Name
campaignContentId
Type
string Required
Description
Name
campaignSegmentationId
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
contactMethod
Type
one of: SMS, Email, All Required
Description
Name
contentType
Type
one of: PlainText, HTML Required
Description
Name
createdDate
Type
string Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been 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
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
errorMessage
Type
string Required
Description
Name
id
Type
string Required
Description
Name
locationId
Type
string Required
Description
Name
name
Type
string Required
Description
Name
normalizedName
Type
string Required
Description
Name
sentByUserId
Type
string Required
Description
Name
sentDate
Type
string Required
Description
Name
status
Type
one of: Draft, Error, Sending, Sent Required
Description
Name
updatedDate
Type
string 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
appointmentCount
Type
integer Required
Description
Name
baseId
Type
integer Required
Description
vcdb base id
Name
bedLength
Type
string Required
Description
Name
bodyStyle
Type
string Required
Description
Name
bodyStyleId
Type
integer Required
Description
vcdb body style id
Name
coalescedVINorHIN
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
companyId
Type
string Required
Description
Name
computed_ymm
Type
string Required
Description
Name
configurationStatus
Type
one of: Custom, Incomplete, Invalid, NotSupported, Valid Required
Description
Name
createdDate
Type
string Required
Description
Name
customPhoto
Type
boolean Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been 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
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
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
drivingCondition
Type
one of: Normal, Severe Required
Description
Name
engine
Type
string Required
Description
Name
engineHoursLogs
Type
object Required
Description
an array of engine hours logs { engineId: string; inHours: number; outHours: number; orderId: string; }
Name
engineId
Type
integer Required
Description
vcdb engine id
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
externalId
Type
string Required
Description
an id that can be used to reference the vehicle in an external system
Name
frontTireSize
Type
string Required
Description
custom front tire size override value
Name
hin
Type
string Required
Description
Vessel hull identification number
Name
id
Type
string Required
Description
Name
imported
Type
boolean Required
Description
Name
labels
Type
object Required
Description
Name
lastServicedDate
Type
string Required
Description
Name
length
Type
number Required
Description
Name
lengthUnit
Type
one of: Ft, M Required
Description
Name
licensePlate
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
licensePlateState
Type
string Required
Description
Name
locationIds
Type
array Required
Description
Name
make
Type
string Required
Description
holds Hull make for vessel
Name
makeId
Type
integer Required
Description
vcdb make id
Name
messageCount
Type
integer Required
Description
Name
mileage
Type
number Required
Description
Name
mileageLogCount
Type
integer Required
Description
Name
mileageUnit
Type
one of: Mile, Kilometer Required
Description
Name
model
Type
string Required
Description
Name
modelId
Type
integer Required
Description
vcdb model id
Name
name
Type
string Required
Description
Custom vehicle name / Vessel registered name
Name
note
Type
string Required
Description
Name
odometer
Type
boolean Required
Description
Name
orderCount
Type
integer Required
Description
Name
originLocationId
Type
string Required
Description
the location that created the vehicle
Name
ownerCount
Type
integer Required
Description
Name
preferredLaborGuide
Type
one of: HeavyDuty, LightDuty, Other Required
Description
Name
productionDate
Type
string Required
Description
Name
rearTireSize
Type
string Required
Description
custom rear tire size override value
Name
region
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
serial
Type
string Required
Description
Name
size
Type
one of: HeavyDuty, LightDuty, Other Required
Description
Name
stockPhoto
Type
boolean Required
Description
Name
submodel
Type
string Required
Description
Name
submodelId
Type
integer Required
Description
vcdb submodel id
Name
tirePressureLogCount
Type
integer Required
Description
Name
transmission
Type
one of: Automatic, Manual, AutomaticCVT, AutomaticDualClutch Required
Description
Name
transmissionId
Type
integer Required
Description
vcdb transmission id
Name
transmissionMfrCode
Type
string Required
Description
Name
transmissionSpeed
Type
string Required
Description
Name
type
Type
one of: ATV, Bicycle, BigRig, Boat, CamperTopper, ClassAMotorhome, ClassBMotorhome, ClassCMotorhome, ClassSuperCMotorhome, Convertible, Coupe, FifthWheel, Hatchback, Jeep, Motorcycle, Other, PopUp, RV, SUV, Sedan, Trailer, TravelTrailer, Truck, TruckCamper, UTV, Van, Wagon Required
Description
Name
unit
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
vcdbId
Type
integer Required
Description
vcdb id
Name
vcdbVehicleId
Type
string Required
Description
id of vcdb_vehicle record
Name
vin
Type
string Required
Description
Name
year
Type
integer Required
Description
Name
customFields
Type
object Deprecated
Description
DEPRECATED: custom fields as JSON object. This is no longer supported.
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

POST

/v3/order/:orderId/service

curl https://api.shopmonkey.cloud/v3/order/:orderId/service \
  -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.400Z",
      "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/:id

Delete Service

Delete a Service from an Order

URL parameters

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

Query String parameters

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

`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
allowCollectPayment
Type
boolean Required
Description
Name
allowCustomerApplyCoupon
Type
boolean Required
Description
Name
allowCustomerAuthorization
Type
boolean Required
Description
Name
allowCustomerViewActivity
Type
boolean Required
Description
Name
allowCustomerViewAuthorizations
Type
boolean Required
Description
Name
allowCustomerViewInspections
Type
boolean Required
Description
Name
allowCustomerViewMessages
Type
boolean Required
Description
Name
appliedDiscountCents
Type
integer Required
Description
the total discount applied to the order in cents
Name
appliedDiscountPercent
Type
number Required
Description
the total discount applied to the order in percent
Name
appliedDiscountValueType
Type
one of: Percent, FixedCents Required
Description
Name
appointmentDates
Type
array Required
Description
Name
archived
Type
boolean Required
Description
Name
assignedTechnicianIds
Type
array Required
Description
Name
attributionMessageId
Type
string Required
Description
Name
attributionSource
Type
one of: WorkRequestForm, AppointmentScheduler, Manual, FuzzyCampaignSMSDelivered, FuzzyCampaignEmailRead Required
Description
Name
authorized
Type
boolean Required
Description
Name
authorizedDate
Type
string Required
Description
Name
automatedCampaignId
Type
string Required
Description
Name
coalescedName
Type
string Required
Description
, "generatedName"
Name
companyId
Type
string Required
Description
Name
complaint
Type
string Required
Description
Name
completedAuthorizedLaborHours
Type
number Required
Description
Name
completedDate
Type
string Required
Description
Name
completedLaborHours
Type
number Required
Description
Name
conversationId
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
customerId
Type
string Required
Description
Name
deferredServiceCount
Type
integer Required
Description
// number of services that were deferred, excluding hidden, revived, and maually excluded
Name
deleted
Type
boolean Required
Description
if the record has been 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
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
depositFullyPaid
Type
boolean Required
Description
Name
depositFullyPaidDate
Type
string Required
Description
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
dueDate
Type
string Required
Description
Name
emailId
Type
string Required
Description
id of the email to use instead of the customer's default email
Name
epaCents
Type
integer Required
Description
Name
externalNumber
Type
string Required
Description
allow user to override generated number
Name
feesCents
Type
integer Required
Description
Name
fullyPaidDate
Type
string Required
Description
Name
generatedCustomerName
Type
string Required
Description
"[firstName] [lastName]" pulled from the customer, if any
Name
generatedName
Type
string Required
Description
Name
generatedVehicleName
Type
string Required
Description
"[year] [make] [model] [submodel]" pulled from the vehicle, if any
Name
gstCents
Type
integer Required
Description
Name
hasPayments
Type
boolean Required
Description
if the order has any payments associated with it
Name
hstCents
Type
integer Required
Description
Name
id
Type
string Required
Description
Name
imported
Type
boolean Required
Description
Name
inspectionCount
Type
integer Required
Description
Name
inspectionReviewStatus
Type
one of: None, Reviewed, NotReviewed Required
Description
Name
inspectionStatus
Type
one of: None, Completed, NotCompleted Required
Description
Name
invoiced
Type
boolean Required
Description
Name
invoicedDate
Type
string Required
Description
Name
invoiceLockState
Type
one of: Unlocked, Locked, PreviouslyLocked Required
Description
Name
labels
Type
object Required
Description
Name
laborCents
Type
integer Required
Description
Name
locationId
Type
string Required
Description
Name
messageCount
Type
integer Required
Description
Name
messagedDate
Type
string Required
Description
Name
mileageIn
Type
number Required
Description
Name
mileageOut
Type
number Required
Description
Name
name
Type
string Required
Description
Name
number
Type
string Required
Description
COLLATE "en-u-kn-true"
Name
oneTimeCampaignId
Type
string Required
Description
Name
orderCreatedDate
Type
string Required
Description
allow user to override created date
Name
paid
Type
boolean Required
Description
Name
paidCostCents
Type
integer Required
Description
Name
partsCents
Type
integer Required
Description
Name
paymentDueDate
Type
string Required
Description
Name
paymentTermId
Type
string Required
Description
id of the payment term for the order
Name
phoneNumberId
Type
string Required
Description
id of the phone number to use instead of the customer's default number
Name
pstCents
Type
integer Required
Description
Name
publicId
Type
string Required
Description
Name
purchaseOrderNumber
Type
string Required
Description
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
recommendation
Type
string Required
Description
Name
remainingCostCents
Type
integer Required
Description
Name
repairOrderDate
Type
string Required
Description
// the date the order was moved into repair order status
Name
requestedDepositCents
Type
integer Required
Description
Name
requireESignatureOnAuthorization
Type
boolean Required
Description
Name
requireESignatureOnInspection
Type
boolean Required
Description
Name
requireESignatureOnInvoice
Type
boolean Required
Description
Name
sentToCarfax
Type
boolean Required
Description
Name
serviceWriterId
Type
string Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopUnreadMessageCount
Type
integer Required
Description
Name
statementId
Type
string Required
Description
a statement this order included in
Name
status
Type
one of: Estimate, RepairOrder, Invoice Required
Description
Name
subcontractsCents
Type
integer Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxConfigId
Type
string Required
Description
Name
tiresCents
Type
integer Required
Description
Name
totalAuthorizedLaborHours
Type
number Required
Description
Name
totalCostCents
Type
integer Required
Description
Name
totalLaborHours
Type
number Required
Description
Name
transactionalFeeSubtotalCents
Type
integer Required
Description
// value before taxes
Name
transactionalFeeTotalCents
Type
integer Required
Description
Name
transactionFeeConfigId
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
updatedSinceSignedInvoice
Type
boolean Required
Description
Name
vehicleId
Type
string Required
Description
Name
workflowStatusDate
Type
string Required
Description
Name
workflowStatusDuration
Type
object Required
Description
Stores how many time the order has been in each status
Name
workflowStatusId
Type
string Required
Description
Name
workflowStatusPosition
Type
number Required
Description
Name
appointments
Type
array Required
Description
Deprecated: will return []
Name
authorizations
Type
array Required
Description
Deprecated: will return []
Name
automatedCampaign
Type
object Required
Description
AutomatedCampaign schema
Name
couponOrderDiscount
Type
object Required
Description
CouponOrderDiscount schema
Name
customFields
Type
object Deprecated
Description
DEPRECATED: custom fields as JSON object. This is no longer supported.
Name
customer
Type
object Required
Description
Name
files
Type
array
Description
Name
inspections
Type
array Required
Description
Deprecated: will return []
Name
oneTimeCampaign
Type
object Required
Description
OneTimeCampaign schema
Name
paymentTerm
Type
object
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 `automatedCampaign` object

Name
activatedByUserId
Type
string Required
Description
Name
activatedDate
Type
string Required
Description
Name
campaignContentId
Type
string Required
Description
Name
cannedServiceId
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
contactMethod
Type
one of: SMS, Email, All Required
Description
Name
contentType
Type
one of: PlainText, HTML Required
Description
Name
createdDate
Type
string Required
Description
Name
deferredServiceId
Type
string Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been 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
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
errorMessage
Type
string Required
Description
Name
id
Type
string Required
Description
Name
internalScheduledJobId
Type
string Required
Description
Name
locationId
Type
string Required
Description
Name
name
Type
string Required
Description
Name
normalizedName
Type
string Required
Description
Name
reminderType
Type
one of: Days, Weeks, Months, Years Required
Description
Name
reminderValue
Type
integer Required
Description
Name
status
Type
one of: Draft, Error, Paused, Active Required
Description
Name
type
Type
one of: CannedServiceReminder, DeferredServiceReminder, CustomerLastServiceDate, AnyServiceFollowUp Required
Description
Name
updatedDate
Type
string Required
Description

Properties for `couponOrderDiscount` object

Name
appliedByCustomerId
Type
string Required
Description
the customer that applied the discount
Name
appliedByUserId
Type
string Required
Description
the user that applied the discount
Name
appliedDate
Type
string Required
Description
the time the discount was applied
Name
appliedDiscountCents
Type
integer Required
Description
The discount amount applied when the coupon was redeemed
Name
companyId
Type
string Required
Description
Name
couponId
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
id
Type
string Required
Description
Name
locationId
Type
string Required
Description
Name
orderId
Type
string Required
Description
Name
redeemedDate
Type
string Required
Description
the time the discount was redeemed
Name
redeemedOrderTotalCents
Type
integer Required
Description
Name
status
Type
one of: Applied, Invalid, Redeemed Required
Description
Name
statusDate
Type
string Required
Description
the time the status was last updated
Name
statusInvalidReason
Type
one of: Expired, NotStarted, NotApplicable, MinimumSpend, MaxRedemptions Required
Description
Name
updatedDate
Type
string Required
Description

Properties for `customer` object

Name
address1
Type
string Required
Description
Name
address2
Type
string Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
city
Type
string Required
Description
Name
coalescedFirstNameOrCompanyName
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
companyName
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
createdDate
Type
string Required
Description
Name
customerType
Type
one of: Customer, Fleet Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been 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
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
discountPercent
Type
number Required
Description
Name
dotNumber
Type
string Required
Description
Name
externalId
Type
string Required
Description
an id that can be used to reference the customer in an external system
Name
finixIdentityId
Type
string Required
Description
Name
firstName
Type
string Required
Description
Name
fleetId
Type
string Required
Description
Name
gstExempt
Type
boolean Required
Description
CA specific
Name
hstExempt
Type
boolean Required
Description
CA specific
Name
id
Type
string Required
Description
Name
imported
Type
boolean Required
Description
Name
labels
Type
object Required
Description
Name
laborMatrixId
Type
string Required
Description
Name
laborRateId
Type
string Required
Description
Name
lastName
Type
string Required
Description
Name
lastTimeOrderWorked
Type
string Required
Description
Name
locationIds
Type
array Required
Description
Name
marketingOptIn
Type
boolean Required
Description
was never used
Name
messageCount
Type
integer 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
note
Type
string Required
Description
Name
orderCount
Type
integer Required
Description
Name
originLocationId
Type
string Required
Description
the location that created the customer
Name
paymentTermId
Type
string Required
Description
Name
postalCode
Type
string Required
Description
Name
preferredContactMethod
Type
one of: SMS, Email, All Required
Description
Name
preferredLanguage
Type
one of: en, en_US, fr_CA, es_MX Required
Description
Name
pricingMatrixId
Type
string Required
Description
Name
pstExempt
Type
boolean Required
Description
CA specific
Name
publicId
Type
string Required
Description
Name
referralSourceId
Type
string Required
Description
Name
showLaborHours
Type
boolean Required
Description
visibility overrides for labor hours, taking precedence over location configuration settings
Name
showLaborNote
Type
boolean Required
Description
visibility overrides for labor note, taking precedence over location configuration settings
Name
showPartCostAndQuantity
Type
boolean Required
Description
visibility overrides for part and tire price and quantity, taking precedence over location configuration settings
Name
showPartNote
Type
boolean Required
Description
visibility overrides for part and tire note, taking precedence over location configuration settings
Name
showPartNumber
Type
boolean Required
Description
visibility overrides for part and tire part number, taking precedence over location configuration settings
Name
showSubcontractNote
Type
boolean Required
Description
visibility overrides for subcontract note, taking precedence over location configuration settings
Name
state
Type
string Required
Description
Name
statementCount
Type
integer Required
Description
Name
taxExempt
Type
boolean Required
Description
US specific
Name
transactionCount
Type
integer Required
Description
Name
updatedDate
Type
string Required
Description
Name
vehicleCount
Type
integer Required
Description
Name
website
Type
string Required
Description
Name
bnplPrequalificationData
Type
one of: any, null, any
Description
Sunbit pre-qualification results; amount, date, etc.
Name
customFields
Type
object Deprecated
Description
DEPRECATED: custom fields as JSON object. This is no longer supported.
Name
emails
Type
array Required
Description
Name
phoneNumbers
Type
array Required
Description

Properties for `oneTimeCampaign` object

Name
campaignContentId
Type
string Required
Description
Name
campaignSegmentationId
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
contactMethod
Type
one of: SMS, Email, All Required
Description
Name
contentType
Type
one of: PlainText, HTML Required
Description
Name
createdDate
Type
string Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been 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
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
errorMessage
Type
string Required
Description
Name
id
Type
string Required
Description
Name
locationId
Type
string Required
Description
Name
name
Type
string Required
Description
Name
normalizedName
Type
string Required
Description
Name
sentByUserId
Type
string Required
Description
Name
sentDate
Type
string Required
Description
Name
status
Type
one of: Draft, Error, Sending, Sent Required
Description
Name
updatedDate
Type
string 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
appointmentCount
Type
integer Required
Description
Name
baseId
Type
integer Required
Description
vcdb base id
Name
bedLength
Type
string Required
Description
Name
bodyStyle
Type
string Required
Description
Name
bodyStyleId
Type
integer Required
Description
vcdb body style id
Name
coalescedVINorHIN
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
companyId
Type
string Required
Description
Name
computed_ymm
Type
string Required
Description
Name
configurationStatus
Type
one of: Custom, Incomplete, Invalid, NotSupported, Valid Required
Description
Name
createdDate
Type
string Required
Description
Name
customPhoto
Type
boolean Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been 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
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
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
drivingCondition
Type
one of: Normal, Severe Required
Description
Name
engine
Type
string Required
Description
Name
engineHoursLogs
Type
object Required
Description
an array of engine hours logs { engineId: string; inHours: number; outHours: number; orderId: string; }
Name
engineId
Type
integer Required
Description
vcdb engine id
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
externalId
Type
string Required
Description
an id that can be used to reference the vehicle in an external system
Name
frontTireSize
Type
string Required
Description
custom front tire size override value
Name
hin
Type
string Required
Description
Vessel hull identification number
Name
id
Type
string Required
Description
Name
imported
Type
boolean Required
Description
Name
labels
Type
object Required
Description
Name
lastServicedDate
Type
string Required
Description
Name
length
Type
number Required
Description
Name
lengthUnit
Type
one of: Ft, M Required
Description
Name
licensePlate
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
licensePlateState
Type
string Required
Description
Name
locationIds
Type
array Required
Description
Name
make
Type
string Required
Description
holds Hull make for vessel
Name
makeId
Type
integer Required
Description
vcdb make id
Name
messageCount
Type
integer Required
Description
Name
mileage
Type
number Required
Description
Name
mileageLogCount
Type
integer Required
Description
Name
mileageUnit
Type
one of: Mile, Kilometer Required
Description
Name
model
Type
string Required
Description
Name
modelId
Type
integer Required
Description
vcdb model id
Name
name
Type
string Required
Description
Custom vehicle name / Vessel registered name
Name
note
Type
string Required
Description
Name
odometer
Type
boolean Required
Description
Name
orderCount
Type
integer Required
Description
Name
originLocationId
Type
string Required
Description
the location that created the vehicle
Name
ownerCount
Type
integer Required
Description
Name
preferredLaborGuide
Type
one of: HeavyDuty, LightDuty, Other Required
Description
Name
productionDate
Type
string Required
Description
Name
rearTireSize
Type
string Required
Description
custom rear tire size override value
Name
region
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
serial
Type
string Required
Description
Name
size
Type
one of: HeavyDuty, LightDuty, Other Required
Description
Name
stockPhoto
Type
boolean Required
Description
Name
submodel
Type
string Required
Description
Name
submodelId
Type
integer Required
Description
vcdb submodel id
Name
tirePressureLogCount
Type
integer Required
Description
Name
transmission
Type
one of: Automatic, Manual, AutomaticCVT, AutomaticDualClutch Required
Description
Name
transmissionId
Type
integer Required
Description
vcdb transmission id
Name
transmissionMfrCode
Type
string Required
Description
Name
transmissionSpeed
Type
string Required
Description
Name
type
Type
one of: ATV, Bicycle, BigRig, Boat, CamperTopper, ClassAMotorhome, ClassBMotorhome, ClassCMotorhome, ClassSuperCMotorhome, Convertible, Coupe, FifthWheel, Hatchback, Jeep, Motorcycle, Other, PopUp, RV, SUV, Sedan, Trailer, TravelTrailer, Truck, TruckCamper, UTV, Van, Wagon Required
Description
Name
unit
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
vcdbId
Type
integer Required
Description
vcdb id
Name
vcdbVehicleId
Type
string Required
Description
id of vcdb_vehicle record
Name
vin
Type
string Required
Description
Name
year
Type
integer Required
Description
Name
customFields
Type
object Deprecated
Description
DEPRECATED: custom fields as JSON object. This is no longer supported.
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/:id

curl https://api.shopmonkey.cloud/v3/order/:orderId/service/: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.401Z",
      "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"
              }
            }
          ]
        }
      ]
    }
  }
}

Service

Get Services

URL parameters

200 Response

4xx Response

5xx Response

Example Request

Example Responseapplication/json

Update Service

URL parameters

Query String parameters

Body parameters

200 Response

Properties for data object

Properties for order object

Properties for automatedCampaign object

Properties for couponOrderDiscount object

Properties for customer object

Properties for oneTimeCampaign 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

Add Services

URL parameters

Query String parameters

Body parameters

200 Response

Properties for data object

Properties for order object

Properties for automatedCampaign object

Properties for couponOrderDiscount object

Properties for customer object

Properties for oneTimeCampaign 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

Delete Service

URL parameters

Query String parameters

200 Response

Properties for data object

Properties for order object

Properties for automatedCampaign object

Properties for couponOrderDiscount object

Properties for customer object

Properties for oneTimeCampaign 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

`200` Response

`4xx` Response

`5xx` Response

Example Response
application/json

`200` Response

Properties for `data` object

Properties for `order` object

Properties for `automatedCampaign` object

Properties for `couponOrderDiscount` object

Properties for `customer` object

Properties for `oneTimeCampaign` 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 `automatedCampaign` object

Properties for `couponOrderDiscount` object

Properties for `customer` object

Properties for `oneTimeCampaign` 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 `automatedCampaign` object

Properties for `couponOrderDiscount` object

Properties for `customer` object

Properties for `oneTimeCampaign` 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