Get purchase items tied to a purchase

get https://{project_url}/webservice/rest-api/{api_interface}/{version}/purchases/{purchase_id}/purchase-items

Get information about all purchase items created in relation to a specific purchase.

Path Params

purchase_id

string

required

The unique ID of the purchase.

Query Params

count

integer

≥ 1

Defaults to 100

The number of records to return in API response.
⚠️ We recommended adjust the batch size based on processing time. Depending on the response time of the request. Default value of 100 records is used if count parameter is not set.

offset

integer

≥ 0

Defaults to 0

The number of records from a collection to skip. Default value of 0 is used when parameter offset is not set.

sort_field

string

Name of the sorting parameter. You can sort by any of the first level parameters from the resource response. Response is sorted by the specified field.

sort_direction

string

Direction of sorting the response list.

Headers

Accept-Language

string

Defaults to cs, en-gb;q=0.8

The unique ID of the language code by ISO 639-1.

Responses

Response body

object

data

object

purchase_items

array of objects

List of purchase items tied to a purchase.

purchase_items

object

purchase_item_id

string

The unique ID of the purchase item.

product_id

string

required

The unique ID of the product.

product_name

string

The unique name of the product.

product_group_id

string

The unique ID of the product group.

product_group_name

string

The unique ID of the product group.

product_brand_id

string

The unique ID of the product brand.

product_brand_name

string

The unique ID of the product brand.

external_id

string

Identifier of the purchase item in external system.

purchase_item_type_id

string

required

Type of the purchase item.There is a distinction between a purchase in an e-shop, in a brick-and-mortar store, a mobile application, or a cancellation of the purchase. It also differentiates purchases without the possibility of applying loyalty benefits from ordinary purchases or from purchases with the application of loyalty points.

price

float

required

Price of the purchase item.

amount

float

required

Amount of the purchase item.

vat_rate

float

required

The rate of an item VAT.

additional_properties

array of objects

List of additional properties.

additional_properties

object

property_record_id

string

The unique ID of the property record.

property_id

string

required

The unique ID of the property.

property_name

string

Name of the property.

property_value

Value of the property.

last_change

string

Date and time of the last change. (YYYY-MM-DD HH:MM:SS)

total_items

integer

The number of all found purchase items.

429

Too many requests - more than the resource limit.

503

Temporary state when the service is temporarily unavailable, overloaded or there is a maintenance window.

Language

Credentials

URL


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://sandbox.crmcarecloud.com/webservice/rest-api/enterprise-interface/v1.0/purchases/purchase_id/purchase-items?count=100&offset=0' \
3
     --header 'Accept-Language: cs, en-gb;q=0.8' \
4
     --header 'accept: application/json'


xxxxxxxxxx
30
}
1
{
2
  "data": {
3
    "purchase_items": [
4
      {
5
        "purchase_item_id": "84b757641df03b1529c2c7f66c",
6
        "product_id": "89b3b24b405f461c63d8fcaa0c",
7
        "product_name": "Apple Watch Ultra 2",
8
        "product_group_id": "82de12eb8b138791e678fd11c3",
9
        "product_group_name": "Smart watch",
10
        "product_brand_id": "82db62087b0f79a6e14e5747e7",
11
        "product_brand_name": "Apple",
12
        "external_id": null,
13
        "purchase_item_type_id": "86e05affc7a7abefcd513ab400",
14
        "price": 1.99,
15
        "amount": null,
16
        "vat_rate": null,
17
        "additional_properties": [
18
          {
19
            "property_record_id": "docasna_blokace_darce_do:8ea2591121e636086a4a9c0992",
20
            "property_id": "docasna_blokace_darce_do",
21
            "property_name": "Property #6",
22
            "property_value": "string",
23
            "last_change": "2023-02-02 00:00:00"
24
          }
25
        ]

200OK

400Bad input parameter. Error message specifies the detail.

401The client has invalid credentials or auth token.

403The client does not exist or the client tried to access non authorized property/resource.

404The resource was not found.

405The resource does not support the specified HTTP method.

500Server is not working as expected.