ym88659208ym87991671
Интеграция с MCP серверами партнера | Документация для разработчиков
Развернуть

Интеграция с MCP серверами партнера

Обновлено 19 ноября 2025

Данная спецификация описывает протокол взаимодействия между GigaChat и MCP (Model Context Protocol) серверами партнеров.

Все MCP-серверы должны:

  • поддерживать UUID v4 для rqUid;
  • обрабатывать cтандартные коды ошибок;
  • соответствовать протоколу MCP.

Перед прочтением рекомендуем ознакомиться с основами протоколов MCP и JSON-RPC 2.0.

Инициализация покупки

Для инициализации покупки:

  1. Клиент запускает процесс покупки через интерфейс GigaChat (мобильное приложение/веб-сайт).
  2. GigaChat получает начальные данные: выбранные товары, предпочтения клиента.

Получение информации о мерчанте

Процесс получения информации о мерчанте:

  1. GigaChat отправляет запрос get_merchant_info на MCP-сервер с целью получить детальную информацию о мерчанте:
  • название компании и описание;
  • доступные методы доставки;
  • поддерживаемые способы оплаты;
  • интеграции с экосистемой Сбера.
{
  "rqUid": "123e4567-e89b-12d3-a456-426614174000",
  "rqTm": "2025-11-19T10:15:30Z",
  "clientInfo": {
    "clientInfoToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "sberId": "sber_user_123456789",
    "accessToken": "merchant_access_token_abc123"
  }
}
  1. MCP-сервер возвращает структурированные данные о мерчанте.
{
  "jsonrpc": 2,
  "result": {
    "rqUid": "123e4567-e89b-12d3-a456-426614174000",
    "rsTm": "2025-11-19T14:30:00Z",
    "merchantInfo": {
      "merchantName": "ООО 'Электронный Мир'",
      "website": "https://electronworld.ru",
      "description": "Крупнейший онлайн-ритейлер электроники в России",
      "mainCategories": [
        "electronics",
        "smartphones",
        "laptops"
      ],
      "allCategories": [
        "smartphones",
        "tablets",
        "laptops"
      ],
      "supportedBrands": [
        "samsung",
        "apple",
        "xiaomi"
      ],
      "deliveryRegions": [
        "Москва",
        "Московская область"
      ],
      "deliveryMethods": [
        {
          "type": "courier",
          "name": "Курьерская доставка",
          "minDays": 1,
          "maxDays": 3,
          "costTable": [
            {
              "orderAmountMin": 0,
              "orderAmountMax": 5000,
              "deliveryCost": 299
            }
          ],
          "costNotes": "Бесплатная доставка при заказе от 5000 руб"
        }
      ],
      "paymentOptions": {
        "online": {
          "supported": true,
          "methods": [
            "card",
            "sberpay",
            "bnpl"
          ]
        },
        "courier": {
          "supported": true,
          "methods": [
            "card",
            "cash",
            "sberpay"
          ]
        },
        "pickup": {
          "supported": true,
          "methods": [
            "card",
            "cash",
            "sberpay"
          ]
        }
      },
      "sberIntegrations": {
        "sberIdSupported": true,
        "sberpaySupported": true,
        "sberPrimeSupported": true,
        "sberLoyaltySupported": true
      },
      "contactInfo": {
        "phone": "+7-495-123-45-67",
        "email": "support@electronworld.ru"
      },
      "additionalInfo": {
        "loyaltyProgram": true,
        "giftCards": true,
        "establishedDate": "2015-03-15",
        "giftWrapping": true,
        "installation": true,
        "tradeIn": true
      }
    },
    "matchReasons": [
      "специализация_на_электронике",
      "поддержка_sberpay"
    ]
  },
  "id": "req_120"
}
  1. GigaChat фильтрует мерчантов и подбирает наиболее релевантных в зависимости от запроса и предпочтений клиента.

Подбор SKU товаров

