21 października 2019
Historia operacji billingowych i saldo
Udostępniliśmy dziś nowy zasób GET /billing/billing-entries, dzięki któremu pobierzesz historię operacji billingowych oraz saldo 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.
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.
