Интеграция с PttAvm: API, XML, фулфилмент и единое управление магазином

О PttAvm: основание, собственники и положение на рынке

Основание и история (1840 год — наши дни)

PTT (Posta ve Telgraf Teşkilatı — Почтово-телеграфная организация Турции) была основана в 1840 году в Османской империи и является одной из старейших почтовых организаций в мире. Модернизированная в годы Республики, PTT в 2013 году была преобразована в акционерное общество. PttAvm был запущен в 2017 году в рамках инициативы цифровой трансформацииPTT; его цель — дать малому и среднему бизнесу, местным производителям, женщинам-предпринимателям и владельцам товаров с географическим указанием возможность вести электронную торговлю с низкими комиссиями под государственной гарантией.

После бума электронной коммерции, вызванного пандемией после 2020 года, объёмы PttAvm быстро выросли. Сегодня PttAvm превратился в государственную экосистему электронной коммерции, включающую маркетплейс (3P), сеть доставки PTT Kargo , сервис фулфилмента PTT Logistics , витрину Местный производитель, а также программы Товары с географическим указанием и Женщины-предприниматели .

Структура собственности PttAvm (2025)

• PTT Anonim Şirketi (PTT Inc.) — единственный акционер (100%, государственная организация)
• Министерство транспорта и инфраструктуры Турецкой Республики — единственный акционер PTT Inc. (100%)
• Фонд национального благосостояния Türkiye — стратегическая координация государственных активов
• Государственная организация — официальные протоколы о сотрудничестве с KOSGEB (турецким агентством по малому и среднему бизнесу), Tarım Kredi (Сельскохозяйственная кредитная кооперация) и Турецким патентным и товарным ведомством

Положение в турецкой электронной коммерции

По состоянию на 2024 год PttAvm позиционируется как самый надёжный государственный маркетплейс Турции. В отличие от частных маркетплейсов, таких как Trendyol и Hepsiburada, он выделяется государственными субсидиями, низкими комиссиями и политикой защиты малого и среднего бизнеса. Особенно сильные позиции у него в экосистемах географических указаний, местных производителей, женщин-предпринимателей и KOSGEB . Благодаря сети PTT из 17 000+ почтовых отделений доставка охватывает все 81 провинцию Турции.

Объёмы продаж и масштаб PttAvm (данные 2024–2025)

С момента запуска в 2017 году — и особенно после цифровой трансформации времён пандемии — PttAvm растёт на 50–80% в год. Государственные субсидии и низкие комиссии быстро увеличили число продавцов.

Год	GMV (TRY)	Заказы	Активные покупатели	Активные продавцы
2020	~500 млн ₺	3 млн	1,5 млн	5 тыс.
2022	~2 млрд ₺	12 млн	3 млн	12 тыс.
2024	~4,5 млрд ₺	28 млн	4 млн+	20 тыс.+
2025 (прогноз)	~6,5 млрд ₺	42 млн	5,5 млн	28 тыс.

Этот рост обеспечили сеть PTT Kargo по 81 провинции, низкие комиссии при государственных субсидиях, а также специальные программы «Витрина местных производителей», «Товары с географическим указанием» и «Женщины-предприниматели» . Стать продавцом на PttAvm — это путь в электронную коммерцию с самыми низкими комиссиями и государственной поддержкой, особенно для малого и среднего бизнеса и местных производителей.

Открытие магазина на PttAvm (актуальные правила 2026 года)

1. Юридические и финансовые требования

Чтобы стать продавцом на PttAvm, необходимо иметь действующую налоговую регистрацию в Турции. Подходят ИП, ООО и акционерное общество; при этом вы должны быть плательщиком электронных счетов (e-Fatura) и иметь возможность выставлять счета e-Arşiv. Отдельные каналы подачи заявки предусмотрены для предприятий, участвующих в программах KOSGEB (турецкого агентства по малому и среднему бизнесу), Tarım Kredi (Сельскохозяйственная кредитная кооперация) и географических указаний.

• Налоговое свидетельство (текущего года)
• Налоговый номер и турецкий идентификационный номер (для ИП)
• Выписка из торгового реестра (для ООО/АО)
• Образцы подписей
• Банковский счёт (IBAN) — выплаты перечисляются на этот счёт
• Интегратор e-Fatura/e-Arşiv, одобренный GİB, или портал GİB (Налоговое управление Турции)
• Свидетельство на товарный знак (для защищённых категорий, например косметики, продуктов питания, игрушек)
• Регистрация географического указания (в Турецком патентном и товарном ведомстве для таких товаров, как Antep Fıstığı, ковры Hereke и др.)

