Canned Service

A CannedService object is a reusable service that you can create to make easier when you need to add repeatable services, parts, fees, etc to a Customer Order.

GET/v3/canned_service/:id

Find Canned Service

Find one Canned Service by id

URL parameters

Name
id
Type
string Required
Description
the id for the object to retrieve

Produces

The response content type: application/json

`200` Response

Name
data
Type
object Required
Description
CannedService schema
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

Properties for `data` object

Name
id
Type
string Required
Description
Name
publicId
Type
string Required
Description
Name
meta
Type
object Required
Description
the metadata about the most recent change to the row
Name
metadata
Type
object
Description
metadata reserved for customers to control
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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

Properties for `meta` object

Name
userId
Type
string
Description
the user id that made the most recent change
Name
sessionId
Type
string
Description
the session id for the most recent change
Name
version
Type
number
Description
a monotonically increasing number for the most recent change

`4xx` Response

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

`5xx` Response

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

Example Request

GET

/v3/canned_service/:id

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

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "meta": {
      "userId": "userId",
      "sessionId": "sessionId",
      "version": 1
    },
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

GET/v3/canned_service

List Canned Services

Find all Canned Services

Query String parameters

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

Produces

The response content type: application/json

`200` Response

Name
data
Type
array Required
Description
an array of items
Name
meta
Type
object
Description
Name
success
Type
boolean Required
Description
if successful, will be true. if not successful, will be false and message will contain a human readable error message

Properties for `meta` object

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

`4xx` Response

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

`5xx` Response

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

Example Request

GET

/v3/canned_service

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

Example Response
application/json

{
  "success": true,
  "data": [
    {
      "id": "id",
      "createdDate": "createdDate",
      "updatedDate": null,
      "companyId": "companyId",
      "locationId": "locationId",
      "name": "name",
      "note": "note",
      "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",
      "calculatedPartsCents": 1,
      "calculatedTiresCents": 1,
      "calculatedLaborCents": 1,
      "calculatedSubcontractsCents": 1,
      "calculatedFeeCents": 1,
      "calculatedEpaCents": 1,
      "calculatedDiscountCents": 1,
      "calculatedDiscountPercent": 1,
      "calculatedShopSuppliesCents": 1,
      "calculatedTaxCents": 1,
      "totalCents": 1,
      "deleted": true,
      "deletedUserId": null,
      "deletedDate": null,
      "deletedReason": null,
      "labelConnections": [
        {
          "label": {
            "id": "id",
            "name": "name",
            "color": "color",
            "entity": "entity",
            "saved": true
          }
        }
      ],
      "labors": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "locationId": "locationId",
          "cannedServiceId": "cannedServiceId",
          "discountCents": 1,
          "discountPercent": 1,
          "discountValueType": "discountValueType",
          "name": null,
          "hours": 1,
          "rateCents": 1,
          "rateId": null,
          "showHours": true,
          "showNote": true,
          "ordinal": 1,
          "costHours": null,
          "costRateCents": null,
          "costTotalCents": null,
          "multiplier": 1,
          "multiplierType": "multiplierType",
          "note": "note",
          "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",
          "cannedServiceId": "cannedServiceId",
          "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"
          }
        }
      ],
      "fees": [
        {
          "id": "id",
          "createdDate": "createdDate",
          "updatedDate": null,
          "companyId": "companyId",
          "locationId": "locationId",
          "cannedServiceId": "cannedServiceId",
          "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"
            }
          }
        }
      ],
      "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,
          "cannedServiceId": "cannedServiceId",
          "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"
            }
          },
          "pricingMatrix": {
            "id": "id",
            "name": "name"
          },
          "vendor": {
            "id": "id",
            "name": "name"
          },
          "brand": {
            "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,
          "cannedServiceId": "cannedServiceId",
          "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"
          }
        }
      ]
    }
  ]
}

PATCH/v3/canned_service/:id/:action

Soft Delete Canned Service

Soft delete or undelete a Canned Service by id

URL parameters

Name
action
Type
one of: 'delete', 'undelete' Required
Description
the action to take
Name
id
Type
string Required
Description
primary key for the record

