Przejdź do treści

Miejsce wgrania dokumentu wsadu

POST /allee/feeds/documents

wzór Amazon SP-APIallegro:api:sale:offers:writelimit: bulk

Dla wsadów większych niż chcesz wysłać w treści żądania: podpisany adres PUT (5 min, do 10 MB) — wgraj dokument JSON wprost do magazynu, potem POST /allee/feeds z inputFeedDocumentId. W sandboxie → 403 SANDBOX_UNSUPPORTED (wysyłaj content).

Zgodność: wzorowana na Amazon Selling Partner API — Feeds — createFeedDocument.
Uprawnienie: zakres allegro:api:sale:offers:write.
Grupa limitu: bulk.

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

contentType string wymagane
Wartości: application/json

Odpowiedzi

201 Miejsce wgrania. · FeedDocumentUpload
feedDocumentId string · uuid zawsze
method string zawsze
Wartości: PUT
url string · uri zawsze
headers object zawsze
expiresAt string · date-time zawsze
maxBytes 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ę).
403SANDBOX_UNSUPPORTEDOperacja niedostępna w sandboxie (pliki trafiałyby do magazynu produkcyjnego).
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).
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.
503NOT_DEPLOYEDFunkcja jeszcze nie uruchomiona (np. sandbox, wsady).
503STORAGE_UNAVAILABLEMagazyn plików chwilowo niedostępny.
Miejsce wgrania dużego wsadu (klucz produkcyjny — w sandboxie 403 SANDBOX_UNSUPPORTED)
curl -sS -X POST "${ALLEE_API_URL:-https://api.allee.pl}/allee/feeds/documents" \
  -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'
{
  "contentType": "application/json"
}
JSON
Odpowiedź (środowisko testowe)
HTTP 201 application/vnd.allegro.public.v1+json
{
  "feedDocumentId": "aac1646a-866c-4baa-9f1c-b9cbbf6f8d35",
  "method": "PUT",
  "url": "https://0e31a0c8a001f9f8df521110ca4f3f6e.r2.cloudflarestorage.com/allee/api-feeds/980000001/aac1646a-866c-4baa-9f1c-b9cbbf6f8d35.json?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=0136e1e8b4bd3d8e11870c33177d2879%2F20261110%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20261110T111005Z&X-Amz-Expires=300&X-Amz-SignedHeaders=content-type%3Bhost&X-Amz-Signature=…",
  "headers": {
    "Content-Type": "application/json"
  },
  "expiresAt": "2026-11-10T11:15:05.000Z",
  "maxBytes": 10485760
}

Nowy wsad ofert (JSON_LISTINGS_FEED)

POST /allee/feeds

wzór Amazon SP-APIallegro:api:sale:offers:writelimit: bulk

Do 10 000 komunikatów (UPDATE, PARTIAL_UPDATE, PATCH, DELETE) przetwarzanych w tle w kolejności messageId. Odpowiedź 202 od razu; koniec poznasz z GET /allee/feeds/{feedId} albo powiadomienia FEED_PROCESSING_FINISHED, wynik każdego komunikatu — z …/result.

Źródło (dokładnie jedno): content (dokument inline), messages (sama lista) albo inputFeedDocumentId. Najwyżej 2 wsady sprzedawcy w toku (429 TOO_MANY_CONCURRENT). Gdy kolejka nie działa, wsad do 500 komunikatów przetwarzamy od razu (202 z DONE).

Zgodność: wzorowana na Amazon Selling Partner API — Feeds — createFeed (JSON_LISTINGS_FEED).
Uprawnienie: zakres allegro:api:sale:offers:write.
Grupa limitu: bulk.

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

feedType string wymagane
Wartości: JSON_LISTINGS_FEED
content FeedDocument

Dokument wsadu JSON_LISTINGS_FEED.

Pola obiektu
header object
Pola obiektu
sellerId string
version string
Wartości: 2.0
messages array<FeedMessage> wymagane

Do 10 000 komunikatów.