Подбор SKU (артикулы) товаров:

  1. GigaChat отправляет запрос get_skus с информацией о товарах, чтобы получить конкретные SKU (артикулы) товаров с:
  • актуальными ценами;
  • наличием на складе;
  • информацией о доставке;
  • атрибутами товаров.
{
  "rqUid": "123e4567-e89b-12d3-a456-426614174000",
  "rqTm": "2025-11-19T10:15:30Z",
  "clientInfo": {
    "clientInfoToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "sberId": "sber_user_123456789",
    "accessToken": "merchant_access_token_abc123"
  },
  "products": [
    {
      "productId": "prod_12345",
      "name": "Смартфон Samsung Galaxy S24 Ultra",
      "category": "smartphones",
      "limit": 5,
      "quantity": {
        "value": 1.5,
        "unit": "kg",
        "type": "weight"
      },
      "attributes": {
        "brand": "samsung",
        "color": "черный",
        "storage": "256gb",
        "releaseDate": "2024-01-17"
      }
    }
  ],
  "context": {
    "sessionId": "sess_abc123"
  }
}
  1. MCP-сервер сопоставляет товары с внутренней системой мерчанта.
{
  "jsonrpc": 2,
  "result": {
    "rqUid": "123e4567-e89b-12d3-a456-426614174000",
    "rsTm": "2025-11-19T10:16:05Z",
    "productSkus": {
      "prod_12345": [
        {
          "skuId": "sber_sku_67890",
          "productId": "prod_12345",
          "stockQuantity": 15
        }
      ]
    },
    "personalizationFactors": {
      "priceSensitivity": "medium",
      "preferredBrands": [
        "samsung",
        "apple"
      ]
    }
  },
  "id": "req_123"
}

Расчет стоимости доставки

Для расчета стоимости товара:

  1. GigaChat отправляет запрос calculate_delivery, чтобы получить точную стоимость и сроки доставки. Запрос содержит параметры доставки:
  • метод доставки (курьер, самовывоз, почта);
  • регион доставки;
  • общая сумма заказа;
  • габариты и вес товаров.
{
  "rqUid": "123e4567-e89b-12d3-a456-426614174000",
  "rqTm": "2025-11-19T10:15:30Z",
  "clientInfo": {
    "clientInfoToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "sberId": "sber_user_123456789",
    "accessToken": "merchant_access_token_abc123"
  },
  "deliveryInfo": {
    "deliveryMethod": "courier",
    "region": "Москва",
    "totalOrderAmount": 12000.5,
    "totalWeight": 2.5,
    "totalVolume": 0.02,
    "deliveryDate": "2025-11-20",
    "preferredDeliveryTime": "14:00-18:00"
  },
  "context": {
    "sessionId": "sess_abc123"
  }
}
  1. MCP-сервер рассчитывает стоимость на основе внутренних тарифов мерчанта:
{
  "jsonrpc": 2,
  "result": {
    "rqUid": "123e4567-e89b-12d3-a456-426614174000",
    "rsTm": "2025-11-19T09:45:30Z",
    "deliveryCost": 0,
    "deliveryTime": {
      "minDays": 1,
      "maxDays": 2,
      "estimatedDate": "2024-01-21",
      "estimatedDeliveryStart": "2024-01-21T10:00:00Z",
      "estimatedDeliveryEnd": "2024-01-21T14:00:00Z"
    },
    "costBreakdown": {
      "baseCost": 299,
      "distanceSurcharge": 0,
      "weightSurcharge": 0,
      "urgencySurcharge": 0,
      "freeThresholdApplied": true
    },
    "availableTimeSlots": [
      {
        "date": "2024-01-21",
        "slots": [
          "10:00-14:00",
          "14:00-18:00"
        ]
      }
    ],
    "restrictions": [
      "нет_доставки_в_выходные"
    ],
    "dynamicPricingInfo": {
      "isPeakHours": false,
      "demandMultiplier": 1,
      "priceValidUntil": "2025-11-19T23:59:59Z"
    }
  },
  "id": "req_130"
}

