Przejdź do treści

Warunki zwrotów — lista

GET /after-sales-service-conditions/return-policies

zgodna z Allegroallegro:api:sale:settings:readlimit: read

Twoje wpisy warunków zwrotów (id i nazwa). Klucz listy: returnPolicies.

Zgodność: zgodna z Allegro REST API (ten sam kształt) — GET /after-sales-service-conditions/return-policies.
Uprawnienie: zakres allegro:api:sale:settings:read.
Grupa limitu: read.

Odpowiedzi

200 Lista. · ReturnPolicyList
returnPolicies array<object> zawsze
Pola obiektu
id string · uuid zawsze
name string zawsze
count integer 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}/after-sales-service-conditions/return-policies" \
  -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
{
  "returnPolicies": [
    {
      "id": "0d2fcf15-119d-479c-9d97-ba1794013def",
      "name": "Zwroty 30 dni"
    },
    {
      "id": "42133d83-0ba2-472e-9f21-25f2c35b69e4",
      "name": "Zwroty demo"
    }
  ],
  "count": 2
}

Warunki zwrotów — nowe

POST /after-sales-service-conditions/return-policies

zgodna z Allegroallegro:api:sale:settings:writelimit: write

name (1–100 znaków) i pola w kształcie Allegro z białej listy (np. okres P14D, kto pokrywa koszt zwrotu, adres) — wartości sprawdzamy, a pola spoza listy pomijamy.

201 — nowy wpis. 200 — ta sama name i identyczna treść (bezpieczne ponowienie). Ta sama name, inna treść → 422 NAME_HAS_TO_BE_UNIQUE (details = id istniejącego). Najwyżej 50 wpisów każdego rodzaju.

Zgodność: zgodna z Allegro REST API (ten sam kształt) — POST /after-sales-service-conditions/return-policies.
Uprawnienie: zakres allegro:api:sale:settings:write.
Grupa limitu: write.

Nagłówki

Idempotency-Key string

Ochrona przed podwójnym wykonaniem (jak Stripe/Amazon): powtórzony POST z tym samym kluczem i tą samą treścią w ciągu 24 h zwraca zapisaną odpowiedź z nagłówkiem Idempotent-Replayed: true i niczego nie wykonuje drugi raz. Inna treść → 422 IDEMPOTENCY_KEY_REUSED; żądanie jeszcze trwa → 409 IDEMPOTENCY_KEY_IN_USE. 1–100 znaków ASCII (np. UUID).

Treść żądania application/vnd.allegro.public.v1+json

name string wymagane

1–100 znaków, unikalna w obrębie sprzedawcy.

availability object
Pola obiektu
range string
Wartości: FULL, RESTRICTED, DISABLED
restrictionCause object
Pola obiektu
name string
description string
withdrawalPeriod string

Okres ISO 8601, np. P14D, P1Y, P2Y.

returnCost object
Pola obiektu
coveredBy string
Wartości: SELLER, BUYER
address object

Adres (kształt Allegro).

Pola obiektu
name string
street string
postCode string
postalCode string
city string
countryCode string

Kod kraju ISO 3166-1 alfa-2.

phoneNumber string
email string · email
contact object
Pola obiektu
phoneNumber string
email string · email
options object
Pola obiektu
cashOnDeliveryNotAllowed boolean
freeAccessoriesReturnRequired boolean
refundLoweredByReceivedDiscount boolean
businessReturnAllowed boolean
collectBySellerOnly boolean
description string

Odpowiedzi

200 Identyczny wpis już był. · ReturnPolicy
id string · uuid zawsze
name string zawsze
availability object
Pola obiektu
range string
Wartości: FULL, RESTRICTED, DISABLED
restrictionCause object
Pola obiektu
name string
description string
withdrawalPeriod string

Okres ISO 8601, np. P14D, P1Y, P2Y.

returnCost object
Pola obiektu
coveredBy string
Wartości: SELLER, BUYER
address object

Adres (kształt Allegro).

Pola obiektu
name string
street string
postCode string
postalCode string
city string
countryCode string

Kod kraju ISO 3166-1 alfa-2.

phoneNumber string
email string · email
contact object
Pola obiektu
phoneNumber string
email string · email
options object
Pola obiektu
cashOnDeliveryNotAllowed boolean
freeAccessoriesReturnRequired boolean
refundLoweredByReceivedDiscount boolean
businessReturnAllowed boolean
collectBySellerOnly boolean
description string
201 Utworzono. · ReturnPolicy
id string · uuid zawsze
name string zawsze
availability object
Pola obiektu
range string
Wartości: FULL, RESTRICTED, DISABLED
restrictionCause object
Pola obiektu
name string
description string
withdrawalPeriod string

Okres ISO 8601, np. P14D, P1Y, P2Y.

returnCost object
Pola obiektu
coveredBy string
Wartości: SELLER, BUYER
address object