Pola obiektu
messageId integer wymagane

Numer komunikatu w wsadzie (unikalny).

sku string

SKU oferty.

offerId string

Albo id oferty.

operationType string wymagane

UPDATE = utwórz/zastąp (jak PUT), PARTIAL_UPDATE = zmień podane atrybuty, PATCH = JSON Patch, DELETE = usuń szkic / zakończ.

Wartości: UPDATE, PARTIAL_UPDATE, PATCH, DELETE
requirements string
Wartości: LISTING, LISTING_OFFER_ONLY
status string
Wartości: ACTIVE, INACTIVE
attributes ListingAttributes

Atrybuty listingu (płaskie, nazwy jak w schemacie kategorii GET /allee/categories/{id}/schema).

Pola obiektu
name string

Tytuł (10–75 znaków).

category object

Kategoria (alleeId ma pierwszeństwo).

Pola obiektu
alleeId integer
id string
parameters object

Parametry: klucz = id parametru Allegro (patrz schemat kategorii).

images array<string · uri>

1–16 adresów.

description string

Opis (tekst, 20–20 000 znaków).

price MoneyInput

Kwota w żądaniu.

Pola obiektu
amount string|number wymagane

Kwota jako tekst „123.45” (zalecane) albo liczba.

currency string

Waluta: tylko PLN (domyślnie PLN).

Wartości: PLN
stock integer

Sztuki (0–99 999).

ean string

GTIN (EAN).

shippingRatesId string · uuid

Twój cennik.

handlingTime string

PT0S, PT24H, P2D…P60D.

returnPolicyId string · null
warrantyId string · null
impliedWarrantyId string · null
responsibleProducerId string · null
responsiblePersonId string · null
safetyInformation SafetyInformation · null
Pola obiektu
type string wymagane
Wartości: TEXT, NO_SAFETY_INFORMATION, ATTACHMENTS
description string

Treść informacji (dla TEXT).

taxRate string · null
Wartości: 0.00, 5.00, 8.00, 23.00, null
invoice string · null
Wartości: VAT, VAT_MARGIN, WITHOUT_VAT, NO_INVOICE, null
location object · null
patches array<object>
messages array<FeedMessage>

Albo sama lista komunikatów.

Pola obiektu
messageId integer wymagane

Numer komunikatu w wsadzie (unikalny).

sku string

SKU oferty.

offerId string

Albo id oferty.

operationType string wymagane

UPDATE = utwórz/zastąp (jak PUT), PARTIAL_UPDATE = zmień podane atrybuty, PATCH = JSON Patch, DELETE = usuń szkic / zakończ.

Wartości: UPDATE, PARTIAL_UPDATE, PATCH, DELETE
requirements string
Wartości: LISTING, LISTING_OFFER_ONLY
status string
Wartości: ACTIVE, INACTIVE
attributes ListingAttributes

Atrybuty listingu (płaskie, nazwy jak w schemacie kategorii GET /allee/categories/{id}/schema).

Pola obiektu
name string

Tytuł (10–75 znaków).

category object

Kategoria (alleeId ma pierwszeństwo).

Pola obiektu
alleeId integer
id string
parameters object

Parametry: klucz = id parametru Allegro (patrz schemat kategorii).

images array<string · uri>

1–16 adresów.

description string

Opis (tekst, 20–20 000 znaków).

price MoneyInput

Kwota w żądaniu.

Pola obiektu
amount string|number wymagane

Kwota jako tekst „123.45” (zalecane) albo liczba.

currency string

Waluta: tylko PLN (domyślnie PLN).

Wartości: PLN
stock integer

Sztuki (0–99 999).

ean string

GTIN (EAN).

shippingRatesId string · uuid

Twój cennik.

handlingTime string

PT0S, PT24H, P2D…P60D.

returnPolicyId string · null
warrantyId string · null
impliedWarrantyId string · null
responsibleProducerId string · null
responsiblePersonId string · null
safetyInformation SafetyInformation · null
Pola obiektu
type string wymagane
Wartości: TEXT, NO_SAFETY_INFORMATION, ATTACHMENTS
description string