Создание и подписание CartMandate

Для создания мандата корзины:

  1. GigaChat отправляет запрос create_cart_mandate с полным содержимым корзины.
  2. MCP-сервер создает CartMandate — юридически значимый документ, который фиксирует:
  • состав заказа;
  • цены товаров;
  • условия доставки;
  • срок действия корзины.
{
  "rqUid": "123e4567-e89b-12d3-a456-426614174000",
  "rqTm": "2025-11-19T10:15:30Z",
  "clientInfo": {
    "clientInfoToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "sberId": "sber_user_123456789",
    "accessToken": "merchant_access_token_abc123"
  },
  "cartContents": {
    "id": "cart_12345",
    "userCartConfirmationRequired": true,
    "merchantName": "ООО 'Электронный Мир'",
    "cartExpiry": "2025-11-19T11:15:30Z",
    "paymentRequest": {
      "methodData": [
        {
          "supportedMethods": "sberpay",
          "data": {}
        }
      ],
      "details": {
        "id": "payment_12345",
        "displayItems": [
          {
            "label": "Смартфон Samsung Galaxy S24 Ultra",
            "amount": {
              "currency": "RUB",
              "value": 89999.99
            },
            "pending": false,
            "refundPeriod": 30
          }
        ],
        "shippingOptions": [
          {
            "id": "courier_moscow",
            "label": "Курьерская доставка по Москве",
            "amount": {
              "currency": "RUB",
              "value": 89999.99
            },
            "selected": true
          }
        ],
        "modifiers": [
          {
            "supportedMethods": "sberpay",
            "total": {
              "label": "Смартфон Samsung Galaxy S24 Ultra",
              "amount": {
                "currency": "RUB",
                "value": 89999.99
              },
              "pending": false,
              "refundPeriod": 30
            },
            "additionalDisplayItems": [
              {
                "label": "Смартфон Samsung Galaxy S24 Ultra",
                "amount": {
                  "currency": "RUB",
                  "value": 89999.99
                },
                "pending": false,
                "refundPeriod": 30
              }
            ],
            "data": {}
          }
        ],
        "total": {
          "label": "Смартфон Samsung Galaxy S24 Ultra",
          "amount": {
            "currency": "RUB",
            "value": 89999.99
          },
          "pending": false,
          "refundPeriod": 30
        }
      },
      "options": {
        "requestPayerName": true,
        "requestPayerEmail": true,
        "requestPayerPhone": false,
        "requestShipping": true,
        "shippingType": "delivery"
      },
      "shippingAddress": {
        "city": "Москва",
        "country": "RU",
        "dependentLocality": "string",
        "organization": "string",
        "phoneNumber": "+7-495-123-45-67",
        "postalCode": "123456",
        "recipient": "Иван Иванов",
        "region": "Москва",
        "sortingCode": "string",
        "addressLine": [
          "ул. Тверская, д. 1"
        ]
      }
    }
  }
}
  1. Сервер подписывает мандат цифровой подписью мерчанта:
{
  "jsonrpc": 2,
  "result": {
    "rqUid": "c07273ac-91d8-45d3-b9b7-d0807017c49f",
    "rsTm": "2019-08-24T14:15:22Z",
    "merchantSignedMandate": {
      "contents": {
        "id": "cart_12345",
        "userCartConfirmationRequired": true,
        "merchantName": "ООО 'Электронный Мир'",
        "cartExpiry": "2025-11-19T11:15:30Z",
        "paymentRequest": {
          "methodData": [
            {
              "supportedMethods": "sberpay",
              "data": {}
            }
          ],
          "details": {
            "id": "payment_12345",
            "displayItems": [
              {
                "label": "Смартфон Samsung Galaxy S24 Ultra",
                "amount": {
                  "currency": "RUB",
                  "value": 89999.99
                },
                "pending": false,
                "refundPeriod": 30
              }
            ],
            "shippingOptions": [
              {
                "id": "courier_moscow",
                "label": "Курьерская доставка по Москве",
                "amount": {
                  "currency": "RUB",
                  "value": 89999.99
                },
                "selected": true
              }
            ],
            "modifiers": [
              {
                "supportedMethods": "sberpay",
                "total": {
                  "label": "Смартфон Samsung Galaxy S24 Ultra",
                  "amount": {},
                  "pending": false,
                  "refundPeriod": 30
                },
                "additionalDisplayItems": [
                  {}
                ],
                "data": {}
              }
            ],
            "total": {
              "label": "Смартфон Samsung Galaxy S24 Ultra",
              "amount": {
                "currency": "RUB",
                "value": 89999.99
              },
              "pending": false,
              "refundPeriod": 30
            }
          },
          "options": {
            "requestPayerName": true,
            "requestPayerEmail": true,
            "requestPayerPhone": false,
            "requestShipping": true,
            "shippingType": "delivery"
          },
          "shippingAddress": {
            "city": "Москва",
            "country": "RU",
            "dependentLocality": "string",
            "organization": "string",
            "phoneNumber": "+7-495-123-45-67",
            "postalCode": "123456",
            "recipient": "Иван Иванов",
            "region": "Москва",
            "sortingCode": "string",
            "addressLine": [
              "ул. Тверская, д. 1"
            ]
          }
        }
      },
      "merchantAuthorization": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjIwMjQwOTA..."
    },
    "mandateId": "mandate_12345"
  },
  "id": "req_400"
}

