Subcontract

A Subcontract object represents a specific subcontract line item that you add to an Order as part of a Service.

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

Update Order Line Item

Update an Order Line Item for subcontract

URL parameters

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

Body parameters

Name
locationId
Type
string
Description
Name
name
Type
string
Description
Name
discountCents
Type
integer
Description
Name
discountPercent
Type
number
Description
Name
discountValueType
Type
string
Description
Name
taxable
Type
boolean
Description
US specific
Name
taxableGST
Type
boolean
Description
CA specific
Name
taxableHST
Type
boolean
Description
CA specific
Name
taxablePST
Type
boolean
Description
CA specific
Name
costCents
Type
integer
Description
Name
retailCostCents
Type
integer
Description
Name
showNote
Type
boolean
Description
Show note on estimates and invoices
Name
note
Type
string
Description
Name
vendorId
Type
string
Description
Name
serviceId
Type
string
Description
Name
orderId
Type
string
Description
Name
ordinal
Type
number
Description
Name
categoryId
Type
string
Description
Name
sourceItemId
Type
string
Description
Name
labels
Type
undefined
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
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message
Name
data
Type
object Required
Description

Properties for `data` object

Name
order
Type
object Required
Description
Order schema

Properties for `order` object

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

Properties for `customer` object

Name
id
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
customerType
Type
string Required
Description
Name
firstName
Type
string Required
Description
Name
lastName
Type
string Required
Description
Name
companyName
Type
string Required
Description
Name
address1
Type
string Required
Description
Name
address2
Type
string Required
Description
Name
city
Type
string Required
Description
Name
state
Type
string Required
Description
Name
country
Type
string Required
Description
Name
postalCode
Type
string Required
Description
Name
dotNumber
Type
string Required
Description
Name
paymentTermId
Type
string Required
Description
Name
note
Type
string Required
Description
Name
marketingOptIn
Type
boolean Required
Description
Name
preferredContactMethod
Type
string Required
Description
Name
referralSourceId
Type
string Required
Description
Name
taxExempt
Type
boolean Required
Description
US specific
Name
gstExempt
Type
boolean Required
Description
CA specific
Name
hstExempt
Type
boolean Required
Description
CA specific
Name
pstExempt
Type
boolean Required
Description
CA specific
Name
discountPercent
Type
number Required
Description
Name
laborRateId
Type
string Required
Description
Name
laborMatrixId
Type
string Required
Description
Name
pricingMatrixId
Type
string Required
Description
Name
fleetId
Type
string Required
Description
Name
lastTimeOrderWorked
Type
string Required
Description
Name
statementCount
Type
integer Required
Description
Name
transactionCount
Type
integer Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
messageCount
Type
integer Required
Description
Name
website
Type
string Required
Description
Name
normalizedFirstName
Type
string Required
Description
Name
normalizedLastName
Type
string Required
Description
Name
normalizedName
Type
string Required
Description
if fleet, contains the normalized companyName, else normalized firstName lastName
Name
vehicleCount
Type
integer Required
Description
Name
orderCount
Type
integer Required
Description
Name
finixIdentityId
Type
string Required
Description
Name
labels
Type
undefined Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
labelConnections
Type
array Required
Description
Name
customFields
Type
object
Description
custom fields as JSON object
Name
emails
Type
array Required
Description
Name
phoneNumbers
Type
array Required
Description

Properties for `paymentTerm` object

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

Properties for `profitability` object

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

Properties for `labor` object

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

Properties for `parts` object

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

Properties for `subcontracts` object

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

Properties for `tires` object

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

Properties for `vehicle` object

Name
id
Type
string Required
Description
()
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
size
Type
string Required
Description
Name
type
Type
string Required
Description
Name
year
Type
integer Required
Description
Name
make
Type
string Required
Description
Name
makeId
Type
integer Required
Description
vcdb make id
Name
model
Type
string Required
Description
Name
modelId
Type
integer Required
Description
vcdb model id
Name
submodel
Type
string Required
Description
Name
submodelId
Type
integer Required
Description
vcdb submodel id
Name
engine
Type
string Required
Description
Name
productionDate
Type
string Required
Description
Name
transmission
Type
string Required
Description
Name
transmissionId
Type
integer Required
Description
vcdb transmission id
Name
drivetrain
Type
string Required
Description
Name
bodyStyle
Type
string Required
Description
Name
bedLength
Type
string Required
Description
Name
vin
Type
string Required
Description
Name
color
Type
string Required
Description
Name
unit
Type
string Required
Description
Name
mileage
Type
number Required
Description
Name
mileageUnit
Type
string Required
Description
Name
odometer
Type
boolean Required
Description
Name
licensePlate
Type
string Required
Description
Name
licensePlateState
Type
string Required
Description
Name
licensePlateCountry
Type
string Required
Description
Name
note
Type
string Required
Description
Name
vcdbVehicleId
Type
string Required
Description
Name
ownerCount
Type
integer Required
Description
Name
orderCount
Type
integer Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
tirePressureLogCount
Type
integer Required
Description
Name
mileageLogCount
Type
integer Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
messageCount
Type
integer Required
Description
Name
computed_ymm
Type
string Required
Description
Name
customPhoto
Type
boolean Required
Description
Name
stockPhoto
Type
boolean Required
Description
Name
labels
Type
undefined Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
labelConnections
Type
array Required
Description
Name
customFields
Type
object
Description
custom fields as JSON object
Name
tirePressureLogs
Type
array
Description