Treść informacji (dla TEXT).

taxRate string · null
Wartości: 0.00, 5.00, 8.00, 23.00, null
invoice string · null
Wartości: VAT, VAT_MARGIN, WITHOUT_VAT, NO_INVOICE, null
location object · null
patches array<object>
header object

Nagłówek przy podaniu messages.

inputFeedDocumentId string · uuid

Albo dokument wgrany przez POST /allee/feeds/documents.

uploadId string

Alias inputFeedDocumentId.

marketplaceIds array<string>
feedOptions object

Odpowiedzi

202 Przyjęto do przetwarzania. · Feed
feedId string · uuid zawsze
feedType string zawsze
Wartości: JSON_LISTINGS_FEED
marketplaceIds array<string> zawsze
createdTime string · date-time zawsze
processingStatus string zawsze
Wartości: IN_QUEUE, IN_PROGRESS, DONE, CANCELLED, FATAL
processingStartTime string · date-time · null zawsze
processingEndTime string · date-time · null zawsze
resultFeedDocumentId string · null zawsze

Gdy DONE: wynik pod GET /allee/feeds/{feedId}/result.

allee object zawsze
Pola obiektu
source string zawsze

Skąd wsad: treść żądania, dokument, polecenie wsadowe Allegro.

Wartości: INLINE, DOKUMENT, POLECENIE
messages object zawsze
Pola obiektu
total integer zawsze
processed integer zawsze
accepted integer zawsze
invalid integer zawsze
withWarnings integer zawsze
fatalError string · null zawsze