Adres (kształt Allegro).

Pola obiektu
name string
street string
postCode string
postalCode string
city string
countryCode string

Kod kraju ISO 3166-1 alfa-2.

phoneNumber string
email string · email
contact object
Pola obiektu
phoneNumber string
email string · email
options object
Pola obiektu
cashOnDeliveryNotAllowed boolean
freeAccessoriesReturnRequired boolean
refundLoweredByReceivedDiscount boolean
businessReturnAllowed boolean
collectBySellerOnly boolean
description string

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ę).
413PAYLOAD_TOO_LARGETreść żądania za duża (JSON 5 MB, faktura PDF 3 MB).
415UNSUPPORTED_MEDIA_TYPEZły Content-Type treści.
422JsonMappingExceptionTreść nie jest poprawnym JSON albo ma zły kształt (np. images jako obiekty).
422LIMIT_EXCEEDEDLimit wpisów osiągnięty (np. 50 warunków danego rodzaju).
422NAME_HAS_TO_BE_UNIQUENazwa zajęta (details = id istniejącego wpisu).
422VALIDATION_ERRORZła wartość parametru zapytania (400) albo pola treści (422); path wskazuje miejsce.
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Przykład
curl -sS -X POST "${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/return-policies" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -H "Content-Type: application/vnd.allegro.public.v1+json" \
  --data-binary @- \
  -w '\nHTTP %{http_code}\n' <<'JSON'
{
  "name": "Zwroty 30 dni",
  "availability": {
    "range": "FULL"
  },
  "withdrawalPeriod": "P30D",
  "returnCost": {
    "coveredBy": "SELLER"
  },
  "address": {
    "name": "Sklep Przykładowy",
    "street": "Magazynowa 1",
    "postCode": "00-001",
    "city": "Warszawa",
    "countryCode": "PL"
  }
}
JSON
Odpowiedź (środowisko testowe)
HTTP 201 application/vnd.allegro.public.v1+json
{
  "id": "0d2fcf15-119d-479c-9d97-ba1794013def",
  "name": "Zwroty 30 dni",
  "availability": {
    "range": "FULL"
  },
  "withdrawalPeriod": "P30D",
  "returnCost": {
    "coveredBy": "SELLER"
  },
  "address": {
    "name": "Sklep Przykładowy",
    "street": "Magazynowa 1",
    "postCode": "00-001",
    "city": "Warszawa",
    "countryCode": "PL"
  }
}
Przykład: Warunki do usunięcia
curl -sS -X POST "${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/return-policies" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -H "Content-Type: application/vnd.allegro.public.v1+json" \
  --data-binary @- \
  -w '\nHTTP %{http_code}\n' <<'JSON'
{
  "name": "Zwroty 14 dni (stare)",
  "availability": {
    "range": "FULL"
  },
  "withdrawalPeriod": "P14D",
  "returnCost": {
    "coveredBy": "BUYER"
  }
}
JSON
HTTP 201 application/vnd.allegro.public.v1+json
{
  "id": "134c9af0-5758-4921-92d0-6e9e2a8f595f",
  "name": "Zwroty 14 dni (stare)",
  "availability": {
    "range": "FULL"
  },
  "withdrawalPeriod": "P14D",
  "returnCost": {
    "coveredBy": "BUYER"
  }
}

Warunki zwrotów

GET /after-sales-service-conditions/return-policies/{returnPolicyId}

zgodna z Allegroallegro:api:sale:settings:readlimit: read

Pełny wpis warunków zwrotów. Cudzy → 403, brak (albo inny rodzaj) → 404.

Zgodność: zgodna z Allegro REST API (ten sam kształt) — GET /after-sales-service-conditions/return-policies/{id}.
Uprawnienie: zakres allegro:api:sale:settings:read.
Grupa limitu: read.

Parametry ścieżki

returnPolicyId string wymagany

Identyfikator (UUID).

Odpowiedzi

200 Wpis. · ReturnPolicy
id string · uuid zawsze
name string zawsze
availability object
Pola obiektu
range string
Wartości: FULL, RESTRICTED, DISABLED
restrictionCause object
Pola obiektu
name string
description string
withdrawalPeriod string

Okres ISO 8601, np. P14D, P1Y, P2Y.

returnCost object
Pola obiektu
coveredBy string
Wartości: SELLER, BUYER
address object

Adres (kształt Allegro).

Pola obiektu
name string
street string
postCode string
postalCode string
city string
countryCode string

Kod kraju ISO 3166-1 alfa-2.