2. Подача заявки в панель продавца PttAvm

Заявка подаётся через satici.pttavm.com. Срок рассмотрения — 5–7 рабочих дней из-за процедур государственного учреждения (немного дольше, чем у частных маркетплейсов, но преимущества после одобрения значительно больше). После одобрения вы получаете ID магазина, API-ключ (apiKey) и API-секрет (apiSecret) — они необходимы для интеграции.

📥 Официальная заявка продавца PttAvm satici.pttavm.com — бесплатная заявка, одобрение за 5–7 рабочих дней →

3. Загрузка товаров и требования к контенту

PttAvm применяет к карточкам товаров требования к контенту, соответствующие стандартам турецкой электронной коммерции:

• Название: 50–150 символов, бренд + название товара + ключевая характеристика
• Изображение: белый фон, минимум 1000×1000 px, до 8 фотографий, без водяных знаков и текста
• Описание: поддерживается HTML, минимум 200 символов
• Сопоставление категорий: ID категории PttAvm + атрибуты (цвет, размер, материал, страна происхождения)
• Штрихкод (GTIN/EAN): по возможности — существенно ускоряет сопоставление
• Метки «Местный производитель» / «Географическое указание»: право на значок для подходящих товаров, с пониженными комиссиями

Комиссии PttAvm (2026)

Комиссии PttAvm в 2026 году составляют от 3% до 18% в зависимости от категории — значительно ниже, чем у Trendyol и Hepsiburada, благодаря государственным субсидиям. НДС 20%, сервисный сбор и стоимость PTT Kargo добавляются к комиссии. Производители, участвующие в программах KOSGEB, Tarım Kredi и географических указаний, получают дополнительные скидки на комиссию.

Формула чистой прибыли: Цена продажи − Комиссия − НДС − Сервисный сбор − Стоимость PTT Kargo − Себестоимость товара = Чистая прибыль. Модуль ценообразования Zunapro рассчитывает это автоматически для каждого товара и категории; он также учитывает скидки по программам KOSGEB, географических указаний и местных производителей.

API-интеграция PttAvm — технические подробности

Интерфейс PttAvm API — это RESTful-интерфейс, позволяющий продавцам программно синхронизировать данные о товарах, остатках, заказах, ценах, доставке и возвратах с системой PttAvm. Базовый URL API: https://ws.pttavm.com/api/v1/

Авторизация API

PttAvm API использует схему подписи API Key + Secret (HMAC SHA-256) . Каждый запрос содержит метку времени + подпись HMAC SHA-256, передаваемые в заголовке Authorization . Срока действия токена нет; однако в целях безопасности рекомендуется менять учётные данные каждые 6–12 месяцев. Официальная документация: ws.pttavm.com/docs.

Основные категории эндпоинтов

• Products API — создание и обновление товаров, сопоставление категорий, запросы значков местного производителя/географического указания
• Stock API — синхронизация остатков и цен (массовый эндпоинт, максимум 100 товаров за запрос)
• Orders API — список заказов, обновление статусов, создание посылок
• Categories API — дерево категорий PttAvm, шаблоны атрибутов, категории с льготами
• Cargo API — создание этикеток PTT Kargo, синхронизация трек-номеров
• Claims API — запросы заявок на возврат, принятие/отклонение
• Webhooks — мгновенные обратные вызовы при изменении заказов и остатков

Лимит запросов и обработка ошибок

Лимит запросов PttAvm API — 40 запросов в минуту на продавца. При превышении возвращается 429 Too Many Requests. Типичные коды ошибок: 400 (неверные данные товара), 401 (ошибка подписи HMAC), 404 (категория/штрихкод не найдены), 500 (системная ошибка PttAvm — повторите запрос). Интегратор Zunapro автоматически обрабатывает эти ошибки с помощью повторных попыток с экспоненциальной задержкой и очереди недоставленных сообщений (dead-letter queue).

XML-интеграция PttAvm — массовый перенос товаров

XML-интеграция PttAvm — это система, которая автоматически считывает каталог товаров вашего поставщика или собственного интернет-магазина в формате XML и переносит его в панель продавца PttAvm. XML-схема PttAvm соответствует стандартам турецкой электронной коммерции. Как альтернатива ручному вводу товаров, она позволяет загрузить тысячи товаров за считанные минуты.

Структура XML-схемы (совместимой с PttAvm)

Основные поля XML, загружаемого в PttAvm:

