Get Receipt by External Reference

GET /f/finance/{businessLocationId}/saleByExternalReference

OAuth2

Returns a single receipt matching the external reference supplied in the request.

Path parameters

businessLocationId integer(int64) Required

Unique identifier for a business location

Query parameters

externalReferenceId string Required

The external reference of the receipt

Responses

• 200 application/json

Receipt returned
Hide response attributes Show response attributes object
- accountReference string
  
  Unique reference id of the account
- accountFiscId string
  
  The account identifier
- receiptId string
  
  The id of the receipt attached to this account
- source object
  
  Hide source attributes Show source attributes
  
  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.
  
  totalNetAmountWithoutTax string
  
  Total amount of the sale line, before tax
  
  menuListPrice string
  
  Price listed on the menu
  
  unitCostPrice string
  
  Unit cost price
  
  serviceCharge string
  
  Service charge
  
  serviceChargeRate string
  
  Service charge rate, as a percentage
  
  discountAmount string
  
  Discount amount
  
  taxCode string
  
  System code for the tax rate
  
  taxAmount string
  
  Tax total
  
  taxRatePercentage string
  
  Tax rate, as a percentage
  
  taxLines array[object]
  
  Hide taxLines attributes Show taxLines attributes object
  
  taxId string
  
  Unique identifier for the tax
  
  taxCode string
  
  System code for the tax rate
  
  taxRate string
  
  Tax rate, as a multiplier
  
  taxAmount string
  
  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
  
  totalDiscountAmount string
  
  The total discount amount
  
  sku string
  
  The item SKU
  
  name string
  
  The item name
  
  statisticGroup string
  
  The item's statistic group
  
  quantity string
  
  The item quantity
  
  accountingGroup object
  
  Hide accountingGroup attributes Show accountingGroup attributes
  
  accountingGroupId number
  
  The unique identifier of 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 number
  
  The unique identifier of 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
  
  The timestamp of when the line item was created
  
  staffId number
  
  The unique identifier of the user who created the line item
  
  staffName string
  
  The name of the user who created the line item
  
  deviceId number
  
  The unique identifier of 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
  
  Values are Broken, Cooking, Other, Taste, Unhappy Client, User Mistake, or Waited too long.
  
  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 number
  
  The unique identifier of the payment method
  
  netAmountWithTax string
  
  The net payment amount, including tax
  
  currency string
  
  The payment currency
  
  tip string
  
  The tip amount
  
  consumer object
  
  Hide consumer attributes Show consumer attributes
  
  id string
  
  The UUID of the customer associated with the payment, if applicable
  
  customerId number
  
  The unique identifier for the customer
  
  title string
  
  firstName string
  
  lastName string
  
  phoneNumber1 string
  
  phoneNumber2 string
  
  companyName string
  
  addressLine1 string
  
  addressLine2 string
  
  zipCode string
  
  city string
  
  state string
  
  email string
  
  taxIdentifier string
  
  fiscalCode string
  
  destinationCode string
  
  type string
  
  The type of payment
  
  Values are NORMAL or ACCOUNTS_RECEIVABLE.
  
  deviceId string
  
  The unique identifier of the device where the payment was processed
  
  deviceName string
  
  The name of the device where the payment was processed
  
  staffId number
  
  The unique identifier of 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 of the revenue center where the payment was processed
  
  fiscId string
  
  The id of the payment
  
  uuid string
  
  The base64url encoded UUID of the payment
  
  fiscDate string
  
  The time stamp of the payment
  
  surcharge string
  
  The surcharge amount
- timeofOpening string
  
  The account creation timestamp
- timeofCloseAndPaid string
  
  The account close timestamp
- cancelled boolean
- externalFiscalNumber string
- 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 number
  
  The unique identifier of the user associated with the account
- type string
  
  The sale type
  
  Values are SALE, VOID, RECALL, REFUND, SPLIT, UPDATE, TRANSFER, FLOAT, or TRANSITORY.
- externalReferences array[string]
  
  List of order reference identifiers
- nbCovers number
  
  The number of covers
- dineIn boolean
  
  Whether the order is dine-in
- deviceId number
- deviceName string
- voidReason string
  
  The void reason, if applicable
  
  Values are Broken, Cooking, Other, Taste, Unhappy Client, User Mistake, or Waited too long.

GET /f/finance/{businessLocationId}/saleByExternalReference