Процесс распределения подписанного мандата:

  1. Клиент подтверждает заказ и подписывает мандат в приложении Сбера.
  2. GigaChat отправляет запрос share_fully_signed_mandate с полностью подписанным мандатом.
  3. MCP-сервер сохраняет мандат в системе мерчанта для разрешения диспутов:
{
  "rqUid": "123e4567-e89b-12d3-a456-426614174000",
  "rqTm": "2025-11-19T10:15:30Z",
  "clientInfo": {
    "clientInfoToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "sberId": "sber_user_123456789",
    "accessToken": "merchant_access_token_abc123"
  },
  "merchantSignedMandate": {
    "contents": {
      "id": "cart_12345",
      "userCartConfirmationRequired": true,
      "merchantName": "ООО 'Электронный Мир'",
      "cartExpiry": "2025-11-19T11:15:30Z",
      "paymentRequest": {
        "methodData": [
          {
            "supportedMethods": "sberpay",
            "data": {}
          }
        ],
        "details": {
          "id": "payment_12345",
          "displayItems": [
            {
              "label": "Смартфон Samsung Galaxy S24 Ultra",
              "amount": {
                "currency": "RUB",
                "value": 89999.99
              },
              "pending": false,
              "refundPeriod": 30
            }
          ],
          "shippingOptions": [
            {
              "id": "courier_moscow",
              "label": "Курьерская доставка по Москве",
              "amount": {
                "currency": "RUB",
                "value": 89999.99
              },
              "selected": true
            }
          ],
          "modifiers": [
            {
              "supportedMethods": "sberpay",
              "total": {
                "label": "Смартфон Samsung Galaxy S24 Ultra",
                "amount": {
                  "currency": "RUB",
                  "value": 89999.99
                },
                "pending": false,
                "refundPeriod": 30
              },
              "additionalDisplayItems": [
                {
                  "label": "Смартфон Samsung Galaxy S24 Ultra",
                  "amount": {},
                  "pending": false,
                  "refundPeriod": 30
                }
              ],
              "data": {}
            }
          ],
          "total": {
            "label": "Смартфон Samsung Galaxy S24 Ultra",
            "amount": {
              "currency": "RUB",
              "value": 89999.99
            },
            "pending": false,
            "refundPeriod": 30
          }
        },
        "options": {
          "requestPayerName": true,
          "requestPayerEmail": true,
          "requestPayerPhone": false,
          "requestShipping": true,
          "shippingType": "delivery"
        },
        "shippingAddress": {
          "city": "Москва",
          "country": "RU",
          "dependentLocality": "string",
          "organization": "string",
          "phoneNumber": "+7-495-123-45-67",
          "postalCode": "123456",
          "recipient": "Иван Иванов",
          "region": "Москва",
          "sortingCode": "string",
          "addressLine": [
            "ул. Тверская, д. 1"
          ]
        }
      }
    },
    "merchantAuthorization": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjIwMjQwOTA..."
  },
  "mandateId": "mandate_12345"
}
  1. Система подтверждает сохранение мандата и выдает идентификатор для доступа:
{
  "jsonrpc": 2,
  "result": {
    "rqUid": "c07273ac-91d8-45d3-b9b7-d0807017c49f",
    "rsTm": "2019-08-24T14:15:22Z",
    "fullySignedMandate": {
      "contents": {
        "id": "cart_12345",
        "userCartConfirmationRequired": true,
        "merchantName": "ООО 'Электронный Мир'",
        "cartExpiry": "2025-11-19T11:15:30Z",
        "paymentRequest": {
          "methodData": [
            {
              "supportedMethods": "sberpay",
              "data": {}
            }
          ],
          "details": {
            "id": "payment_12345",
            "displayItems": [
              {
                "label": "Смартфон Samsung Galaxy S24 Ultra",
                "amount": {
                  "currency": "RUB",
                  "value": 89999.99
                },
                "pending": false,
                "refundPeriod": 30
              }
            ],
            "shippingOptions": [
              {
                "id": "courier_moscow",
                "label": "Курьерская доставка по Москве",
                "amount": {
                  "currency": "RUB",
                  "value": 89999.99
                },
                "selected": true
              }
            ],
            "modifiers": [
              {
                "supportedMethods": "sberpay",
                "total": {
                  "label": "Смартфон Samsung Galaxy S24 Ultra",
                  "amount": {},
                  "pending": false,
                  "refundPeriod": 30
                },
                "additionalDisplayItems": [
                  {}
                ],
                "data": {}
              }
            ],
            "total": {
              "label": "Смартфон Samsung Galaxy S24 Ultra",
              "amount": {
                "currency": "RUB",
                "value": 89999.99
              },
              "pending": false,
              "refundPeriod": 30
            }
          },
          "options": {
            "requestPayerName": true,
            "requestPayerEmail": true,
            "requestPayerPhone": false,
            "requestShipping": true,
            "shippingType": "delivery"
          },
          "shippingAddress": {
            "city": "Москва",
            "country": "RU",
            "dependentLocality": "string",
            "organization": "string",
            "phoneNumber": "+7-495-123-45-67",
            "postalCode": "123456",
            "recipient": "Иван Иванов",
            "region": "Москва",
            "sortingCode": "string",
            "addressLine": [
              "ул. Тверская, д. 1"
            ]
          }
        }
      },
      "merchantAuthorization": "string",
      "userAuthorization": "string",
      "mandateId": "mandate_12345"
    },
    "storageConfirmation": {
      "clientStored": true,
      "storageLocation": "sber_app",
      "storedAt": "2025-11-19T10:05:00Z"
    }
  },
  "id": "req_410"
}