Body parameters

Consumes

The following content type is required: application/json

Name
reason
Type
string Required
Description
the reason message if deleted

Produces

The response content type: application/json

`200` Response

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

Properties for `data` 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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

PATCH

/v3/canned_service/:id/:action

curl https://api.shopmonkey.cloud/v3/canned_service/:id/:action \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -X PATCH -H 'Content-Type: application/json' \
  --data '{ "reason" : "value" }'

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

POST/v3/canned_service

Create Canned Service

Create a new canned service

Body parameters

Consumes

The following content type is required: application/json

Produces

The response content type: application/json

`200` Response

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

Properties for `data` 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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

POST

/v3/canned_service

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

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

PUT/v3/canned_service/:id

Update Canned Service

Update one canned service

URL parameters

Name
id
Type
string Required
Description
the id for the canned service

Body parameters

Consumes

The following content type is required: application/json

Name
pricing
Type
one of: FixedPrice, LineItem
Description
Name
name
Type
string
Description
Name
note
Type
string
Description
Name
lumpSum
Type
boolean
Description
Name
recommended
Type
boolean
Description
Name
epaPercent
Type
number
Description
Name
epaCents
Type
integer
Description
Name
epaValueType
Type
one of: Percent, FixedCents
Description
Name
express
Type
boolean
Description
visibility in Express Lane
Name
discountCents
Type
integer
Description
Name
discountPercent
Type
number
Description
Name
discountValueType
Type
one of: Percent, FixedCents
Description
Name
taxCents
Type
integer
Description
Name
taxPercent
Type
number
Description
Name
taxValueType
Type
one of: Percent, FixedCents
Description
Name
gstCents
Type
integer
Description
Name
gstPercent
Type
number
Description
Name
gstValueType
Type
one of: Percent, FixedCents
Description
Name
pstCents
Type
integer
Description
Name
pstPercent
Type
number
Description
Name
pstValueType
Type
one of: Percent, FixedCents
Description
Name
hstCents
Type
integer
Description
Name
hstPercent
Type
number
Description
Name
hstValueType
Type
one of: Percent, FixedCents
Description
Name
shopSuppliesApplied
Type
boolean
Description
Name
shopSuppliesCents
Type
integer
Description
Name
shopSuppliesPercent
Type
number
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents
Description
Name
fixedPriceCents
Type
integer
Description
the pre-tax cost of the service when pricing is FixedPrice
Name
bookable
Type
boolean
Description
bookable through the appointment scheduler
Name
motorTaxonomyIds
Type
array
Description

Produces

The response content type: application/json

`200` Response

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

Properties for `data` 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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

PUT

/v3/canned_service/:id

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

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

DELETE/v3/canned_service/:id

Delete Canned Service

Permanently delete a Canned Service by id

URL parameters

Name
id
Type
string Required
Description
the id of the record to delete

Produces

The response content type: application/json

`200` Response

Name
data
Type
object
Description
Name
success
Type
boolean Required
Description

Properties for `data` object

Name
id
Type
string Required
Description
the id for the object

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

DELETE

/v3/canned_service/:id

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

Example Response
application/json

{
  "success": true
}

POST/v3/canned_service/:id/part

Create Canned Service Part

Create a new canned service part item

URL parameters

Name
id
Type
string Required
Description
the id for the canned service

Body parameters

Consumes

The following content type is required: application/json