• productMainId — основной код товара (группирует варианты)
• brand, title, productCode, stockCode, barcode
• categoryId (категория PttAvm), attributes (цвет, размер, материал, страна происхождения)
• quantity (остаток), listPrice, salePrice, vatRate
• cargoCompanyId (по умолчанию PTT Kargo), shipmentAddressId
• geographicalIndication (код географического указания — при наличии)
• domesticProducer (признак местного производителя), womanEntrepreneur (признак женщины-предпринимателя)
• images (1–8 URL), description (HTML)

Перенос из XML поставщика в PttAvm

Большинство турецких оптовиков/поставщиков и местных производителей (особенно малый бизнес в анатолийских провинциях и производители товаров с географическим указанием) передают свои каталоги в формате XML. XML-модуль Zunapro:

1. Считывает URL XML поставщика (cron раз в час/в сутки)
2. Запоминает сопоставление категорий (первое сопоставление вручную, затем автоматически)
3. Нормализует атрибуты, такие как бренд, материал, страна происхождения и размер
4. Автоматически назначает значки местного производителя / географического указания
5. Добавляет к цене маржу + комиссию (включая государственные скидки)
6. Отслеживает складские запасы — автоматически деактивирует товары, которых больше нет у поставщика
7. Загружает в PttAvm через API

Фулфилмент PttAvm (PTT Logistics) — логистическое решение с государственной поддержкой

Фулфилмент PTT Logistics — это услуга, построенная на давно сложившейся почтовой и курьерской инфраструктуре PTT. После передачи товаров в сеть PTT из 17 000+ почтовых отделений хранение, упаковку, доставку до покупателя через PTT Kargo и обработку возвратов полностью берёт на себя PTT. Расширенная в 2024 году, эта услуга предлагает продавцам PttAvm льготный пакет хранения и доставки.

Преимущества фулфилмента PTT Logistics

• Доставка во все 81 провинцию — PTT Kargo + сеть из 17 000+ почтовых отделений
• Гарантия государственной инфраструктуры — гарантия почтово-телеграфного ведомства Турции
• Клиентский сервис берёт на себя PTT — возвраты, обмены, жалобы
• Метка «Доставлено с гарантией PTT» — повышает конверсию, особенно на региональных и сельских рынках
• Никаких операционных хлопот — вы не занимаетесь упаковкой и отправкой
• Льготный пакет — цены с государственными субсидиями, доступные только продавцам PttAvm

Стоимость фулфилмента PTT Logistics (2025, ориентировочно)

• Хранение: 60–120 ₺ за м³ в месяц (с государственными субсидиями, ниже, чем в частном секторе)
• Обработка заказа: 4–10 ₺ за единицу
• Обработка возврата: 6–12 ₺ за возврат
• Комиссия: стандартная комиссия PttAvm + 0,5–1,5% сбор за фулфилмент

Фулфилмент PTT Logistics выгоден для продавцов, обрабатывающих 300+ заказов в месяц. Продавцы с небольшим объёмом могут предпочесть отправлять товары со своего склада через PTT Kargo.

Рейтинг магазина на PttAvm и доля отмен

PttAvm присваивает каждому продавцу рейтинг магазина по шкале от 1 до 10; он напрямую влияет на видимость на витрине. Престиж магазина дополнительно повышают значки «Местный производитель», «Женщины-предприниматели» и «Географическое указание» . Основные факторы, снижающие рейтинг:

• Доля отмен — отмены из-за отсутствия товара на складе наказываются сильнее всего; свыше 3% — предупреждение, свыше 6% — риск закрытия магазина
• Задержки отгрузки — заказы, не переданные PTT Kargo в пределах срока подготовки
• Доля возвратов — возвраты выше ожидаемых порогов
• Отзывы покупателей — оценка должна оставаться выше 4,0 звезды
• Время ответа — на сообщения нужно отвечать в течение 24 часов (стандарт государственного маркетплейса)

С помощью автоматической синхронизации остатков Zunapro вы снижаете риск отмен на 90%; товары, проданные на вашем сайте, на складе или на другом маркетплейсе, мгновенно деактивируются на PttAvm.

Реклама на PttAvm, государственные льготы и умное ценообразование

Рекламные площадки PttAvm

• Спонсируемые товары PttAvm (Sponsored Products) — верхние позиции в результатах поиска (оплата за клик, TRY/клик)
• Витрина местных производителей — отдельное рекламное место для товаров со значком местного производителя
• Витрина географических указаний — спонсорство, предназначенное для товаров с географическим указанием
• Витрина магазинов женщин-предпринимателей — отдельный баннер для продавцов с сертификатом женщины-предпринимателя

Государственные льготы и программы