phoneNumber string
email string · email
contact object
Pola obiektu
phoneNumber string
email string · email
options object
Pola obiektu
cashOnDeliveryNotAllowed boolean
freeAccessoriesReturnRequired boolean
refundLoweredByReceivedDiscount boolean
businessReturnAllowed boolean
collectBySellerOnly boolean
description string

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ę).
404NOT_FOUNDNie ma takiego zasobu (albo należy do innego sprzedawcy — dla wątków, zwrotów i spraw odpowiedź jest ta sama).
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}/after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def" \
  -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
{
  "id": "0d2fcf15-119d-479c-9d97-ba1794013def",
  "name": "Zwroty 30 dni",
  "availability": {
    "range": "FULL"
  },
  "withdrawalPeriod": "P30D",
  "returnCost": {
    "coveredBy": "SELLER"
  },
  "address": {
    "name": "Sklep Przykładowy",
    "street": "Magazynowa 1",
    "postCode": "00-001",
    "city": "Warszawa",
    "countryCode": "PL"
  }
}

Warunki zwrotów — zmiana

PUT /after-sales-service-conditions/return-policies/{returnPolicyId}

zgodna z Allegroallegro:api:sale:settings:writelimit: write

Pełna podmiana treści (biała lista pól Allegro dla rodzaju; nieznane pole → 422 UnknownJSONProperty). Oferty wskazujące ten wpis widzą nową treść.

Zgodność: zgodna z Allegro REST API (ten sam kształt) — PUT /after-sales-service-conditions/return-policies/{id}.
Uprawnienie: zakres allegro:api:sale:settings:write.
Grupa limitu: write.

Parametry ścieżki

returnPolicyId string wymagany

Identyfikator (UUID).

Treść żądania application/vnd.allegro.public.v1+json

name string wymagane

1–100 znaków, unikalna w obrębie sprzedawcy.

availability object
Pola obiektu
range string
Wartości: FULL, RESTRICTED, DISABLED
restrictionCause object
Pola obiektu
name string
description string
withdrawalPeriod string

Okres ISO 8601, np. P14D, P1Y, P2Y.

returnCost object
Pola obiektu
coveredBy string
Wartości: SELLER, BUYER
address object

Adres (kształt Allegro).

Pola obiektu
name string
street string
postCode string
postalCode string
city string
countryCode string

Kod kraju ISO 3166-1 alfa-2.

phoneNumber string
email string · email
contact object
Pola obiektu
phoneNumber string
email string · email
options object
Pola obiektu
cashOnDeliveryNotAllowed boolean
freeAccessoriesReturnRequired boolean
refundLoweredByReceivedDiscount boolean
businessReturnAllowed boolean
collectBySellerOnly boolean
description string

Odpowiedzi

200 Zmieniono. · ReturnPolicy
id string · uuid zawsze
name string zawsze
availability object
Pola obiektu
range string
Wartości: FULL, RESTRICTED, DISABLED
restrictionCause object
Pola obiektu
name string
description string
withdrawalPeriod string

Okres ISO 8601, np. P14D, P1Y, P2Y.

returnCost object
Pola obiektu
coveredBy string
Wartości: SELLER, BUYER
address object

Adres (kształt Allegro).

Pola obiektu
name string
street string
postCode string
postalCode string
city string
countryCode string

Kod kraju ISO 3166-1 alfa-2.

phoneNumber string
email string · email
contact object
Pola obiektu
phoneNumber string
email string · email
options object
Pola obiektu
cashOnDeliveryNotAllowed boolean
freeAccessoriesReturnRequired boolean
refundLoweredByReceivedDiscount boolean
businessReturnAllowed boolean
collectBySellerOnly boolean
description string

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ę).
404NOT_FOUNDNie ma takiego zasobu (albo należy do innego sprzedawcy — dla wątków, zwrotów i spraw odpowiedź jest ta sama).
413PAYLOAD_TOO_LARGETreść żądania za duża (JSON 5 MB, faktura PDF 3 MB).
415UNSUPPORTED_MEDIA_TYPEZły Content-Type treści.
422JsonMappingExceptionTreść nie jest poprawnym JSON albo ma zły kształt (np. images jako obiekty).
422NAME_HAS_TO_BE_UNIQUENazwa zajęta (details = id istniejącego wpisu).
422UnknownJSONPropertyPole nieznane w tym miejscu (path wskazuje które).
422VALIDATION_ERRORZła wartość parametru zapytania (400) albo pola treści (422); path wskazuje miejsce.
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Przykład
curl -sS -X PUT "${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -H "Content-Type: application/vnd.allegro.public.v1+json" \
  --data-binary @- \
  -w '\nHTTP %{http_code}\n' <<'JSON'
{
  "name": "Zwroty 30 dni",
  "availability": {
    "range": "FULL"
  },
  "withdrawalPeriod": "P30D",
  "returnCost": {
    "coveredBy": "SELLER"
  },
  "address": {
    "name": "Sklep Przykładowy",
    "street": "Magazynowa 2",
    "postCode": "00-001",
    "city": "Warszawa",
    "countryCode": "PL"
  }
}
JSON
Odpowiedź (środowisko testowe)
HTTP 200 application/vnd.allegro.public.v1+json
{
  "id": "0d2fcf15-119d-479c-9d97-ba1794013def",
  "name": "Zwroty 30 dni",
  "availability": {
    "range": "FULL"
  },
  "withdrawalPeriod": "P30D",
  "returnCost": {
    "coveredBy": "SELLER"
  },
  "address": {
    "name": "Sklep Przykładowy",
    "street": "Magazynowa 2",
    "postCode": "00-001",
    "city": "Warszawa",
    "countryCode": "PL"
  }
}