Создание заказа и обработка платежа

Чтобы создать и обработать платеж:

  1. GigaChat отправляет запрос create_order с:
  • полностью подписанным CartMandate;
  • выбранным способом доставки;
  • контактной информацией;
  • методом оплаты.
{
  "rqUid": "123e4567-e89b-12d3-a456-426614174000",
  "rqTm": "2025-11-19T10:15:30Z",
  "clientInfo": {
    "clientInfoToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "sberId": "sber_user_123456789",
    "accessToken": "merchant_access_token_abc123"
  },
  "fullySignedMandate": {
    "contents": {
      "id": "cart_12345",
      "userCartConfirmationRequired": true,
      "merchantName": "ООО 'Электронный Мир'",
      "cartExpiry": "2025-11-19T11:15:30Z",
      "paymentRequest": {
        "methodData": [
          {
            "supportedMethods": "sberpay",
            "data": {}
          }
        ],
        "details": {
          "id": "payment_12345",
          "displayItems": [
            {
              "label": "Смартфон Samsung Galaxy S24 Ultra",
              "amount": {
                "currency": "RUB",
                "value": 89999.99
              },
              "pending": false,
              "refundPeriod": 30
            }
          ],
          "shippingOptions": [
            {
              "id": "courier_moscow",
              "label": "Курьерская доставка по Москве",
              "amount": {
                "currency": "RUB",
                "value": 89999.99
              },
              "selected": true
            }
          ],
          "modifiers": [
            {
              "supportedMethods": "sberpay",
              "total": {
                "label": "Смартфон Samsung Galaxy S24 Ultra",
                "amount": {
                  "currency": "RUB",
                  "value": 89999.99
                },
                "pending": false,
                "refundPeriod": 30
              },
              "additionalDisplayItems": [
                {
                  "label": "Смартфон Samsung Galaxy S24 Ultra",
                  "amount": {},
                  "pending": false,
                  "refundPeriod": 30
                }
              ],
              "data": {}
            }
          ],
          "total": {
            "label": "Смартфон Samsung Galaxy S24 Ultra",
            "amount": {
              "currency": "RUB",
              "value": 89999.99
            },
            "pending": false,
            "refundPeriod": 30
          }
        },
        "options": {
          "requestPayerName": true,
          "requestPayerEmail": true,
          "requestPayerPhone": false,
          "requestShipping": true,
          "shippingType": "delivery"
        },
        "shippingAddress": {
          "city": "Москва",
          "country": "RU",
          "dependentLocality": "string",
          "organization": "string",
          "phoneNumber": "+7-495-123-45-67",
          "postalCode": "123456",
          "recipient": "Иван Иванов",
          "region": "Москва",
          "sortingCode": "string",
          "addressLine": [
            "ул. Тверская, д. 1"
          ]
        }
      }
    },
    "merchantAuthorization": "string",
    "userAuthorization": "string",
    "mandateId": "mandate_12345"
  },
  "deliveryOption": {
    "method": "courier",
    "shippingOptionId": "courier_moscow",
    "preferredDeliveryDate": "2025-11-20",
    "timeSlot": "14:00-18:00"
  },
  "contactInfo": {
    "shippingAddress": {
      "city": "Москва",
      "country": "RU",
      "dependentLocality": "string",
      "organization": "string",
      "phoneNumber": "+7-495-123-45-67",
      "postalCode": "123456",
      "recipient": "Иван Иванов",
      "region": "Москва",
      "sortingCode": "string",
      "addressLine": [
        "ул. Тверская, д. 1"
      ]
    },
    "recipientName": "Иван Иванов",
    "phone": "+7-495-123-45-67",
    "email": "ivan@example.com"
  },
  "paymentMethod": {
    "method": "sberpay",
    "token": "pm_12345",
    "saveForFuture": true
  }
}
  1. MCP-сервер:
  • создает заказ в системе мерчанта;
  • инициирует платеж через интегрированную платежную систему;
  • резервирует товары на складе.