Powód przerwania całego wsadu (FATAL).

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.
422FEED_DOCUMENT_NOT_FOUNDNie ma takiego dokumentu wsadu.
422INVALID_FEED_DOCUMENTDokument wsadu ma zły kształt.
422JsonMappingExceptionTreść nie jest poprawnym JSON albo ma zły kształt (np. images jako obiekty).
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_CONCURRENTZa dużo ciężkich operacji naraz (wsady, raporty, duże polecenia).
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
503NOT_DEPLOYEDFunkcja jeszcze nie uruchomiona (np. sandbox, wsady).
503QUEUE_UNAVAILABLEKolejka wsadów chwilowo nie działa.
Przykład
curl -sS -X POST "${ALLEE_API_URL:-https://api.allee.pl}/allee/feeds" \
  -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'
{
  "feedType": "JSON_LISTINGS_FEED",
  "content": {
    "header": {
      "sellerId": 980000001,
      "version": "2.0"
    },
    "messages": [
      {
        "messageId": 1,
        "sku": "FILM-21ef85-5",
        "operationType": "UPDATE",
        "requirements": "LISTING",
        "attributes": {
          "name": "Gabinet doktora Caligari DVD",
          "category": {
            "alleeId": 35
          },
          "parameters": {
            "225693": {
              "values": [
                "5901234123464"
              ]
            },
            "237218": {
              "values": [
                "Metropolis"
              ]
            },
            "246845": {
              "valuesIds": [
                "246845_622165"
              ]
            },
            "250077": {
              "valuesIds": [
                "250077_1797493"
              ]
            },
            "11323": {
              "valuesIds": [
                "11323_1"
              ]
            }
          },
          "price": {
            "amount": "45.00",
            "currency": "PLN"
          },
          "stock": 3,
          "images": [
            "https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp"
          ],
          "description": "Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.",
          "shippingRatesId": "797d2e65-cb23-4a16-98e9-d6f2a399839a",
          "responsibleProducerId": "472bad66-e704-4344-a2d6-9bd85b1f9a5e",
          "safetyInformation": {
            "type": "TEXT",
            "description": "Produkt bezpieczny w normalnym użytkowaniu."
          }
        }
      },
      {
        "messageId": 2,
        "sku": "FILM-21ef85-6",
        "operationType": "UPDATE",
        "requirements": "LISTING",
        "attributes": {
          "name": "Nosferatu DVD wydanie specjalne",
          "category": {
            "alleeId": 35
          },
          "parameters": {
            "225693": {
              "values": [
                "5901234123464"
              ]
            },
            "237218": {
              "values": [
                "Metropolis"
              ]
            },
            "246845": {
              "valuesIds": [
                "246845_622165"
              ]
            },
            "250077": {
              "valuesIds": [
                "250077_1797493"
              ]
            },
            "11323": {
              "valuesIds": [
                "11323_1"
              ]
            }
          },
          "price": {
            "amount": "39.90",
            "currency": "PLN"
          },
          "stock": 5,
          "images": [
            "https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp"
          ],
          "description": "Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.",
          "shippingRatesId": "797d2e65-cb23-4a16-98e9-d6f2a399839a",
          "responsibleProducerId": "472bad66-e704-4344-a2d6-9bd85b1f9a5e",
          "safetyInformation": {
            "type": "TEXT",
            "description": "Produkt bezpieczny w normalnym użytkowaniu."
          }
        }
      },
      {
        "messageId": 3,
        "sku": "FILM-21ef85-5",
        "operationType": "PARTIAL_UPDATE",
        "attributes": {
          "price": {
            "amount": "41.90",
            "currency": "PLN"
          },
          "stock": 15
        }
      }
    ]
  }
}
JSON
Odpowiedź (środowisko testowe)
HTTP 202 application/vnd.allegro.public.v1+json
{
  "feedId": "8abb06e8-6e07-4bbb-b0d7-7fda5882df49",
  "feedType": "JSON_LISTINGS_FEED",
  "marketplaceIds": [
    "allee-pl"
  ],
  "createdTime": "2026-11-10T11:10:04.563Z",
  "processingStatus": "IN_QUEUE",
  "processingStartTime": null,
  "processingEndTime": null,
  "resultFeedDocumentId": null,
  "allee": {
    "source": "INLINE",
    "messages": {
      "total": 3,
      "processed": 0,
      "accepted": 0,
      "invalid": 0,
      "withWarnings": 0
    },
    "fatalError": null
  }
}
Przykład: Wsad z samą listą komunikatów (messages)
curl -sS -X POST "${ALLEE_API_URL:-https://api.allee.pl}/allee/feeds" \
  -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'
{
  "feedType": "JSON_LISTINGS_FEED",
  "messages": [
    {
      "messageId": 1,
      "sku": "FILM-21ef85-6",
      "operationType": "DELETE"
    }
  ]
}
JSON
HTTP 202 application/vnd.allegro.public.v1+json
{
  "feedId": "9be12e3a-f19a-4295-8542-b7392a657fcd",
  "feedType": "JSON_LISTINGS_FEED",
  "marketplaceIds": [
    "allee-pl"
  ],
  "createdTime": "2026-11-10T11:10:04.568Z",
  "processingStatus": "IN_QUEUE",
  "processingStartTime": null,
  "processingEndTime": null,
  "resultFeedDocumentId": null,
  "allee": {
    "source": "INLINE",
    "messages": {
      "total": 1,
      "processed": 0,
      "accepted": 0,
      "invalid": 0,
      "withWarnings": 0
    },
    "fatalError": null
  }
}

Lista wsadów

GET /allee/feeds

wzór Amazon SP-APIallegro:api:sale:offers:readlimit: read

Wsady tej aplikacji (klucza) u sprzedawcy, najnowsze pierwsze.

Zgodność: wzorowana na Amazon Selling Partner API — Feeds — getFeeds.
Uprawnienie: zakres allegro:api:sale:offers:read.
Grupa limitu: read.

Parametry zapytania

processingStatuses string

Statusy rozdzielone przecinkiem: IN_QUEUE, IN_PROGRESS, DONE, CANCELLED, FATAL.

pageSize integer

1–100.

nextToken string

Token następnej strony.

Odpowiedzi