Name
discountCents
Type
integer
Description
Name
discountPercent
Type
number
Description
Name
discountValueType
Type
one of: Percent, FixedCents
Description
Name
quantity
Type
number
Description
Name
retailCostCents
Type
integer
Description
Name
wholesaleCostCents
Type
integer
Description
Name
showNote
Type
boolean
Description
Name
showPartNumber
Type
boolean
Description
Name
showCostAndQuantity
Type
boolean
Description
Name
reduceInventoryCount
Type
boolean
Description
Name
taxableGST
Type
boolean
Description
CA specific
Name
taxablePST
Type
boolean
Description
CA specific
Name
taxableHST
Type
boolean
Description
CA specific
Name
taxable
Type
one of: any, any
Description
US specific
Name
ordinal
Type
number
Description
Name
name
Type
string
Description
Name
note
Type
string
Description
Name
partNumber
Type
string
Description
Name
binLocation
Type
string
Description
Name
vendorId
Type
string
Description
Name
inventoryPartId
Type
string
Description
Name
categoryId
Type
string
Description
Name
pricingMatrixId
Type
string
Description
Name
url
Type
string
Description
Name
dynamic
Type
boolean
Description
Name
type
Type
string
Description
Name
filter
Type
object
Description
Determines which inventory parts to match when part is dynamic
Name
allowManualQuantity
Type
boolean
Description
Allow quantity to be manually set when adding the service
Name
fixedPriceLimitType
Type
one of: None, Quantity, Price
Description
Name
fixedPriceLimitQuantity
Type
number
Description
Quantities exceeding the amount will be charged based on their individual part price as an addition to the fixed price canned service.
Name
fixedPriceLimitPriceCents
Type
integer
Description
Part prices exceeding the amount will have their difference charged in addition to the fixed price canned service.

Produces

The response content type: application/json

`200` Response

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

Properties for `data` 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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

POST

/v3/canned_service/:id/part

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

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

PUT/v3/canned_service/:id/part/:itemId

Update Canned Service Part

Update one canned service part item

URL parameters

Name
id
Type
string Required
Description
the id for the canned service
Name
itemId
Type
string Required
Description
the part item id

Body parameters

Consumes

The following content type is required: application/json

Name
discountCents
Type
integer
Description
Name
discountPercent
Type
number
Description
Name
discountValueType
Type
one of: Percent, FixedCents
Description
Name
quantity
Type
number
Description
Name
retailCostCents
Type
integer
Description
Name
wholesaleCostCents
Type
integer
Description
Name
showNote
Type
boolean
Description
Name
showPartNumber
Type
boolean
Description
Name
showCostAndQuantity
Type
boolean
Description
Name
reduceInventoryCount
Type
boolean
Description
Name
taxableGST
Type
boolean
Description
CA specific
Name
taxablePST
Type
boolean
Description
CA specific
Name
taxableHST
Type
boolean
Description
CA specific
Name
taxable
Type
boolean
Description
US specific
Name
ordinal
Type
number
Description
Name
name
Type
string
Description
Name
note
Type
string
Description
Name
partNumber
Type
string
Description
Name
binLocation
Type
string
Description
Name
vendorId
Type
string
Description
Name
inventoryPartId
Type
string
Description
Name
categoryId
Type
string
Description
Name
pricingMatrixId
Type
string
Description
Name
url
Type
string
Description
Name
dynamic
Type
boolean
Description
Name
type
Type
string
Description
Name
filter
Type
object
Description
Determines which inventory parts to match when part is dynamic
Name
allowManualQuantity
Type
boolean
Description
Allow quantity to be manually set when adding the service
Name
fixedPriceLimitType
Type
one of: None, Quantity, Price
Description
Name
fixedPriceLimitQuantity
Type
number
Description
Quantities exceeding the amount will be charged based on their individual part price as an addition to the fixed price canned service.
Name
fixedPriceLimitPriceCents
Type
integer
Description
Part prices exceeding the amount will have their difference charged in addition to the fixed price canned service.

Produces

The response content type: application/json

`200` Response

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

Properties for `data` 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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

PUT

/v3/canned_service/:id/part/:itemId

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

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

DELETE/v3/canned_service/:id/part/:itemId

Delete Canned Service Part

Delete one canned service part item

URL parameters

Name
id
Type
string Required
Description
the id for the canned service
Name
itemId
Type
string Required
Description
the part item id

Produces

The response content type: application/json

`200` Response

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

Properties for `data` 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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

DELETE

/v3/canned_service/:id/part/:itemId

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

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

POST/v3/canned_service/:id/subcontract

Create Canned Service Subcontract

Create a new canned service subcontract item

URL parameters

Name
id
Type
string Required
Description
the id for the canned service

Body parameters

Consumes

The following content type is required: application/json