Warunki zwrotów — usunięcie

DELETE /after-sales-service-conditions/return-policies/{returnPolicyId}

zgodna z Allegroallegro:api:sale:settings:writelimit: write

Usuwa wpis. Wpis wskazany w którejś ofercie → 409 IN_USE (najpierw odepnij go od ofert).

Zgodność: zgodna z Allegro REST API (ten sam kształt) — DELETE /after-sales-service-conditions/return-policies/{id}.
Uprawnienie: zakres allegro:api:sale:settings:write.
Grupa limitu: write.

Parametry ścieżki

returnPolicyId string wymagany

Identyfikator (UUID).

Odpowiedzi

204 Usunięto.

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ę).
404NOT_FOUNDNie ma takiego zasobu (albo należy do innego sprzedawcy — dla wątków, zwrotów i spraw odpowiedź jest ta sama).
409IN_USEWpis jest wskazany w ofercie.
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Przykład
curl -sS -X DELETE "${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/return-policies/134c9af0-5758-4921-92d0-6e9e2a8f595f" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -w '\nHTTP %{http_code}\n'
Odpowiedź (środowisko testowe)
HTTP 204 text/html; charset=UTF-8
(0 B: text/html; charset=UTF-8)

Warunki reklamacji (rękojmia) — lista

GET /after-sales-service-conditions/implied-warranties

zgodna z Allegroallegro:api:sale:settings:readlimit: read

Twoje wpisy warunków reklamacji (id i nazwa). Klucz listy: impliedWarranties.

Zgodność: zgodna z Allegro REST API (ten sam kształt) — GET /after-sales-service-conditions/implied-warranties.
Uprawnienie: zakres allegro:api:sale:settings:read.
Grupa limitu: read.

Odpowiedzi

200 Lista. · ImpliedWarrantyList
impliedWarranties array<object> zawsze
Pola obiektu
id string · uuid zawsze
name string zawsze
count integer 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}/after-sales-service-conditions/implied-warranties" \
  -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
{
  "impliedWarranties": [
    {
      "id": "eab748ba-c9ec-444f-8f18-eb3b4174ebca",
      "name": "Reklamacje demo"
    },
    {
      "id": "d82f8496-f284-4cdf-9575-242222870c5f",
      "name": "Rękojmia 2 lata"
    }
  ],
  "count": 2
}

Warunki reklamacji (rękojmia) — nowe

POST /after-sales-service-conditions/implied-warranties

zgodna z Allegroallegro:api:sale:settings:writelimit: write

name (1–100 znaków) i pola w kształcie Allegro z białej listy (np. okres P14D, kto pokrywa koszt zwrotu, adres) — wartości sprawdzamy, a pola spoza listy pomijamy.

201 — nowy wpis. 200 — ta sama name i identyczna treść (bezpieczne ponowienie). Ta sama name, inna treść → 422 NAME_HAS_TO_BE_UNIQUE (details = id istniejącego). Najwyżej 50 wpisów każdego rodzaju.

Zgodność: zgodna z Allegro REST API (ten sam kształt) — POST /after-sales-service-conditions/implied-warranties.
Uprawnienie: zakres allegro:api:sale:settings:write.
Grupa limitu: write.

Nagłówki

Idempotency-Key string

Ochrona przed podwójnym wykonaniem (jak Stripe/Amazon): powtórzony POST z tym samym kluczem i tą samą treścią w ciągu 24 h zwraca zapisaną odpowiedź z nagłówkiem Idempotent-Replayed: true i niczego nie wykonuje drugi raz. Inna treść → 422 IDEMPOTENCY_KEY_REUSED; żądanie jeszcze trwa → 409 IDEMPOTENCY_KEY_IN_USE. 1–100 znaków ASCII (np. UUID).

Treść żądania application/vnd.allegro.public.v1+json

name string wymagane

1–100 znaków, unikalna.

individual object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
corporate object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
address object

Adres (kształt Allegro).

Pola obiektu
name string
street string
postCode string
postalCode string
city string
countryCode string

Kod kraju ISO 3166-1 alfa-2.

phoneNumber string
email string · email
description string

Odpowiedzi

200 Identyczny wpis już był. · ImpliedWarranty
id string · uuid zawsze
name string zawsze
individual object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
corporate object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
address object

Adres (kształt Allegro).

Pola obiektu
name string
street string
postCode string
postalCode string
city string
countryCode string