Результат — заказ создан, платеж обрабатывается:

{
  "jsonrpc": 2,
  "result": {
    "rqUid": "c07273ac-91d8-45d3-b9b7-d0807017c49f",
    "rsTm": "2019-08-24T14:15:22Z",
    "order": {
      "orderId": "order_12345",
      "mandateId": "mandate_12345",
      "status": "confirmed",
      "createdAt": "2025-11-19T10:30:00Z",
      "updatedAt": "2025-11-19T10:35:00Z",
      "totalAmount": {
        "currency": "RUB",
        "value": 89999.99
      },
      "items": [
        {
          "skuId": "sber_sku_67890",
          "productId": "prod_12345",
          "name": "Смартфон Samsung Galaxy S24 Ultra",
          "quantity": 1,
          "price": {
            "currency": "RUB",
            "value": 89999.99
          },
          "attributes": {
            "color": "черный",
            "storage": "256gb"
          }
        }
      ],
      "deliveryInfo": {
        "method": "courier",
        "shippingOptionId": "courier_moscow",
        "cost": {
          "currency": "RUB",
          "value": 89999.99
        },
        "address": {
          "city": "Москва",
          "country": "RU",
          "dependentLocality": "string",
          "organization": "string",
          "phoneNumber": "+7-495-123-45-67",
          "postalCode": "123456",
          "recipient": "Иван Иванов",
          "region": "Москва",
          "sortingCode": "string",
          "addressLine": [
            "ул. Тверская, д. 1"
          ]
        },
        "estimatedDelivery": "2024-01-21T14:00:00Z",
        "pickupPointId": "pickup_123"
      },
      "contactInfo": {
        "recipientName": "Иван Иванов",
        "phone": "+7-495-123-45-67",
        "email": "ivan@example.com"
      },
      "merchantNotes": "Товар будет упакован в подарочную упаковку"
    },
    "paymentInfo": {
      "paymentId": "pay_12345",
      "paymentUrl": "https://payment.merchant.com/pay/pay_12345",
      "paymentStatus": "pending",
      "amount": {
        "currency": "RUB",
        "value": 89999.99
      },
      "expiresAt": "2025-11-19T11:30:00Z"
    },
    "nextActions": [
      "redirect_to_payment"
    ]
  },
  "id": "req_500"
}