Name
name
Type
string Required
Description
Name
discountCents
Type
integer
Description
Name
discountPercent
Type
number
Description
Name
discountValueType
Type
one of: Percent, FixedCents
Description
Name
taxableGST
Type
boolean
Description
CA specific
Name
taxablePST
Type
boolean
Description
CA specific
Name
taxableHST
Type
boolean
Description
CA specific
Name
taxable
Type
one of: any, any
Description
US 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

Produces

The response content type: application/json

`200` Response

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

Properties for `data` 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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

POST

/v3/canned_service/:id/subcontract

curl https://api.shopmonkey.cloud/v3/canned_service/:id/subcontract \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data '{ "name" : "value" }'

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

PUT/v3/canned_service/:id/subcontract/:itemId

Update Canned Service Subcontract

Update one canned service subcontract item

URL parameters

Name
id
Type
string Required
Description
the id for the canned service
Name
itemId
Type
string Required
Description
the subcontract item id

Body parameters

Consumes

The following content type is required: application/json

Name
name
Type
string
Description
Name
discountCents
Type
integer
Description
Name
discountPercent
Type
number
Description
Name
discountValueType
Type
one of: Percent, FixedCents
Description
Name
taxableGST
Type
boolean
Description
CA specific
Name
taxablePST
Type
boolean
Description
CA specific
Name
taxableHST
Type
boolean
Description
CA specific
Name
taxable
Type
boolean
Description
US 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

Produces

The response content type: application/json

`200` Response

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

Properties for `data` 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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

PUT

/v3/canned_service/:id/subcontract/:itemId

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

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

DELETE/v3/canned_service/:id/subcontract/:itemId

Delete Canned Service Subcontract

Delete one canned service subcontract item

URL parameters

Name
id
Type
string Required
Description
the id for the canned service
Name
itemId
Type
string Required
Description
the subcontract item id

Produces

The response content type: application/json

`200` Response

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

Properties for `data` 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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

DELETE

/v3/canned_service/:id/subcontract/:itemId

curl https://api.shopmonkey.cloud/v3/canned_service/:id/subcontract/:itemId \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -X DELETE -H 'Content-Type: application/json' \
  --data '{}'

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

POST/v3/canned_service/:id/tire

Create Canned Service Tire

Create a new canned service tire item

URL parameters

Name
id
Type
string Required
Description
the id for the canned service

Body parameters

Consumes

The following content type is required: application/json

Name
name
Type
string Required
Description
Name
note
Type
string
Description
Name
pricingMatrixId
Type
string
Description
Name
discountCents
Type
integer
Description
Name
discountPercent
Type
number
Description
Name
discountValueType
Type
one of: Percent, FixedCents
Description
Name
quantity
Type
integer
Description
Name
retailCostCents
Type
integer
Description
Name
wholesaleCostCents
Type
integer
Description
Name
ordinal
Type
number
Description
Name
sizeFormat
Type
one of: Conventional, OffRoadSAE
Description
Name
size
Type
string
Description
Name
partNumber
Type
string
Description
Name
binLocation
Type
string
Description
Name
tireModelId
Type
string
Description
Name
taxableGST
Type
boolean
Description
CA specific
Name
taxablePST
Type
boolean
Description
CA specific
Name
taxableHST
Type
boolean
Description
CA specific
Name
taxable
Type
one of: any, any
Description
US specific
Name
showPartNumber
Type
boolean
Description
show on estimates and invoices
Name
showPriceAndQuantity
Type
boolean
Description
show on estimates and invoices
Name
showNote
Type
boolean
Description
show on estimates and invoices
Name
reduceInventoryCount
Type
boolean
Description
Name
federalExciseTaxCents
Type
integer
Description
Name
wasteTireFee
Type
integer
Description
Name
inventoryTireId
Type
string
Description
Name
url
Type
string
Description

Produces

The response content type: application/json

`200` Response

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

Properties for `data` 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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

POST

/v3/canned_service/:id/tire

curl https://api.shopmonkey.cloud/v3/canned_service/:id/tire \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data '{ "name" : "value" }'

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

PUT/v3/canned_service/:id/tire/:itemId

