Основа для публикации backend-командой. Все адреса .invalid, карты, аптеки и ответы в примерах учебные. Публичный доступ к документации не даёт доступа к API; рабочий адрес и данные подключения выдаёт Олекстра.
ИТ-службе аптечной сети
Данные подключения
| Параметр | Требование |
|---|---|
| Протокол | PharmApi или Сооплата; одновременный смешанный режим не предусмотрен |
| Адрес | Выданный Олекстрой HTTPS-адрес нужного контура; не выводится из примера |
| Коды | Устойчивый код сети и каждой точки, адрес, регион, город |
| Товар | Заводской штрихкод, известный Ekt либо согласованное сопоставление кода сети. До пяти действующих заводских штрихкодов одного SKU |
| Доступ | Отдельно согласованные ключи и ограничения канала. Не помещайте секрет в URL, журнал или клиентский JS |
| Окружение | Тестовые данные Сооплаты отдельно от рабочих; диапазоны карт проверяет backend на непересечение |
Полный список аптек
Полный список заменяет состав одной сети: отсутствующие коды выключаются, совпадающие коды сохраняют участие в программах. Адрес не используется как идентификатор. Перед применением оператор проверяет новые, изменённые и отключаемые точки. Для восстановления используется сохранённый снимок. Новый код не получает участие автоматически.
Шаблон административной загрузки CSV — формат фронтенд-адаптера, не кассовый wire-формат метода pl. Реальная pl-загрузка согласуется с backend отдельно; CSV не отправляется в кассовый API.
Безопасность и диагностика
Настройте TLS и разрешённый сетевой доступ. Исключение HTTP требует отдельного документированного согласования. Не передавайте рабочие карты, секреты и персональные данные в диагностических примерах. Для обращения укажите время, контур, код точки, метод, request ID и обезличенный ответ.
Текущий вход Сооплаты на backend связывает drugstoreId с учётной записью по бренду. Его защита на edge и окончательные данные подключения должны быть подтверждены backend до публикации рабочего адреса; наличие общих полей ключа в админке не доказывает аутентификацию этого входа.
Спецификации
OpenAPI /pharmacy/v1 — точный снимок подтверждённого контракта нового API. PharmApi и Сооплата имеют собственные форматы: их нельзя подменять DTO этого OpenAPI.
Admin API подключения сетей находится в проектировании. Frontend mock не является публичным производственным API.