[NEWS] Historia operacji billingowych i saldo / Billing operations and balance

Udostępniliśmy dziś nowy zasób [GET /billing/billing-entries](https://developer.allegro.pl/documentation/#tag/Billing), dzięki któremu pobierzesz [historię operacji billingowych oraz saldo](https://allegro.pl/moje-allegro/moje-konto/rachunki/rozliczenia-z-allegro) zautoryzowanego użytkownika.

Domyślnie w odpowiedzi otrzymasz listę 100 operacji billingowych, gdzie pierwszy wynik jest najnowszy. Możesz skorzystać z sortowania i filtrowania, aby zawęzić wyniki wyszukiwania i uzyskać interesujące cię dane. Więcej na ten temat dowiesz się z [naszego poradnika](https://developer.allegro.pl/charges/#0).

**Przykładowy request,** dla którego otrzymasz informacje o operacjach z 10.10.2019:
```
curl -X GET
https://api.allegro.pl/billing/billing-entries?occurredAt.gte=2019-10-10T00:00:00.000Z&occurredAt.lte=2019-10-10T23:59:59.000Z
-H ‘Authorization: Bearer {token}’ /
-H ‘Accept: application/vnd.allegro.public.v1+json’ /
-H ‘Content-Type: application/vnd.allegro.public.v1+json’
```

**Przykładowy response:**
```
{
"billingEntries": [
{
"id": "da74ef80-f97a-4b04-a748-4c129cfb94b8 -- identyfikator operacji
"occurredAt": "2019-10-10T10:27:17.412Z", -- czas wystąpienia operacji
"type": {
"id": "LIS", -- trzyliterowy kod typu operacji
"name": "Wystawienie przedmiotu" -- nazwa typu operacji
"offer": {
"id": "6206586563", -- identyfikator oferty
"name": "oferta testowa" -- tytuł oferty
},
"value": {
"amount": "-1.00", -- cena operacji
"currency": "PLN"
},
"tax": {
"percentage": "0", -- wysokość podatku
"annotation": "EXEMPT" -- pole opcjonalne - dane zwracamy
w przypadku, gdy operacja jest
zwolniona z podatku (“EXEMPT”)
lub podatek nie ma zastosowania
("NOT_APPLICABLE")
},
"balance": {
"amount": "-737.57", -- saldo po operacji
"currency": "PLN"
}
}
]
}
```

Więcej informacji znajdziesz w naszej [dokumentacji](https://developer.allegro.pl/documentation/#tag/Billing).

-----

We have introduced new resource [GET /billing/billing-entries](https://developer.allegro.pl/documentation/#tag/Billing), which allows you to retrieve[ list of billing operations and balance](https://allegro.pl/moje-allegro/moje-konto/rachunki/rozliczenia-z-allegro) for the authorized user.

By default, you will retrieve list of 100 billing operations, where the first result is the newest. You can use sorting and filtering to narrow down your search results and get the data you are interested in. More information you will find in [our tutorial.](https://developer.allegro.pl/en/charges/#0)

**Sample request**, for which you will retrieve information about the operations from 10.10.2019:

```
curl -X GET
https://api.allegro.pl/billing/billing-entries?occurredAt.gte=2019-10-10T00:00:00.000Z&occurredAt.lte=2019-10-10T23:59:59.000Z
-H ‘Authorization: Bearer {token}’ /
-H ‘Accept: application/vnd.allegro.public.v1+json’ /
-H ‘Content-Type: application/vnd.allegro.public.v1+json’
```

**Sample response:**

```
{
"billingEntries": [
{
"id": "da74ef80-f97a-4b04-a748-4c129cfb94b8", -- billing entry ID
"occurredAt": "2019-10-10T10:27:17.412Z", -- date of billing entry
"type": {
"id": "LIS", -- three-letter code of the billing type
"name": "Wystawienie przedmiotu" -- name of the billing type
"offer": {
"id": "6206586563", -- offer ID
"name": "oferta testowa" -- offer title
},
"value": {
"amount": "-1.00",
"currency": "PLN"
},
"tax": {
"percentage": "0" -- tax rate
"annotation": "EXEMPT" -- additional field - returned if
the billing entry is exempt
from tax (“EXEMPT”)
or tax is not applicable
("NOT_APPLICABLE")
},
"balance": {
"amount": "-737.57", -- balance after the operation
"currency": "PLN"
}
}
]
}
```

You can find more details about the new resource in the [documentation](https://developer.allegro.pl/documentation/#tag/Billing).