Przejdź do treści

Wsady i raporty

Wsad ofert

Do 10 000 komunikatów: UPDATE (utwórz/zastąp jak PUT po SKU), PARTIAL_UPDATE (np. cena i stan), PATCH, DELETE. Odpowiedź 202 od razu, przetwarzanie w tle po kolei (messageId).

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

Stan: GET /allee/feeds/{feedId} albo powiadomienie FEED_PROCESSING_FINISHED. Wynik każdego komunikatu:

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'

Duży wsad: najpierw POST /allee/feeds/documents (podpisany adres PUT, do 10 MB), wgraj dokument, potem POST /allee/feeds z inputFeedDocumentId. Tylko ceny i stany w kształcie zbliżonym do Allegro: POST /sale/offer-bulk-modification-commands.

Raporty

Typy: OFFERS_ALL, OFFERS_ISSUES, ORDERS_BY_DATE, RETURNS, BILLING_ENTRIES, API_USAGE; CSV albo JSON, gzip, okres do 92 dni, dokument przechowywany 7 dni.

curl -sS -X POST "${ALLEE_API_URL:-https://api.allee.pl}/allee/reports" \
  -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'
{
  "reportType": "OFFERS_ALL",
  "reportOptions": {
    "format": "CSV"
  }
}
JSON
curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492/document" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -w '\nHTTP %{http_code}\n'

Adres z odpowiedzi jest podpisany i ważny 5 minut — pobierz go bez tokenu:

curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/allee/report-documents/a6c80abf-5393-43af-b634-b9ec56eae431/file?expires=1794309305&mode=test&signature=…" \
  -H "Accept: application/gzip" \
  -o raport.csv.gz -w 'HTTP %{http_code}\n'