Гиды API Операции

Документация

Руководства, примеры и справочные пути для ведения поставок, возвратов, товаров, онбординга B2B, аккаунтов супермаркетов, отчётов и интеграций в wallmarkets.

Просмотр по процессу

Найдите нужную часть системы

Сначала короткие пути, более глубокий справочник ниже. Выберите процесс, который соответствует стоящей перед вами задаче.

Рекомендуемый первый запуск Создайте одну реальную поставку с реальным филиалом, затем распечатайте запись и посмотрите, где она появляется в отчётности.
Следуйте быстрому старту →

Начало работы

Быстрый путь

Используйте этот раздел, когда вам нужен самый короткий надёжный путь от нового аккаунта до одной реальной записи поставки, которую можно просмотреть, распечатать и включить в отчёт.

1Создать аккаунт 2Добавьте каталог и филиалы 3Сохраните первую поставку

Что такое wallmarkets?

wallmarkets помогает поставщикам вести учет поставок, возвратов, товарови счетов супермаркетов в единой рабочей системе. С ее помощью можносоздавать чистые отчеты о поставках, связывать возвраты с исходнымипартиями и просматривать цифры в отчетах и аналитике.

Сделайте сначала Проверьте одну обычную поставку

Используйте реальные данные о товаре, филиале, количестве и цене, чтобы остальному процессу было что показать.

Избегайте Проверка каждого крайнего случая

Быстрее всего уверенность приходит от одной скучной, но точной записи, затем от одного возврата, если он нужен вашей команде.

Результат Исходная запись

Вы получаете страницу деталей поставки, которая может питать печать, экспорты, возвраты, отчётность и последующий разбор.

Пререквизиты
Современный браузер (Chrome, Firefox, Safari, Edge)
Адрес электронной почты или аккаунт Google
Не требуется установка программного обеспечения
Поддержка PWA на мобильных устройствах
Лучший первый запуск: одна реальная доставка

Используйте первую поставку для проверки рабочего процесса на реальныхданных, а не для стресс-тестирования всех граней сразу.

Быстрый старт

1
Создать учетную запись
Зарегистрируйтесь с помощью электронной почты или Google OAuth.Подтвердите свою электронную почту, чтобы активировать все функции.
2
Добавьте свои продукты
Укажите название, вес, цену и категорию для каждого поставляемого продукта.
3
Регистрируйте супермаркеты
Добавьте сети и филиалы, которые вы поставляете, с адресами иконтактными данными.
4
Создайте свою первую доставку
Выберите товары, количество, целевой супермаркет и дату доставки.
5
Отслеживайте все
Просмотрите запись, все связанные с ней возвраты и представленияотчетности, которые объясняют, что изменилось.

Мобильный доступ

На мобильных устройствах вы можете установить wallmarkets какProgressive Web App (PWA) для более быстрого повторного доступа иограниченного просмотра кэша при нестабильном соединении. Узнайте, как →

Поставки

Основная задача

Создавайте чистые записи отгрузок, отвечающие, куда ушёл товар, что в него входило и что должно произойти дальше, если что-то вернётся.

1Выберите назначение 2Добавьте товарные линейки 3Печатайте или экспортируйте

Создание доставки

Перейдите в раздел "Доставка" > "Новая доставка".Выберите целевой супермаркет и филиал, добавьте один или несколькотоваров с указанием количества, выберите дату доставки и отправьтезаявку.

Полученная страница с деталями становится исходной записью, которую выможете просмотреть, распечатать, экспортировать или использовать вкачестве отправной точки для связанного возврата позже.

Форма записи о доставке

delivery.yaml
supermarket: E-mart
branch: Central Branch
delivery_date: 2026-03-15

lines:
  Whole Milk 1L x 50 @ 2850
  Greek Yogurt 500g x 30 @ 4200

Важен не сам формат, а то, что назначение, количество и цены корректныдо сохранения записи.

Как доставка отображается в приложении

Текущий рабочий процесс сосредоточен на чистой записи, а не на глубокоймашине статусов. На практике команды перемещаются между представлениемсписка, страницей подробностей и любыми связанными записями о возврате.

