17 marca 2021
PATCH /sale/product-offers/{offerId} - dodaliśmy obsługę pola product.id
Za pomocą PATCH /sale/product-offers/{offerId} zmienisz dane w ofercie w prosty sposób. Wystarczy, że w strukturze przekażesz dowolne pole oferty, nie musisz przekazywać całego jej modelu.
W ostatnim czasie zapowiedzieliśmy, że 1.04.2021 zwiększymy wymóg procentowy ofert połączonych z Katalogiem produktów Allegro. Aby ułatwić proces powiązania oferty z produktem, dodaliśmy dziś obsługę pola product.id, w którym wskazujesz identyfikator danego produktu lub numer GTIN (EAN, ISBN, ISSN). W odpowiedzi automatycznie zaktualizujemy w ofercie:
- kategorię i parametry,
- opis,
- zdjęcia,
- sekcję “pasuje do”,
- specyfikację techniczną TecDoc
zgodnie z danymi zawartymi w produkcie.
Oznacza to, że jeżeli w żądaniu PATCH /sale/product-offers/{offerId} przekazujesz product.id, zgadzasz się na to, aby ofertę dostosować do produktu.
Ważne! Jeżeli chcesz zachować aktualny opis, zdjęcia i parametry produktowe, oprócz product.id powinieneś przekazać również takie pola jak: description, images i product.parameters. Możesz je pobrać z edytowanej przez Ciebie oferty, korzystając z zasobu: GET /sale/offers/{offerId}.
Aby przedstawić proces powiązania oferty z produktem metodą PATCH, udostępniliśmy w naszym poradniku szczegółową instrukcję.
Przykładowy request:
curl -X PATCH \
‘https://api.allegro.pl/sale/product-offers/7680042192 \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.beta.v2+json'
-H 'Content-Type: application/vnd.allegro.beta.v2+json' \
-d ’{
"product": {
"id": "0475a562-fbbb-4260-b772-59a82aa96554"
}
}'
Pamiętaj, że nie możesz usunąć produktu z oferty. W przypadku, gdy w polu product.id przekażesz wartość null - zwrócimy błąd 422.
Przykładowy response:
{
"id": "7680042192",
"name": "Żarówka samochodowa LED",
"product": {
"id": "0475a562-fbbb-4260-b772-59a82aa96554",
"publication": {
"status": "NOT_LISTED"
}
},
"afterSalesServices": {
"impliedWarranty": {
"id": "f4f3541e-41c2-481f-938a-2a1b8c0ce65a"
},
"returnPolicy": {
"id": "7068910b-29b9-449b-8ad0-99625a6312db"
},
"warranty": null
},
"payments": {
"invoice": "NO_INVOICE"
},
"sellingMode": {
"format": "BUY_NOW",
"price": {
"amount": 100,
"currency": "PLN"
},
"startingPrice": null,
"minimalPrice": null
},
"stock": {
"available": 3,
"unit": "UNIT"
},
"location": {
"countryCode": "PL",
"province": "WIELKOPOLSKIE",
"city": "Poznań",
"postCode": "60-166"
},
"delivery": {
"shippingRates": {
"id": "7dd8049c-1753-4842-8870-e29a2efc3d62"
},
"handlingTime": "PT48H",
"additionalInfo": ""
},
"publication": {
"duration": null,
"status": "ACTIVE",
"endedBy": null,
"endingAt": null,
"startingAt": null,
"republish": false
},...
"description": {...}
"validation": {
"errors": [],
"warnings": [],
"validatedAt": "2021-03-16T14:01:53.434Z"
},
"createdAt": "2021-02-24T07:01:55Z",
"updatedAt": "2021-03-16T14:01:53.793Z",...
"images": [
"https://a.allegroimg.com/original/119247/d50959f64c568b3cd1421c70f31e",
"https://a.allegroimg.com/original/1112b4/d03b421247169a2835880cc39d88"
],
"external": null,
"category": {
"id": "257359"
},
"tax": {
"percentage": null
},
"sizeTable": null,
"discounts": {
"wholesalePriceList": null
}
}
Jeśli chcesz sprawdzić, które z twoich ofert nie są powiązane z produktem, skorzystaj z GET /sale/offers?product.id.empty=true.
Więcej informacji o tym, jak zarządzać ofertą za pomocą metody PATCH, znajdziesz w poradniku.
