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

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

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

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

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

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

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

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

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

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

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

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

  • 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"
      }
    }

  • 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"
    }

  • GigaChat фильтрует мерчантов и подбирает наиболее релевантных в зависимости от запроса и предпочтений клиента.

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

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

  • 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"
      }
    }

  • 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"
    }

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

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

  • 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"
  }
}

  • 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

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

  • GigaChat отправляет запрос create_cart_mandate с полным содержимым корзины.

  • 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"
            ]
          }
        }
      }
    }

  • Сервер подписывает мандат цифровой подписью мерчанта:

    {
      "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"
    }

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

  • Клиент подтверждает заказ и подписывает мандат в приложении Сбера.

  • GigaChat отправляет запрос share_fully_signed_mandate с полностью подписанным мандатом.

  • 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"
    }

  • Система подтверждает сохранение мандата и выдает идентификатор для доступа:

    {
      "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"
    }

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

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

  • 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
  }
}

  • 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"
}

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

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

  • 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"
}

  • 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 в настройках своего браузера.