Update Canned Service Tire

Update one canned service tire item

URL parameters

Name
id
Type
string Required
Description
the id for the canned service
Name
itemId
Type
string Required
Description
the tire item id

Body parameters

Consumes

The following content type is required: application/json

Name
name
Type
string
Description
Name
note
Type
string
Description
Name
pricingMatrixId
Type
string
Description
Name
discountCents
Type
integer
Description
Name
discountPercent
Type
number
Description
Name
discountValueType
Type
one of: Percent, FixedCents
Description
Name
quantity
Type
integer
Description
Name
retailCostCents
Type
integer
Description
Name
wholesaleCostCents
Type
integer
Description
Name
ordinal
Type
number
Description
Name
sizeFormat
Type
one of: Conventional, OffRoadSAE
Description
Name
size
Type
string
Description
Name
partNumber
Type
string
Description
Name
binLocation
Type
string
Description
Name
tireModelId
Type
string
Description
Name
taxableGST
Type
boolean
Description
CA specific
Name
taxablePST
Type
boolean
Description
CA specific
Name
taxableHST
Type
boolean
Description
CA specific
Name
taxable
Type
boolean
Description
US specific
Name
showPartNumber
Type
boolean
Description
show on estimates and invoices
Name
showPriceAndQuantity
Type
boolean
Description
show on estimates and invoices
Name
showNote
Type
boolean
Description
show on estimates and invoices
Name
reduceInventoryCount
Type
boolean
Description
Name
federalExciseTaxCents
Type
integer
Description
Name
wasteTireFee
Type
integer
Description
Name
inventoryTireId
Type
string
Description
Name
url
Type
string
Description

Produces

The response content type: application/json

`200` Response

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

Properties for `data` 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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

PUT

/v3/canned_service/:id/tire/:itemId

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

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

DELETE/v3/canned_service/:id/tire/:itemId

Delete Canned Service Tire

Delete one canned service tire item

URL parameters

Name
id
Type
string Required
Description
the id for the canned service
Name
itemId
Type
string Required
Description
the tire item id

Produces

The response content type: application/json

`200` Response

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

Properties for `data` 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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

DELETE

/v3/canned_service/:id/tire/:itemId

curl https://api.shopmonkey.cloud/v3/canned_service/:id/tire/:itemId \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -X DELETE -H 'Content-Type: application/json' \
  --data '{}'

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

POST/v3/canned_service/:id/labor

Create Canned Service Labor

Create a new canned service labor item

URL parameters

Name
id
Type
string Required
Description
the id for the canned service

Body parameters

Consumes

The following content type is required: application/json

Name
discountCents
Type
integer
Description
Name
discountPercent
Type
number
Description
Name
discountValueType
Type
one of: Percent, FixedCents
Description
Name
name
Type
string
Description
Name
hours
Type
number
Description
Name
rateCents
Type
integer
Description
Name
rateId
Type
string
Description
Name
showHours
Type
boolean
Description
Name
showNote
Type
boolean
Description
Name
ordinal
Type
number
Description
Name
costHours
Type
number
Description
Name
costRateCents
Type
integer
Description
Name
costTotalCents
Type
integer
Description
Name
multiplier
Type
number
Description
Name
multiplierType
Type
one of: Hours, Rate
Description
Name
note
Type
string
Description
Name
categoryId
Type
string
Description
Name
skillRequired
Type
one of: General, Maintenance, Precision
Description
Name
skillRequiredDescription
Type
string
Description
Name
taxableGST
Type
boolean
Description
CA specific
Name
taxablePST
Type
boolean
Description
CA specific
Name
taxableHST
Type
boolean
Description
CA specific
Name
taxable
Type
one of: any, any
Description
US specific
Name
laborMatrixId
Type
string
Description
Name
inventoryLaborId
Type
string
Description

Produces

The response content type: application/json

`200` Response

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

Properties for `data` 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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

POST

/v3/canned_service/:id/labor

curl https://api.shopmonkey.cloud/v3/canned_service/:id/labor \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data '{}'

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

PUT/v3/canned_service/:id/labor/:itemId

Update Canned Service Labor

