๐งพTickets
This page provides a description of the available API routes for managing tickets.
Before you dive into the tickets API reference, it's a great idea to check out some articles that talk about different ticket states, the math used in tickets.
Additionally, if you plan to both read and edit tickets, don't miss the article on how tickets work with users' permissions.
API methods
Get tickets
GET
http://{server-address}/tickets
Returns all customers that matches query parameters. Result is of type QueryResult<Ticket>
.
Query Parameters
Headers
{
"items":
[
{
"id": "635f70e1fa3dab15784a0b45",
"externalId": null,
"state": "Closed",
"type": "CashRegister",
"name": "7",
"openDate": "2022-10-31T06:53:20.76Z",
"issueDate": null,
"closeDate": "2022-10-31T07:05:43Z",
"closeInfo":
{
"eKasa": null,
"dailySalesReportNumber": 123,
"number": 3,
"fiscalMemorySerialNumber": "347...005",
"fiscalName": "eKasa",
"deviceName": "P01"
},
"purchaseType": "WalkIn",
"location":
{
"zoneName": "Bar",
"tableName": "B7"
},
"customer":
{
"id": null,
"externalId": null,
"cardSerialNumber": "customer-card-serial-number",
"firstName": null,
"lastName": null,
"fullName": "John Doe",
"gender": null,
"birthDate": null,
"address": null,
"deliveryAddress": null,
"isCompany": false,
"company": null,
"phone": null,
"email": null,
"creditRate": null,
"meta":
{}
},
"originDeviceName": "P01",
"employee":
{
"name": "Mr. Waiter",
"userName": "1",
"featureName": null
},
"items":
[
{
"id": 1,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Cappucino",
"description": null,
"stockName": "S01",
"code": 9,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 2.083333,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 2,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Espresso Doppio",
"description": null,
"stockName": "S01",
"code": 7,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 2.166667,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 3,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Espresso",
"description": null,
"stockName": "S01",
"code": 1,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 1.416667,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 4,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Mlieko",
"description": null,
"stockName": "S01",
"code": 49,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 0.25,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
}
],
"payments":
[
{
"paymentType":
{
"number": 2,
"description": "Kreditnรก karta",
"isChangeable": false,
"category": "CreditCard"
},
"amount":
{
"amount": 6.73,
"currencyLabel": "EUR",
"domesticCurrencyLabel": "EUR",
"exchangeRate": 1.0
}
}
],
"currencyLabel": "EUR",
"discountRate": 5.0,
"roundingAmount":
{
"amount": 0.0,
"currencyLabel": "EUR"
},
"invoiceNumber": null,
"paragonNumber": null,
"isParagon": false,
"_v": 2
}
],
"count": 1,
"totalCount": 258773
}
Get ticket
GET
http://{server-address}/tickets/{id}
Result is of type Ticket
.
Query Parameters
Headers
{
"id": "635f70e1fa3dab15784a0b45",
"externalId": null,
"state": "Closed",
"type": "CashRegister",
"name": "7",
"openDate": "2022-10-31T06:53:20.76Z",
"issueDate": null,
"closeDate": "2022-10-31T07:05:43Z",
"closeInfo":
{
"eKasa": null,
"dailySalesReportNumber": 123,
"number": 3,
"fiscalMemorySerialNumber": "347...005",
"fiscalName": "eKasa",
"deviceName": "P01"
},
"purchaseType": "WalkIn",
"location":
{
"zoneName": "Bar",
"tableName": "B7"
},
"customer":
{
"id": null,
"externalId": null,
"cardSerialNumber": "customer-card-serial-number",
"firstName": null,
"lastName": null,
"fullName": "John Doe",
"gender": null,
"birthDate": null,
"address": null,
"deliveryAddress": null,
"isCompany": false,
"company": null,
"phone": null,
"email": null,
"creditRate": null,
"meta":
{}
},
"originDeviceName": "P01",
"employee":
{
"name": "Mr. Waiter",
"userName": "1",
"featureName": null
},
"items":
[
{
"id": 1,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Cappucino",
"description": null,
"stockName": "S01",
"code": 9,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 2.083333,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 2,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Espresso Doppio",
"description": null,
"stockName": "S01",
"code": 7,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 2.166667,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 3,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Espresso",
"description": null,
"stockName": "S01",
"code": 1,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 1.416667,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 4,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Mlieko",
"description": null,
"stockName": "S01",
"code": 49,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 0.25,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
}
],
"payments":
[
{
"paymentType":
{
"number": 2,
"description": "Kreditnรก karta",
"isChangeable": false,
"category": "CreditCard"
},
"amount":
{
"amount": 6.73,
"currencyLabel": "EUR",
"domesticCurrencyLabel": "EUR",
"exchangeRate": 1.0
}
}
],
"currencyLabel": "EUR",
"discountRate": 5.0,
"roundingAmount":
{
"amount": 0.0,
"currencyLabel": "EUR"
},
"invoiceNumber": null,
"paragonNumber": null,
"isParagon": false,
"_v": 2
}
{
"title": "Zdroj nebol nรกjdenรฝ",
"status": 404
}
Create ticket
POST
http://{server-address}/tickets
Creates new opened ticket. Result is of type Ticket
.
Required rights
Please see User rights required for creating and modifying ticket section.
Required environments
Sale environment required.
Headers
Request Body
{
"id": "635f70e1fa3dab15784a0b45",
"externalId": null,
"state": "Open",
"type": "CashRegister",
"name": "7",
"openDate": "2022-10-31T06:53:20.76Z",
"issueDate": null,
"closeDate": null,
"closeInfo": null,
"purchaseType": "WalkIn",
"location":
{
"zoneName": "Bar",
"tableName": "B7"
},
"customer":
{
"id": null,
"externalId": null,
"cardSerialNumber": "customer-card-serial-number",
"firstName": null,
"lastName": null,
"fullName": "John Doe",
"gender": null,
"birthDate": null,
"address": null,
"deliveryAddress": null,
"isCompany": false,
"company": null,
"phone": null,
"email": null,
"creditRate": null,
"meta":
{}
},
"originDeviceName": "P01",
"employee":
{
"name": "Mr. Waiter",
"userName": "1",
"featureName": null
},
"items":
[
{
"id": 1,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Cappucino",
"description": null,
"stockName": "S01",
"code": 9,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 2.083333,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 2,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Espresso Doppio",
"description": null,
"stockName": "S01",
"code": 7,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 2.166667,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 3,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Espresso",
"description": null,
"stockName": "S01",
"code": 1,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 1.416667,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 4,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Mlieko",
"description": null,
"stockName": "S01",
"code": 49,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 0.25,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
}
],
"payments": [],
"currencyLabel": "EUR",
"discountRate": 5.0,
"roundingAmount": null,
"invoiceNumber": null,
"paragonNumber": null,
"isParagon": false,
"_v": 1
}
Create or update ticket
PUT
http://{server-address}/tickets/{id}
Creates new or updates existing opened ticket. Attempt to update closed ticket will result in HTTP Status 403 (Forbidden). Result is of type Ticket
.
Required rights
Please see User rights required for creating and modifying ticket section.
Required environments
Sale environment required.
Path Parameters
Headers
Request Body
{
"id": "635f70e1fa3dab15784a0b45",
"externalId": null,
"state": "Open",
"type": "CashRegister",
"name": "7",
"openDate": "2022-10-31T06:53:20.76Z",
"issueDate": null,
"closeDate": null,
"closeInfo": null,
"purchaseType": "WalkIn",
"location":
{
"zoneName": "Bar",
"tableName": "B7"
},
"customer":
{
"id": null,
"externalId": null,
"cardSerialNumber": "customer-card-serial-number",
"firstName": null,
"lastName": null,
"fullName": "John Doe",
"gender": null,
"birthDate": null,
"address": null,
"deliveryAddress": null,
"isCompany": false,
"company": null,
"phone": null,
"email": null,
"creditRate": null,
"meta":
{}
},
"originDeviceName": "P01",
"employee":
{
"name": "Mr. Waiter",
"userName": "1",
"featureName": null
},
"items":
[
{
"id": 1,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Cappucino",
"description": null,
"stockName": "S01",
"code": 9,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 2.083333,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 2,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Espresso Doppio",
"description": null,
"stockName": "S01",
"code": 7,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 2.166667,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 3,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Espresso",
"description": null,
"stockName": "S01",
"code": 1,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 1.416667,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 4,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Mlieko",
"description": null,
"stockName": "S01",
"code": 49,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 0.25,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
}
],
"payments": [],
"currencyLabel": "EUR",
"discountRate": 5.0,
"roundingAmount": null,
"invoiceNumber": null,
"paragonNumber": null,
"isParagon": false,
"_v": 1
}
Batch tickets update
PATCH
http://{server-address}/tickets
Preforms batch update of one or more tickets. Collection of affected tickets is returned.
Required rights
Please see User rights required for creating and modifying ticket section.
Required environments
Sale environment required.
Path Parameters
Headers
{
"id": "635f70e1fa3dab15784a0b45",
"externalId": null,
"state": "Open",
"type": "CashRegister",
"name": "7",
"openDate": "2022-10-31T06:53:20.76Z",
"issueDate": null,
"closeDate": null,
"closeInfo": null,
"purchaseType": "WalkIn",
"location":
{
"zoneName": "Bar",
"tableName": "B7"
},
"customer":
{
"id": null,
"externalId": null,
"cardSerialNumber": "customer-card-serial-number",
"firstName": null,
"lastName": null,
"fullName": "John Doe",
"gender": null,
"birthDate": null,
"address": null,
"deliveryAddress": null,
"isCompany": false,
"company": null,
"phone": null,
"email": null,
"creditRate": null,
"meta":
{}
},
"originDeviceName": "P01",
"employee":
{
"name": "Mr. Waiter",
"userName": "1",
"featureName": null
},
"items":
[
{
"id": 1,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Cappucino",
"description": null,
"stockName": "S01",
"code": 9,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 2.083333,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 2,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Espresso Doppio",
"description": null,
"stockName": "S01",
"code": 7,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 2.166667,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 3,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Espresso",
"description": null,
"stockName": "S01",
"code": 1,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 1.416667,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 4,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Mlieko",
"description": null,
"stockName": "S01",
"code": 49,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 0.25,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
}
],
"payments": [],
"currencyLabel": "EUR",
"discountRate": 5.0,
"roundingAmount": null,
"invoiceNumber": null,
"paragonNumber": null,
"isParagon": false,
"_v": 1
}
{
"title": "Zdroj nebol nรกjdenรฝ",
"status": 404
}
Delete ticket
DELETE
http://{server-address}/tickets/{id}
Required rights
Please see User rights required for deleting ticket section.
Required environments
Sale environment required.
Path Parameters
Headers
{
"id": "635f70e1fa3dab15784a0b45",
"externalId": null,
"state": "Open",
"type": "CashRegister",
"name": "7",
"openDate": "2022-10-31T06:53:20.76Z",
"issueDate": null,
"closeDate": null,
"closeInfo": null,
"purchaseType": "WalkIn",
"location":
{
"zoneName": "Bar",
"tableName": "B7"
},
"customer":
{
"id": null,
"externalId": null,
"cardSerialNumber": "customer-card-serial-number",
"firstName": null,
"lastName": null,
"fullName": "John Doe",
"gender": null,
"birthDate": null,
"address": null,
"deliveryAddress": null,
"isCompany": false,
"company": null,
"phone": null,
"email": null,
"creditRate": null,
"meta":
{}
},
"originDeviceName": "P01",
"employee":
{
"name": "Mr. Waiter",
"userName": "1",
"featureName": null
},
"items":
[
{
"id": 1,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Cappucino",
"description": null,
"stockName": "S01",
"code": 9,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 2.083333,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 2,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Espresso Doppio",
"description": null,
"stockName": "S01",
"code": 7,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 2.166667,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 3,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Espresso",
"description": null,
"stockName": "S01",
"code": 1,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 1.416667,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 4,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Mlieko",
"description": null,
"stockName": "S01",
"code": 49,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 0.25,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
}
],
"payments": [],
"currencyLabel": "EUR",
"discountRate": 5.0,
"roundingAmount": null,
"invoiceNumber": null,
"paragonNumber": null,
"isParagon": false,
"_v": 1
}
{
"title": "Zdroj nebol nรกjdenรฝ",
"status": 404
}
RPC Actions
These API methods trigger specific actions on server. However, it's important to note that depending on the type of selected fiscal device or order endpoint device, some methods may not be supported. Furthermore, if an action is attempted on an inactive fiscal device or order endpoint device, it will lead to failure. In both scenarios, making API calls will generate an HTTP status code of 403.
Close ticket
POST
http://{server-address}/tickets/{id}/close
Fiscalizes specific ticket (prints receipt or sends email receipt)and changes it's state to closed. Request body contains TicketCloseContext
class. Ticket is returned in response body.
Required rights
Please see User rights required for closing ticket section.
Required environments
Sale environment required.
Path Parameters
Headers
Request Body
{
"id": "635f70e1fa3dab15784a0b45",
"externalId": null,
"state": "Closed",
"type": "CashRegister",
"name": "7",
"openDate": "2022-10-31T06:53:20.76Z",
"issueDate": null,
"closeDate": "2022-10-31T07:05:43Z",
"closeInfo":
{
"eKasa": null,
"dailySalesReportNumber": 123,
"number": 3,
"fiscalMemorySerialNumber": "347...005",
"fiscalName": "eKasa",
"deviceName": "P01"
},
"purchaseType": "WalkIn",
"location":
{
"zoneName": "Bar",
"tableName": "B7"
},
"customer":
{
"id": null,
"externalId": null,
"cardSerialNumber": "customer-card-serial-number",
"firstName": null,
"lastName": null,
"fullName": "John Doe",
"gender": null,
"birthDate": null,
"address": null,
"deliveryAddress": null,
"isCompany": false,
"company": null,
"phone": null,
"email": null,
"creditRate": null,
"meta":
{}
},
"originDeviceName": "P01",
"employee":
{
"name": "Mr. Waiter",
"userName": "1",
"featureName": null
},
"items":
[
{
"id": 1,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Cappucino",
"description": null,
"stockName": "S01",
"code": 9,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 2.083333,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 2,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Espresso Doppio",
"description": null,
"stockName": "S01",
"code": 7,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 2.166667,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 3,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Espresso",
"description": null,
"stockName": "S01",
"code": 1,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 1.416667,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
},
{
"id": 4,
"externalId": null,
"type": "Positive",
"plu":
{
"name": "Mlieko",
"description": null,
"stockName": "S01",
"code": 49,
"articleCategoryLabel": "KAV",
"vatInfo":
{
"category": 1,
"rate": 20.0
},
"isDiscountAllowed": true,
"isPriceFixed": true,
"isSplittable": true,
"orderEndpointNames":
[
"Bar"
],
"type": "Recipe",
"specialRegulation": null,
"isCashbackAllowed": true
},
"comment": null,
"unitPrice":
{
"amount": 0.25,
"currencyLabel": "EUR"
},
"quantity":
{
"amount": 1.0,
"unit": "ks"
},
"discountRate": 0.0,
"referenceFiscalTicketId": null,
"voucherNumber": null,
"isQuantityFixed": false,
"courseNumber": null
}
],
"payments":
[
{
"paymentType":
{
"number": 2,
"description": "Kreditnรก karta",
"isChangeable": false,
"category": "CreditCard"
},
"amount":
{
"amount": 6.73,
"currencyLabel": "EUR",
"domesticCurrencyLabel": "EUR",
"exchangeRate": 1.0
}
}
],
"currencyLabel": "EUR",
"discountRate": 5.0,
"roundingAmount":
{
"amount": 0.0,
"currencyLabel": "EUR"
},
"invoiceNumber": null,
"paragonNumber": null,
"isParagon": false,
"_v": 2
}
{
"title": "Zdroj nebol nรกjdenรฝ",
"status": 404
}
Print preliminary ticket
POST
http://{server-address}/tickets/{id}/print_preliminary_ticket
Prints preliminary receipt on specified order endpoint.
A preliminary receipt, often referred to as a "pre-check" or "provisional bill," is a document provided to diners before they make the final payment for their meal. This receipt outlines the items ordered and their associated costs, offering customers an initial overview of their expenses. This lets customer review the details before the final bill is issued.
The ticket's state remains unchanged. This action can be executed on both opened and closed tickets.
Required rights
Please see User rights required for printing preliminary ticket section.
Required environments
Sale environment required.
Path Parameters
Headers
Request Body
The response contains no content.
{
"title": "Zdroj nebol nรกjdenรฝ",
"status": 404
}
Last updated