200 Wsady. · FeedList
feeds array<Feed> zawsze
Pola obiektu
feedId string · uuid zawsze
feedType string zawsze
Wartości: JSON_LISTINGS_FEED
marketplaceIds array<string> zawsze
createdTime string · date-time zawsze
processingStatus string zawsze
Wartości: IN_QUEUE, IN_PROGRESS, DONE, CANCELLED, FATAL
processingStartTime string · date-time · null zawsze
processingEndTime string · date-time · null zawsze
resultFeedDocumentId string · null zawsze

Gdy DONE: wynik pod GET /allee/feeds/{feedId}/result.

allee object zawsze
Pola obiektu
source string zawsze

Skąd wsad: treść żądania, dokument, polecenie wsadowe Allegro.

Wartości: INLINE, DOKUMENT, POLECENIE
messages object zawsze
Pola obiektu
total integer zawsze
processed integer zawsze
accepted integer zawsze
invalid integer zawsze
withWarnings integer zawsze
fatalError string · null zawsze

Powód przerwania całego wsadu (FATAL).

nextToken string · null 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.
503NOT_DEPLOYEDFunkcja jeszcze nie uruchomiona (np. sandbox, wsady).
Przykład
curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/allee/feeds?processingStatuses=DONE%2CCANCELLED&pageSize=10" \
  -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
{
  "feeds": [
    {
      "feedId": "9be12e3a-f19a-4295-8542-b7392a657fcd",
      "feedType": "JSON_LISTINGS_FEED",
      "marketplaceIds": [
        "allee-pl"
      ],
      "createdTime": "2026-11-10T11:10:04.568Z",
      "processingStatus": "CANCELLED",
      "processingStartTime": null,
      "processingEndTime": "2026-11-10T11:10:04.570Z",
      "resultFeedDocumentId": null,
      "allee": {
        "source": "INLINE",
        "messages": {
          "total": 1,
          "processed": 0,
          "accepted": 0,
          "invalid": 0,
          "withWarnings": 0
        },
        "fatalError": null
      }
    },
    {
      "feedId": "8abb06e8-6e07-4bbb-b0d7-7fda5882df49",
      "feedType": "JSON_LISTINGS_FEED",
      "marketplaceIds": [
        "allee-pl"
      ],
      "createdTime": "2026-11-10T11:10:04.563Z",
      "processingStatus": "DONE",
      "processingStartTime": "2026-11-10T11:10:04.617Z",
      "processingEndTime": "2026-11-10T11:10:04.709Z",
      "resultFeedDocumentId": "8abb06e8-6e07-4bbb-b0d7-7fda5882df49",
      "allee": {
        "source": "INLINE",
        "messages": {
          "total": 3,
          "processed": 3,
          "accepted": 3,
          "invalid": 0,
          "withWarnings": 0
        },
        "fatalError": null
      }
    }
  ],
  "nextToken": null
}

Wsad

GET /allee/feeds/{feedId}

wzór Amazon SP-APIallegro:api:sale:offers:readlimit: read

Stan i liczniki wsadu.

Zgodność: wzorowana na Amazon Selling Partner API — Feeds — getFeed.
Uprawnienie: zakres allegro:api:sale:offers:read.
Grupa limitu: read.

Parametry ścieżki

feedId string · uuid wymagany

Identyfikator wsadu.

Odpowiedzi

200 Wsad. · Feed
feedId string · uuid zawsze
feedType string zawsze
Wartości: JSON_LISTINGS_FEED
marketplaceIds array<string> zawsze
createdTime string · date-time zawsze
processingStatus string zawsze
Wartości: IN_QUEUE, IN_PROGRESS, DONE, CANCELLED, FATAL
processingStartTime string · date-time · null zawsze
processingEndTime string · date-time · null zawsze
resultFeedDocumentId string · null zawsze

Gdy DONE: wynik pod GET /allee/feeds/{feedId}/result.

allee object zawsze
Pola obiektu
source string zawsze

Skąd wsad: treść żądania, dokument, polecenie wsadowe Allegro.