Update one canned service labor item

URL parameters

Name
id
Type
string Required
Description
the id for the canned service
Name
itemId
Type
string Required
Description
the labor item id

Body parameters

Consumes

The following content type is required: application/json

Name
discountCents
Type
integer
Description
Name
discountPercent
Type
number
Description
Name
discountValueType
Type
one of: Percent, FixedCents
Description
Name
name
Type
string
Description
Name
hours
Type
number
Description
Name
rateCents
Type
integer
Description
Name
rateId
Type
string
Description
Name
showHours
Type
boolean
Description
Name
showNote
Type
boolean
Description
Name
ordinal
Type
number
Description
Name
costHours
Type
number
Description
Name
costRateCents
Type
integer
Description
Name
costTotalCents
Type
integer
Description
Name
multiplier
Type
number
Description
Name
multiplierType
Type
one of: Hours, Rate
Description
Name
note
Type
string
Description
Name
categoryId
Type
string
Description
Name
skillRequired
Type
one of: General, Maintenance, Precision
Description
Name
skillRequiredDescription
Type
string
Description
Name
taxableGST
Type
boolean
Description
CA specific
Name
taxablePST
Type
boolean
Description
CA specific
Name
taxableHST
Type
boolean
Description
CA specific
Name
taxable
Type
boolean
Description
US specific
Name
laborMatrixId
Type
string
Description
Name
inventoryLaborId
Type
string
Description

Produces

The response content type: application/json

`200` Response

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

Properties for `data` 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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

PUT

/v3/canned_service/:id/labor/:itemId

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

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

DELETE/v3/canned_service/:id/labor/:itemId

Delete Canned Service Labor

Delete one canned service labor item

URL parameters

Name
id
Type
string Required
Description
the id for the canned service
Name
itemId
Type
string Required
Description
the labor item id

Produces

The response content type: application/json

`200` Response

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

Properties for `data` 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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

DELETE

/v3/canned_service/:id/labor/:itemId

curl https://api.shopmonkey.cloud/v3/canned_service/:id/labor/:itemId \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -X DELETE -H 'Content-Type: application/json' \
  --data '{}'

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

POST/v3/canned_service/:id/fee

Create Canned Service Fee

Create a new canned service fee item

URL parameters

Name
id
Type
string Required
Description
the id for the canned service

Body parameters

Consumes

The following content type is required: application/json

Name
feeType
Type
one of: PercentLineItem, PercentService, FixedCents
Description
Name
percent
Type
number
Description
Name
amountCents
Type
integer
Description
Name
lineItemEntity
Type
one of: Labor, Part, Subcontract, Tire
Description
Name
partId
Type
string
Description
Name
laborId
Type
string
Description
Name
subcontractId
Type
string
Description
Name
tireId
Type
string
Description
Name
name
Type
string Required
Description
Name
ordinal
Type
number
Description
Name
categoryId
Type
string
Description
Name
inventoryFeeId
Type
string
Description

Produces

The response content type: application/json

`200` Response

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

Properties for `data` 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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

POST

/v3/canned_service/:id/fee

curl https://api.shopmonkey.cloud/v3/canned_service/:id/fee \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data '{ "name" : "value" }'

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

PUT/v3/canned_service/:id/fee/:itemId

Update Canned Service Fee

Update one canned service fee item

URL parameters

Name
id
Type
string Required
Description
the id for the canned service
Name
itemId
Type
string Required
Description
the fee item id

Body parameters

Consumes

The following content type is required: application/json

Name
feeType
Type
one of: PercentLineItem, PercentService, FixedCents
Description
Name
percent
Type
number
Description
Name
amountCents
Type
integer
Description
Name
lineItemEntity
Type
one of: Labor, Part, Subcontract, Tire
Description
Name
partId
Type
string
Description
Name
laborId
Type
string
Description
Name
subcontractId
Type
string
Description
Name
tireId
Type
string
Description
Name
name
Type
string
Description
Name
ordinal
Type
number
Description
Name
categoryId
Type
string
Description
Name
inventoryFeeId
Type
string
Description

Produces

The response content type: application/json

