🇬🇪 QuickShipper: OAuth-კლიენტი და საქართველოს კურიერების არჩევა

QuickShipper — მიწოდების აგრეგატორია საქართველოში: საკუთარი ავტოპარკი და დაკავშირებული ადგილობრივი სამსახურები. ერთი ბარათი მყიდველს შეკვეთის გაფორმებისას კურიერის რამდენიმე ვარიანტს სთავაზობს, თითოეულის ფასითა და ვადით.

სად იმართება: მართვის პანელი → „გზავნილები“ → ღილაკი „მიწოდების სამსახურები“ (ან ობიექტის ბარათი → WEB → „მიწოდების სამსახურები“).

რა დაგჭირდებათ#

• სატესტო გარემოსთვის — სატესტო კაბინეტის test.quickshipper.ge ლოგინი და პაროლი (რეგისტრაცია თავისუფალია, გასაღებები საჭირო არ არის);
• რეალური გარემოსთვის — Delivery API-ის OAuth-კლიენტი: Client ID და Client secret (სერვისი მოთხოვნით გასცემს, კაბინეტში დამოუკიდებლად არ გაიცემა);
• ობიექტის მისამართი, ქალაქი, კოორდინატები და ტელეფონი, საიდანაც კურიერი შეკვეთებს იღებს.

სატესტო გარემო: სატესტო კაბინეტი#

1. დარეგისტრირდით test.quickshipper.ge-ზე.
2. დააკავშირეთ კურიერები: Parameters → Integration → Activation of courier services. საცდელად საკმარისია ღილაკი „Add your own delivery type“ — მიტანის საკუთარი ტიპი სახელითა და ფასით; დაკავშირებული კურიერების გარეშე ტარიფები არ იქნება.
3. სერვისის ბარათში ჩაწერეთ ამ კაბინეტის ლოგინი და პაროლი, Client ID ცარიელი დატოვეთ — QuickShipper-ის Delivery API-ის სატესტო კლიენტი საერთოა და მათ დოკუმენტაციაშია გამოქვეყნებული.

საბრძოლო კონტური: გასაღებები სერვისთან#

1. შექმენით ბიზნესის ანგარიში qshpr.com-ზე.
2. მიწერეთ info@qshpr.com-ზე: «გთხოვთ, მომცეთ Delivery API-ზე წვდომა ონლაინ-მაღაზიის ინტეგრაციისთვის», მიუთითეთ ანგარიშის e-mail.
3. სერვისი გამოგიგზავნით Client ID-სა და Client secret-ს (ზოგჯერ ლოგინით შესასვლელ ლოგინსა და პაროლსაც) და ინტეგრაციის მიღებას ჩაატარებს.

რა უნდა ჩაწეროთ სერვისის ბარათში#

შემოწმება#

1. დააჭირეთ «შენახვას».
2. დააჭირეთ «მიერთების შემოწმებას»: ბარათის ქვეშ პროვაიდერების ტარიფები გამოჩნდება. წარწერა «მოკ-რეჟიმი» ნიშნავს, რომ გასაღებები მიერთებული არ არის და ტარიფები სადემონსტრაციოა.
3. მონიშნეთ «QuickShipper-ის ჩართვა».

სატესტო და საბრძოლო კონტურები#

• გასაღებების გარეშე ბარათი სადემონსტრაციო ტარიფებს აჩვენებს.
• «სატესტო» კონტური — QuickShipper-ის სატესტო სერვერის ნამდვილი პასუხები. მყიდველი ასეთ ტარიფებს ვერ ხედავს, შეკვეთიდან ზედნადები არ იქმნება: სატესტო შეკვეთას არავინ წაიღებს.
• «საბრძოლო» კონტური — ჩართეთ, როცა სამსახური დაადასტურებს, რომ ინტეგრაციამ მიღება გაიარა. ამ მომენტიდან QuickShipper-ის ტარიფები მყიდველს შეკვეთის გაფორმებისას გამოუჩნდება, ხოლო შეკვეთის ბარათიდან ზედნადები შეიქმნება.

ხშირი პრობლემები#

• წერილზე პასუხი არ არის — ხელახლა მისწერეთ ან QuickShipper-ის მხარდაჭერაში დარეკეთ: API-ზე წვდომას ხელით გასცემენ.
• «კავშირის შემოწმება» ავტორიზაციის შეცდომას წერს — შეამოწმეთ, რომ არჩეულია ისავე კონტური, რომლისთვისაც გასაღებები გაიცა: სატესტო კაბინეტის ლოგინი საბრძოლო კონტურში არ მუშაობს, საბრძოლო გასაღებები კი ქვიშის ყუთში. invalid_grant — Invalid password — კაბინეტის არასწორი პაროლია.
• ტარიფები არ არის — QuickShipper-ის კაბინეტში არც ერთი კურიერი არ არის ჩართული («Activation of courier services»), აღების წერტილს კოორდინატები არ აქვს ან მყიდველის მისამართი პროვაიდერების ზონის გარეთაა.
• ზედნადები ქვიშის ყუთში არ იბეჭდება — QuickShipper-ის სატესტო სერვერის ზედნადებების გენერატორი ახლა არ მუშაობს; შეკვეთა ამ დროს მაინც იქმნება.

ბმულები#

• სერვისის საიტი: https://qshpr.com/
• API-ის დოკუმენტაცია (Swagger): https://delivery-test.quickshipper.ge/swagger/

← მიტანის ყველა სერვისი