Kod kraju ISO 3166-1 alfa-2.

phoneNumber string
email string · email
description string
201 Utworzono. · ImpliedWarranty
id string · uuid zawsze
name string zawsze
individual object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
corporate object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
address object

Adres (kształt Allegro).

Pola obiektu
name string
street string
postCode string
postalCode string
city string
countryCode string

Kod kraju ISO 3166-1 alfa-2.

phoneNumber string
email string · email
description string

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ę).
413PAYLOAD_TOO_LARGETreść żądania za duża (JSON 5 MB, faktura PDF 3 MB).
415UNSUPPORTED_MEDIA_TYPEZły Content-Type treści.
422JsonMappingExceptionTreść nie jest poprawnym JSON albo ma zły kształt (np. images jako obiekty).
422LIMIT_EXCEEDEDLimit wpisów osiągnięty (np. 50 warunków danego rodzaju).
422NAME_HAS_TO_BE_UNIQUENazwa zajęta (details = id istniejącego wpisu).
422VALIDATION_ERRORZła wartość parametru zapytania (400) albo pola treści (422); path wskazuje miejsce.
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Rękojmia (implied-warranties)
curl -sS -X POST "${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/implied-warranties" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -H "Content-Type: application/vnd.allegro.public.v1+json" \
  --data-binary @- \
  -w '\nHTTP %{http_code}\n' <<'JSON'
{
  "name": "Rękojmia 2 lata",
  "individual": {
    "period": "P2Y"
  },
  "corporate": {
    "period": "P1Y"
  }
}
JSON
Odpowiedź (środowisko testowe)
HTTP 201 application/vnd.allegro.public.v1+json
{
  "id": "d82f8496-f284-4cdf-9575-242222870c5f",
  "name": "Rękojmia 2 lata",
  "individual": {
    "period": "P2Y"
  },
  "corporate": {
    "period": "P1Y"
  }
}
Przykład: Warunki reklamacji do usunięcia
curl -sS -X POST "${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/implied-warranties" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -H "Content-Type: application/vnd.allegro.public.v1+json" \
  --data-binary @- \
  -w '\nHTTP %{http_code}\n' <<'JSON'
{
  "name": "Rękojmia (stara)",
  "individual": {
    "period": "P2Y"
  },
  "corporate": {
    "period": "P1Y"
  }
}
JSON
HTTP 201 application/vnd.allegro.public.v1+json
{
  "id": "c3d63ea5-5893-4e48-a3e3-63cb41d238f3",
  "name": "Rękojmia (stara)",
  "individual": {
    "period": "P2Y"
  },
  "corporate": {
    "period": "P1Y"
  }
}

Warunki reklamacji (rękojmia)

GET /after-sales-service-conditions/implied-warranties/{impliedWarrantyId}

zgodna z Allegroallegro:api:sale:settings:readlimit: read

Pełny wpis warunków reklamacji. Cudzy → 403, brak (albo inny rodzaj) → 404.

Zgodność: zgodna z Allegro REST API (ten sam kształt) — GET /after-sales-service-conditions/implied-warranties/{id}.
Uprawnienie: zakres allegro:api:sale:settings:read.
Grupa limitu: read.

Parametry ścieżki

impliedWarrantyId string wymagany

Identyfikator (UUID).

Odpowiedzi

200 Wpis. · ImpliedWarranty
id string · uuid zawsze
name string zawsze
individual object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
corporate object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
address object

Adres (kształt Allegro).

Pola obiektu
name string
street string
postCode string
postalCode string
city string
countryCode string

Kod kraju ISO 3166-1 alfa-2.

phoneNumber string
email string · email
description string

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ę).
404NOT_FOUNDNie ma takiego zasobu (albo należy do innego sprzedawcy — dla wątków, zwrotów i spraw odpowiedź jest ta sama).
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}/after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f" \
  -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
{
  "id": "d82f8496-f284-4cdf-9575-242222870c5f",
  "name": "Rękojmia 2 lata",
  "individual": {
    "period": "P2Y"
  },
  "corporate": {
    "period": "P1Y"
  }
}

Warunki reklamacji (rękojmia) — zmiana

PUT /after-sales-service-conditions/implied-warranties/{impliedWarrantyId}

zgodna z Allegroallegro:api:sale:settings:writelimit: write

Pełna podmiana treści (biała lista pól Allegro dla rodzaju; nieznane pole → 422 UnknownJSONProperty). Oferty wskazujące ten wpis widzą nową treść.

Zgodność: zgodna z Allegro REST API (ten sam kształt) — PUT /after-sales-service-conditions/implied-warranties/{id}.
Uprawnienie: zakres allegro:api:sale:settings:write.
Grupa limitu: write.

Parametry ścieżki

impliedWarrantyId string wymagany

Identyfikator (UUID).

Treść żądania application/vnd.allegro.public.v1+json

