Przejdź do treści

Typy operacji rozliczeniowych

GET /billing/billing-types

zgodna z Allegroallegro:api:billing:readlimit: read

Dziś pusta lista — allee.pl nie pobiera opłat ani prowizji.

Zgodność: zgodna z Allegro REST API (ten sam kształt) — GET /billing/billing-types.
Uprawnienie: zakres allegro:api:billing:read.
Grupa limitu: read.

Odpowiedzi

200 Typy. · BillingTypeList
id string zawsze
description string zawsze

Błędy

HTTPKodZnaczenie
401invalid_tokenBrak, zły, wygasły albo odwołany token lub klucz (format OAuth, nagłówek WWW-Authenticate).
403ACCOUNT_INACTIVEKonto sprzedawcy jest nieaktywne.
403AccessDeniedBrak zakresu albo zasób innego sprzedawcy.
403KEY_QUARANTINEDKwarantanna: działa tylko odczyt (wykryto nietypowe użycie).
403KEY_SUSPENDEDKlucz albo dostęp aplikacji wstrzymany (przez sprzedawcę albo ochronę).
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Przykład
curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/billing/billing-types" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -w '\nHTTP %{http_code}\n'
Odpowiedź (środowisko testowe)
HTTP 200 application/vnd.allegro.public.v1+json
[]

Operacje rozliczeniowe

GET /billing/billing-entries

zgodna z Allegroallegro:api:billing:readlimit: read

Operacje na koncie rozliczeniowym sprzedawcy (dla allee.pl).

Zgodność: zgodna z Allegro REST API (ten sam kształt) — GET /billing/billing-entries.
Uprawnienie: zakres allegro:api:billing:read.
Grupa limitu: read.

Parametry zapytania

offset integer

Ile pozycji pominąć.

limit integer

Ile pozycji zwrócić (1–100, domyślnie 100).

id.gt string

Po tym id.

occurredAt.gte string · date-time

Od.

occurredAt.lte string · date-time

Do.

type.id string

Typ operacji.

order.id string · uuid

Zamówienie.

offer.id string

Oferta.

Odpowiedzi

200 Operacje. · BillingEntryList
billingEntries array<object> zawsze
Pola obiektu
id string zawsze
occurredAt string · date-time zawsze
type object zawsze
Pola obiektu
id string zawsze
name string · null zawsze
offer object · null zawsze
Pola obiektu
id string zawsze
name string · null zawsze
value Money zawsze

Kwota (kształt Allegro).

Pola obiektu
amount string zawsze

Kwota z dwoma miejscami po przecinku, kropka dziesiętna.

currency string zawsze

Waluta (allee.pl: tylko PLN).

Wartości: PLN
tax object · null zawsze
Pola obiektu
percentage string zawsze
balance Money · null zawsze
Pola obiektu
amount string zawsze

Kwota z dwoma miejscami po przecinku, kropka dziesiętna.

currency string zawsze

Waluta (allee.pl: tylko PLN).

Wartości: PLN
order IdRef · null zawsze
Pola obiektu
id string zawsze
count integer zawsze
totalCount integer zawsze

Błędy

HTTPKodZnaczenie
400VALIDATION_ERRORZła wartość parametru zapytania (400) albo pola treści (422); path wskazuje miejsce.
401invalid_tokenBrak, zły, wygasły albo odwołany token lub klucz (format OAuth, nagłówek WWW-Authenticate).
403ACCOUNT_INACTIVEKonto sprzedawcy jest nieaktywne.
403AccessDeniedBrak zakresu albo zasób innego sprzedawcy.
403KEY_QUARANTINEDKwarantanna: działa tylko odczyt (wykryto nietypowe użycie).
403KEY_SUSPENDEDKlucz albo dostęp aplikacji wstrzymany (przez sprzedawcę albo ochronę).
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Przykład
curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/billing/billing-entries?occurredAt.gte=2026-10-11T00%3A00%3A00Z&limit=50" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -w '\nHTTP %{http_code}\n'
Odpowiedź (środowisko testowe)
HTTP 200 application/vnd.allegro.public.v1+json
{
  "billingEntries": [],
  "count": 0,
  "totalCount": 0
}