# Получение информации о заказе
:::warning
  В инструкции описаны **примеры** POST-запросов. Интеграция с Mindbox не будет работать, если использовать запросы из примеров ниже без редактирования.

  Операции именно под вашу задачу создает и описывает в техническом задании менеджер проекта, если у вас нет такого документа, то обратитесь к вашему менеджеру.
:::

## Описание метода

Осуществляется с помощью POST-запроса. Название операции настраивается в системе Майндбокс. Подробней про вызов метода можно прочитать [здесь](https://developers.mindbox.ru/docs/v3).

Метод соответствует операции с набором шагов  "Заказ - Получить существующий заказ - Добавить в ответ операции данные - Информация о заказе".

```xml title="Универсальная операция"
POST https://api.mindbox.ru/v3/operations/sync?endpointId={уникальный идентификатор сайта/мобильного приложения/и т.п.}&operation={название операции}

Accept: application/xml
Content-Type: application/xml
Authorization: SecretKey {Секретный ключ, обязательность уточнить у менеджера}

<operation>
  <order>
    <ids>
      <{название поля-идентификатора}>{Значение в поле-идентификаторе}</{название поля-идентификатора}>
    </ids>
  </order>
</operation>
```

В запросе передается один из идентификаторов заказа.

## Пример операции

```xml title="Получение истории заказов"
POST https://api.mindbox.ru/v3/operations/sync?endpointId=MindboxRu&operation=GetOrderInfo

Accept: application/xml
Content-Type: application/xml

<operation>
  <order>
    <ids>
      <webSiteId>1543</webSiteId>
    </ids>
  </order>
</operation>
```

## Ответ

```xml title="Получение информации о заказе"
<result>
    <status>Success</status>
<order>
    <processingStatus>Found</processingStatus>
    <ids>
        <mindboxId>{ID заказа в Mindbox}</mindboxId>
        <myWebSiteId>{ID заказа на сайте}</myWebSiteId>
    </ids>
    <lines>
        <line>
            <product>
                <ids>
                    <mindboxId>{ID товара в Mindbox}</mindboxId>
                    <myWebSiteId>{ID товара на сайте}</myWebSiteId>
                </ids>
            </product>
            <sku>
                <ids>
                    <mindboxId>{ID SKU в Mindbox}</mindboxId>
                    <myWebSiteId>{ID SKU на сайте}</myWebSiteId>
                </ids>
            </sku>
            <basePricePerItem>{Базовая цена за единицу товара}</basePricePerItem>
            <priceOfLine>{Конечная цена за линию чека}</priceOfLine>
            <quantity>{Количество}</quantity>
            <status>
                <ids>
                    <externalId>{Статус покупки}</externalId>
                </ids>
            </status>
            <appliedPromotions>
                <appliedPromotion>{Примененная промоакция к позиции заказа. Описание узла в отдельной таблице.}</appliedPromotion>
            </appliedPromotions>
        </line>
    </lines>
    <appliedPromotions>
        <appliedPromotion>{Примененная промоакция к заказу. Описание узла в отдельной таблице.}</appliedPromotion>
    </appliedPromotions>
    <payments>
        <payment>
            <type>{Идентификатор способ оплаты}</type>
            <amount>{Размер платежа}</amount>
        </payment>
    </payments>
    <bonusPointsInfoPerBalanceType>
        <bonusPointsInfo>
            <spentAmount>{Сумма потраченных баллов с конкретного балльного счета за заказ на настоящий момент времени}</spentAmount>
            <earnedAmount>{Сумма начисленных баллов на конкретный балльный счет за заказ на настоящий момент времени}</earnedAmount>
            <balanceType>
                <name>{Название балльного счета}</name>
                <ids>
                    <systemName>{Системное имя балльного счета}</systemName>
                </ids>
            </balanceType>
        </bonusPointsInfo>
        <bonusPointsInfo>
            <spentAmount>{Сумма потраченных баллов с конкретного балльного счета за заказ на настоящий момент времени}</spentAmount>
            <earnedAmount>{Сумма начисленных баллов на конкретный балльный счет за заказ на настоящий момент времени}</earnedAmount>
            <balanceType>
                <name>{Название балльного счета}</name>
                <ids>
                    <systemName>{Системное имя балльного счета}</systemName>
                </ids>
            </balanceType>
        </bonusPointsInfo>
    </bonusPointsInfoPerBalanceType>
    <totalPrice>{Стоимость заказа с учетом скидок (после вычета отмененных и возвращенных позиций)}</totalPrice>
</order>
</result>
```

## Примененные промоакции

:::info
  В **appliedPromotions**  в узле **type** указывается тип примененной промоакции.

  Если с примененной промоакцией связан промокод, он вернется в ответе. При использовании внешних промокодов, процессинг которых не на стороне Майндбокс, узел **promotion** будет отсуствовать.

  Поддерживаются следующие типы:

  * **discount** — скидка, может применяться только к позиции заказа
  * **deliveryDiscount** — скидка, может применяться только на заказ
  * **earnedBonusPoints** — начисление бонусных баллов за заказов
  * **spentBonusPoints** — списание бонусных баллов для оплаты заказа
  * **issuedCoupon** — выданный купон за заказ
  * **message** — сообщение покупателю
:::

<Tabs defaultValue="discount" className="w-full">
    <TabsList className="flex w-max gap-2">
      <TabsTrigger value="discount">discount</TabsTrigger>
      <TabsTrigger value="deliveryDiscount">deliveryDiscount</TabsTrigger>
      <TabsTrigger value="earnedBonusPoints">earnedBonusPoints</TabsTrigger>
      <TabsTrigger value="spentBonusPoints">spentBonusPoints</TabsTrigger>
      <TabsTrigger value="issuedCoupon">issuedCoupon</TabsTrigger>
      <TabsTrigger value="message">message</TabsTrigger>
    </TabsList>
  <TabsContent value="discount">
```xml
<appliedPromotion>
  <type>discount</type>
  <coupon>
    <ids>
      <code>{Промокод}</code>
    </ids>
    <pool>
      <ids>
        <mindboxId>{Идентификатор Mindbox}</mindboxId>
        <externalId>{Внешний идентификатор пула промокодов}</externalId>
      </ids>
      <name>{Наименование пула промокодов}</name>
      <description>{Описание пула промокодов}</description>
    </pool>
  </coupon>
  <promotion>
    <ids>
      <mindboxId>{Идентификатор Mindbox}</mindboxId>
      <externalId>{Внешний идентификатор промоакции}</externalId>
    </ids>
    <name>{Наименование промоакции}</name>
    <type>{Тип промоакции}</type>
  </promotion>
  <amount>{Размер скидки}</amount>
</appliedPromotion>
```
   </TabsContent>
  <TabsContent value="deliveryDiscount">
```xml 
<appliedPromotion>
  <type>deliveryDiscount</type>
  <coupon>
    <ids>
      <code>{Промокод}</code>
    </ids>
    <pool>
      <ids>
        <mindboxId>{Идентификатор Mindbox}</mindboxId>
        <externalId>{Внешний идентификатор пула промокодов}</externalId>
      </ids>
      <name>{Наименование пула промокодов}</name>
      <description>{Описание пула промокодов}</description>
    </pool>
  </coupon>
  <promotion>
    <ids>
      <mindboxId>{Идентификатор Mindbox}</mindboxId>
      <externalId>{Внешний идентификатор промоакции}</externalId>
    </ids>
    <name>{Наименование промоакции}</name>
    <type>{Тип промоакции}</type>
  </promotion>
  <amount>{Размер скидки}</amount>
</appliedPromotion>
```
   </TabsContent>
  <TabsContent value="earnedBonusPoints">
```xml 
<appliedPromotion>
  <type>earnedBonusPoints</type>
  <coupon>
    <ids>
      <code>{Промокод}</code>
    </ids>
    <pool>
      <ids>
        <mindboxId>{Идентификатор Mindbox}</mindboxId>
        <externalId>{Внешний идентификатор пула промокодов}</externalId>
      </ids>
      <name>{Наименование пула промокодов}</name>
      <description>{Описание пула промокодов}</description>
    </pool>
  </coupon>
  <promotion>
    <ids>
      <mindboxId>{Идентификатор Mindbox}</mindboxId>
      <externalId>{Внешний идентификатор промоакции}</externalId>
    </ids>
    <name>{Наименование промоакции}</name>
    <type>{Тип промоакции}</type>
  </promotion>
  <balanceType>
    <ids>
      <systemName>{Системное имя балльного счёта}</systemName>
    </ids>
    <name>{Название балльного счёта}</name>
  </balanceType>
  <amount>{Количество начисленных баллов}</amount>
  <expirationDateTimeUtc>{Дата сгорания начисленных баллов}</expirationDateTimeUtc>
</appliedPromotion>
```
   </TabsContent>
  <TabsContent value="spentBonusPoints">
```xml 
<appliedPromotion>
  <type>spentBonusPoints</type>
  <coupon>
    <ids>
      <code>{Промокод}</code>
    </ids>
    <pool>
      <ids>
        <mindboxId>{Идентификатор Mindbox}</mindboxId>
        <externalId>{Внешний идентификатор пула промокодов}</externalId>
      </ids>
      <name>{Наименование пула промокодов}</name>
      <description>{Описание пула промокодов}</description>
    </pool>
  </coupon>
  <promotion>
    <ids>
      <mindboxId>{Идентификатор Mindbox}</mindboxId>
      <externalId>{Внешний идентификатор промоакции}</externalId>
    </ids>
    <name>{Наименование промоакции}</name>
    <type>{Тип промоакции}</type>
  </promotion>
  <balanceType>
    <ids>
      <systemName>{Системное имя балльного счёта}</systemName>
    </ids>
    <name>{Название балльного счёта}</name>
  </balanceType>
  <amount>{Количество потраченных баллов}</amount>
</appliedPromotion>
```
   </TabsContent>
  <TabsContent value="issuedCoupon">
```xml 
<appliedPromotion>
  <type>issuedCoupon</type>
  <coupon>
    <ids>
      <code>{Промокод}</code>
    </ids>
    <pool>
      <ids>
        <mindboxId>{Идентификатор Mindbox}</mindboxId>
        <externalId>{Внешний идентификатор пула промокодов}</externalId>
      </ids>
      <name>{Наименование пула промокодов}</name>
      <description>{Описание пула промокодов}</description>
    </pool>
  </coupon>
  <promotion>
    <ids>
      <mindboxId>{Идентификатор Mindbox}</mindboxId>
      <externalId>{Внешний идентификатор промоакции}</externalId>
    </ids>
    <name>{Наименование промоакции}</name>
    <type>{Тип промоакции}</type>
  </promotion>
  <issuedCoupon>
    <ids>
      <code>{Выданный промокод}</code>
    </ids>
    <pool>
      <ids>
        <mindboxId>{Идентификатор Mindbox}</mindboxId>
        <externalId>{Внешний идентификатор пула промокодов}</externalId>
      </ids>
      <name>{Наименование пула промокодов}</name>
      <description>{Описание пула промокодов}</description>
    </pool>
  </issuedCoupon>
</appliedPromotion>
```
   </TabsContent>
  <TabsContent value="message">
```xml 
<appliedPromotion>
  <type>message</type>
  <coupon>
    <ids>
      <code>{Промокод}</code>
    </ids>
    <pool>
      <ids>
        <mindboxId>{Идентификатор Mindbox}</mindboxId>
        <externalId>{Внешний идентификатор пула промокодов}</externalId>
      </ids>
      <name>{Наименование пула промокодов}</name>
      <description>{Описание пула промокодов}</description>
    </pool>
  </coupon>
  <promotion>
    <ids>
      <mindboxId>{Идентификатор Mindbox}</mindboxId>
      <externalId>{Внешний идентификатор промоакции}</externalId>
    </ids>
    <name>{Наименование промоакции}</name>
    <type>{Тип промоакции}</type>
  </promotion>
</appliedPromotion>
```
   </TabsContent>
</Tabs>