name string wymagane

1–100 znaków, unikalna.

individual object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
corporate object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
address object

Adres (kształt Allegro).

Pola obiektu
name string
street string
postCode string
postalCode string
city string
countryCode string

Kod kraju ISO 3166-1 alfa-2.

phoneNumber string
email string · email
description string

Odpowiedzi

200 Zmieniono. · ImpliedWarranty
id string · uuid zawsze
name string zawsze
individual object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
corporate object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
address object

Adres (kształt Allegro).

Pola obiektu
name string
street string
postCode string
postalCode string
city string
countryCode string

Kod kraju ISO 3166-1 alfa-2.

phoneNumber string
email string · email
description string

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ę).
404NOT_FOUNDNie ma takiego zasobu (albo należy do innego sprzedawcy — dla wątków, zwrotów i spraw odpowiedź jest ta sama).
413PAYLOAD_TOO_LARGETreść żądania za duża (JSON 5 MB, faktura PDF 3 MB).
415UNSUPPORTED_MEDIA_TYPEZły Content-Type treści.
422JsonMappingExceptionTreść nie jest poprawnym JSON albo ma zły kształt (np. images jako obiekty).
422NAME_HAS_TO_BE_UNIQUENazwa zajęta (details = id istniejącego wpisu).
422UnknownJSONPropertyPole nieznane w tym miejscu (path wskazuje które).
422VALIDATION_ERRORZła wartość parametru zapytania (400) albo pola treści (422); path wskazuje miejsce.
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Przykład
curl -sS -X PUT "${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -H "Content-Type: application/vnd.allegro.public.v1+json" \
  --data-binary @- \
  -w '\nHTTP %{http_code}\n' <<'JSON'
{
  "name": "Rękojmia 2 lata",
  "individual": {
    "period": "P2Y"
  },
  "corporate": {
    "period": "P2Y"
  }
}
JSON
Odpowiedź (środowisko testowe)
HTTP 200 application/vnd.allegro.public.v1+json
{
  "id": "d82f8496-f284-4cdf-9575-242222870c5f",
  "name": "Rękojmia 2 lata",
  "individual": {
    "period": "P2Y"
  },
  "corporate": {
    "period": "P2Y"
  }
}

Warunki reklamacji (rękojmia) — usunięcie

DELETE /after-sales-service-conditions/implied-warranties/{impliedWarrantyId}

zgodna z Allegroallegro:api:sale:settings:writelimit: write

Usuwa wpis. Wpis wskazany w którejś ofercie → 409 IN_USE (najpierw odepnij go od ofert).

Zgodność: zgodna z Allegro REST API (ten sam kształt) — DELETE /after-sales-service-conditions/implied-warranties/{id}.
Uprawnienie: zakres allegro:api:sale:settings:write.
Grupa limitu: write.

Parametry ścieżki

impliedWarrantyId string wymagany

Identyfikator (UUID).

Odpowiedzi

204 Usunięto.

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ę).
404NOT_FOUNDNie ma takiego zasobu (albo należy do innego sprzedawcy — dla wątków, zwrotów i spraw odpowiedź jest ta sama).
409IN_USEWpis jest wskazany w ofercie.
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Przykład
curl -sS -X DELETE "${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/implied-warranties/c3d63ea5-5893-4e48-a3e3-63cb41d238f3" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -w '\nHTTP %{http_code}\n'
Odpowiedź (środowisko testowe)
HTTP 204 text/html; charset=UTF-8
(0 B: text/html; charset=UTF-8)

Gwarancja — lista

GET /after-sales-service-conditions/warranties

zgodna z Allegroallegro:api:sale:settings:readlimit: read

Twoje wpisy gwarancji (id i nazwa). Klucz listy: warranties.

Zgodność: zgodna z Allegro REST API (ten sam kształt) — GET /after-sales-service-conditions/warranties.
Uprawnienie: zakres allegro:api:sale:settings:read.
Grupa limitu: read.

Odpowiedzi

200 Lista. · WarrantyList
warranties array<object> zawsze
Pola obiektu
id string · uuid zawsze
name string zawsze
count integer 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}/after-sales-service-conditions/warranties" \
  -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
{
  "warranties": [
    {
      "id": "e0b5c0de-c9d1-4be5-a5be-595e95db67ad",
      "name": "Gwarancja demo"
    },
    {
      "id": "5be961ca-7c55-4d2a-9332-93d58877d4a2",
      "name": "Gwarancja producenta"
    }
  ],
  "count": 2
}

Gwarancja — nowe

POST /after-sales-service-conditions/warranties

zgodna z Allegroallegro:api:sale:settings:writelimit: write

name (1–100 znaków) i pola w kształcie Allegro z białej listy (np. okres P14D, kto pokrywa koszt zwrotu, adres) — wartości sprawdzamy, a pola spoza listy pomijamy.

