Appointment
shop_idnumber · requiredUnique Identifier
datestring · requiredExample: 2024-07-09T08:35:25.394Zyearstring · requiredmakestring · requiredmodelstring · requiredhome_phonestring · requiredwork_phonestring · requiredcell_phonestring · required
customer_idUnique identifier of the customer
vehicle_idUnique identifier of the vehicle
repair_order_idUnique identifier of the repair order
employee_idUnique identifier of the employee
donebooleanIs this appointment already completed?
Default: falsecolumnstringName of the bay that this appointment is scheduled in
Example: Oil Change Bayreasonstring | nullReason for the appointment
Example: Oil Chnagestatusstring | nullThe status of the associated work order (if linked)
first_namestringCustomer information if customer_id is not provided
Example: Johnlast_namestringCustomer information if customer_id is not provided
Example: DoehoursnumberDuration of the appointment in hours
Example: 2.5emailCustomer information if customer_id is not provided
Appointment_Response
appointment_idnumber · required
shop_idnumberUnique Identifier
customer_idUnique identifier of the customer
vehicle_idUnique identifier of the vehicle
repair_order_idUnique identifier of the repair order
employee_idUnique identifier of the employee
first_namestringCustomer information if customer_id is not provided
Example: Johnlast_namestringCustomer information if customer_id is not provided
Example: Doevehicleobject | nullreasonstring | nullReason for the appointment
Example: Oil Chnagephoneobject | nullhoursnumberDuration of the appointment in hours
Example: 2.5columnstringName of the bay that this appointment is scheduled in
Example: Oil Change BaydonebooleanIs this appointment already completed?
Default: falseemailCustomer information if customer_id is not provided
sourcestring | null · enumEnum values:WebsiteTire LinkMobileAppointmentCall CenterCustomer PortalMobile VanAPIscheduleobjecttimestampstringThe date to find scheduled appointments
Example: 2024-07-09T08:35:25.394Zupdated_atstring | nulldeletedstring | nullstatusstring | nullThe status of the associated work order (if linked)
Bay
shop_idnumber · requiredUnique identifier of the shop
titlestring · requiredThe title of the bay
Example: Oil Changeidnumber · requiredUnique identifier of the bay
orderinteger · requiredThe order the bay should show (lowest to highest, left to right)
Example: 1is_mobileboolean · requiredIs this bay a mobile van?
allow_overbookingboolean · requiredDoes the bay allow overbooking?
Appointment_Filters
first_namestringCustomer information if customer_id is not provided
Example: Johnlast_namestringCustomer information if customer_id is not provided
Example: Doereasonstringyearinteger | stringExample: 2023makestringExample: VolkswagenmodelstringExample: JettadatestringThe date of the appointment
timestringThe time the appointment starts
ShipTo
numberstring · requiredThe number assigned to the ship to
namestring · requiredThe ship to name
Example: John's Plumbingaddressstring · requiredExample: 123 w 123 ncitystring · requiredExample: Loganstatestring · requiredExample: Utahzipstring · requiredemailstring | null · requiredExample: [email protected]work_phonestring · requiredExample: 1234567899faxstring · requiredExample: 1234567899home_phonestring · requiredExample: 1234567899cell_phonestring · requiredExample: 1234567899
ShipTo_Response
numberstring · requiredThe number assigned to the ship to
namestring · requiredThe ship to name
Example: John's Plumbingaddressstring · requiredExample: 123 w 123 ncitystring · requiredExample: Loganstatestring · requiredExample: Utahzipstring · requiredemailstring | null · requiredExample: [email protected]work_phonestring · requiredExample: 1234567899faxstring · requiredExample: 1234567899home_phonestring · requiredExample: 1234567899cell_phonestring · requiredExample: 1234567899idnumber · requiredUnique identifier of the ship to
customer_idnumber · requiredUnique identifier of the customer the ship to is related to
Customer
shop_idnumber · requiredUnique Identifier
business_namestring · requiredExample: John's Plumbingfirst_namestring · requiredOnly required if business name not provided
Example: Johnlast_namestring · requiredOnly required if business name not provided
Example: Doeaddressstring · requiredExample: 123 w 123 ncitystring · requiredExample: Loganstatestring · requiredExample: Utahzipstring · required
home_phonestringExample: 1234567899work_phonestringExample: 1234567899cell_phonestringExample: 1234567899faxstringExample: 1234567899emailstring | nullExample: [email protected]commentsstringExample: Likes us to call him when vehicle is donecell_providerstringExample: VerizonactivebooleanDefault: truecredit_limitnumberExample: 500extensionnumberExample: 123customer_typestringExample: Retailcustomer_pay_typestringName of customer's terms
customer_numberstringExample: 456
Customer_Response
customer_idnumberUnique identifier of the customer
shop_idnumberUnique Identifier
business_namestringExample: John's Plumbingfirst_namestringOnly required if business name not provided
Example: Johnlast_namestringOnly required if business name not provided
Example: DoeaddressstringExample: 123 w 123 ncitystringExample: LoganstatestringExample: Utahzipstringphoneobjectemailstring | nullExample: [email protected]allow_marketingbooleancommentsstringExample: Likes us to call him when vehicle is donecell_providerstringExample: VerizonactivebooleanDefault: truetax_exemptbooleanDoes the customer have a tax exempt certificate on file?
Default: falsecredit_limitnumberExample: 500extensionstringcustomer_typestringExample: Retailtermsstringcustomer_numberstringExample: 456customer_pay_typestringThe customers Terms
timestampstringThe created at time
home_phonestring · deprecated · requiredThis field is deprecated. Please use fields under the phone object
cell_phonestring · deprecated · requiredThis field is deprecated. Please use fields under the phone object
work_phonestring · deprecated · requiredThis field is deprecated. Please use fields under the phone object
faxstring · deprecated · requiredThis field is deprecated. Please use fields under the phone object
Employee
shop_idnumber · requiredemployee_numberstring · requiredThis must be unique across the company
Example: JD123
first_namestringExample: Johnlast_namestringExample: DoeaddressstringExample: 123 w 123 ncitystringExample: LoganstatestringExample: UtahzipstringphonestringExample: 1234567899emailstring | nullExample: [email protected]job_descriptionstringdate_hiredstringExample: 2024-07-09T08:35:25.394Zdefault_writerbooleanIs this the default salesperson?
Default: falseactivebooleanDefault: truehourly_ratenumberExample: 22.5pinstringExample: 1234company_accessbooleanDoes this employee have access to all locations within the company?
notesstringExample: Great hire!
Employee_Response
employee_idnumber · requiredUnique identifier of the employee
shop_idnumber · requiredemployee_numberstring · requiredThis must be unique across the company
Example: JD123payment_typestring · requiredcommissionstring · requiredtimestampstring · requiredExample: 2024-07-09T08:35:25.394Z
first_namestringExample: Johnlast_namestringExample: DoeaddressstringExample: 123 w 123 ncitystringExample: LoganstatestringExample: UtahzipstringphonestringExample: 1234567899emailstring | nullExample: [email protected]job_descriptionstringdate_hiredstringExample: 2024-07-09T08:35:25.394Zdefault_writerbooleanIs this the default salesperson?
Default: falseactivebooleanDefault: truehourly_ratenumberExample: 22.5pinstringExample: 1234company_accessbooleanDoes this employee have access to all locations within the company?
notesstringExample: Great hire!
Employee_Types
Vehicle
customer_idnumber · requiredUnique identifier of the customer the vehicle is related to
yearinteger | string · requiredExample: 2023makestring · requiredExample: Volkswagenmodelstring · requiredExample: Jettatypestring · requiredExample: SE
vinstringExample: 123456789123456license_numberstringExample: 123ASDFlicense_statestringExample: Utahfleet_numberstringThis maps to Tire Guru's vehicle unit number
Example: 123colorstringExample: Whiteaces_idstring
Vehicle_Response
vehicle_idnumber · requiredUnique identifier of the vehicle
customer_idnumber · requiredUnique identifier of the customer the vehicle is related to
yearinteger | string · requiredExample: 2023makestring · requiredExample: Volkswagenmodelstring · requiredExample: Jettatypestring · requiredExample: SE
vinstringExample: 123456789123456license_numberstringExample: 123ASDFlicense_statestringExample: Utahfleet_numberstringThis maps to Tire Guru's vehicle unit number
Example: 123colorstringExample: Whiteaces_idstring
Get_Vehicles_Request
sortstringort by column, can be DESC or ASC. For DESC append a - next to the sort column. Eg: -first_name. Sortable field: first_name, last_name, year, date and reason.
pageintegerPage number to return. Defaults to 1
pageSizeintegerstring Number of items to return in a page. Defaults to 10.
with_detailsbooleanvehicle_idnumberUnique Identifier
filterobject
Supplier
shop_idnumber · requiredUnique identifier of the shop
supplier_namestring · requiredExample: John's Plumbingsupplier_addressstring · requiredExample: 123 w 123 nsupplier_citystring · requiredExample: Logansupplier_statestring · requiredExample: Utahsupplier_zipstring · requiredsupplier_phonestring · requiredExample: 1234567899account_numberstring · requiredThe is the equivalent to Tire Guru's Vendor Number field
Example: LPS30
supplier_faxstringExample: 1234567899supplier_contactstringExample: John Doesupplier_emailstring | nullExample: [email protected]urlstring | nullExample: localpartstore.comtermsstringExample: Net 30notesstringExample: Phone number is John's cell
Supplier_Response
supplier_idnumber · requiredUnique identifier of the supplier
shop_idnumber · requiredUnique identifier of the shop
available_company_wideboolean · requiredsupplierobject · requiredaccount_numberstring · requiredThe is the equivalent to Tire Guru's Vendor Number field
Example: LPS30online_orderingboolean · requiredtimestamprequired
urlstring | nullExample: localpartstore.comtermsstringExample: Net 30notesstringExample: Phone number is John's cell
Shop_Hours
shop_idnumber · requireddayinteger · requiredDay of week. 0=Sunday, 6=Saturday
Example: 0start_timestring · requiredExample: 08:00end_timestring · requiredExample: 17:00openboolean · required
Shop_Sources
idnumber · requiredshop_idnumber · requiredsourcestring · requiredactiveboolean · required
Create_Repair_Order_Request
shop_idnumber · requiredUnique identifier of the shop
customerobject · requiredOnly provide this field if not providing a customer_id. This data will create a temporary customer and ignore the the customer_id field.
customer_idnumberUnique identifier of the customer the repair order is related to
vehicle_idnumberUnique identifier of the vehicle the repair order is related to
vehicleobjectOnly provide this field if not providing a vehicle_id. This data will create a temporary vehicle and ingore the vehicle_id field.
writerstringExample: John Doewritten_bystringpurchase_order_numberstringcommentsstringExample: Check for oil leaksourcestringreference_sourcestringtread_depth_lrstring/32
Example: 15tread_depth_rfstring/32
Example: 15tread_depth_lfstring/32
Example: 15tread_depth_rrstring/32
Example: 15miles_instringExample: 45000miles_outstringExample: 45000urlstringURL to external website relating to the work order
Example: https://example.comtax_level_idnumberprice_level_idnumbertypestring · enumEnum values:repair_orderquotedatestringExample: 2024-07-09T08:35:25.394Zship_to_idnumberUnique identifier of the ship to the repair order is related to
statusstringroutestringThe name of the route
route_stopstringThe stop number for the route. Must provide route if providing stop
Sublet_Reponse
sublet_idnumber · requireditem_idnumber · requiredshop_idnumber · requiredUnique identifier of the shop
repair_order_idnumber · requiredUnique identifier of the repair order
sublet_descriptionstring · requiredExample: Sublet Laborsublet_pricenumber · requiredExample: 89.55sublet_costnumber · requiredExample: 67.44sublet_invoice_numberstring · requiredExample: 12345sublet_supplierstring · requiredExample: John's Tire Storepart_order_numberstring · requiredExample: 165135is_taxableboolean · requiredtimestampstring · required
Part
shop_idnumber · requiredpart_idnumber · requiredquantitynumber · requiredExample: 3
complaint_idnumberCan link to a complaint category
costnumberDollar amount of cost for each. Cost should be for quantity of 1
Example: 5.21codestringCode to show in part number within RO
Example: C125EbinstringtaxnumberDollar amount of tax for each. Tax should be for quantity of 1
Example: 1.15fetnumberDollar amount of FET for each. FET should be for quantity of 1
Example: 2.22partsnumberDollar amount of parts for each. Parts should be for quantity of 1
Example: 45.15labornumberDollar amount of labor for each. Labor should be for quantity of 1
Example: 22.87part_statusstring · enumEnum values:not_startedin_progresscompletedExample: not_startedbrandstringdescriptionstringstatusstring · enumEnum values:approvedpendingdeclined
Labor_Response
labor_idnumber · requireditem_idnumber · requiredshop_idnumber · requiredrepair_order_idnumber · requiredcomplaint_idnumber · requiredcanned_jobs_idnumber · requiredrate_labelstring · requiredExample: Mount and Balancehourly_ratestring · requiredlabor_hoursnumber · requiredExample: 3labornumber · requiredTotal dollars for labor for each hour. Should represent a quantity of 1
Example: 150technicianstring · requiredExample: John Doeline_totalnumber · requiredsales1string · requiredExample: John Doesales2string · requiredtech1string · requiredtech2string · requiredlabor_statusstring · enum · requiredEnum values:not_startedin_progresscompletedExample: not_startedtimestampstring · requiredTime added to order
Example: 2024-07-09T08:35:25.394Zdate_donestring · required
Recommended_Repair
idnumber · requiredrepair_order_idnumber · requireddescriptionstring · requiredExample: Please check oil leaktotal_recommendednumber · requiredtechnician_notesstring · requiredExample: Oil leak looks like needs new drain plugtimestampstring · requiredExample: 2024-07-09T08:35:25.394Zvehicle_idnumber · requiredshop_idnumber · requiredcustomer_idnumber · required
parent_idnumberIf the recommended service is a child of another, this will be the id of the parent recommended service
Repair_Order_Response
repair_order_idnumber · requiredshop_idnumber · requiredrepair_order_typestring · enum · requiredEnum values:repair_orderquoteExample: repair_orderstatusstring | null · requiredExample: In Progresswriterstring · requiredExample: John Doetax_ratestring · requiredpurchase_order_numberstring · requiredExample: 123tracking_numberstring · requiredreference_numberstring · requiredmiles_innumber · requiredmiles_outnumber · requiredcommentsstring · requiredExample: This is a test commentparts_costnumber · requiredvehicleobject | null · requiredcustomerobject | null · requiredtotalobject · requireddate_instring · requiredExample: 2024-07-09T08:35:25.394Zdate_finalrequireddate_closedrequiredfinal_daterequiredstatus_daterequiredtimestampstring · requiredExample: 2024-07-09T08:35:25.394Z
routestringfees_discountsarray | nullOnly returned if 'with_details' in request is true
itemsarray | nullOnly returned if 'with_details' in request is true
Fee_and_Discount
idnumber · requiredcodestring · requiredExample: TRFnamestring · requiredExample: Tire Recycle Feequantitynumber · requiredExample: 1pricenumber · requiredPrice each - represents quantity of 1
Example: 25taxnumber · requiredTax each - represents quantity of 1
Example: 1typestring · enum · requiredEnum values:feediscountExample: feeshop_idstring · required
Complaint_Category
complaint_category_idnumber · requirednamestring · requiredactiveboolean · requiredcolorstring · requiredorderinteger · required
Repair_Order_Item
idnumber · requiredThe ID representing the line item of the order
item_idnumber · requiredThe ID for the item
quantitynumber · requiredparts_eachnumber · requiredlabor_eachnumber · requiredcost_eachnumber · requiredtaxnumber · requiredfetnumber · requiredtotalnumber · requiredcodestring · requireddescriptionstring · requiredsizestring · requiredlabor_hoursnumber | null · requiredstatusstring · enum · requiredEnum values:approvedpendingdeclinedcanned_job_idstring | null · requiredcomplaint_idstring | null · requiredCan link to a complaint category
Get_Parts_Response
part_idnumber · requiredRepresents the ID of the specific line item on the repair order
item_idnumber · requiredRepresents the ID of the item
shop_idnumber · requiredcomplaint_idnumber · requiredrepair_order_idnumber · requiredcanned_job_idrequiredpartobject · requiredtotal_pricenumber · requiredpart_order_numberstring · requiredtotal_costnumber · requiredbinstring | null · requiredtaxnumber · requiredorder_statusstring | null · enum · requiredEnum values:receivedpartially_receivedpendingsales_personstring · requiredsales1string | null · requiredsales2string | null · requiredtech1string | null · requiredtech2string | null · requireddatestring · requiredtimestampstring · required
Sublet
shop_idnumber · requiredUnique identifier of the shop
descriptionstring · requiredExample: Sublet Laborpricenumber · requiredExample: 89.55costnumber · requiredExample: 67.44
complaint_idUnique identifier of the complaint
donebooleanDefaults to false
Labor
shop_idnumber · requiredlabor_idnumber · requiredcomplaint_idnumber · requiredrate_labelstring · requiredExample: Mount and Balancelabor_hoursnumber · requiredExample: 3labornumber · requiredTotal dollars for labor for each hour. Should represent a quantity of 1
Example: 150tech1string · requiredExample: John Doetech2string · requiredsales1string · requiredsales2string · requiredsales_personstring · requiredlabor_statusstring · enum · requiredEnum values:not_startedin_progresscompletedExample: not_started
Get_Fees_and_Discounts_Response
idnumber · requiredcodestring · requiredExample: TRFnamestring · requiredExample: Tire Recycle Feeamountnumber · requiredExample: 1amount_typestring · enum · requiredEnum values:Fixed AmountAdjust to QTYAdjusted Retail %Manual AmtPromotionInvoice Subtotal %Adjust QTY off Adjusted %display_typestring · enum · requiredEnum values:partlaborminimumnumber · requiredmaximumnumber · requiredquantitynumber · requiredtaxableboolean · requiredtypestring · enum · requiredEnum values:feediscountshop_idnumber · required
Paginated_Request_Body
sortstringort by column, can be DESC or ASC. For DESC append a - next to the sort column. Eg: -first_name. Sortable field: first_name, last_name, year, date and reason.
pageintegerPage number to return. Defaults to 1
pageSizeintegerstring Number of items to return in a page. Defaults to 10.
Inventory
part_idnumbershop_idnumberpartobjecton_handnumberallocatednumbernet_on_handnumberreorder_levelnumbermax_on_handnumbermaintain_stockstringExample: YESbinstringExample:taxbooleanIs item taxable?
notesstringExample:timestampstringExample: 2014-11-18T20:38:34.000000Zcustom_fieldsobject[]
Get_Bins_Response
bin_idnumbercodestringdescriptionstringmax_quantitynumberactivebooleanshop_idnumber
Get_Groups_Response
manufacturer_idnumber · requiredgroup_idnumber · requireddescriptionstring · requiredactiveboolean · requiredcreated_bystring | null · requiredcreated_atrequired
Get_Manufacturers_Response
manufacturer_idnumber · requirednamestring · requiredactiveboolean · requiredcreated_atstring | null · requiredcreated_byrequired
Canned_Job
canned_job_idnumber · requiredjob_namestring · requiredtimestampstring · requiredExample: 2024-07-09T08:35:25.394Zorderinteger · required
subcategoriesarray | null
Get_Purchase_Orders_Response
purchase_order_idnumber · requiredsupplier_idnumber · requiredshop_idnumber · requiredsupplier_namestring · requiredpurchase_order_numberstring · requiredreferencestring · requiredtrackingstring · requiredship_viastring | null · requirednotesstring | null · requiredtotalnumber · requiredcreated_atstring · requiredlocked_atstring | null · requiredreceived_atstring | null · requiredetastring | null · requiredordered_bystring · requiredstatusstring · enum · requiredEnum values:openlockedreceivedbackordered
itemsobject[]
Get_Expense_Items_Response
expense_item_idstring · requiredcodestring · requireddescriptionstring · requiredis_freightboolean · requiredactiveboolean · requiredshop_idnumber · required
Get_Purchase_Order_Item_Response
purchase_order_item_idnumber · requiredThe unique id for the line item in the purchase order
costnumber · requiredquantitynumber · requiredallocatednumber · requiredavailablenumber · requiredlocked_atrequiredreceived_atrequiredbackordered_atrequiredtotalnumber · requiredstatusstring · enum · requiredEnum values:openlockedreceivedbackordered
item_idRequired if expense_id is not provided
expense_item_idstring | nullcodestringsizestringrawsizestringdescriptionstringfetnumber | null
Purchase_Order_Item
quantitynumber · required
item_idnumberRequired when expense_item_id not provided
expense_item_idnumberRequired when item_id not provided
sizestringWill override item's size
codestringWill override item's code
descriptionstringWill override item's description
costnumberWill override item's cost
fetnumberWill override item's fet
binstring
Create_Purchase_Order_Request
supplier_idnumber · requiredshop_idnumber · requiredinvoice_numberstring · requiredRequired when updating to a received status
referencestringtrackingstringship_viastringnotesstringetastringExample: 2024-07-09T08:35:25.394Zorder_bystringThe name of the user who created the order
statusstring · enumDefaults to open
Enum values:openlockedreceived
Create_Notification_Request
titlestring · requireddescriptionstring · requiredshop_idnumber · required
employee_idsnumber[]dataobject
Customer_Accounts_Receivable
idnumber · requiredPrimary key for the payment
customer_idnumber · requiredPrimary key for the customer
shop_idnumber · requiredPrimary key of the shop that the AR incurred from
numberstring · requiredThe AR number
amountnumber · requiredAmount of payment (negative if adding balance)
discountnumber · requiredAmount of discount applied
remainingnumber · requiredAmount remaining after payments and discounts
datestring · requiredDate AR was added
Example: 2024-07-09T08:35:25.394Zdue_datestring · requiredDue date of AR
Example: 2024-07-09T08:35:25.394Zactual_datestring · requiredThe actual timestamp that the AR was created
typestring · enum · requiredType of AR
Enum values:invoiceservice_chargeunappliedlate_feegl_roadepositreferencestring · requiredReference number for this AR post
paymentsobject[] · requiredA list of all payments made towards this AR balance
repair_order_idThe primary key of the related repair order
notesstring | nullNotes related to this AR post
Shop_Info
shop_idnumber · requirednamestring · requiredaddressstring · requiredcitystring · requiredstatestring · requiredzipstring · required
numberstringphonestringemailstringwebsitestringlogo_urlstringmetaobject
General_Ledger_Post
idnumber · requiredPrimary key of the GL entry
namestring · requiredName of the journal for the GL entry
descriptionstring · requiredDescription of the entry
actual_datestring · requiredDate actual entry was made
Example: 2024-07-09T08:35:25.394Zposted_datestring · requiredDate entry was posted to
Example: 2024-07-09T08:35:25.394Zsource_typestring · enum · requiredType of payment:
Enum values:Manual Journal EntrySales JournalInventory Receipts JournalA/R - Cash JournalA/R - Cash Journal (Corporate)Purchase JournalPayroll JournalService Charge Journaltypestring · enum · requiredDebit or Credit
Enum values:debitcreditamountnumber · requiredAmount of post
majornumber · requiredNumber for major account
major_namestring · requiredMajor account name
minornumber · requiredNumber for minor account
minor_namestring · requiredMinor account name
is_manualboolean · requiredWas the entry a manually added entry
shop_idnumber · required
Workflow_Status
status_idnumber · requirednamestring · requireddescriptionstring · requiredorderinteger · requiredcolorstring | null · pattern:^#[0-9A-Fa-f]{6}$· required
Create_Wholesale_Order_Request
fill_killstring · enum · requiredEnum values:fokfakbackshop_idnumber · requiredcustomer_idnumber · requireditemsobject[] · required
ship_to_idnumberpurchase_order_numberstringtracking_numberstringreference_numberstringstatusstringurlstringroutestringroute_stopstringcommentsstring
Wholesale_Order_Response
order_idstring · requiredorder_numberstring · requiredshop_idstring · requireditemsobject[] · requiredtotalobject · required
statusstringpurchase_order_numberstringtracking_numberstringreference_numberstringrouteobject
Inspection_Response
idnumber · requiredshop_idnumber · requiredinspection_namestring · requiredcreated_atstring · requiredExample: 2024-07-09T08:35:25.394Zupdated_atstring · requiredExample: 2024-07-09T08:35:25.394Zrepair_order_idnumber · requiredvehicle_idnumber · requiredresultsobject[] · required
completed_atcompleted_by_employee_namestring | nullcompleted_by_employee_idcustomer_id
Inspection_Result
idnumber · requiredtitlestring · requiredThe title for the inspection result question
findingsobject[] · required
determinationstring | null · enumDetermination often represents the red, yellow, green field
Enum values:CRITICALWARNOKmeasurementsarray | nullattachmentsarray | nullList of attachments for the result