Просмотр списка Детальная страница PDF / Печать Связанные доходы

Ссылка на список

Поле панели Операционное значение Влияние решения
Дата Когда запись о доставке запланирована и когда она была создана Пригодится для просмотра сроков и периодов активности
Пункт назначения Супермаркет и филиал Именно здесь обычно в первую очередь всплывают ошибки на уровне филиалов
Значение Общая стоимость поставки по позициям Помогает быстро заметить негабаритные грузы
Заполнено / Возврат(ы) Является ли поставка самостоятельной или уже имеет связанные записи овозвратах Быстрый сигнал для последующей работы

Отслеживание и фильтрация

Страница "Поставки" представляет собой датированный рабочий список.Используйте ее для открытия записей, экспорта CSV, просмотра значений иопределения того, какие поставки уже имеют связанные возвраты. Есличто-то требует пояснений, перейдите на страницу с деталями доставки, ане пытайтесь сделать слишком много выводов из одной только таблицы.

Возвращает

Основная задача

Держите возвращённый товар привязанным к исходной поставке, чтобы история оставалась понятной в операциях, финансах и отчётности.

1Выберите поставку 2Подтвердите количества 3Оцените влияние

Обработка возврата

Перейдите в меню Возвраты > Новый возврат илиначните со страницы с деталями доставки. Выберите исходную поставку,подтвердите возвращаемый товар(ы) и его количество, выберите датувозврата и сохраните запись.

Каждый возврат остается связанным с первоначальной поставкой, чтопозволяет сохранить историю для последующего чтения при составленииотчетов и последующей работе.

Правила проверки возврата

Проверка валидации Применённое правило Предотвращённый риск
Объем поставки Выбранная поставка должна относиться к текущему бизнесу Предотвращает привязку возвратов к неверному счету
Дата возвращения Это не может быть до даты поставки или в будущем Сохраняйте хронологию и правдоподобность истории возвращения
Количество Возвращаемое количество не может превышать поставленное за вычетом ранеевозвращенных Не позволяйте командам повторно отправлять один и тот же груз на бумаге
Цена Возвращенные линии должны по-прежнему иметь положительную цену заединицу продукции Сохраняет значение возврата значимым в отчетах и экспорте

Связанные записи и документы

Каждый возврат имеет прямую связь с оригинальной поставкой и может бытьпросмотрен, распечатан или загружен в формате PDF. Такая связаннаяструктура облегчает последующий анализ и выверку, чем попыткиотслеживать возвраты в виде свободно плавающих заметок.

Аналитика возврата

Представления отчетов облегчают чтение итогов возврата рядом с итогамидоставки, а затем более глубокую фильтрацию по супермаркетам икатегориям в аналитике, когда требуется объяснить закономерность.

Продукция

Основная задача

Сделайте каталог надёжным до того, как поставки начнут его использовать. Данные товаров должны быть скучными, единообразными и легко импортируемыми пакетами.

1Название и вес 2Цена и категория 3Импортируйте или редактируйте

Управление каталогом продукции

У каждого товара есть название, вес, цена и категория. Продуктамприсваивается уникальный последовательный идентификатор, которыйиспользуется в поставках, возвратах и отчетах. Добавляйте товары поотдельности или импортируйте партию через CSV.

Редактируйте существующие продукты на странице с подробной информацией опродукте. Изменения цены или веса относятся только к будущим поставкам -исторические записи сохраняются.

Модель данных о продукте

Поле API Тип значения Обязательно? Значение поля
name string Отображаемое название продукта
weight decimal Вес в килограммах
price decimal Цена за единицу
category string Группировка, определяемая пользователем
sequential_id integer авто Уникальный, назначаемый системой

Импорт CSV

Добавьте товары в большом количестве, загрузив файл CSV. Импортерпроверяет каждую строку и сообщает о любых ошибках перед выполнениемоперации.

products.csv
name,weight,price,category
"Whole Milk 1L",1.03,2850,"Dairy"
"Greek Yogurt 500g",0.52,4200,"Dairy"
"Orange Juice 2L",2.10,5600,"Beverages"

