Punkty odbioru osobistego

14 sierpnia 2017

Udostępniliśmy naszym sprzedającym punkty odbioru osobistego. Użytkownik może ustawić listę takich punktów. Wyświetlimy je w sekcji Dostawa i płatność we wszystkich jego ofertach z odbiorem osobistym.

Dla punktów odbioru przygotowaliśmy poniższe zasoby w REST API Allegro:

POST /points-of-service - chcę utworzyć punkt odbioru
1. PUT /points-of-service/{Point_of_service_ID} - chcę zmienić punkt odbioru
2. GET /points-of-service?seller.id={Seller_ID} - chcę pobrać punkty odbioru danego sprzedawcy
3. GET /points-of-service/{Point_of_service_ID} - chcę pobrać dany punkt odbioru
4. DELETE /points-of-service/{Point_of_service_ID} - chcę usunąć punkt odbioru

POST /points-of-service

To zasób, którym dodasz punkt odbioru, jako zalogowany sprzedawca. Identyfikator zalogowanego sprzedawcy wykorzystaj w treści wywołania.

curl -X POST \
  https://api.allegro.pl/points-of-service \
  -H 'accept: application/vnd.allegro.public.v1+json' \
  -H 'content-type: application/vnd.allegro.public.v1+json' \
  -H 'authorization: Bearer {token}’ \
  -d '{
  "externalId": "POS01",         -- niewymagane, Twoje wewnętrzne oznaczenie tego punktu odbioru
  "name": "Test",                -- wymagane, nazwa punktu, którą wyświetlamy w ofercie
  "seller": {
    "id": "{seller_ID}"          -- wymagane, identyfikator sprzedawcy
  },
  "type": "PICKUP_POINT",        -- wymagane, typ punktu, obecnie tylko  PICKUP_POINT
  "address": {
    "street": "Grunwaldzka 182", -- niewymagane, dokładny adres
    "city": "Poznań",            -- wymagane, miasto
    "zipCode": "60-166",         -- wymagane, kod pocztowy
    "state": "wielkopolskie",    -- wymagane, województwo
    "countryCode": "PL",         -- wymagane, kraj
    "coordinates": {             -- niewymagane, współrzędne geograficzne punktu, 
                                    np z: https://www.wspolrzedne-gps.pl/
      "lat": 52.4064,
      "lon": 16.9252
    }
  },
  "phoneNumber": "+48123456789", -- niewymagane, nr telefonu do danego punktu
  "email": "abc@email.com",      -- niewymagane, adres email do danego punktu
  "openHours": [                 -- niewymagane, godziny otwarcia. Jeśli punkt jest 
                                    nieczynny w dany dzień, nie przesyłaj go 
                                    (w przykładzie nie ma soboty i niedzieli).
    {
      "dayOfWeek": "MONDAY",
      "from": "09:00:00.000",
      "to": "17:00:00.000"
    },
    {
      "dayOfWeek": "TUESDAY",
      "from": "09:00:00.000",
      "to": "17:00:00.000"
    },
    {
      "dayOfWeek": "WEDNESDAY",
      "from": "09:00:00.000",
      "to": "17:00:00.000"
    },
    {
      "dayOfWeek": "THURSDAY",
      "from": "09:00:00.000",
      "to": "17:00:00.000"
    },
    {
      "dayOfWeek": "FRIDAY",
      "from": "09:00:00.000",
      "to": "17:00:00.000"
    }
  ],
  "serviceTime": "PT24H",        -- niewymagane, czas w którym dostarczysz zamówienie do punktu 
                                    w ISO 8601 Duration
                                    https://en.wikipedia.org/wiki/ISO_8601#Durations
  "payments": [                  -- niewymagane, metody płatności dostępne w danym punkcie. 
                                    Jeśli wyślesz pustą tablicę - oznaczymy, 
                                    że odbiór jest tylko po przedpłacie.
    {
      "method": "CASH"
    },
   {
      "method": "CARD"
   }

  ],
  "confirmationType": "CALL_US", -- wymagane, dostępne wartości: AWAIT_CONTACT (Ponformujemy o 
                                    terminie odbioru) lub CALL_US (Prosimy umówić się na odbiór).
  "status": "ACTIVE"             -- wymagane, status punktu, dostępne wartości: "ACTIVE", 
                                    "TEMPORARILY_CLOSED", "CLOSED_DOWN". W ofercie pokazujemy tylko 
                                    punkty ze statusem "ACTIVE".
}'

PUT /points-of-service/{Point_of_service_ID}

Tym zasobem możesz zaktualizować dane wybranego punktu, jako zalogowany sprzedawca. Wyślij identyczną strukturę danych, jak dla metody POST i dodaj identyfikator punktu, który chcesz zaktualizować.

curl -X PUT \
  https://api.allegro.pl/points-of-service/{Point_of_service_ID} \
  -H 'accept: application/vnd.allegro.public.v1+json' \
  -H 'content-type: application/vnd.allegro.public.v1+json' \
  -H 'authorization: Bearer {token}’ \
  -d '{
            "id": "{Point_of_service_ID}",
            "externalId": null,
            "name": "Uproszczony punkt",
            "seller": {
                "id": "{seller_ID}"
            },
            "type": "PICKUP_POINT",
            "address": {
                "street": "",
                "city": "Poznań",
                "zipCode": "60-166",
                "state": "wielkopolskie",
                "countryCode": "PL",
                "coordinates": null
            },
            "phoneNumber": "",
            "email": "",
            "openHours": [],
            "serviceTime": null,
            "payments": [],
            "confirmationType": "CALL_US",
            "status": "ACTIVE"
        }'

GET /points-of-service?seller.id={seller.ID}

Tym zasobem, otrzymasz listę wszystkich punktów danego sprzedającego (seller.ID). Musisz być zalogowany, jako użytkownik Allegro.

curl -X GET \
  'https://api.allegro.pl/points-of-service?seller.id={seller.ID}' \
  -H 'accept: application/vnd.allegro.public.v1+json' \
  -H 'authorization: Bearer {token}’ \

GET /points-of-service/{Point_of_service_ID}

Tym zasobem, otrzymasz dane konkretnego punktu odbioru. Musisz być zalogowany, jako użytkownik Allegro.

curl -X GET \
 https://api.allegro.pl/points-of-service/{Point_of_service_ID} \
  -H 'accept: application/vnd.allegro.public.v1+json' \
  -H 'authorization: Bearer {token}’

DELETE /points-of-service/{Point_of_service_ID}

Tym zasobem możesz usunąć punkt odbioru. Aby usunąć dane, musisz być uwierzytelniony jako sprzedawca.

curl -X DELETE \
  https://api.allegro.pl/points-of-service/{Point_of_service_ID} \
  -H 'accept: application/vnd.allegro.public.v1+json' \
  -H 'authorization: Bearer {token}’

14 sierpnia 2017