Properties for `workflowStatus` object

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

`4xx` Response

Name
code
Type
string
Description
The error code
Name
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
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

PUT

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

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

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

Add Subcontract to Service

Add a Subcontract to a Service for an Order

URL parameters

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

Body parameters

Name
locationId
Type
string
Description
Name
name
Type
string Required
Description
Name
discountCents
Type
integer
Description
Name
discountPercent
Type
number
Description
Name
discountValueType
Type
string
Description
Name
taxableGST
Type
boolean
Description
CA specific
Name
taxableHST
Type
boolean
Description
CA specific
Name
taxablePST
Type
boolean
Description
CA specific
Name
costCents
Type
integer
Description
Name
retailCostCents
Type
integer
Description
Name
showNote
Type
boolean
Description
Show note on estimates and invoices
Name
note
Type
string
Description
Name
vendorId
Type
string
Description
Name
ordinal
Type
number
Description
Name
categoryId
Type
string
Description
Name
sourceItemId
Type
string
Description
Name
labels
Type
undefined
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
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message
Name
data
Type
object Required
Description

Properties for `data` object

Name
order
Type
object Required
Description
Order schema

Properties for `order` object

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

Properties for `customer` object

Name
id
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
customerType
Type
string Required
Description
Name
firstName
Type
string Required
Description
Name
lastName
Type
string Required
Description
Name
companyName
Type
string Required
Description
Name
address1
Type
string Required
Description
Name
address2
Type
string Required
Description
Name
city
Type
string Required
Description
Name
state
Type
string Required
Description
Name
country
Type
string Required
Description
Name
postalCode
Type
string Required
Description
Name
dotNumber
Type
string Required
Description
Name
paymentTermId
Type
string Required
Description
Name
note
Type
string Required
Description
Name
marketingOptIn
Type
boolean Required
Description
Name
preferredContactMethod
Type
string Required
Description
Name
referralSourceId
Type
string Required
Description
Name
taxExempt
Type
boolean Required
Description
US specific
Name
gstExempt
Type
boolean Required
Description
CA specific
Name
hstExempt
Type
boolean Required
Description
CA specific
Name
pstExempt
Type
boolean Required
Description
CA specific
Name
discountPercent
Type
number Required
Description
Name
laborRateId
Type
string Required
Description
Name
laborMatrixId
Type
string Required
Description
Name
pricingMatrixId
Type
string Required
Description
Name
fleetId
Type
string Required
Description
Name
lastTimeOrderWorked
Type
string Required
Description
Name
statementCount
Type
integer Required
Description
Name
transactionCount
Type
integer Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
messageCount
Type
integer Required
Description
Name
website
Type
string Required
Description
Name
normalizedFirstName
Type
string Required
Description
Name
normalizedLastName
Type
string Required
Description
Name
normalizedName
Type
string Required
Description
if fleet, contains the normalized companyName, else normalized firstName lastName
Name
vehicleCount
Type
integer Required
Description
Name
orderCount
Type
integer Required
Description
Name
finixIdentityId
Type
string Required
Description
Name
labels
Type
undefined Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
labelConnections
Type
array Required
Description
Name
customFields
Type
object
Description
custom fields as JSON object
Name
emails
Type
array Required
Description
Name
phoneNumbers
Type
array Required
Description

Properties for `paymentTerm` object

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

Properties for `profitability` object

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

Properties for `labor` object

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

Properties for `parts` object

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

Properties for `subcontracts` object

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

Properties for `tires` object

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

Properties for `vehicle` object