Категории продуктов

Организуйте продукты по категориям (например, молочные продукты,напитки, замороженные продукты) для упрощения фильтрации в формедоставки и для отчетности на уровне категорий. Категории определяютсяпользователем - создавайте любые группировки, которые подходят длявашего бизнеса.

Супермаркеты

Основная задача

Разделяйте сети и филиалы, чтобы ваша команда доставляла в правильное физическое место, а не полагалась на расплывчатые названия аккаунтов.

1Создать сеть 2Добавьте филиалы 3Используйте в поставках

Счета супермаркетов

Каждый аккаунт супермаркета представляет сеть, в которую вы доставляететовары. В рамках этого аккаунта можно зарегистрировать филиалы ссобственным адресом и контактными данными. Такая структура позволяетпривязать доставку и возврат к нужному месту получения, а не объединятьвсе в одну запись на уровне сети.

Отраслевая иерархия

Сеть супермаркетов (например, E-mart)
Филиал: Центральный (адрес, контакт)
Филиал: Ист-Сайд (Адрес, контакты)
Филиал: Аэропорт Роуд (Адрес, контакты)

Добавление супермаркета

1
Перейдите в раздел Супермаркеты > Добавить новый
2
Введите название цепи и основные контактные данные
3
Добавьте один или несколько филиалов с их собственным адресом иконтактными данными
4
Экономьте - супермаркет теперь доступен в форме доставки

Поля записи филиала

Записи о филиалах наиболее полезны, когда они содержат детали, накоторые ваша команда будет опираться при создании и последующей проверкедоставки.

branch.yaml
name: Central Branch
address: Peace Avenue 10
contact_person: Receiving Manager
phone: +976-...
email: central@example.com

Чем четче данные о филиале, тем легче избежать ошибок в дальнейшем.

Управление филиалом

Используйте страницы супермаркета и филиала, чтобы точно указыватьимена, адреса и контакты. Чистые данные о филиалах впоследствии окупятсяпри создании доставок, возвратов и отчетов.

Онбординг B2B

Основная задача

Используйте онбординг B2B, когда супермаркет хочет получать предложения товаров онлайн или когда местный поставщик хочет предложить реальные позиции каталога на полки супермаркета.

1Выберите роль 2Опубликуйте или предложите 3Одобрите и закажите

Что создаёт онбординг B2B

Онбординг B2B превращает доступ к полке в отслеживаемый процесс. Владелец супермаркета может открыть портал покупателя, опубликовать, что готов принимать каждый магазин, рассмотреть предложения местных поставщиков, написать поставщику, одобрить или отклонить предложение и начать первый запрос товара. Поставщик может открыть тот же портал со своей стороны, отправить предложение для полки с подтверждением каталога, затем после одобрения координировать запросы, поставки, счета и контроль оплаты.

Путь покупателя Супермаркет присоединяется как покупатель для полки

Путь покупателя начинается с онбординга B2B, включает портал и направляет владельца к приёму для полки, чтобы магазины были готовы до того, как поставщики начнут предлагать.

Путь поставщика Местный бизнес предлагает себя со своим каталогом

Путь поставщика может начаться из публичного каталога приёма B2B, затем использует «Найти супермаркеты», чтобы отправить подтверждение товара, ключевые товары, условия запуска и контактные данные.

Результат Управляемый след партнёрства

Каждое приглашение, предложение, заметка, сообщение, одобрение, отказ, запрос товара, счёт и проверка администратором остаются привязанными к записи B2B.

Онбординг покупателя-супермаркета

Используйте этот путь для владельца в стиле eMart или категорийного закупщика, который хочет получать предложения от местных брендов и решать, что попадёт на физические полки.