curl \
 -X GET https://api.lsk.lightspeed.app/f/finance/{businessLocationId}/saleByExternalReference?externalReferenceId=ref1234 \
 -H "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "accountReference": "57X0j3hzTZ2oo9sdVWiUog==",
  "accountFiscId": "A65315.17",
  "receiptId": "R65315.13",
  "source": {
    "initialAccountId": "A65315.13",
    "previousAccountId": "A65315.15"
  },
  "salesLines": [
    {
      "id": "S65315.33",
      "parentLineId": "S65315.32",
      "totalNetAmountWithTax": "11.00",
      "totalNetAmountWithoutTax": "8.33",
      "menuListPrice": "10.00",
      "unitCostPrice": "5.00",
      "serviceCharge": "1.00",
      "serviceChargeRate": "10.00",
      "discountAmount": "0.00",
      "taxCode": "VAT20",
      "taxAmount": "1.6667",
      "taxRatePercentage": "20.00",
      "taxLines": [
        {
          "taxId": "41910290874374",
          "taxCode": "VAT20",
          "taxRate": "1.2",
          "taxAmount": "1.666667",
          "taxIncluded": true
        }
      ],
      "discountType": "DISCOUNT",
      "discountCode": "10PCT",
      "discountName": "10% Discount",
      "accountDiscountAmount": "1.00",
      "totalDiscountAmount": "1.00",
      "sku": "52",
      "name": "Burger",
      "statisticGroup": "Food",
      "quantity": "1",
      "accountingGroup": {
        "accountingGroupId": 141948669132845,
        "name": "Food",
        "statisticGroup": "Food",
        "code": "123"
      },
      "currency": "GBP",
      "tags": [
        "string"
      ],
      "revenueCenter": "Fixed POS",
      "revenueCenterId": 141948669132822,
      "categories": [
        {
          "category": "default",
          "value": "Food"
        }
      ],
      "timeofSale": "2023-07-27T19:58:22.474Z",
      "staffId": 14670,
      "staffName": "Manager",
      "deviceId": 75125,
      "deviceName": "iPad9",
      "voidReason": "Unhappy Client",
      "accountProfileCode": "AAP"
    }
  ],
  "payments": [
    {
      "code": "CASH",
      "description": "Cash",
      "paymentMethodId": 141948669132824,
      "netAmountWithTax": "11.00",
      "currency": "GBP",
      "tip": "0.00",
      "consumer": {
        "id": "ec021fb0-4c12-425e-b30f-320ab720448b",
        "customerId": 120913,
        "title": "Mr",
        "firstName": "John",
        "lastName": "Doe",
        "phoneNumber1": "555-555-5555",
        "phoneNumber2": "555-555-5556",
        "companyName": "Company Name",
        "addressLine1": "123 Street st.",
        "addressLine2": "Unit 123",
        "zipCode": "12345",
        "city": "Some City",
        "state": "Some State",
        "email": "[email protected]",
        "taxIdentifier": "123456789",
        "fiscalCode": "123456789",
        "destinationCode": "123456789"
      },
      "type": "NORMAL",
      "deviceId": "72676",
      "deviceName": "ipad9",
      "staffId": 180480,
      "staffName": "Manager",
      "authorization": "001",
      "externalReference": "1000",
      "revenueCenter": "Fixed POS",
      "revenueCenterId": 141948669132822,
      "fiscId": "T72691.8",
      "uuid": "bc7i2X_CTkeg8qlec66wmg==",
      "fiscDate": "2023-02-14T20:04:08.665Z",
      "surcharge": "0.00"
    }
  ],
  "timeofOpening": "2023-02-14T19:58:48.224Z",
  "timeofCloseAndPaid": "2023-02-14T20:04:08.734Z",
  "cancelled": true,
  "externalFiscalNumber": "string",
  "tableNumber": "1",
  "tableName": "Dining Room, Table 1",
  "accountProfileCode": "AAP",
  "ownerName": "Manager",
  "ownerId": 14670,
  "type": "SALE",
  "externalReferences": [
    "[\"TASK:OO-141948669132802-UNIQUEORDERREFERENCEE\", \"TASK:OO-141948669132802-UNIQUEORDERREFERENCEF\"]"
  ],
  "nbCovers": 2.0,
  "dineIn": true,
  "deviceId": 75125,
  "deviceName": "ipad9",
  "voidReason": "Unhappy Client"
}