Zastosowanie

Endpoint /product służy do tworzenia nowych kartotek produktów.

Specyfikacja POST

Request

HTTP POST https://drinks2cash.com/api/product Authorization: <api_key_dystrybutora>Content-Type: multipart/form-data; W form-data należy przekazać:

• name - string - nazwa produktu w tym zawartość procentowa oraz pojemność w ml np. Jack Daniels 40% 700ml - wymagane
• brand - integer lub string - marka, typ wyliczeniowy, numer z listy poniżej, jeśli nie ma tej marki na liście możesz wpisać markę słownie - wymagane
• ean - string (same liczby)- ean - wymagane
• sku - string - identyfikator produktu w twoim systemie - wymagane
• packages - integer lub string - rodzaj opakowania, np. 4 szt., 12 szt, typ wyliczeniowy, numer z listy poniżej, jeśli nie ma rodzaju opakowania na liście wpisz ją jako string
• weight - float, waga w kg
• concession_type - wartości A,B lub C - rodzaj koncesji - wymagane
• description - text - opis produktu
• short_description - string(1024) - jeśli masz w systemie krótki opis, prześlij go w tym polu
• pictures[] - binary (file) - zdjęcia produktu, max 5 MB jedno, JPEG PNG, multifile
• categories[] - tablica z integer lub string - typ wyliczeniowy, prześlij numer kategorii z listy poniżej, jeśli uważasz, że nie ma tam Twojej kategorii wpisz string - wymagane
• attachments[] - binary (file) - załączniki do produktu, PDF max 10 MB jeden
• capacity - integer lub string - pojemność, typ wyliczeniowy, prześlij numer z listy poniżej lub wpisz string jeśli nie znajdziesz odpowiedniej pojemności
• percent_of_alcohol - integer lub string - prześlij numer pojemności z listy poniżej lub wpisz swoją pojemność jeśli nie ma jej na liście

Swój api_key znajdziesz na stronie: https://drinks2cash.com/order/admin-importer

Responses

HTTP 200 - OK Body:

{
    "code": 201,
    "reasonPhrase": "Created",
    "data": "Created"
}

Operacja zakończona sukcesem. Poczekaj teraz, aż moderator Drinks2cash sprawdzi wprowadzone dane i zatwierdzi produkt. HTTP 403 - Forbidden Body:

{
    "code": 403,
    "reasonPhrase": "Forbidden",
    "data": "Unauthorised"
}

Nie zidentyfikowano użytkownika. Sprawdź, czy podałeś poprawne api_key, znajdziesz je w swoim panelu administracyjnym w zakładce https://drinks2cash.com/order/admin-importer HTTP 400 - Bad request Błędne parametry żądania. Jeśli wprowadzone przez Ciebie dane są niepoprawne otrzymasz komunikat ze szczegółową informacją.

Przykład:

{
    "code": 400,
    "reasonPhrase": "Bad Request",
    "message": {
        "ean": {
            "notDigits": "Podana wartość może zawierać tylko cyfry"
        },
        "sku": {
            "recordFound": "SKU already exists"
        },
        "weight": {
            "callbackValue": "Weight must be numeric"
        },
        "concession_type": {
            "notInArray": "Only A,B,C are allowed"
        },
        "pictures": {
            "callbackValue": "Only JPEG and PNG files, max 10 MB are allowed"
        },
        "categories": {
            "callbackValue": "Category must be a number or a string up to 20 chars"
        }
    }
}

Załączniki:

1. lista identyfikatory marek - brand

• brands-id.xlsx

1. lista identyfikatory opakowań - packages[]

• package.xlsx

1. lista identyfikatory kategorii - categories[]

main_categories.xlsx detail_category.xlsx

1. list identyfikatory pojemności - capacity