1
Создайте бизнес-аккаунт
Владелец регистрируется, подтверждает email и создаёт бизнес-профиль для оператора супермаркета. B2B требует текущего бизнеса, потому что все предложения и запросы привязаны к контексту этого бизнеса.
2
Открыть онбординг B2B
Владелец открывает B2B > Начало работы и выбирает Начать как покупатель-супермаркет. Форма отправляется с entry_mode=supermarket, отмечает B2B включённым, завершает шаг онбординга и перенаправляет к приёму покупателя.
3
Создайте или закрепите за собой магазины супермаркета
Каждый магазин супермаркета становится профилем приёмки, в который могут обращаться поставщики. У профиля должны быть реальный адрес, ответственное контактное лицо, телефон или email и ожидания по приёмке на уровне филиала.
4
Опубликуйте приём для полки
Приём для полки фиксирует контакт покупателя, окна приёмки, ритм поставок, минимальную стоимость заказа, требуемые документы и заметки покупателя. Это сообщает поставщикам, что должно содержать полезное предложение, до того как они его отправят.
5
Входящие предложения
Входящие предложения показывают ожидающие, активные и отклонённые отношения с поставщиками с количеством позиций каталога, пакетом предложения, подтверждающими показателями, условиями запуска, заметками покупателя, сообщениями и кнопками действий.
6
Решите и начните первый заказ для полки
Покупатель может написать поставщику, добавить внутренние заметки, одобрить предложение, отклонить его с указанием причины или конвертировать активное предложение в запрос товара на первоначальное количество.

Онбординг местного поставщика

Используйте этот путь для производителя продуктов, бренда упакованных товаров или оптовика, у которого уже есть товары и который хочет показать покупателям супермаркетов, почему товары заслуживают места на полке.

1
Подготовьте подтверждение каталога
У поставщика должны быть готовы названия товаров, категории, цены, складские возможности, подтверждающие показатели и условия запуска. Предложение сильнее, когда называет ключевые товары и причины, по которым клиенты уже их хотят.
2
Начать предложения поставщика
Поставщик открывает онбординг B2B и выбирает Начать как местный поставщик. Форма отправляется с entry_mode=supplier, включает B2B и перенаправляет на панель B2B.
3
Найти приём супермаркета
Публичный каталог приёма B2B по адресу /b2b/intake показывает стойки покупателей до входа. После включения B2B «Найти супермаркеты» позволяет поставщику открыть стойку, прочитать требования и отправить предложение для полки с текстом предложения, ключевыми товарами, подтверждающими показателями, условиями запуска и контактными данными.
4
Отвечайте на сообщения покупателей
Сообщения партнёрства держат переговоры внутри записи. Поставщик может отвечать на вопросы покупателя вместо разрозненных звонков, скриншотов или цепочек писем.
5
Координируйте после одобрения
Как только супермаркет одобряет предложение, отношения становятся активными. Запросы товара, предложения по поставке, счета, отслеживание оплаты, аналитика и экспорты затем работают из того же следа партнёрства.

Справочник жизненного цикла

Момент онбординга Что происходит Запись создана или обновлена Решение владельца
Включить B2B Бизнес переключается с обычной логистики на портал B2B. У бизнеса установлено b2b_enabled, шаг онбординга отмечен завершённым Выберите путь покупателя, путь поставщика или используйте оба
Приём для полки Супермаркет указывает, что он может принять и какое подтверждение ожидает. Поля приёма супермаркета, контакт, окна, документы, заметки Подготовьте магазин к приёму предложений
Предложение поставщика Поставщик запрашивает доступ к полке и прикладывает историю своего каталога. Строка партнёрства плюс детали аудита пакета предложения Рассмотрите, напишите, отметьте, одобрите или отклоните
Одобренное предложение Поставщику достаточно доверия, чтобы начать координацию по полке. Статус партнёрства меняется на активный Создайте первый запрос товара
Первый заказ Покупатель запрашивает первоначальное количество выбранных товаров. Запрос товара с товаром, супермаркетом, количеством и запросившим пользователем Одобряйте, отклоняйте, конвертируйте в поставку, выставляйте счёт и отслеживайте оплату

Операционные экраны

Онбординг B2B Приём для полки Поиск поставщиков Предложения поставщика Запросы товара Счета

Куда идти дальше

Отчетность

Рабочий процесс отчётности

