---
title: 50. Sameday
description: "## Данни за достъп За пълна интеграция с Sameday API са необходими: - Username (потребителско име за API) - Password (парола за API) Данните се предоставят от Sameday при сключване на договор и активиране на API достъп за вашия търговски акаунт. Обърнете се към вашия търговски представител или…"
url: "https://izprati.bg/docs/sameday/"
updated: "2026-07-27"
category: Куриери
---

# 50. Sameday

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

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

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

Данните се предоставят от Sameday при сключване на договор и активиране на API достъп за вашия търговски акаунт. Обърнете се към вашия търговски представител или екипа за интеграции на Sameday (България: [sameday.bg](https://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):

| Действие | Какво да направите |
| --- | --- |
| Integration | Изберете куриер Sameday |
| Connection name | Име на връзката, напр. `Sameday - [име на магазина]` |
| Username | Sameday API потребителско име |
| Password | Sameday API парола |
| Create | Натиснете Create / Създай с достъп до куриера |

> Не създавайте повече от една активна връзка за 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 и документи

| Поле | Описание | Препоръка |
| --- | --- | --- |
| API host | Базов URL на Sameday API | Оставете празно за България — използва се `https://api.sameday.bg`. За Румъния: `https://api.sameday.ro`. За Унгария: `https://api.sameday.hu`. |
| Тип документ | Формат на AWB/етикет | A6 (по подразбиране), A4 или A4 4xA6 — според принтера ви. |
| Валута | ISO код (EUR, RON, HUF…) | По подразбиране EUR за български магазини. |

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

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

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

| Поле (англ.) | Превод | Описание | Необходими действия |
| --- | --- | --- | --- |
| Стъпка 1 — Carrier settings |  |  |  |
| Integration | Интеграция | Избор на куриер | Изберете Sameday → Create connection |
| Connection | Връзка | Връзка Shopify ↔ Sameday | Connection name, Username, Password → Create |
| Стъпка 2 — Authentication |  |  |  |
| Username | Потребителско име | API username от Sameday | Попълнете, ако сте пропуснали при създаване |
| Password | Парола | API password от Sameday | Попълнете, ако сте пропуснали при създаване |
| Стъпка 3 — General Options |  |  |  |
| Pickup point (optional) | Пункт за вземане (по избор) | Merchant pickup point в Sameday | Препоръчително — изберете склад/точка за вземане |
| API host | API host | Базов URL на API | Празно = `https://api.sameday.bg` |
| Document Type | Тип документ | A6 / A4 / A4_4xA6 | Според принтера |
| Currency | Валута | Валута за API заявки | BGN, EUR и др. |

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

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

|  | Пункт за вземане (pickup point) | Точка на получател (OOH / easybox) |
| --- | --- | --- |
| Кой избира | Търговецът в настройките на Изпрати.БГ | Клиентът при checkout (widget / Carriers API) |
| За какво служи | Откъде куриерът взима пратката | Къде клиентът получава пратката |
| В API | `pickupPoint` (merchant id) | `oohLastMile` / service point от поръчката |

Ако клиентът е избрал 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 за активиране.

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

| Проблем | Причина | Решение |
| --- | --- | --- |
| Не се създават товарителници | Ограничен режим или грешни credentials | Пълна връзка + проверка Username/Password |
| „Username or password not set“ | Липсват auth данни | Попълнете Authentication и запазете |
| Липсва pickup point | Не е избран и API няма default | Изберете пункт в опростен/про режим |
| Грешен API host | Ръчен URL за друг пазар | BG: празно или `api.sameday.bg`; RO/HU: съответният host |
| Няма easybox в checkout | Не е настроен widget/CCS | Вижте checkout документацията в секция Shopify |
| Cross-border грешка | Няма XB/XL услуга в акаунта | Поискайте активиране от Sameday |