• KOSGEB — программы поддержки малого и среднего бизнеса через PttAvm со специальными скидками на комиссию
• Кооперативы Tarım Kredi — сниженные комиссии для фермеров и сельскохозяйственных производителей
• Турецкое патентное ведомство — географические указания — отдельная категория и пониженные комиссии для официально зарегистрированных товаров с географическим указанием, таких как Antep Fıstığı (антепская фисташка), Erzurum Cağ Kebabı (эрзурумский каг-кебаб) и Çorum Leblebisi (чорумский жареный нут)
• Сертификат женщины-предпринимателя — специальная программа для женщин-предпринимателей, сертифицированных KAGİDER или KOSGEB
• Сертификат местного производителя — скидки на комиссию для товаров со значком местного производителя, подтверждённым TOBB

Умное ценообразование (репрайсер)

На PttAvm существует ценовая конкуренция, хотя она не так остра, как на Trendyol, поскольку пул продавцов более селективен. Модуль репрайсера Zunapro автоматически корректирует цены относительно конкурентов за считанные секунды — он никогда не опускается ниже вашего минимального порога прибыли и учитывает государственные скидки.

Электронные счета и e-Arşiv для PttAvm (соответствие требованиям GİB)

Все продавцы на PttAvm обязаны выставлять счета e-Arşiv покупателям B2C и счета e-Fatura покупателям B2B (регламент GİB, Налоговое управление Турции). Выписывать счета вручную невозможно, когда заказов становится больше 50 в день.

Модуль электронных счетов Zunapro:

• Автоматически выставляет e-Arşiv/e-Fatura в момент поступления данных заказа PttAvm
• Интегрируется с одобренными GİB сторонними интеграторами (Logo, Mikro, Uyumsoft, Foriba, Veriban и др.)
• Автоматические счета на возврат при возвратах
• Ежемесячная отчётность KDV1, KDV2 (НДС)
• Автоматическая отправка PDF e-Arşiv покупателям по электронной почте + SMS

Интеграция доставки PttAvm — PTT Kargo + альтернативы

Заказы PttAvm по умолчанию отправляются через PTT Kargo (собственная курьерская служба PTT, самая обширная сеть доставки в Турции: 81 провинция + 17 000+ почтовых отделений). Можно также подключить альтернативные службы доставки: Yurtiçi Kargo, Aras Kargo, DHL Kargo, Sürat Kargo.

Наш мультикурьерный модуль Zunapro автоматически выбирает наиболее подходящую службу доставки по весу заказа, городу назначения и предпочтениям покупателя; печатает этикетки и автоматически передаёт трек-номера в PttAvm. Охват PTT Kargo в провинциях и сельской местности не имеет равных, особенно при доставке в деревни и посёлки за пределами центров 81 провинции.

Возвраты и клиентский сервис PttAvm

В турецкой электронной коммерции доля возвратов составляет 25–35% в моде, 4–8% в электронике, 8–12% в товарах для дома и 2–4% в продуктах питания (особенно в товарах с географическим указанием). Если процесс возврата вести неправильно, рейтинг магазина снижается.

Стандартный процесс возврата PttAvm:

1. Покупатель оформляет заявку на возврат в панели PttAvm (в течение 14 дней после доставки)
2. PTT Kargo бесплатно забирает товар (1–3 рабочих дня; его можно также сдать в почтовом отделении)
3. Склад PTT проверяет товар, направляет его продавцу или принимает возврат
4. Продавец одобряет или отклоняет возврат в течение 1–3 рабочих дней
5. В случае одобрения средства покупателя возвращаются в кошелёк PttAvm

Модуль возвратов Zunapro автоматически отслеживает все эти этапы; он отправляет продавцу уведомления в панели и автоматически выставляет счёт на возврат при возвратах покупателей.

Интеграция PttAvm с Zunapro — настройка в 4 шага (10 минут)

1. Введите данные магазина PttAvm — В панели Zunapro перейдите в раздел «Маркетплейсы» → PttAvm и введите ID магазина, API-ключ и API-секрет.
2. Подключите существующий сайт — Готовые коннекторы для Shopify, WooCommerce, OpenCart, İkas, Ticimax, PrestaShop и Magento. Введите URL API + ключ доступа.
3. Мастер сопоставления категорий — Сопоставьте категории вашего сайта с категориями PttAvm перетаскиванием. Значки местного производителя / географического указания назначаются автоматически.
4. Первичная синхронизация — Товары, остатки, цены, заказы, PTT Kargo — всё синхронизируется автоматически. Уже через 10 минут вашим магазином PttAvm можно управлять из панели Zunapro.

Часто задаваемые вопросы об интеграции с PttAvm (FAQ)