Превращайте операционные записи в решения

Используйте отчёты, чтобы сравнивать движение, возвраты и стоимость, не превращая каждый вопрос в восстановление таблицы.

1Выберите период 2Сравните возвраты 3Экспортируйте при необходимости
Панель управления CSV Фильтры API

Приборная панель KPIs

Главная панель позволяет быстро получить информацию, которая нужнабольшинству команд в первую очередь: доход, чистый доход, поставки ивозврат за выбранный период. Суть не в том, чтобы любоваться картами. Ав том, чтобы заметить, когда одна из них начинает рассказывать историю,отличную от остальных.

Доступные типы отчетов

UI CSV Деталь

Разбивка на возвраты

Возвращайте подсчеты и значения рядом с поставками, чтобы вы могливидеть, какие счета или периоды генерируют драг.

Открыть руководство по возвратам
Панель управления CSV Аналитика

Отчет о доходах

Считайте валовое движение рядом с доходностью и чистой стоимостью, чтобыпериод имел финансовый, а не только операционный смысл.

Открыть руководство по панели
UI Аналитика CSV

Характеристики продукта

Используйте представления продуктов и категорий, чтобы увидеть, гдесосредоточена ценность и какие товары постоянно возвращаются в качествеповторных работ.

Открыть руководство по аналитике

Создание отчетов

Перейдите к разделу "Отчеты" на боковой панели, задайтедиапазон дат и сначала просмотрите доставку и возврат вместе. Если вамнужно более глубокое объяснение, откройте панель аналитики иотфильтруйте товары по супермаркету или категории.

Предварительный просмотр конечных точек API

GET /api/dashboard/stats
GET /api/dashboard/stats?range=30d

{
  "revenue": 12450000,
  "net": 11200000,
  "deliveries": 156,
  "returns": 8,
  "period_change": "+12.3%"
}

Управление счетами

Основная задача

Держите в ясности владение, ключи API, ожидания по оплате и настройки аккаунта, чтобы операции не зависели от загадочного доступа.

1Обновите профиль 2Назовите ключи API 3Отзывайте устаревший доступ

Профиль и пароль

Обновите имя, компанию, электронную почту, аватар и имя пользователя вНастройках учетной записи. На этой же странице можноизменить пароль, выбрать язык, включить уведомления, ссылки наконфиденциальность и удалить аккаунт.

Перейдите в раздел "Настройки учетной записи →

Текущая модель доступа

Область товара Текущее покрытие Рекомендуемая практика
Объем бизнес-данных Поставки, возвраты, продукты и супермаркеты привязаны к текущемуконтексту бизнеса Проверьте бизнес-контекст в первую очередь, если кажется, что чего-то нехватает
Настройки учетной записи Профиль, пароль, язык, ссылки на конфиденциальность и удаление учетнойзаписи находятся в настройках учетной записи при входе в систему Четко обозначьте принадлежность и электронную почту владельца внутри команды
Ключи API Ключи создаются и отзываются из учетной записи, которой они принадлежат Используйте отдельные именованные ключи для каждой интеграции и быстроотзывайте устаревшие
Управление командой Сегодня этот продукт проще, чем полноценная корпоративная консольуправления ролями Не стройте внутренние процессы вокруг пользовательского интерфейса,который еще не существует

API-ключи

Сгенерируйте именованные ключи API в Настройках аккаунта >Ключи API. Скопируйте ключ, когда он будет показан, надежнохраните его и отзовите, когда интеграция больше не нуждается в доступе.

api-key-notes.txt
Key name: Production ETL
Rate limit tier: standard
Best practice: one key per integration
Action when retired: revoke immediately

Выставление счетов

wallmarkets предлагает доступ на основе плана, но не каждый аккаунтоткрывает полную рабочую область для самостоятельного выставления счетовпрямо в приложении. Относитесь к изменениям в биллинге как к работе науровне владельца и используйте руководство по биллингу, если необходимопрояснить путь.

Готовы приступить к работе?

Изучите наши пошаговые руководства в Справочном центре или погрузитесь всправочник API для расширенных интеграций.