Name
id
Type
string Required
Description
()
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
size
Type
string Required
Description
Name
type
Type
string Required
Description
Name
year
Type
integer Required
Description
Name
make
Type
string Required
Description
Name
makeId
Type
integer Required
Description
vcdb make id
Name
model
Type
string Required
Description
Name
modelId
Type
integer Required
Description
vcdb model id
Name
submodel
Type
string Required
Description
Name
submodelId
Type
integer Required
Description
vcdb submodel id
Name
engine
Type
string Required
Description
Name
productionDate
Type
string Required
Description
Name
transmission
Type
string Required
Description
Name
transmissionId
Type
integer Required
Description
vcdb transmission id
Name
drivetrain
Type
string Required
Description
Name
bodyStyle
Type
string Required
Description
Name
bedLength
Type
string Required
Description
Name
vin
Type
string Required
Description
Name
color
Type
string Required
Description
Name
unit
Type
string Required
Description
Name
mileage
Type
number Required
Description
Name
mileageUnit
Type
string Required
Description
Name
odometer
Type
boolean Required
Description
Name
licensePlate
Type
string Required
Description
Name
licensePlateState
Type
string Required
Description
Name
licensePlateCountry
Type
string Required
Description
Name
note
Type
string Required
Description
Name
vcdbVehicleId
Type
string Required
Description
Name
ownerCount
Type
integer Required
Description
Name
orderCount
Type
integer Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
tirePressureLogCount
Type
integer Required
Description
Name
mileageLogCount
Type
integer Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
messageCount
Type
integer Required
Description
Name
computed_ymm
Type
string Required
Description
Name
customPhoto
Type
boolean Required
Description
Name
stockPhoto
Type
boolean Required
Description
Name
labels
Type
undefined Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
labelConnections
Type
array Required
Description
Name
customFields
Type
object
Description
custom fields as JSON object
Name
tirePressureLogs
Type
array
Description

Properties for `workflowStatus` object

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

`4xx` Response

Name
code
Type
string
Description
The error code
Name
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
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

POST

/v3/order/:orderId/service/:serviceId/subcontract

curl https://api.shopmonkey.cloud/v3/order/ORDERID/service/SERVICEID/subcontract \ 
  -H "Authorization: Bearer ${SM_TOKEN}" \ 
  -X POST -H 'Content-Type: application/json' \ 
  --data '{ "name" : "value" }'

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

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

Delete Order Line Item

Delete an Order Line Item for subcontract

URL parameters

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