Wartości: INLINE, DOKUMENT, POLECENIE
messages object zawsze
Pola obiektu
total integer zawsze
processed integer zawsze
accepted integer zawsze
invalid integer zawsze
withWarnings integer zawsze
fatalError string · null zawsze

Powód przerwania całego wsadu (FATAL).

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.
503NOT_DEPLOYEDFunkcja jeszcze nie uruchomiona (np. sandbox, wsady).
Przykład
curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49" \
  -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
{
  "feedId": "8abb06e8-6e07-4bbb-b0d7-7fda5882df49",
  "feedType": "JSON_LISTINGS_FEED",
  "marketplaceIds": [
    "allee-pl"
  ],
  "createdTime": "2026-11-10T11:10:04.563Z",
  "processingStatus": "IN_QUEUE",
  "processingStartTime": null,
  "processingEndTime": null,
  "resultFeedDocumentId": null,
  "allee": {
    "source": "INLINE",
    "messages": {
      "total": 3,
      "processed": 0,
      "accepted": 0,
      "invalid": 0,
      "withWarnings": 0
    },
    "fatalError": null
  }
}

Anulowanie wsadu

DELETE /allee/feeds/{feedId}

wzór Amazon SP-APIallegro:api:sale:offers:writelimit: write

Tylko wsad w kolejce (IN_QUEUE); inaczej 409 FEED_NOT_CANCELLABLE z bieżącym statusem w details.

Zgodność: wzorowana na Amazon Selling Partner API — Feeds — cancelFeed.
Uprawnienie: zakres allegro:api:sale:offers:write.
Grupa limitu: write.

Parametry ścieżki

feedId string · uuid wymagany

Identyfikator wsadu.

Odpowiedzi

200 Anulowano. · Feed
feedId string · uuid zawsze
feedType string zawsze
Wartości: JSON_LISTINGS_FEED
marketplaceIds array<string> zawsze
createdTime string · date-time zawsze
processingStatus string zawsze
Wartości: IN_QUEUE, IN_PROGRESS, DONE, CANCELLED, FATAL
processingStartTime string · date-time · null zawsze
processingEndTime string · date-time · null zawsze
resultFeedDocumentId string · null zawsze

Gdy DONE: wynik pod GET /allee/feeds/{feedId}/result.

allee object zawsze
Pola obiektu
source string zawsze

Skąd wsad: treść żądania, dokument, polecenie wsadowe Allegro.

Wartości: INLINE, DOKUMENT, POLECENIE
messages object zawsze
Pola obiektu
total integer zawsze
processed integer zawsze
accepted integer zawsze
invalid integer zawsze
withWarnings integer zawsze
fatalError string · null zawsze

Powód przerwania całego wsadu (FATAL).

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).
409FEED_NOT_CANCELLABLEWsad nie jest już w kolejce.
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
503NOT_DEPLOYEDFunkcja jeszcze nie uruchomiona (np. sandbox, wsady).
Przykład
curl -sS -X DELETE "${ALLEE_API_URL:-https://api.allee.pl}/allee/feeds/9be12e3a-f19a-4295-8542-b7392a657fcd" \
  -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
{
  "feedId": "9be12e3a-f19a-4295-8542-b7392a657fcd",
  "feedType": "JSON_LISTINGS_FEED",
  "marketplaceIds": [
    "allee-pl"
  ],
  "createdTime": "2026-11-10T11:10:04.568Z",
  "processingStatus": "CANCELLED",
  "processingStartTime": null,
  "processingEndTime": "2026-11-10T11:10:04.570Z",
  "resultFeedDocumentId": null,
  "allee": {
    "source": "INLINE",
    "messages": {
      "total": 1,
      "processed": 0,
      "accepted": 0,
      "invalid": 0,
      "withWarnings": 0
    },
    "fatalError": null
  }
}

Raport przetwarzania wsadu

GET /allee/feeds/{feedId}/result

wzór Amazon SP-APIallegro:api:sale:offers:readlimit: read

