API и интеграция с 1С

Описание для разработки расширения 1С. Интерактивная схема: Swagger UI.

База

• URL сайта: https://dataprice.it-pandas.kz
• Кодировка UTF-8, заголовок Content-Type: application/json
• Авторизация (один вариант):

  Authorization: Bearer <token>
  
  или
  
  X-Api-Key: <api_key>

• Токен создаётся в кабинете поставщика (Настройки / Интеграции).

Минимальный сценарий расширения

1. GET /api/v1/ping — проверка токена и компании
2. POST /api/v1/products/upload — номенклатура из 1С
3. POST /api/v1/stocks и POST /api/v1/prices — остатки и цены
4. GET /api/v1/orders/download — забрать заказы с сайта
5. POST /api/v1/orders/upload — подтвердить/обновить статусы

GET /api/v1/ping

{
  "success": true,
  "service": "PandaPrice",
  "api_version": "v1",
  "company": { "id": 10, "name": "…", "slug": "…", "type": "supplier" }
}

POST /api/v1/products/upload

{
  "products": [
    {
      "id": "guid-1c",
      "sku": "ART-001",
      "barcode": "4607…",
      "nkt_code": "1234567890123",
      "tnved_code": "2202100000",
      "kpved_code": "10.51.11",
      "catalog_group": "food",
      "name": "Товар",
      "unit": "шт",
      "stock": 100,
      "price": 1500.00,
      "price_wholesale": 1350.00
    }
  ]
}

Синонимы: article ≡ sku, quantity ≡ stock, external_id ≡ id, nkt ≡ nkt_code, tnved ≡ tnved_code, kpved ≡ kpved_code, group ≡ catalog_group (slug: food, household, auto…).

REST API товаров

• POST /api/products — один товар (те же поля, включая коды НКТ/ТНВЭД/КПВЭД и штрихкод)
• POST /api/products/bulk — пакетная загрузка массива products
• PUT /api/products/{id} — обновление
• GET /api/products — список с поиском ?q= (название, SKU, штрихкод, коды)

Остатки и цены

POST /api/v1/stocks
{ "stocks": [ { "sku": "ART-001", "stock": 95 } ] }

POST /api/v1/prices
{ "prices": [ { "sku": "ART-001", "price": 1550, "price_wholesale": 1400 } ] }

Заказы

• GET /api/v1/orders/download — выгрузка заказов в 1С
• POST /api/v1/orders/upload — обратная загрузка/подтверждение

Исходники расширения

В комплекте поставки есть папка integrations/1c-extension/ с BSL-модулями и API_CONTRACT.md. Готовый .cfe собирается в Конфигураторе 1С.

Открыть Swagger FAQ