Отслеживание статуса заказа

Для отслеживания статуса заказа:

  1. GigaChat периодически отправляет запросы get_order_status, чтобы получить актуальную информацию о:
  • текущем статусе доставки;
  • расчетном времени доставки;
  • трекинг-номере для отслеживания;
  • информации о пункте выдачи (при самовывозе).
{
  "rqUid": "123e4567-e89b-12d3-a456-426614174000",
  "rqTm": "2025-11-19T10:15:30Z",
  "clientInfo": {
    "clientInfoToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "sberId": "sber_user_123456789",
    "accessToken": "merchant_access_token_abc123"
  },
  "orderId": "order_12345"
}
  1. MCP-сервер предоставляет статус в реальном времени:
{
  "jsonrpc": 2,
  "result": {
    "rqUid": "c07273ac-91d8-45d3-b9b7-d0807017c49f",
    "rsTm": "2019-08-24T14:15:22Z",
    "orderId": "order_12345",
    "deliveryStatus": "in_transit",
    "deliveryStatusDescription": "Заказ в пути до пункта выдачи",
    "estimatedDelivery": "2024-01-21T14:00:00Z",
    "lastUpdated": "2024-01-20T10:30:00Z",
    "trackingInfo": {
      "trackingNumber": "TRK123456789",
      "trackingUrl": "https://tracking.delivery.com/TRK123456789",
      "carrier": "CDEK"
    },
    "pickupPoint": {
      "id": "pickup_123",
      "name": "Пункт выдачи на Тверской",
      "address": "ул. Тверская, д. 1",
      "phone": "+7-495-123-45-67",
      "workingHours": "10:00-20:00"
    }
  },
  "id": "req_510"
}

Коды ошибок

В процессе работы могут возникать ошибки, описанные в таблице.

КодСообщениеОписание
-32001Invalid client info tokenНевалидный или просроченный JWT-токен
-32002Merchant not foundМерчант не найден
-32003Product not availableТовар недоступен
-32004Delivery not availableДоставка недоступна в указанный регион
-32005Cart mandate expiredСрок действия корзины истек
-32006Payment failedОшибка при обработке платежа
-32007Insufficient stockНедостаточно товара на складе
-32008Invalid mandate signatureНевалидная подпись мандата
-32009Order not foundЗаказ не найден
-32099Internal server errorВнутренняя ошибка сервера

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней

Это полезный материал?
Развернуть
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей. Вы можете запретить сохранение cookie в настройках своего браузера.