Po DONE/FATAL: podsumowanie, problemy z numerem komunikatu i wynik każdego komunikatu (oferta, zmiana, issues). Wcześniej → 409 FEED_NOT_FINISHED.

Zgodność: wzorowana na Amazon Selling Partner API — Feeds — processing report (JSON).
Uprawnienie: zakres allegro:api:sale:offers:read.
Grupa limitu: read.

Parametry ścieżki

feedId string · uuid wymagany

Identyfikator wsadu.

Odpowiedzi

200 Raport. · FeedResult
header object zawsze
Pola obiektu
sellerId string zawsze
feedId string zawsze
version string zawsze
issues array<ListingIssue> zawsze
Pola obiektu
code string zawsze

Kod problemu (ten sam słownik co błędy walidacji oferty).

message string zawsze
severity string zawsze

ERROR blokuje zapis/publikację, WARNING nie blokuje.

Wartości: ERROR, WARNING, INFO
attributeNames array<string> zawsze

Atrybuty, których dotyczy problem.

categories array<string> zawsze

Grupy problemu, np. MISSING_ATTRIBUTE, INVALID_ATTRIBUTE, GPSR.

path string · null

Pole w kształcie Allegro (np. productSet[0].product.parameters).

messageId integer

Numer komunikatu wsadu (tylko w raporcie wsadu).

summary object zawsze
Pola obiektu
errors integer zawsze
warnings integer zawsze
messagesProcessed integer zawsze
messagesAccepted integer zawsze
messagesInvalid integer zawsze
allee object zawsze
Pola obiektu
processingStatus string zawsze
Wartości: DONE, FATAL
fatalError string · null zawsze
results array<object> zawsze

Wynik każdego komunikatu.

Pola obiektu
messageId integer zawsze
sku string · null zawsze
offerId string · null zawsze
status string zawsze
Wartości: ACCEPTED, INVALID
change string · null zawsze
Wartości: CREATED, UPDATED, UNCHANGED, DELETED, ENDED, null
issues array<ListingIssue> zawsze
Pola obiektu
code string zawsze

Kod problemu (ten sam słownik co błędy walidacji oferty).

message string zawsze
severity string zawsze

ERROR blokuje zapis/publikację, WARNING nie blokuje.

Wartości: ERROR, WARNING, INFO
attributeNames array<string> zawsze

Atrybuty, których dotyczy problem.

categories array<string> zawsze

Grupy problemu, np. MISSING_ATTRIBUTE, INVALID_ATTRIBUTE, GPSR.

path string · null

Pole w kształcie Allegro (np. productSet[0].product.parameters).

messageId integer

Numer komunikatu wsadu (tylko w raporcie wsadu).

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).
409FEED_NOT_FINISHEDWsad jeszcze trwa.
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
503NOT_DEPLOYEDFunkcja jeszcze nie uruchomiona (np. sandbox, wsady).
Przykład
curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49/result" \
  -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
{
  "header": {
    "sellerId": "980000001",
    "feedId": "8abb06e8-6e07-4bbb-b0d7-7fda5882df49",
    "version": "2.0"
  },
  "issues": [],
  "summary": {
    "errors": 0,
    "warnings": 0,
    "messagesProcessed": 3,
    "messagesAccepted": 3,
    "messagesInvalid": 0
  },
  "allee": {
    "processingStatus": "DONE",
    "fatalError": null,
    "results": [
      {
        "messageId": 1,
        "sku": "FILM-21ef85-5",
        "offerId": "900000000000026",
        "status": "ACCEPTED",
        "change": "CREATED",
        "issues": []
      },
      {
        "messageId": 2,
        "sku": "FILM-21ef85-6",
        "offerId": "900000000000027",
        "status": "ACCEPTED",
        "change": "CREATED",
        "issues": []
      },
      {
        "messageId": 3,
        "sku": "FILM-21ef85-5",
        "offerId": "900000000000026",
        "status": "ACCEPTED",
        "change": "UPDATED",
        "issues": []
      }
    ]
  }
}