`200` Response

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

Properties for `data` 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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

PUT

/v3/canned_service/:id/fee/:itemId

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

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

DELETE/v3/canned_service/:id/fee/:itemId

Delete Canned Service Fee

Delete one canned service fee item

URL parameters

Name
id
Type
string Required
Description
the id for the canned service
Name
itemId
Type
string Required
Description
the fee item id

Produces

The response content type: application/json

`200` Response

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

Properties for `data` 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
cannedServiceTemplateId
Type
string Required
Description
/// This is explicitly not a foreign key to persist this connection for consumer processing after canned service template deletion
Name
pricing
Type
one of: FixedPrice, LineItem Required
Description
Name
name
Type
string Required
Description
Name
note
Type
string Required
Description
Name
lumpSum
Type
boolean Required
Description
Name
recommended
Type
boolean Required
Description
Name
epaPercent
Type
number Required
Description
Name
epaCents
Type
integer Required
Description
Name
epaValueType
Type
one of: Percent, FixedCents Required
Description
Name
express
Type
boolean Required
Description
visibility in Express Lane
Name
discountCents
Type
integer Required
Description
Name
discountPercent
Type
number Required
Description
Name
discountValueType
Type
one of: Percent, FixedCents Required
Description
Name
taxCents
Type
integer Required
Description
Name
taxPercent
Type
number Required
Description
Name
taxValueType
Type
one of: Percent, FixedCents Required
Description
Name
gstCents
Type
integer Required
Description
Name
gstPercent
Type
number Required
Description
Name
gstValueType
Type
one of: Percent, FixedCents Required
Description
Name
pstCents
Type
integer Required
Description
Name
pstPercent
Type
number Required
Description
Name
pstValueType
Type
one of: Percent, FixedCents Required
Description
Name
hstCents
Type
integer Required
Description
Name
hstPercent
Type
number Required
Description
Name
hstValueType
Type
one of: Percent, FixedCents Required
Description
Name
shopSuppliesApplied
Type
boolean Required
Description
Name
shopSuppliesCents
Type
integer Required
Description
Name
shopSuppliesPercent
Type
number Required
Description
Name
shopSuppliesValueType
Type
one of: Percent, FixedCents Required
Description
Name
calculatedPartsCents
Type
integer Required
Description
Name
calculatedTiresCents
Type
integer Required
Description
Name
calculatedLaborCents
Type
integer Required
Description
Name
calculatedSubcontractsCents
Type
integer Required
Description
Name
calculatedFeeCents
Type
integer Required
Description
Name
calculatedEpaCents
Type
integer Required
Description
Name
calculatedDiscountCents
Type
integer Required
Description
Name
calculatedDiscountPercent
Type
number Required
Description
Name
calculatedShopSuppliesCents
Type
integer Required
Description
Name
calculatedTaxCents
Type
integer Required
Description
US specific
Name
calculatedGSTCents
Type
integer Required
Description
CA specific
Name
calculatedPSTCents
Type
integer Required
Description
CA specific
Name
calculatedHSTCents
Type
integer Required
Description
CA specific
Name
totalCents
Type
integer Required
Description
Name
fixedPriceCents
Type
integer Required
Description
the pre-tax cost of the service when pricing is FixedPrice
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
labels
Type
object Required
Description
Name
bookable
Type
boolean Required
Description
bookable through the appointment scheduler
Name
bookableOrdinal
Type
number Required
Description
the position in the appointment scheduler services appear
Name
imported
Type
boolean Required
Description
Name
motorTaxonomyIds
Type
array Required
Description
Name
labelConnections
Type
array RequiredDeprecated
Description
Use `labels` field
Name
photo
Type
boolean Required
Description
true if the canned service has a photo
Name
fees
Type
array
Description
Name
labors
Type
array
Description
Name
parts
Type
array
Description
Name
subcontracts
Type
array
Description
Name
tires
Type
array
Description

`4xx` Response

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

`5xx` Response

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

Example Request
application/json

DELETE

/v3/canned_service/:id/fee/:itemId