201 — nowy wpis. 200 — ta sama name i identyczna treść (bezpieczne ponowienie). Ta sama name, inna treść → 422 NAME_HAS_TO_BE_UNIQUE (details = id istniejącego). Najwyżej 50 wpisów każdego rodzaju.

Zgodność: zgodna z Allegro REST API (ten sam kształt) — POST /after-sales-service-conditions/warranties.
Uprawnienie: zakres allegro:api:sale:settings:write.
Grupa limitu: write.

Nagłówki

Idempotency-Key string

Ochrona przed podwójnym wykonaniem (jak Stripe/Amazon): powtórzony POST z tym samym kluczem i tą samą treścią w ciągu 24 h zwraca zapisaną odpowiedź z nagłówkiem Idempotent-Replayed: true i niczego nie wykonuje drugi raz. Inna treść → 422 IDEMPOTENCY_KEY_REUSED; żądanie jeszcze trwa → 409 IDEMPOTENCY_KEY_IN_USE. 1–100 znaków ASCII (np. UUID).

Treść żądania application/vnd.allegro.public.v1+json

name string wymagane

1–100 znaków, unikalna.

type string
Wartości: MANUFACTURER, SELLER
individual object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
corporate object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
attachment object
Pola obiektu
name string
url string · uri

Adres https.

description string

Odpowiedzi

200 Identyczny wpis już był. · Warranty
id string · uuid zawsze
name string zawsze
type string
Wartości: MANUFACTURER, SELLER
individual object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
corporate object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
attachment object
Pola obiektu
name string
url string · uri

Adres https.

description string
201 Utworzono. · Warranty
id string · uuid zawsze
name string zawsze
type string
Wartości: MANUFACTURER, SELLER
individual object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
corporate object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
attachment object
Pola obiektu
name string
url string · uri

Adres https.

description string

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ę).
413PAYLOAD_TOO_LARGETreść żądania za duża (JSON 5 MB, faktura PDF 3 MB).
415UNSUPPORTED_MEDIA_TYPEZły Content-Type treści.
422JsonMappingExceptionTreść nie jest poprawnym JSON albo ma zły kształt (np. images jako obiekty).
422LIMIT_EXCEEDEDLimit wpisów osiągnięty (np. 50 warunków danego rodzaju).
422NAME_HAS_TO_BE_UNIQUENazwa zajęta (details = id istniejącego wpisu).
422VALIDATION_ERRORZła wartość parametru zapytania (400) albo pola treści (422); path wskazuje miejsce.
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Gwarancja (warranties)
curl -sS -X POST "${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/warranties" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -H "Content-Type: application/vnd.allegro.public.v1+json" \
  --data-binary @- \
  -w '\nHTTP %{http_code}\n' <<'JSON'
{
  "name": "Gwarancja producenta",
  "individual": {
    "period": "P2Y",
    "type": "MANUFACTURER"
  },
  "corporate": {
    "period": "P1Y",
    "type": "MANUFACTURER"
  }
}
JSON
Odpowiedź (środowisko testowe)
HTTP 201 application/vnd.allegro.public.v1+json
{
  "id": "5be961ca-7c55-4d2a-9332-93d58877d4a2",
  "name": "Gwarancja producenta",
  "individual": {
    "period": "P2Y",
    "type": "MANUFACTURER"
  },
  "corporate": {
    "period": "P1Y",
    "type": "MANUFACTURER"
  }
}
Przykład: Gwarancja do usunięcia
curl -sS -X POST "${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/warranties" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -H "Content-Type: application/vnd.allegro.public.v1+json" \
  --data-binary @- \
  -w '\nHTTP %{http_code}\n' <<'JSON'
{
  "name": "Gwarancja sprzedawcy (stara)",
  "individual": {
    "period": "P1Y",
    "type": "SELLER"
  }
}
JSON
HTTP 201 application/vnd.allegro.public.v1+json
{
  "id": "2ebf18a5-0d1e-4ece-a9e0-66861011ca83",
  "name": "Gwarancja sprzedawcy (stara)",
  "individual": {
    "period": "P1Y",
    "type": "SELLER"
  }
}

Gwarancja

GET /after-sales-service-conditions/warranties/{warrantyId}

zgodna z Allegroallegro:api:sale:settings:readlimit: read

Pełny wpis gwarancji. Cudzy → 403, brak (albo inny rodzaj) → 404.

Zgodność: zgodna z Allegro REST API (ten sam kształt) — GET /after-sales-service-conditions/warranties/{id}.
Uprawnienie: zakres allegro:api:sale:settings:read.
Grupa limitu: read.

Parametry ścieżki

warrantyId string wymagany

Identyfikator (UUID).

Odpowiedzi

200 Wpis. · Warranty
id string · uuid zawsze
name string zawsze
type string
Wartości: MANUFACTURER, SELLER
individual object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
corporate object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
attachment object
Pola obiektu
name string
url string · uri

