Перейти к содержанию

Orders (GET/POST)

Эндпоинты для работы с заказами: получение новых заказов, поступивших из внешних систем, и отправка обновлений статусов из системы клиента.

Получение Новых Заказов

Метод для получения списка заказов, которые были созданы во внешних системах и переданы в 1Bridge, но еще не были загружены в систему 1С клиента (например, находятся в статусе "Новый").

GET /orders HTTP/1.1
Host: api.1bridge.net
Authorization: Bearer {your_access_token}
X-Partner-Id: {your_partner_id}
Accept: application/json
# Дополнительные Query параметры для фильтрации (опционально):
# ?status=new&limit=50&since=2025-04-20T10:00:00Z

Request

GET /orders

Headers

  • Authorization: Required. Bearer Token.
  • X-Partner-Id: Required. Partner ID.
  • Accept: Optional. application/json.

Query Parameters (Optional)

  • status: Фильтр по статусу заказа (например, new, processing).
  • limit: Ограничение количества возвращаемых заказов.
  • since: Получить заказы, созданные или измененные после указанной даты/времени (формат ISO 8601).
  • (Добавьте другие параметры фильтрации/пагинации, если они планируются)

Response (200 OK)

Успешный ответ содержит массив объектов заказов.

{
  "orders": [
    {
      "id": "ext-order-12345", // ID заказа из внешней системы
      "internalId": "uuid-1bridge-order-abc", // Внутренний ID заказа в 1Bridge
      "source": "Glovo", // Источник заказа
      "status": "new",
      "createdAt": "2025-04-21T12:00:00Z",
      "customer": { ... }, // Данные клиента
      "items": [ ... ], // Состав заказа
      "deliveryInfo": { ... }, // Информация о доставке
      "totalPrice": 1500.00
      // ... другие поля заказа ...
    }
  ],
  "pagination": { // Опционально, если есть пагинация
      "hasNext": true,
      "nextToken": "some_token"
  }
}

Обновление Статуса Заказа

Метод для отправки информации об изменении статуса заказа из системы клиента (1С) в 1Bridge. 1Bridge затем передаст этот статус во внешний сервис.

POST /orders HTTP/1.1
Host: api.1bridge.net
Authorization: Bearer {your_access_token}
X-Partner-Id: {your_partner_id}
Content-Type: application/json

{
  "updates": [
    {
       "internalId": "uuid-1bridge-order-abc", // Внутренний ID заказа в 1Bridge
       "externalId": "ext-order-12345", // (Опционально) ID заказа во внешней системе
       "status": "confirmed", // Новый статус заказа
       "comment": "Заказ подтвержден оператором", // Опциональный комментарий
       "updatedAt": "2025-04-21T13:30:00Z" // Время обновления статуса в 1С
    }
    // ... другие обновления статусов ...
  ]
}

Request

POST /orders

Headers

  • Authorization: Required. Bearer Token.
  • X-Partner-Id: Required. Partner ID.
  • Content-Type: Required. application/json.

Body Parameters

  • updates: Required. Массив объектов с обновлениями статусов.

    • internalId или externalId: Required (хотя бы один). Идентификатор заказа. Рекомендуется использовать internalId, полученный при GET /orders.
    • status: Required (string). Новый статус заказа. Определите допустимые значения статусов (confirmed, assembling, shipped, delivered, cancelled, etc.).
    • comment: Optional (string). Комментарий к смене статуса.
    • updatedAt: Optional (string, ISO 8601). Время фактического изменения статуса в системе клиента.

Responses

  • 200 OK: Обновления статусов приняты к обработке.
  • 400 Bad Request: Ошибка в формате данных или не найден заказ.
  • 401 Unauthorized: Ошибка аутентификации.
  • 403 Forbidden: Нет прав.
  • 500 Internal Server Error: Внутренняя ошибка.

(Подробное описание кодов ошибок см. в разделе Error Codes)