Info | ||
---|---|---|
| ||
|
These are the endpoints that are available under the /invoiceItem path, which lists all the different invoice items on the invoices on your business' account.
Endpoint | Description |
---|---|
GET /invoiceItem/client/{clientId}/uninvoiced | Returns all invoiceItem objects assigned to specified client that do not have the invoiceId property filled in yet in array format. |
GET /invoiceItem/product/{productId} | Returns all invoiceItem objects that document the change in stock levels for specified product in array format. |
GET /invoiceItem/recurringAppointments/{recurringAppointmentId} | Returns all invoiceItem objects for the specified recurring appointment set. |
GET /appointments/client/{clientId}/uninvoiced | Returns all appointment objects for a client that have not been assigned to an invoice yet in array format. |
GET /recurringAppointments/client/{clientId}/uninvoiced | Returns all recurringAppointment objects for course sets that client has booked into but have not been invoiced yet in array format. A course set is made up of individual class sessions that all combine to form a course set. If you want to charge someone for their enrollment into the course set, you would need to add an instance of that course set to an invoice. This API is used to find out which course sets a client has booked but not been invoiced for yet. |
GET /invoiceItem/appointment/{calendarId} | Returns all invoiceItem objects for appointments on an invoice in array format. |
GET /invoiceItemList/reportWithCount | Returns a list of all invoice items on an account in array format. |
POST /invoiceItems | Creates a new line item on an invoice. Request body/payload: Must pass an array of invoiceItem objects in request body/payload. For these calls, you need to pass an array of invoiceItem objects with all required fields and any fields you want to set filled in the body of the payload. We have an example of an invoiceItem object in the responses section below and have indicated the required fields in the object values table at the bottom of this page. |
POST /invoiceItem | Creates an invoiceItem object. Request body/payload: Must pass an invoiceiIem object in request body/payload. For these calls, you need to pass an invoiceItem object with all required fields and any fields you want to set filled in the body of the payload. We have an example of an invoiceItem object in the responses section below and have indicated the required fields in the object values table at the bottom of this page. |
PUT /invoiceItem | Updates an existing invoiceItem object. Request body/payload: Must pass an invoiceItem object in request body/payload-make sure to include the correct invoiceId. For these calls, you need to pass an invoiceItem object with all required fields and any fields you want to update filled in the body of the payload. We have an example of an invoiceItem object in the responses section below and have indicated the required fields in the object values table at the bottom of this page. |
DELETE /invoiceItem/{invoiceItemId} | Removes an invoiceItem object from view by setting its active property to false. |
There are no parameters included with invoiceItems calls.
language | js |
---|---|
title | POST /invoiceItems |
linenumbers | true |
collapse | true |
Data points passed on in the request URL portion of the API call that are used to filter the data being requested.
Parameter | Type | Endpoints to be used with | Description |
---|---|---|---|
pageNumber | integer | GET /invoiceItemList/reportWithCount | Works with the pageSize parameter to determine how data gets returned following a GET call. The pageNumber value represents the number of pages on which the invoice items that get returned appear. |
pageSize | integer | Works with the pageNumber parameter to determine how data gets returned following a GET call. The pageSize value represents the number of invoice items appearing on each page of invoice items that gets returned. |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
"pageNumber": 1,
"pageSize": 25 |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"clientId": 10575898,
"description": "test",
"discountAmount": null,
"discountPercentage": 15,
"invoiceId": 2472628,
"quantity": 2,
"rate": 5
} |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"businessId": 43111,
"clientId": 5146945,
"description": "Advanced Dog Training - doggy",
"grossAmount": 25,
"netAmount": 25,
"quantity": 1,
"rate": 25,
"recurringAppointmentId": 742510,
"taxable": false
} |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "active": true, "businessId": 43111, "calendarId": null, "client": null, "clientId": 5146945, "coupon": null, "couponError": null, "createdDate": 1686761942198, "createdUser": "JoeSchmo", "depositAmount": null, "description": "testAdvanced Dog Training - doggy", "discountAmount": null, "discountPercentage": 25, "editing": true, "giftCardUUID": null, ": 15grossAmount": 25, "invoiceId": 2515124, "invoiceItemId": 2685481, "invoiceIdinvoiceItemName": 2472628null, "quantityinvoiceStatus": 2null, "ratemodifiedUser": 5 } | ||||||||
Code Block | ||||||||
| ||||||||
{ "JoeSchmo", "businessIdnetAmount": 4311125, "clientIdnoDescriptionError": 5146945false, "descriptionpackageSoldId": "Advanced Dog Training - doggy"null, "grossAmountproductId": 25null, "netAmountquantity": 251, "quantityrate": 125, "ratereasonId": 25null, "recurringAppointmentId": 742510, "taxable": false } |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
[{ "active": true, "businessId": 43111, "calendarId": null, "client": null, "clientId": 51469455143212, "coupon": null, "couponError": null, "createdDate": 16867619421981536770974005, "createdUser": "JoeSchmo", "depositAmount": null, "description": "AdvancedNeed Dog Training - doggymore $", "discountAmount": null4.5, "discountPercentage": 25, "editing": true10, "giftCardUUID": null, "grossAmount": 2510, "invoiceId": 2515124null, "invoiceItemId": 2685481455016, "invoiceItemName": null, "invoiceStatus": null, "modifiedUser": "JoeSchmo", "netAmount": 25, "noDescriptionError": false10, "packageSoldId": null, "productId": null, "quantity": 12, "rate": 255, "reasonId": null, "recurringAppointmentId": 742510null, "taxable": false } |
] |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
[{ "active": true, "businessId": 43111, "calendarId": null, "client": null, "clientId": 5143212null, "coupon": null, "couponError": null, "createdDate": 15367709740051536869585107, "createdUser": "JoeSchmo", "depositAmount": null, "description": "Need more $Collars: Bought new collars and came in shipment", "discountAmount": 4.5null, "discountPercentage": 10null, "giftCardUUID": null, "grossAmount": 100, "invoiceId": null469508, "invoiceItemId": 455016458960, "invoiceItemName": null, "invoiceStatus": null, "modifiedUser": "JoeSchmo", "netAmount": 100, "packageSoldId": null, "productId": null6183, "quantity": 2-50, "rate": 50, "reasonId": null, "recurringAppointmentId": null, "taxable": falsetrue }] |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
[{ "active": true, "businessId": 43111, "calendarId": null, "client": null, "clientId": null5146945, "coupon": null, "couponError": null, "createdDate": 15368695851071686761942198, "createdUser": "JoeSchmo", "depositAmount": null, "description": "Collars:Advanced BoughtDog newTraining collars and came in shipment- doggy", "discountAmount": null6.25, "discountPercentage": null25, "giftCardUUID": null, "grossAmount": 025, "invoiceId": 4695082515124, "invoiceItemId": 4589602685481, "invoiceItemName": null, "invoiceStatus": null, "modifiedUser": "JoeSchmo", "netAmount": 018.75, "packageSoldId": null, "productId": 6183null, "quantity": -501, "rate": 025, "reasonId": null, "recurringAppointmentId": null742510, "taxable": truefalse }] |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
[{ "addOnReasonIdList": null, "addOnReasonList": null, "additionalStaffIdList": null, "activeaddress": truenull, "businessIdappointmentIdHash": 43111"xqmrSN1n3N", "calendarId": nullappointmentDateTimeClient": "Monday, Sep 3, 2018 at 11:35 AM EDT", "clientappointmentDateTimeStaff": null, "clientIdapptTZ": 5146945null, "couponbatchAppointmentId": null, "couponErrorblockResourceIdList": null, "createdDateblockStaffIdList": 1686761942198null, "createdUserblockedStaffList": "JoeSchmo"null, "depositAmountbusinessId": null43111, "descriptioncalTimeSlot": "Advanced Dog Training - doggy"null, "discountAmountcalendarId": 6.2517713652, "discountPercentagecancelReason": 25null, "giftCardUUIDcancelUser": null, "grossAmountchangeReason": 25null, "invoiceIdclassScheduleId": 2515124null, "invoiceItemIdclassroom": 2685481null, "invoiceItemNameclient": null,{Client object for client "invoiceStatus": null, "modifiedUser": "JoeSchmo"of appointment - for more info, see Clients API page}, "netAmountclientConfirmDate": 18.75null, "packageSoldIdclientConfirmed": nulltrue, "productIdclientEndDate": null"2018-09-03", "quantityclientEndDateTime": 11543829400000, "rateclientEndDateTimeUTC": 251543829400000, "reasonIdclientEndTime": null1505, "recurringAppointmentIdclientReminderHours": 74251024, "taxableclientRescheduleCount": false }] | ||||||||
Code Block | ||||||||
| ||||||||
[{ 0, "addOnReasonIdListclientStartDate": null"2018-09-03", "addOnReasonListclientStartDateTime": null1543827600000, "additionalStaffIdListclientStartDateTimeUTC": null1543827600000, "addressclientStartTime": null1335, "appointmentIdHashcolor": "xqmrSN1n3N"null, "appointmentDateTimeClientcompletedReason": "Mondaynull, Sep 3, 2018 at 11"coordinatorStaff":35 AM EDT"null, "appointmentDateTimeStaffcoupon": null, "apptTZcouponId": null, "batchAppointmentIdcreateddate": null"2018-08-28 17:29:09", "blockResourceIdListcreateduser": null"", "blockStaffIdListcustomField1": null, "blockedStaffListcustomField2": null, "businessIdcustomField3": 43111null, "calTimeSlotcustomFieldData": null, "customFieldDesc"calendarId: "Comments : 17713652", "cancelReasondate": null"2018-09-03", "cancelUserdateCheckedIn": null, "changeReasondateCompleted": null1536580616496, "classScheduleIddateStarted": null, "classroomdiscount": null, "clientduration": {Clientnull, object for client of appointment - for more info, see Clients API page}, "clientConfirmDate"endDate": "2018-09-03", "endDateTimeUTC": null, "clientConfirmedendTime": true1500, "clientEndDateexternalEventId": "2018-09-03"null, "clientEndDateTimefields": 1543829400000,{Scheduler fields object for fields "clientEndDateTimeUTC": 1543829400000, "clientEndTime": 1505, "clientReminderHours": 24of fields of appointment - for more info, see Scheduler Fields API page}, "clientRescheduleCountinvitationUUId": 0null, "clientStartDatejobRequisitionId": "2018-09-03"null, "clientStartDateTimelocation": {Location 1543827600000,object for location of appointment "clientStartDateTimeUTC": 1543827600000, "clientStartTime": 1335- for more info, see Locations API page}, "colorlocationGroup": null, "completedReasonlocationSuperGroup": null, "coordinatorStaffmodifieddate": null "2023-06-14 15:13:57", "couponmodifieduser": null"SYSTEM_CLOSER", "couponIdnoPrefSelected": null, "createddatenoShowReason": "2018-08-28 17:29:09"null, "createdusernote": "", "customField1packageSoldId": null0, "customField2paid": null, "customField3price": null8, "customFieldDatareason": null, "customFieldDesc": "Comments : ", "date": "2018-09-03"{Reason object for service of appointment - for more info, see Services API page}, "dateCheckedInreasonBatchSeriesId": null, "dateCompletedreasonDesc": 1536580616496null, "dateStartedreasonGroup": null, "discountrecall": null, "durationrecallDate": null, "endDaterecallStatus": "2018-09-03"null, "endDateTimeUTCrecurringAppointmentId": null0, "endTimeremindClientSmsHrs": 1500null, "externalEventIdremindStaffSmsHours": null, "fieldsresource": {SchedulerResource fields object for fields of fieldsresource of appointment - for more info, see SchedulerResources Fields API page}, "seats": 1, "sendConfirmationToClient": false, "invitationUUIdsendConfirmationToStaff": nullfalse, "jobRequisitionIdshowAs": null"Busy", "locationstaff": {LocationStaff object for locationstaff of appointment - for more info, see LocationsStaff API page}, "locationGroupstaffReminderHours": null24, "locationSuperGroupstaffRescheduleCount": null0, "modifieddate": "2023-06-14 15:13:57", "modifieduser": "SYSTEM_CLOSER", "noPrefSelected": staffTimeText": null, "noShowReasonstartDate": null, "note": ""2018-09-03", "packageSoldIdstartDateTimeUTC": 0null, "paidstartTime": null1330, "pricestatus": 8"COMPLETED", "reasonsubStatus": {Reason object for service of appointment - for more info, see Services API page}"COMPLETED", "subject": null, "tax1Amount": null, "reasonBatchSeriesIdticket": null, "reasonDesctransactionFee": null, "reasonGroupwaitlistId": null, "recall": null, }] |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
[{ "recallDatebusinessId": null43111, "recallStatuscancelReason": null, "recurringAppointmentIdchangeReason": 0, "remindClientSmsHrs": null, "remindStaffSmsHoursclassScheduleList": null, "resourceclient": {ResourceClient object for resourceclient of appointmentcourse - for more info, set-see Resourcesclient API page}, "seatsclientEndTime": 11200, "sendConfirmationToClientclientId": false5147353, "sendConfirmationToStaffclientReminderHours": false24, "showAsclientStartTime": "Busy"1000, "staffcoordinatorStaff": {Staff object for staff of appointment - for more info, see Staff API page}null, "customFieldData": [], "discount": null, "staffReminderHoursendDate": 24"2018-09-21", "staffRescheduleCountendTime": 01200, "staffTimeTexteveryXMonths": null0, "startDateeveryXWeeks": "2018-09-03"0, "startDateTimeUTCfields": null, "startTimefri": 1330true, "statuslocation": "COMPLETED"{Location object for location of course set-see locations API page}, "subStatuslocationGroup": "COMPLETED"null, "subjectlocationId": null81129, "tax1AmountlocationSuperGroup": null, "ticketmon": nullfalse, "transactionFeenote": null, "waitlistIdreason": null }] | ||||||||
Code Block | ||||||||
| ||||||||
[{ "businessId": 43111, "cancelReason": null{Reason object for service of course set-see services API page}, "changeReasonreasonId": null240127, "classScheduleListrecurringAppointmentId": null179108, "clientrecurringSchedule": {ClientRecurring schedule object for recurring clientschedule of course set-see recurring clientclass schedule API page}, "clientEndTimeremindClientSmsHours": 12001, "clientIdremindStaffSmsHours": 51473530, "clientReminderHoursresource": 24null, "clientStartTimesat": 1000false, "coordinatorStaffseats": null, "customFieldDatastaff": [] {Staff object for staff of course set-see staff API page}, "discountstaffId": null81988, "endDatestaffReminderHours": "2018-09-21"24, "endTimestartDate": 1200"2018-09-19", "everyXMonthsstartTime": 01000, "everyXWeeksstatus": 0"Open", "fieldssun": nullfalse, "frithu": true, "locationtimeSlotList": {Location object for location of course set-see locations API page}null, "locationGrouptue": nullfalse, "locationIdwed": 81129, true } |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
[{ "locationSuperGroupactive": nulltrue, "monbusinessId": false43111, "notecalendarId": null17927840, "reasonclientId": {Reason5147404, object for service of course set-see services API page}"coupon": null, "reasonIdcreatedDate": 2401271536855019903, "recurringAppointmentIdcreatedUser": 179108"JoeSchmo", "recurringScheduledepositAmount": {Recurringnull, schedule object for recurring schedule of course set-see recurring class schedule API page}, "remindClientSmsHours": 1, "remindStaffSmsHours": 0"description": "For Dog Training with Major Hay on Saturday, Sep 15, 2018 at 10:10 AM EDT", "resourcediscountAmount": null, "satdiscountPercentage": falsenull, "seatsgiftCardUUID": null, "staffgrossAmount": {Staff object for staff of course set-see staff API page}0, "staffIdinvoiceId": 81988469475, "staffReminderHoursinvoiceItemId": 24458568, "startDatemodifiedUser": "2018-09-19JoeSchmo", "startTimenetAmount": 10000, "statuspackageSoldId": "Open"null, "sunproductId": falsenull, "thuquantity": true1, "timeSlotListrate": null0, "tuerecurringAppointmentId": falsenull, "wedtaxable": truefalse } ] |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
[{ "active": true, "businessId": 43111, "calendarId": 16470837, "client": {Client object for client of Invoice Item - for "active": truemore info, see Clients "businessId": 43111API page}, "calendarIdclientId": 179278404761823, "clientIdcoupon": 5147404null, "couponcouponError": null, "createdDate": 15368550199031526492308900, "createdUser": "JoeSchmoWebClient", "depositAmount": null0, "description": "For Dog Traininggrooming with MajorTitus HayBigly on SaturdayWednesday, SepJun 156, 2018 at 1012:1005 AMPM EDT", "discountAmount": null0, "discountPercentage": null0, "giftCardUUID": null, "grossAmount": 08, "invoiceId": 469475312165, "invoiceItemId": 295813, "invoiceItemName": 0, "invoiceItemIdinvoiceStatus": 458568"OPEN", "modifiedUser": "JoeSchmo"null, "netAmount": 08, "packageSoldId": null, "productId": null, "quantity": 1, "rate": 0 8, "reasonId": null, "recurringAppointmentId": null, "taxable": false }] |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "active": true, "businessId": 43111, "calendarId": 17466100, "client": {Client object for client of invoice item - for more info, see Clients API page}, "clientId": 4658091, "coupon": null, "couponError": null, "createdDate": 1536759463375, "createdUser": "JoeSchmo", "depositAmount": null, "description": "For Dog Training with Jay Morgan on Thursday, Sep 13, 2018 at 8:00 AM EDT", "discountAmount": 2.25, "discountPercentage": 15, "giftCardUUID": null, "grossAmount": 15, "invoiceId": 465804, "invoiceItemId": 455016, "invoiceItemName": null, "invoiceStatus": null, "modifiedUser": "JoeSchmo", "netAmount": 12.75, "packageSoldId": null, "productId": null, "quantity": 1, "rate": 15, "reasonId": null, "recurringAppointmentId": null, "taxable": false } |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "active": true, "businessId": 43111, "calendarId": null, "client": null, "clientId": 5146945, "coupon": null, "couponError": null, "createdDate": 1686761942198, "createdUser": "JoeSchmo", "depositAmount": null, "description": "Advanced Dog Training - doggy", "discountAmount": null, "discountPercentage": null, "giftCardUUID": null, "grossAmount": 25, "invoiceId": null, "invoiceItemId": 2685481, "invoiceItemName": null, "invoiceStatus": null, "modifiedUser": "JoeSchmo", "netAmount": 25, "packageSoldId": null, "productId": null, "quantity": 1, "rate": 25, "reasonId": null, "recurringAppointmentId": 742510, "taxable": false } |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "active": true, "businessId": 43111, "calendarId": 17602802, "client": null, "clientId": 4761823, "coupon": null, "couponError": null, "createdDate": 1536761795057, "createdUser": "JoeSchmo", "depositAmount": null, "description": "Bought a book", "discountAmount": null, "discountPercentage": null, "giftCardUUID": null, "grossAmount": 10, "invoiceId": 437711, "invoiceItemId": 442802, "invoiceItemName": null, "invoiceStatus": null, "modifiedUser": "JoeSchmo", "netAmount": 10, "packageSoldId": null, "productId": null, "quantity": 1, "rate": 10, "reasonId": null, "recurringAppointmentId": null, "taxable": false } |
Property Name | Type | Required | Description |
---|---|---|---|
active | boolean | Yes | Indicates whether or not the specified invoice item should return on GET calls. |
businessId | integer | Yes | Provides unique numerical ID for the business to which the specified invoice item belongs. |
calendarId | integer | Provides unique numeric ID for the calendar of the appointment from which the specified invoice item was created. | |
client | object | Displays the client object of any client connected to the specified invoice item - for more info, see Clients API page. | |
clientId | integer | Yes | Provides unique numeric ID for the client attached to the specified invoice item. |
coupon | object | Displays the coupon object of any coupon being applied on the specified invoice item - for more info, see Coupon API page. | |
couponError | string | Displays as the error message for the coupon error. | |
createdDate | integer | Displays as the date the specified invoice item was created in milliseconds elapsed since January 1, 1970 00:00:00 UTC form. | |
createdUser | string | Displays as username of the user who created specified invoice item. | |
depositAmount | integer | Displays the monetary amount of any deposit paid for the invoice to which the specified invoice item belongs. | |
description | string | Displays string representation of what the specified invoice item is for. Example: "For Dog Training with Titus Bigly on Thursday, Sep 13, 2018 at 8:00 AM EDT". | |
discountAmount | integer | Displays as monetary value of any discount applied to the specified invoice item. | |
discountPercentage | integer | Displays as percentage of any discount applied to the specified invoice item. | |
giftCardUUId | integer | Provides unique numeric ID for any giftcard used to create the specified invoice item. | |
grossAmount | integer | Displays as monetary value of payment/refund being applied before accounting for any discounts. Refunds show as negative numbers. | |
invoiceId | integer | Yes | Provides unique numeric ID for the invoice to which the specified invoice item belongs. |
invoiceItemId | integer | Yes, on PUT calls | Provides unique numeric ID for the specified invoice item. |
modifiedUser | string | Displays as username of the user who created the specified invoice item. | |
netAmount | integer | Displays as monetary value of payment/refund being applied after accounting for any discounts. Refunds show as negative numbers. | |
packageSoldId | integer | Provides unique numeric ID of any package sold as part of the specified invoice item. | |
productId | integer | Provides unique numeric ID of any product that is part of the specified invoice item. | |
quantity | integer | Yes | Displays as number of payments/refunds being applied. |
rate | integer | Yes | Displays as monetary value of each individual payment/refund being applied. Refunds show as negative numbers. |
reasonId | integer | Provides unique numeric ID of the reason related to the specified invoice item. | |
recurringAppointmentId | integer | Provides unique numeric ID of any recurring appointment related to the specified invoice item. | |
taxable | boolean | Indicates whether or not the specified invoice item is taxable, which would impact the overall balance of the invoice itself. |