curl https://api.shopmonkey.cloud/v3/canned_service/:id/fee/:itemId \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -X DELETE -H 'Content-Type: application/json' \
  --data '{}'

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "name": "name",
    "note": "note",
    "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",
    "calculatedPartsCents": 1,
    "calculatedTiresCents": 1,
    "calculatedLaborCents": 1,
    "calculatedSubcontractsCents": 1,
    "calculatedFeeCents": 1,
    "calculatedEpaCents": 1,
    "calculatedDiscountCents": 1,
    "calculatedDiscountPercent": 1,
    "calculatedShopSuppliesCents": 1,
    "calculatedTaxCents": 1,
    "totalCents": 1,
    "deleted": true,
    "deletedUserId": null,
    "deletedDate": null,
    "deletedReason": null,
    "labelConnections": [
      {
        "label": {
          "id": "id",
          "name": "name",
          "color": "color",
          "entity": "entity",
          "saved": true
        }
      }
    ],
    "labors": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "discountCents": 1,
        "discountPercent": 1,
        "discountValueType": "discountValueType",
        "name": null,
        "hours": 1,
        "rateCents": 1,
        "rateId": null,
        "showHours": true,
        "showNote": true,
        "ordinal": 1,
        "costHours": null,
        "costRateCents": null,
        "costTotalCents": null,
        "multiplier": 1,
        "multiplierType": "multiplierType",
        "note": "note",
        "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",
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ],
    "fees": [
      {
        "id": "id",
        "createdDate": "createdDate",
        "updatedDate": null,
        "companyId": "companyId",
        "locationId": "locationId",
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        }
      }
    ],
    "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,
        "cannedServiceId": "cannedServiceId",
        "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"
          }
        },
        "pricingMatrix": {
          "id": "id",
          "name": "name"
        },
        "vendor": {
          "id": "id",
          "name": "name"
        },
        "brand": {
          "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,
        "cannedServiceId": "cannedServiceId",
        "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"
        }
      }
    ]
  }
}

Canned Service

URL parameters

Produces

200 Response

Properties for data object

Properties for meta object

4xx Response

5xx Response

Example Request

Example Responseapplication/json

Query String parameters

Produces

200 Response

Properties for meta object

4xx Response

5xx Response

Example Request

Example Responseapplication/json

URL parameters

Body parameters

Consumes

Produces

200 Response

Properties for data object

4xx Response

5xx Response

Example Requestapplication/json

Example Responseapplication/json

Body parameters

Consumes

Produces

200 Response

Properties for data object

4xx Response

5xx Response

Example Requestapplication/json

Example Responseapplication/json

URL parameters

Body parameters

Consumes

Produces

200 Response

Properties for data object

4xx Response

5xx Response

Example Requestapplication/json

Example Responseapplication/json

URL parameters

Produces

200 Response

Properties for data object

4xx Response

5xx Response

Example Requestapplication/json

Example Responseapplication/json

URL parameters

Body parameters

Consumes

Produces

200 Response

Properties for data object

4xx Response

5xx Response

Example Requestapplication/json

Example Responseapplication/json

URL parameters

Body parameters

Consumes

Produces

200 Response

Properties for data object

4xx Response

5xx Response

Example Requestapplication/json

Example Responseapplication/json

URL parameters

Produces

200 Response

Properties for data object

4xx Response

`200` Response

Properties for `data` object

Properties for `meta` object

`4xx` Response

`5xx` Response

Example Response
application/json

`200` Response

Properties for `meta` object

`4xx` Response

`5xx` Response

Example Response
application/json

`200` Response

Properties for `data` object

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json

`200` Response

Properties for `data` object

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json

`200` Response

Properties for `data` object

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json

`200` Response

Properties for `data` object

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json

`200` Response

Properties for `data` object

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json

`200` Response

Properties for `data` object

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json

`200` Response

Properties for `data` object

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json

`200` Response

Properties for `data` object

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json

`200` Response

Properties for `data` object

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json

`200` Response

Properties for `data` object

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json

`200` Response

Properties for `data` object

`4xx` Response

`5xx` Response

Example Request
application/json

Example Response
application/json

`200` Response

Properties for `data` object

`4xx` Response