`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
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message
Name
data
Type
object Required
Description

Properties for `data` object

Name
order
Type
object Required
Description
Order schema

Properties for `order` object

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

Properties for `customer` object

Name
id
Type
string Required
Description
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
customerType
Type
string Required
Description
Name
firstName
Type
string Required
Description
Name
lastName
Type
string Required
Description
Name
companyName
Type
string Required
Description
Name
address1
Type
string Required
Description
Name
address2
Type
string Required
Description
Name
city
Type
string Required
Description
Name
state
Type
string Required
Description
Name
country
Type
string Required
Description
Name
postalCode
Type
string Required
Description
Name
dotNumber
Type
string Required
Description
Name
paymentTermId
Type
string Required
Description
Name
note
Type
string Required
Description
Name
marketingOptIn
Type
boolean Required
Description
Name
preferredContactMethod
Type
string Required
Description
Name
referralSourceId
Type
string Required
Description
Name
taxExempt
Type
boolean Required
Description
US specific
Name
gstExempt
Type
boolean Required
Description
CA specific
Name
hstExempt
Type
boolean Required
Description
CA specific
Name
pstExempt
Type
boolean Required
Description
CA specific
Name
discountPercent
Type
number Required
Description
Name
laborRateId
Type
string Required
Description
Name
laborMatrixId
Type
string Required
Description
Name
pricingMatrixId
Type
string Required
Description
Name
fleetId
Type
string Required
Description
Name
lastTimeOrderWorked
Type
string Required
Description
Name
statementCount
Type
integer Required
Description
Name
transactionCount
Type
integer Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
messageCount
Type
integer Required
Description
Name
website
Type
string Required
Description
Name
normalizedFirstName
Type
string Required
Description
Name
normalizedLastName
Type
string Required
Description
Name
normalizedName
Type
string Required
Description
if fleet, contains the normalized companyName, else normalized firstName lastName
Name
vehicleCount
Type
integer Required
Description
Name
orderCount
Type
integer Required
Description
Name
finixIdentityId
Type
string Required
Description
Name
labels
Type
undefined Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
labelConnections
Type
array Required
Description
Name
customFields
Type
object
Description
custom fields as JSON object
Name
emails
Type
array Required
Description
Name
phoneNumbers
Type
array Required
Description

Properties for `paymentTerm` object

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

Properties for `profitability` object

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

Properties for `labor` object

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

Properties for `parts` object

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

Properties for `subcontracts` object

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

Properties for `tires` object

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

Properties for `vehicle` object

Name
id
Type
string Required
Description
()
Name
createdDate
Type
string Required
Description
Name
updatedDate
Type
string Required
Description
Name
companyId
Type
string Required
Description
Name
size
Type
string Required
Description
Name
type
Type
string Required
Description
Name
year
Type
integer Required
Description
Name
make
Type
string Required
Description
Name
makeId
Type
integer Required
Description
vcdb make id
Name
model
Type
string Required
Description
Name
modelId
Type
integer Required
Description
vcdb model id
Name
submodel
Type
string Required
Description
Name
submodelId
Type
integer Required
Description
vcdb submodel id
Name
engine
Type
string Required
Description
Name
productionDate
Type
string Required
Description
Name
transmission
Type
string Required
Description
Name
transmissionId
Type
integer Required
Description
vcdb transmission id
Name
drivetrain
Type
string Required
Description
Name
bodyStyle
Type
string Required
Description
Name
bedLength
Type
string Required
Description
Name
vin
Type
string Required
Description
Name
color
Type
string Required
Description
Name
unit
Type
string Required
Description
Name
mileage
Type
number Required
Description
Name
mileageUnit
Type
string Required
Description
Name
odometer
Type
boolean Required
Description
Name
licensePlate
Type
string Required
Description
Name
licensePlateState
Type
string Required
Description
Name
licensePlateCountry
Type
string Required
Description
Name
note
Type
string Required
Description
Name
vcdbVehicleId
Type
string Required
Description
Name
ownerCount
Type
integer Required
Description
Name
orderCount
Type
integer Required
Description
Name
appointmentCount
Type
integer Required
Description
Name
tirePressureLogCount
Type
integer Required
Description
Name
mileageLogCount
Type
integer Required
Description
Name
deferredServiceCount
Type
integer Required
Description
Name
messageCount
Type
integer Required
Description
Name
computed_ymm
Type
string Required
Description
Name
customPhoto
Type
boolean Required
Description
Name
stockPhoto
Type
boolean Required
Description
Name
labels
Type
undefined Required
Description
Name
deleted
Type
boolean Required
Description
if the record has been deleted
Name
deletedUserId
Type
string Required
Description
the user that deleted the record or null if not deleted
Name
deletedDate
Type
string Required
Description
the date that the record was deleted or null if not deleted
Name
deletedReason
Type
string Required
Description
the reason that the record was deleted
Name
labelConnections
Type
array Required
Description
Name
customFields
Type
object
Description
custom fields as JSON object
Name
tirePressureLogs
Type
array
Description

Properties for `workflowStatus` object

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

`4xx` Response

Name
code
Type
string
Description
The error code
Name
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
documentation_url
Type
string
Description
An optional link to the documentation for the error
Name
message
Type
string
Description
the error message if not successful
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

DELETE

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

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

Subcontract

Update Order Line Item

URL parameters

Body parameters

200 Response

Properties for data object

Properties for order object

Properties for customer object

Properties for paymentTerm object

Properties for profitability object

Properties for labor object

Properties for parts object

Properties for subcontracts object

Properties for tires object

Properties for vehicle object

Properties for workflowStatus object

4xx Response

5xx Response

Example Requestapplication/json

Example Responseapplication/json

Add Subcontract to Service

URL parameters

Body parameters

200 Response

Properties for data object

Properties for order object

Properties for customer object

Properties for paymentTerm object

Properties for profitability object

Properties for labor object

Properties for parts object

Properties for subcontracts object

Properties for tires object

Properties for vehicle object

Properties for workflowStatus object

4xx Response

5xx Response

Example Requestapplication/json

Example Responseapplication/json

Delete Order Line Item

URL parameters

200 Response

Properties for data object

Properties for order object

Properties for customer object

Properties for paymentTerm object

Properties for profitability object

Properties for labor object

Properties for parts object

Properties for subcontracts object

Properties for tires object

Properties for vehicle object

Properties for workflowStatus object

4xx Response

5xx Response

Example Requestapplication/json

Example Responseapplication/json

`200` Response

Properties for `data` object

Properties for `order` object

Properties for `customer` object

Properties for `paymentTerm` object

Properties for `profitability` object

Properties for `labor` object

Properties for `parts` object

Properties for `subcontracts` object

Properties for `tires` object

Properties for `vehicle` object

Properties for `workflowStatus` object

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json

`200` Response

Properties for `data` object

Properties for `order` object

Properties for `customer` object

Properties for `paymentTerm` object

Properties for `profitability` object

Properties for `labor` object

Properties for `parts` object

Properties for `subcontracts` object

Properties for `tires` object

Properties for `vehicle` object

Properties for `workflowStatus` object

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json

`200` Response

Properties for `data` object

Properties for `order` object

Properties for `customer` object

Properties for `paymentTerm` object

Properties for `profitability` object

Properties for `labor` object

Properties for `parts` object

Properties for `subcontracts` object

Properties for `tires` object

Properties for `vehicle` object

Properties for `workflowStatus` object

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json