50. Sameday

Данни за достъп #

За пълна интеграция с Sameday API са необходими:

• Username (потребителско име за API)
• Password (парола за API)

Данните се предоставят от Sameday при сключване на договор и активиране на API достъп за вашия търговски акаунт. Обърнете се към вашия търговски представител или екипа за интеграции на Sameday (България: sameday.bg), за да получите API credentials.

Важно: API потребителското име и паролата не са същите като данните за вход в уеб портала на Sameday (ако имате отделен клиентски акаунт). Използвайте точно credentials, предназначени за API интеграция.

След като ги имате, в приложението Изпрати.БГ в Shopify ги въвеждате в секция Authentication (Удостоверяване).

Настройката на интеграцията със Sameday #

След инсталиране на приложението Изпрати.БГ в Shopify:

1. Отворете приложението от Shopify Admin → Apps → Изпрати.БГ.
2. От началния екран отворете секцията „Куриери“ и натиснете „Конфигурация“ под Sameday,
   или отидете директно на настройките: /app/settings/sameday в приложението.
3. Ако нямате връзка, системата ви води през създаване на Connection (връзка) с куриера Sameday.
4. След успешно свързване настройките се запазват в Изпрати.БГ (не в Shopify) и се използват за генериране на AWB/товарителници, етикети и при нужда — динамични цени.

След като въведете валидни API данни, Izprati.bg зарежда услуги и точки от Sameday API. В повечето случаи е достатъчно да изберете пункт за вземане от търговеца и формата на етикета, след което можете да генерирате товарителници.

Първоначално свързване на системата #

При първо свързване приложението предлага два режима (екран с две колони — „Създай с достъп до куриера“ / „Създай връзка без данни за куриера“).

Свързване с достъп до куриера #

Това е препоръчителният режим. Въвеждате Username и Password за Sameday API и получавате пълен достъп:

• автоматично генериране на товарителници (AWB)
• автоматично качване на tracking номера в Shopify
• динамични куриерски цени (при активиран Carriers API и подходящ Shopify план)
• зареждане на услуги и точки от Sameday
• пълна интеграция със Sameday API

Стъпки (Стъпка 1 — Carrier settings):

Не създавайте повече от една активна връзка за Sameday, освен ако нямате специфична нужда (напр. различни договори).

Ограничен режим (без API данни) #

Ако все още нямате API достъп от Sameday, можете да изберете „Създай ограничена връзка“.

В този режим:

• можете да ползвате фиксирани Shopify цени или персонализирани цени;
• няма автоматично създаване на товарителници и етикети;
• няма динамични цени от куриера;
• няма качване на tracking от Sameday.

Използвайте го само временно, докато получите API credentials.

Опростен и професионален режим #

Настройките на Sameday в приложението са в два режима (превключватели „Опростен режим“ / „Професионален режим“ в заглавието на страницата с настройки).

Опростен режим е подходящ за повечето Shopify магазини. Показва само:

• удостоверяване (при първо свързване);
• пункт за вземане от търговеца;
• API host, тип документ и валута.

Целта е магазинът да е готов за работа за няколко минути.

Професионален режим отваря пълната backend форма с всички полета от интеграцията Sameday — за по-специфични сценарии, различни пазари (BG/RO/HU) или разширена конфигурация, която backend-ът поддържа.

Настройка в опростен режим #

След създадена връзка с API данни отворете Настройки на Sameday (/app/settings/sameday) в Опростен режим.

Пункт за вземане от търговеца #

Това е Sameday pickup point — мястото, от което куриерът взима пратките ви (склад, офис, договорена точка на търговеца).

• Изберете точка от падащото меню (зарежда се от синхронизираните Sameday точки).
• Ако не изберете точка, backend-ът опитва автоматично да използва стандартния merchant pickup point от Sameday API (GET /api/client/pickup-points).

Това не е easybox/шкафчето, което клиентът избира при checkout. За получател се използва отделна точка от поръчката (вижте по-долу).

API и документи #

Натиснете Запази, за да запишете настройките.

Всички настройки в професионален режим #

Таблицата описва полетата в backend формата (същите групи, които използва интеграцията Sameday в Изпрати.БГ).

Важно: пункт за вземане срещу easybox на клиента #

Sameday разграничава два типа „точки“:

Ако клиентът е избрал easybox или офис на Sameday при поръчка, тази информация идва от Shopify поръчката и checkout интеграцията — не от полето „Пункт за вземане“ в настройките.

Наложен платеж (COD) #

При неплатена поръчка в Shopify интеграцията изпраща към Sameday сума за наложен платеж (cashOnDelivery) според стойността на поръчката. Плащането на самата AWB услуга от страна на клиента (awbPayment) следва правилата на Sameday API.

За такса COD и показване в checkout вижте също документацията в Shopify секцията: „70. Такса за наложен платеж (COD)“.

Съпоставяне с Shopify и checkout #

След като Sameday е конфигуриран:

1. Създайте методи за доставка в Shopify (док. „20. Създаване на методи за доставка в Shopify“).
2. Настройте съответствие между Shopify методи и Sameday услуги (док. „30. Настройка на съответствие между Shopify и куриерските услуги“).
3. При нужда от избор на easybox/офис на checkout — активирайте checkout widget или Carriers API (док. секция „15. Варианти за checkout интеграция“).

Услугите на Sameday (адресна доставка, офис, easybox) се зареждат автоматично от API след валидни credentials.

Международни пратки (cross-border) #

Ако държавата на вашия merchant pickup point е различна от държавата на получателя, Sameday изисква cross-border услуга (XB — до адрес, XL — до locker). Интеграцията опитва автоматично да избере подходяща услуга; ако в акаунта ви няма такава услуга, ще получите грешка при експорт — свържете се с Sameday за активиране.

Често срещани проблеми #