Connector API
Search…
Outlet items

Get all outlet items

Returns all outlet items of the enterprise that were consumed (posted) or will be consumed within the specified interval. If the Currency is specified, costs of the items are converted to that currency.

Request

[PlatformAddress]/api/connector/v1/outletItems/getAll
1
{
2
"ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D",
3
"AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D",
4
"Client": "Sample Client 1.0.0",
5
"ConsumedUtc": {
6
"StartUtc": "2020-01-05T00:00:00Z",
7
"EndUtc": "2020-01-10T00:00:00Z"
8
},
9
"ClosedUtc": {
10
"StartUtc": "2020-01-05T00:00:00Z",
11
"EndUtc": "2020-01-10T00:00:00Z"
12
},
13
"Currency": "EUR"
14
}
Copied!
Property
Type
Contract
Description
ClientToken
string
required
Token identifying the client application.
AccessToken
string
required
Access token of the client application.
Client
string
required
Name and version of the client application.
ConsumedUtc
optional, max length 3 months
Interval in which the Outlet item was consumed. Required if no other filter is provided.
ClosedUtc
optional, max length 3 months
Interval in which the Outlet bill was closed.
Currency
string
optional
ISO-4217 code of the Currency the item costs should be converted to.

Time interval

Property
Type
Contract
Description
StartUtc
string
required
Start of the interval in UTC timezone in ISO 8601 format.
EndUtc
string
required
End of the interval in UTC timezone in ISO 8601 format.

Response

1
{
2
"OutletItems": [
3
{
4
"Id": "f29821b7-1659-4c96-a8c7-3725d0f1509b",
5
"BillId": "5c82a9bd-729c-4f80-af48-a56ab3aebbf6",
6
"AccountingCategoryId": "1131ddd1-fa2b-4150-bbf6-7fce94941f65",
7
"Type": "Revenue",
8
"Name": "sample revenue item",
9
"UnitCount": 4,
10
"UnitAmount": {
11
"Currency": "EUR",
12
"GrossValue": 11,
13
"NetValue": 11,
14
"TaxValues": []
15
},
16
"CreatedUtc": "2018-07-25T12:47:11Z",
17
"ConsumedUtc": "2018-07-26T12:19:07Z",
18
"Notes": null
19
},
20
{
21
"Id": "dfec07c6-e278-4ed0-932f-41bbd1f38039",
22
"BillId": "7bdd3b53-7bb3-419d-8ff2-c9bde65d0c7e",
23
"AccountingCategoryId": "7EDAB816-BF4E-40CC-8936-7BC0B222908D",
24
"Type": "Payment",
25
"Name": "sample payment item",
26
"UnitCount": 77,
27
"UnitAmount": {
28
"Currency": "EUR",
29
"GrossValue": 2,
30
"NetValue": 2
31
"TaxValues": []
32
},
33
"CreatedUtc": "2018-07-25T16:25:28Z",
34
"ConsumedUtc": "2018-07-26T10:11:08Z",
35
"Notes": null
36
}
37
],
38
"OutletBills": [
39
{
40
"Id": "5c82a9bd-729c-4f80-af48-a56ab3aebbf6",
41
"OutletId": "c9f09414-2fdf-41d6-bdb1-12158b01048e",
42
"Number": "1305",
43
"ClosedUtc": "2018-07-26T12:19:07Z",
44
"Notes": null
45
},
46
{
47
"Id": "7bdd3b53-7bb3-419d-8ff2-c9bde65d0c7e",
48
"OutletId": "E0A29D6D-411E-4302-AA6D-9289935C5F14",
49
"Number": "1306",
50
"ClosedUtc": "2018-07-26T10:19:02Z",
51
"Notes": null
52
}
53
]
54
}
Copied!
Property
Type
Contract
Description
OutletItems
array of Outlet item
required
The outlet items.
OutletBills
array of Outlet bill
required
The outlet bills of the items.

Outlet item

Property
Type
Contract
Description
Id
string
required
Unique identifier of the item.
BillId
string
required
Unique identifier of the Outlet bill the item belongs to.
AccountingCategoryId
string
optional
Unique identifier of the Accounting category the item belongs to.
Type
required
Type of the item.
Name
string
required
Name of the item.
UnitCount
number
required
Unit count of the item.
UnitAmount
required
Unit amount of the item.
CreatedUtc
string
optional
Date and time of the item creation in UTC timezone in ISO 8601 format.
ConsumedUtc
string
required
Date and time of the item consumption in UTC timezone in ISO 8601 format.
Notes
string
optional
Additional notes.

Outlet item type

  • Revenue
  • NonRevenue
  • Payment

Outlet bill

Property
Type
Contract
Description
Id
string
required
Unique identifier of the bill.
OutletId
string
required
Unique identifier of the Outlet where the bill was issued.
Number
string
required
Number of the bill.
ClosedUtc
string
required
Date and time of the bill closure in UTC timezone in ISO 8601 format.
Notes
string
optional
Additional notes on the bill.
Last modified 3mo ago