Adres https.

description string

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ę).
404NOT_FOUNDNie ma takiego zasobu (albo należy do innego sprzedawcy — dla wątków, zwrotów i spraw odpowiedź jest ta sama).
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}/after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2" \
  -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
{
  "id": "5be961ca-7c55-4d2a-9332-93d58877d4a2",
  "name": "Gwarancja producenta",
  "individual": {
    "period": "P2Y",
    "type": "MANUFACTURER"
  },
  "corporate": {
    "period": "P1Y",
    "type": "MANUFACTURER"
  }
}

Gwarancja — zmiana

PUT /after-sales-service-conditions/warranties/{warrantyId}

zgodna z Allegroallegro:api:sale:settings:writelimit: write

Pełna podmiana treści (biała lista pól Allegro dla rodzaju; nieznane pole → 422 UnknownJSONProperty). Oferty wskazujące ten wpis widzą nową treść.

Zgodność: zgodna z Allegro REST API (ten sam kształt) — PUT /after-sales-service-conditions/warranties/{id}.
Uprawnienie: zakres allegro:api:sale:settings:write.
Grupa limitu: write.

Parametry ścieżki

warrantyId string wymagany

Identyfikator (UUID).

Treść żądania application/vnd.allegro.public.v1+json

name string wymagane

1–100 znaków, unikalna.

type string
Wartości: MANUFACTURER, SELLER
individual object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
corporate object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
attachment object
Pola obiektu
name string
url string · uri

Adres https.

description string

Odpowiedzi

200 Zmieniono. · Warranty
id string · uuid zawsze
name string zawsze
type string
Wartości: MANUFACTURER, SELLER
individual object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
corporate object
Pola obiektu
period string

Okres ISO 8601, np. P14D, P1Y, P2Y.

lifetime boolean

Dożywotnio.

type string
Wartości: MANUFACTURER, SELLER
attachment object
Pola obiektu
name string
url string · uri

Adres https.

description string

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ę).
404NOT_FOUNDNie ma takiego zasobu (albo należy do innego sprzedawcy — dla wątków, zwrotów i spraw odpowiedź jest ta sama).
413PAYLOAD_TOO_LARGETreść żądania za duża (JSON 5 MB, faktura PDF 3 MB).
415UNSUPPORTED_MEDIA_TYPEZły Content-Type treści.
422JsonMappingExceptionTreść nie jest poprawnym JSON albo ma zły kształt (np. images jako obiekty).
422NAME_HAS_TO_BE_UNIQUENazwa zajęta (details = id istniejącego wpisu).
422UnknownJSONPropertyPole nieznane w tym miejscu (path wskazuje które).
422VALIDATION_ERRORZła wartość parametru zapytania (400) albo pola treści (422); path wskazuje miejsce.
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Przykład
curl -sS -X PUT "${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -H "Content-Type: application/vnd.allegro.public.v1+json" \
  --data-binary @- \
  -w '\nHTTP %{http_code}\n' <<'JSON'
{
  "name": "Gwarancja producenta",
  "individual": {
    "period": "P3Y",
    "type": "MANUFACTURER"
  },
  "corporate": {
    "period": "P1Y",
    "type": "MANUFACTURER"
  }
}
JSON
Odpowiedź (środowisko testowe)
HTTP 200 application/vnd.allegro.public.v1+json
{
  "id": "5be961ca-7c55-4d2a-9332-93d58877d4a2",
  "name": "Gwarancja producenta",
  "individual": {
    "period": "P3Y",
    "type": "MANUFACTURER"
  },
  "corporate": {
    "period": "P1Y",
    "type": "MANUFACTURER"
  }
}

Gwarancja — usunięcie

DELETE /after-sales-service-conditions/warranties/{warrantyId}

zgodna z Allegroallegro:api:sale:settings:writelimit: write

Usuwa wpis. Wpis wskazany w którejś ofercie → 409 IN_USE (najpierw odepnij go od ofert).

Zgodność: zgodna z Allegro REST API (ten sam kształt) — DELETE /after-sales-service-conditions/warranties/{id}.
Uprawnienie: zakres allegro:api:sale:settings:write.
Grupa limitu: write.

Parametry ścieżki

warrantyId string wymagany

Identyfikator (UUID).

Odpowiedzi

204 Usunięto.

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ę).
404NOT_FOUNDNie ma takiego zasobu (albo należy do innego sprzedawcy — dla wątków, zwrotów i spraw odpowiedź jest ta sama).
409IN_USEWpis jest wskazany w ofercie.
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Przykład
curl -sS -X DELETE "${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/warranties/2ebf18a5-0d1e-4ece-a9e0-66861011ca83" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -w '\nHTTP %{http_code}\n'
Odpowiedź (środowisko testowe)
HTTP 204 text/html; charset=UTF-8
(0 B: text/html; charset=UTF-8)