Path parameters

• businessLocationId integer(int64) Required

  The unique identifier for the business location.

Query parameters

• from string(date-time) Required

  Start of requested results, in ISO 8601 format.

  Based on the timeClosed sales field.

• to string(date-time)

  End of requested results, in ISO 8601 format.

  Based on the timeClosed sales field.

  If the to date is set to a future date or not included, it will be adjusted to the current date and time to retrieve the most recent data available.

• include string

  Objects to be included in the response.

  The allowed values are: staff, table, consumer, payments, revenue_center, account_profile, payment_authorization.

  Default value is empty.

• pageSize integer(int32)

  Number of entries to return.

  Maximum value is 100. Default value is 50.

• nextPageToken string

  A token that indicates the starting point of the next set of records when paginating through results.

  Default value is empty.

Responses

• 200 application/json

  Financial data returned successfully.

  Hide response attributes Show response attributes object

  • sales array[object]

    Array of sale objects.

    Hide sales attributes Show sales attributes object

    • accountReference string

      Unique reference id of the account.

    • accountFiscId string

      The account identifier.

    • receiptId string

      The unique identifier for the receipt associated with this account.

    • source object

      Additional properties are allowed.

      Hide source attributes Show source attributes object

      • initialAccountId string

        The accountFiscId of the initial transaction associated with the current account, if applicable. For example, in the case of a refund.

        This will match the accountFiscId of the sale if there is no associated account.

      • previousAccountId string

        The accountFiscId of the previous transaction associated with the current account, if applicable. For example, in the case of a refund.

        This may be different from initialAccountId if there is more than one associated account.

        It will not be displayed if there is no associated account.

    • salesLines array[object]
      Hide salesLines attributes Show salesLines attributes object

      • id string

        The sale line identifier.

      • parentLineId string

        The sale line this item is associated with, if applicable.

      • totalNetAmountWithTax string

        Total amount of sale line, including tax. Important Note: This field is for use with tax inclusive businesses. For tax exclusive businesses, see taxAmount and taxLines for tax calculations. The value is precise up to six decimal places.

      • totalNetAmountWithoutTax string

        The total amount of the sale line, before tax. The value is precise up to six decimal places.

      • menuListPrice string

        The price listed on the menu.

      • unitCostPrice string

        The unit cost price.

      • serviceCharge string

        The service charge.

      • serviceChargeRate string

        The service charge rate, as a percentage. The value is precise up to two decimal places.

      • discountAmount string

        The discount amount. The value is precise up to six decimal places.

      • taxCode string

        The system code for the tax rate.

      • taxAmount string

        The tax total.

      • taxRatePercentage string

        The tax rate, as a percentage. The value is precise up to two decimal places.

      • taxLines array[object]
        Hide taxLines attributes Show taxLines attributes object

        • taxId string

          The unique identifier for the tax rate.

        • taxCode string

          The system code for the tax rate.

        • taxRate string

          The tax rate, as a multiplier.

        • taxAmount string

          The tax total.

        • taxIncluded boolean

          Whether or not the business is tax inclusive.

      • discountType string

        The type of discount.

      • discountCode string

        The discount code.

      • discountName string

        The name of the discount.

      • accountDiscountAmount string

        The account discount amount. The value is precise up to two decimal places.

      • totalDiscountAmount string

        The total discount amount. The value is precise up to two decimal places.

      • sku string

        The item SKU.

      • name string

        The item name.

      • statisticGroup string

        The item's statistic group.

      • quantity string

        The quantity of the item sold, which can potentially be a fractional value, especially in cases where the item is sold by weight. The value is precise up to three decimal places.

      • accountingGroup object

        Additional properties are allowed.

        Hide accountingGroup attributes Show accountingGroup attributes object

        • accountingGroupId integer(int64)

          The unique identifier for the item's accounting group.

        • name string

          The name of the accounting group.

        • statisticGroup string

          The accounting group's statistic group.

        • code string

          The code assigned to the accounting group.

      • currency string

        The currency for the sale line.

      • tags array[string]

        The tags attached to the line item.

      • revenueCenter string

        The name of the revenue center where the sale line was created.

      • revenueCenterId integer(int64)

        The unique identifier for the revenue center where the sale line was created.

      • categories array[object]
        Hide categories attributes Show categories attributes object

        • category string

          The line item's category.

        • value string

          The category value.

      • timeOfSale string(date-time)

        The timestamp of when the line item was created.

      • staffId integer(int64)

        The unique identifier for the user who created the line item.

      • staffName string

        The name of the user who created the line item.

      • deviceId integer(int64)

        The unique identifier for the device where the sale line was created.

      • deviceName string

        The name of the device where the sale line was created.

      • voidReason string

        The void reason, if applicable.

      • accountProfileCode string

        The code of the account profile used.

    • payments array[object]
      Hide payments attributes Show payments attributes object

      • code string

        The code of the payment method.

      • description string

        The name of the payment method.

      • paymentMethodId integer(int64)

        The unique identifier for the payment method.

      • netAmountWithTax string

        The net payment amount, including tax. The value is precise up to two decimal places, and if necessary, it is rounded using the "half-even" rounding mode.

      • currency string

        The payment currency.

      • tip string

        The tip amount. The value is precise up to two decimal places, and if necessary, it is rounded using the "half-even" rounding mode.

      • consumer object

        Additional properties are allowed.

        Hide consumer attributes Show consumer attributes object

        • id string

          The UUID of the customer associated with the payment, if applicable.

        • customerId integer(int64)

          The unique identifier for the customer.

        • title string

          The title or honorific of the customer.

        • firstName string

          The first name of the customer.

        • lastName string

          The last name of the customer.

        • phoneNumber1 string

          The primary phone number of the customer.

        • phoneNumber2 string

          An alternative phone number for the customer.

        • companyName string

          The name of the company associated with the customer, if applicable.

        • addressLine1 string

          The primary address line for the customer's address.

        • addressLine2 string

          The secondary address line for the customer's address, such as apartment or suite number.

        • zipCode string

          The postal code for the customer's address.

        • city string

          The city of the customer's address.

        • state string

          The state or region of the customer's address.

        • email string

          The email address of the customer.

      • type string

        The type of payment

        Values are NORMAL or ACCOUNTS_RECEIVABLE.

      • deviceId string

        The unique identifier for the device where the payment was processed.

      • deviceName string

        The name of the device where the payment was processed.

      • staffId number

        The unique identifier for the user who processed the payment.

      • staffName string

        The name of the user who processed the payment.

      • authorization string

        The authorization code for the payment.

      • externalReference string

        The external reference code for the payment.

      • revenueCenter string

        The name of the revenue center where the payment was processed.

      • revenueCenterId number

        The unique identifier for the revenue center where the payment was processed.

      • fiscId string

        The unique identifier for the payment.

      • uuid string

        The base64url encoded UUID of the payment.

      • fiscDate string(date-time)

        The time stamp of the payment.

      • surcharge string

        The surcharge amount. The value is precise up to two decimal places, and if necessary, it is rounded using the "half-even" rounding mode.

    • timeOfOpening string(date-time)

      The account creation timestamp.

    • timeClosed string(date-time)

      The account close timestamp.

    • cancelled boolean

      Whether the account was cancelled.

    • externalFiscalNumber string

      The external reference id of the account.

    • tableNumber string

      The table number.

    • tableName string

      The name of the table.

    • accountProfileCode string

      The account profile associated with the account.

    • ownerName string

      The name of the user associated with the account.

    • ownerId integer(int64)

      The unique identifier for the user associated with the account.

    • type string

      The type of sale.

      Values are SALE, VOID, RECALL, REFUND, SPLIT, UPDATE, TRANSFER, FLOAT, TRANSITORY, CROSS_BL, or CANCEL.

    • externalReferences array[string]

      List of external references for online orders. Includes the TASK prefix, businessLocationId, and the unique reference code provided in the thirdPartyReference field of an online order.

    • nbCovers number(double)

      The number of covers.

    • dineIn boolean

      Whether the order is dine-in.

    • deviceId integer(int64)

      The unique identifier for the device where the account was created.

    • deviceName string

      The name of the device where the account was created.

    • voidReason string

      The void reason, if applicable.

  • nextPageToken string

    Token to use to get the next page of results, if applicable.

• 400 application/json

  Bad Request - Invalid request parameters or format.

  Hide response attribute Show response attribute object

  • error string Required
• 500 application/json

  Internal Server Error - An error occurred on the server.

  Hide response attributes Show response attributes object

  • timestamp string(date-time) Required
  • path string Required
  • status integer(int32) Required
  • error string Required
  • requestId string Required