25 kwietnia 2025
Wystawianie ofert - dzięki nowym metadanym łatwiej obsłużysz błędy w ofertach
Jednym z częstych błędów podczas wystawiania oferty produktu jest rozbieżność między częścią parametrów, które do nas wysyłasz, a danymi produktu w Katalogu Allegro. Sytuacja taka może mieć miejsce gdy na podstawie przesłanych przez Ciebie danych rozpoznaliśmy istniejący produkt.
Od dziś łatwiej obsłużysz przypadki, kiedy występują różnice między wartościami parametrów, bowiem wzbogaciliśmy zwracane w odpowiedzi metadane.
Jak było dotychczas?
Jeśli przy próbie utworzenia nowego produktu za pomocą POST /sale/product-offers rozpoznaliśmy istniejący produkt w naszym katalogu, ale np. wartość jednego z przesłanych parametrów różniła się od naszych danych, zwracaliśmy poniższy, przykładowy błąd. W polu “metadata.productId” informowaliśmy o rozpoznanym produkcie z katalogu.
{
"errors" : [ {
"code" : "PARAMETER_MISMATCH",
"message" : "The provided parameter 'Materiał dominujący'(236902) value (nylon(236902_406918)) does not match the existing parameter value (poliamid(236902_406926))",
"details" : null,
"path" : "productSet[0].product.parameters",
"userMessage" : "Produkt już istnieje w Katalogu. Próbowaliśmy połączyć go z Twoją ofertą, ale wartość parametru 236902 (Materiał dominujący) - nylon(236902_406918) - nie zgadza się z wartością produktu z Katalogu, czyli poliamid(236902_406926). Aby wystawić ofertę, podaj tę wartość: poliamid(236902_406926)."
"metadata" : {
"productId" : "04ee251b-8979-40f4-a2da-b331987a0a0a"
}
} ]
}Jakie zmiany wprowadziliśmy?
W obiekcie “metadata” dodaliśmy nowe pola, dzięki którym łatwiej zidentyfikujesz problematyczny parametr i zmienisz jego wartość w ofercie na prawidłową.
Przykład dla parametru typu słownikowego:
{
"errors" : [ {
"code" : "PARAMETER_MISMATCH",
"message" : "The provided parameter 'Materiał dominujący (id: 236902)' value ‘nylon’ does not match the product parameter value ‘poliamid‘.",
"details" : null,
"path" : "productSet[0].product.parameters",
"userMessage" : "Produkt już istnieje w Katalogu. Próbowaliśmy połączyć go z Twoją ofertą, ale wartość parametru “Materiał dominujący” w ofercie to “nylon” i różni się od wartości w produkcie z naszego katalogu ‘poliamid ‘. Aby wystawić ofertę, zmień wartość na ‘poliamid."
"metadata": {
"productId": "04ee251b-8979-40f4-a2da-b331987a0a0a",
"parameterId": "219781",
"parameterName": "Materiał dominujący",
"currentParameterValueId": "236902_406918", -
"currentParameterValue": "nylon",
"expectedParameterValueId": "236902_406926",
"expectedParameterValue": "poliamid",
}
} ]
}Prócz tego doprecyzowaliśmy komunikaty zwracane w message oraz userMessage.
Na biężaco będziemy również dodawać kolejne metadane dla innych rodzajów błędów, dlatego zwracaj uwagę na informacje, jakie zwracamy w odpowiedzi.
Więcej informacji o metadanych, wraz z innymi przykładami, znajdziesz w naszym poradniku.
