Основа для публикации backend-командой. Все адреса .invalid, карты, аптеки и ответы в примерах учебные. Публичный доступ к документации не даёт доступа к API; рабочий адрес и данные подключения выдаёт Олекстра.

SDK и MCP для ИТ-служб

Открыть интерактивную песочницу методов

Комплект содержит небольшие клиенты JavaScript и Python для подтверждённых форматов, примеры запросов и локальный MCP-сервер документации. Никакие запросы не отправляются при скачивании или запуске MCP.

Скачать комплект ZIP OpenAPI /pharmacy/v1 Версии и SHA-256

JavaScript · Node.js 20+

JavaScript

import { PharmacyClient, examples } from './olekstra-sdk.mjs';
const client = new PharmacyClient({
  baseUrl: 'https://pos.example.invalid',
  protocol: 'pharmapi',
  token: process.env.PHARMACY_TOKEN,
  secret: process.env.PHARMACY_SECRET
});
// Подготовка запроса без отправки:
console.log(client.prepare('quote', examples.pharmapi));
// Явная отправка — только в согласованный тестовый контур:
// await client.send('quote', examples.pharmapi);

SDK не повторяет операции автоматически и не рассчитывает скидку. Он сохраняет HTTP-статус, Content-Type и тело ответа, включая текстовые бизнес-отказы Сооплаты при HTTP 200. Секреты не включаются в подготовленное представление запроса.

Python · 3.10+

Python

from olekstra_sdk import PharmacyClient
client = PharmacyClient('https://pos.example.invalid', 'sooplata')
request = client.prepare('confirm', {
  'drugstoreId': '999_DEMO_0001',
  'voucherId': 'RETURNED_UUID',
  'confirmationToken': 'LAST_RETURNED_UUID'
})
# client.send(...) — отдельный явный вызов

MCP · stdio, версия протокола 2025-11-25

JavaScript

node olekstra-mcp.mjs

// Конфигурация клиента MCP:
{ "mcpServers": { "olekstra-pharmacy-docs": {
  "command": "node",
  "args": ["/absolute/path/olekstra-pharmacy-kit/olekstra-mcp.mjs"]
} } }

Инструменты: protocol_reference (методы/ограничения), request_example (учебный запрос), validate_profile (проверка конфигурации). Сервер читает только локальный комплект, не обращается к кассам, не выдаёт ключи и не подтверждает продажи. Формат соответствует спецификации MCP tools.

Перед рабочим использованием

Backend-команда подтверждает опубликованный адрес, транспортную защиту, профиль сети, версии и примеры на тестовом контуре. SDK — основа интеграции, а не сертификация кассового модуля.