POST api/promoOffers

Метод для создания "Проактивной акции"

Полный URL-адрес запроса: https://sfa-api.ddapp.biz/api/promoOffers

  Для этого метода требуется авторизация

Информация о запросе

URL параметры

Нет

Тело запроса

CreatePromoOfferModel
НазваниеОписаниеТип данныхДополнительная информация
VendorId

string

Длина: от 1 до 100

Соответствует регулярному выражению: ^[a-zA-Zа-яА-Я0-9_-]+$
Type

PromoOfferTypeModel

Обязательное поле
Name

string

Обязательное поле

Максимальная длина: 150
Description

string

Максимальная длина: 1000
DateFrom

date

Обязательное поле
DateTill

date

Обязательное поле
CurrencyId

string

Обязательное поле

Максимальная длина: 3

Минимальная длина: 3
Priority

integer

Нет
IsRequired

boolean

Нет
IsMultiple

boolean

Нет
LimitTotal

integer

Нет
UsedLimitTotal

integer

Нет
LimitPerOrder

integer

Нет
LimitPerTradeOutlet

integer

Нет
SkuMin

integer

Нет
SkuMax

integer

Нет
CountMin

integer

Нет
CountMax

integer

Нет
PackagingId

string

Нет
PackagingMin

decimal number

Нет
PackagingMax

decimal number

Нет
EntityPropertyId

string

Нет
EntityPropertyMin

decimal number

Нет
EntityPropertyMax

decimal number

Нет
SumMin

decimal number

Нет
SumMax

decimal number

Нет
DiscountPerOrder

boolean

Нет
DiscountPerPositions

boolean

Нет
OverrideDiscounts

boolean

Нет
Discount

decimal number

Нет
DiscountsSumMax

decimal number

Нет
UsedDiscountsSum

decimal number

Нет
GiftsSumMax

decimal number

Нет
UsedGiftsSum

decimal number

Нет
PositionGroups

Collection of CreatePromoOfferPositionGroupModel

Нет
GiftGroups

Collection of CreateOfferGiftGroupModel

Нет
TradeOutlets

Collection of string

Нет
TradeOutletCategories

Collection of string

Нет
TradeOutletFormats

Collection of string

Нет
Provinces

Collection of globally unique identifier

Нет
Routes

Collection of string

Нет

Форматы запросов

{
  "vendorId": "sample string 1",
  "type": 0,
  "name": "sample string 2",
  "description": "sample string 3",
  "dateFrom": "2025-12-20T13:07:34.0193653Z",
  "dateTill": "2025-12-20T13:07:34.0193653Z",
  "currencyId": "sample string 6",
  "priority": 7,
  "isRequired": true,
  "isMultiple": true,
  "limitTotal": 1,
  "usedLimitTotal": 1,
  "limitPerOrder": 1,
  "limitPerTradeOutlet": 1,
  "skuMin": 1,
  "skuMax": 1,
  "countMin": 1,
  "countMax": 1,
  "packagingId": "sample string 10",
  "packagingMin": 1.1,
  "packagingMax": 1.1,
  "entityPropertyId": "sample string 11",
  "entityPropertyMin": 1.1,
  "entityPropertyMax": 1.1,
  "sumMin": 1.0,
  "sumMax": 1.0,
  "discountPerOrder": true,
  "discountPerPositions": true,
  "overrideDiscounts": true,
  "discount": 1.0,
  "discountsSumMax": 1.0,
  "usedDiscountsSum": 1.0,
  "giftsSumMax": 1.0,
  "usedGiftsSum": 1.0,
  "positionGroups": [
    {
      "skuMin": 1,
      "skuMax": 1,
      "countMin": 1,
      "countMax": 1,
      "packagingId": "sample string 1",
      "packagingMin": 1.1,
      "packagingMax": 1.1,
      "entityPropertyId": "sample string 2",
      "entityPropertyMin": 1.1,
      "entityPropertyMax": 1.1,
      "sumMin": 1.0,
      "sumMax": 1.0,
      "positions": [
        {
          "productId": "sample string 1",
          "price": 1.0,
          "required": true,
          "countMin": 1,
          "countMax": 1,
          "packagingId": "sample string 3",
          "packagingMin": 1.1,
          "packagingMax": 1.1,
          "entityPropertyId": "sample string 4",
          "entityPropertyMin": 1.1,
          "entityPropertyMax": 1.1,
          "sumMin": 1.0,
          "sumMax": 1.0
        },
        {
          "productId": "sample string 1",
          "price": 1.0,
          "required": true,
          "countMin": 1,
          "countMax": 1,
          "packagingId": "sample string 3",
          "packagingMin": 1.1,
          "packagingMax": 1.1,
          "entityPropertyId": "sample string 4",
          "entityPropertyMin": 1.1,
          "entityPropertyMax": 1.1,
          "sumMin": 1.0,
          "sumMax": 1.0
        }
      ]
    },
    {
      "skuMin": 1,
      "skuMax": 1,
      "countMin": 1,
      "countMax": 1,
      "packagingId": "sample string 1",
      "packagingMin": 1.1,
      "packagingMax": 1.1,
      "entityPropertyId": "sample string 2",
      "entityPropertyMin": 1.1,
      "entityPropertyMax": 1.1,
      "sumMin": 1.0,
      "sumMax": 1.0,
      "positions": [
        {
          "productId": "sample string 1",
          "price": 1.0,
          "required": true,
          "countMin": 1,
          "countMax": 1,
          "packagingId": "sample string 3",
          "packagingMin": 1.1,
          "packagingMax": 1.1,
          "entityPropertyId": "sample string 4",
          "entityPropertyMin": 1.1,
          "entityPropertyMax": 1.1,
          "sumMin": 1.0,
          "sumMax": 1.0
        },
        {
          "productId": "sample string 1",
          "price": 1.0,
          "required": true,
          "countMin": 1,
          "countMax": 1,
          "packagingId": "sample string 3",
          "packagingMin": 1.1,
          "packagingMax": 1.1,
          "entityPropertyId": "sample string 4",
          "entityPropertyMin": 1.1,
          "entityPropertyMax": 1.1,
          "sumMin": 1.0,
          "sumMax": 1.0
        }
      ]
    }
  ],
  "giftGroups": [
    {
      "skuMin": 1,
      "skuMax": 1,
      "countMin": 1,
      "countMax": 1,
      "packagingId": "sample string 1",
      "packagingMin": 1.1,
      "packagingMax": 1.1,
      "entityPropertyId": "sample string 2",
      "entityPropertyMin": 1.1,
      "entityPropertyMax": 1.1,
      "sumMin": 1.0,
      "sumMax": 1.0,
      "gifts": [
        {
          "productId": "sample string 1",
          "countMin": 1,
          "countMax": 1,
          "packagingId": "sample string 2",
          "packagingMin": 1.1,
          "packagingMax": 1.1,
          "entityPropertyId": "sample string 3",
          "entityPropertyMin": 1.1,
          "entityPropertyMax": 1.1,
          "sumMin": 1.0,
          "sumMax": 1.0
        },
        {
          "productId": "sample string 1",
          "countMin": 1,
          "countMax": 1,
          "packagingId": "sample string 2",
          "packagingMin": 1.1,
          "packagingMax": 1.1,
          "entityPropertyId": "sample string 3",
          "entityPropertyMin": 1.1,
          "entityPropertyMax": 1.1,
          "sumMin": 1.0,
          "sumMax": 1.0
        }
      ]
    },
    {
      "skuMin": 1,
      "skuMax": 1,
      "countMin": 1,
      "countMax": 1,
      "packagingId": "sample string 1",
      "packagingMin": 1.1,
      "packagingMax": 1.1,
      "entityPropertyId": "sample string 2",
      "entityPropertyMin": 1.1,
      "entityPropertyMax": 1.1,
      "sumMin": 1.0,
      "sumMax": 1.0,
      "gifts": [
        {
          "productId": "sample string 1",
          "countMin": 1,
          "countMax": 1,
          "packagingId": "sample string 2",
          "packagingMin": 1.1,
          "packagingMax": 1.1,
          "entityPropertyId": "sample string 3",
          "entityPropertyMin": 1.1,
          "entityPropertyMax": 1.1,
          "sumMin": 1.0,
          "sumMax": 1.0
        },
        {
          "productId": "sample string 1",
          "countMin": 1,
          "countMax": 1,
          "packagingId": "sample string 2",
          "packagingMin": 1.1,
          "packagingMax": 1.1,
          "entityPropertyId": "sample string 3",
          "entityPropertyMin": 1.1,
          "entityPropertyMax": 1.1,
          "sumMin": 1.0,
          "sumMax": 1.0
        }
      ]
    }
  ],
  "tradeOutlets": [
    "sample string 1",
    "sample string 2"
  ],
  "tradeOutletCategories": [
    "sample string 1",
    "sample string 2"
  ],
  "tradeOutletFormats": [
    "sample string 1",
    "sample string 2"
  ],
  "provinces": [
    "5578d7e8-4668-41c8-b39e-05be2da9ff4e",
    "7a4e35f9-2c99-4eae-8562-4e0be20961b9"
  ],
  "routes": [
    "sample string 1",
    "sample string 2"
  ]
}

<CreatePromoOfferModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DDApp.Shared.Api.Models.V1.PromoOffers">
  <CountMax>1</CountMax>
  <CountMin>1</CountMin>
  <CurrencyId>sample string 6</CurrencyId>
  <DateFrom>2025-12-20T13:07:34.0193653+00:00</DateFrom>
  <DateTill>2025-12-20T13:07:34.0193653+00:00</DateTill>
  <Description>sample string 3</Description>
  <Discount>1</Discount>
  <DiscountPerOrder>true</DiscountPerOrder>
  <DiscountPerPositions>true</DiscountPerPositions>
  <DiscountsSumMax>1</DiscountsSumMax>
  <EntityPropertyId>sample string 11</EntityPropertyId>
  <EntityPropertyMax>1.1</EntityPropertyMax>
  <EntityPropertyMin>1.1</EntityPropertyMin>
  <GiftGroups>
    <CreateOfferGiftGroupModel>
      <CountMax>1</CountMax>
      <CountMin>1</CountMin>
      <EntityPropertyId>sample string 2</EntityPropertyId>
      <EntityPropertyMax>1.1</EntityPropertyMax>
      <EntityPropertyMin>1.1</EntityPropertyMin>
      <Gifts>
        <CreatePromoOfferGiftModel>
          <CountMax>1</CountMax>
          <CountMin>1</CountMin>
          <EntityPropertyId>sample string 3</EntityPropertyId>
          <EntityPropertyMax>1.1</EntityPropertyMax>
          <EntityPropertyMin>1.1</EntityPropertyMin>
          <PackagingId>sample string 2</PackagingId>
          <PackagingMax>1.1</PackagingMax>
          <PackagingMin>1.1</PackagingMin>
          <ProductId>sample string 1</ProductId>
          <SumMax>1</SumMax>
          <SumMin>1</SumMin>
        </CreatePromoOfferGiftModel>
        <CreatePromoOfferGiftModel>
          <CountMax>1</CountMax>
          <CountMin>1</CountMin>
          <EntityPropertyId>sample string 3</EntityPropertyId>
          <EntityPropertyMax>1.1</EntityPropertyMax>
          <EntityPropertyMin>1.1</EntityPropertyMin>
          <PackagingId>sample string 2</PackagingId>
          <PackagingMax>1.1</PackagingMax>
          <PackagingMin>1.1</PackagingMin>
          <ProductId>sample string 1</ProductId>
          <SumMax>1</SumMax>
          <SumMin>1</SumMin>
        </CreatePromoOfferGiftModel>
      </Gifts>
      <PackagingId>sample string 1</PackagingId>
      <PackagingMax>1.1</PackagingMax>
      <PackagingMin>1.1</PackagingMin>
      <SkuMax>1</SkuMax>
      <SkuMin>1</SkuMin>
      <SumMax>1</SumMax>
      <SumMin>1</SumMin>
    </CreateOfferGiftGroupModel>
    <CreateOfferGiftGroupModel>
      <CountMax>1</CountMax>
      <CountMin>1</CountMin>
      <EntityPropertyId>sample string 2</EntityPropertyId>
      <EntityPropertyMax>1.1</EntityPropertyMax>
      <EntityPropertyMin>1.1</EntityPropertyMin>
      <Gifts>
        <CreatePromoOfferGiftModel>
          <CountMax>1</CountMax>
          <CountMin>1</CountMin>
          <EntityPropertyId>sample string 3</EntityPropertyId>
          <EntityPropertyMax>1.1</EntityPropertyMax>
          <EntityPropertyMin>1.1</EntityPropertyMin>
          <PackagingId>sample string 2</PackagingId>
          <PackagingMax>1.1</PackagingMax>
          <PackagingMin>1.1</PackagingMin>
          <ProductId>sample string 1</ProductId>
          <SumMax>1</SumMax>
          <SumMin>1</SumMin>
        </CreatePromoOfferGiftModel>
        <CreatePromoOfferGiftModel>
          <CountMax>1</CountMax>
          <CountMin>1</CountMin>
          <EntityPropertyId>sample string 3</EntityPropertyId>
          <EntityPropertyMax>1.1</EntityPropertyMax>
          <EntityPropertyMin>1.1</EntityPropertyMin>
          <PackagingId>sample string 2</PackagingId>
          <PackagingMax>1.1</PackagingMax>
          <PackagingMin>1.1</PackagingMin>
          <ProductId>sample string 1</ProductId>
          <SumMax>1</SumMax>
          <SumMin>1</SumMin>
        </CreatePromoOfferGiftModel>
      </Gifts>
      <PackagingId>sample string 1</PackagingId>
      <PackagingMax>1.1</PackagingMax>
      <PackagingMin>1.1</PackagingMin>
      <SkuMax>1</SkuMax>
      <SkuMin>1</SkuMin>
      <SumMax>1</SumMax>
      <SumMin>1</SumMin>
    </CreateOfferGiftGroupModel>
  </GiftGroups>
  <GiftsSumMax>1</GiftsSumMax>
  <IsMultiple>true</IsMultiple>
  <IsRequired>true</IsRequired>
  <LimitPerOrder>1</LimitPerOrder>
  <LimitPerTradeOutlet>1</LimitPerTradeOutlet>
  <LimitTotal>1</LimitTotal>
  <Name>sample string 2</Name>
  <OverrideDiscounts>true</OverrideDiscounts>
  <PackagingId>sample string 10</PackagingId>
  <PackagingMax>1.1</PackagingMax>
  <PackagingMin>1.1</PackagingMin>
  <PositionGroups>
    <CreatePromoOfferPositionGroupModel>
      <CountMax>1</CountMax>
      <CountMin>1</CountMin>
      <EntityPropertyId>sample string 2</EntityPropertyId>
      <EntityPropertyMax>1.1</EntityPropertyMax>
      <EntityPropertyMin>1.1</EntityPropertyMin>
      <PackagingId>sample string 1</PackagingId>
      <PackagingMax>1.1</PackagingMax>
      <PackagingMin>1.1</PackagingMin>
      <Positions>
        <CreatePromoOfferPositionModel>
          <CountMax>1</CountMax>
          <CountMin>1</CountMin>
          <EntityPropertyId>sample string 4</EntityPropertyId>
          <EntityPropertyMax>1.1</EntityPropertyMax>
          <EntityPropertyMin>1.1</EntityPropertyMin>
          <PackagingId>sample string 3</PackagingId>
          <PackagingMax>1.1</PackagingMax>
          <PackagingMin>1.1</PackagingMin>
          <Price>1</Price>
          <ProductId>sample string 1</ProductId>
          <Required>true</Required>
          <SumMax>1</SumMax>
          <SumMin>1</SumMin>
        </CreatePromoOfferPositionModel>
        <CreatePromoOfferPositionModel>
          <CountMax>1</CountMax>
          <CountMin>1</CountMin>
          <EntityPropertyId>sample string 4</EntityPropertyId>
          <EntityPropertyMax>1.1</EntityPropertyMax>
          <EntityPropertyMin>1.1</EntityPropertyMin>
          <PackagingId>sample string 3</PackagingId>
          <PackagingMax>1.1</PackagingMax>
          <PackagingMin>1.1</PackagingMin>
          <Price>1</Price>
          <ProductId>sample string 1</ProductId>
          <Required>true</Required>
          <SumMax>1</SumMax>
          <SumMin>1</SumMin>
        </CreatePromoOfferPositionModel>
      </Positions>
      <SkuMax>1</SkuMax>
      <SkuMin>1</SkuMin>
      <SumMax>1</SumMax>
      <SumMin>1</SumMin>
    </CreatePromoOfferPositionGroupModel>
    <CreatePromoOfferPositionGroupModel>
      <CountMax>1</CountMax>
      <CountMin>1</CountMin>
      <EntityPropertyId>sample string 2</EntityPropertyId>
      <EntityPropertyMax>1.1</EntityPropertyMax>
      <EntityPropertyMin>1.1</EntityPropertyMin>
      <PackagingId>sample string 1</PackagingId>
      <PackagingMax>1.1</PackagingMax>
      <PackagingMin>1.1</PackagingMin>
      <Positions>
        <CreatePromoOfferPositionModel>
          <CountMax>1</CountMax>
          <CountMin>1</CountMin>
          <EntityPropertyId>sample string 4</EntityPropertyId>
          <EntityPropertyMax>1.1</EntityPropertyMax>
          <EntityPropertyMin>1.1</EntityPropertyMin>
          <PackagingId>sample string 3</PackagingId>
          <PackagingMax>1.1</PackagingMax>
          <PackagingMin>1.1</PackagingMin>
          <Price>1</Price>
          <ProductId>sample string 1</ProductId>
          <Required>true</Required>
          <SumMax>1</SumMax>
          <SumMin>1</SumMin>
        </CreatePromoOfferPositionModel>
        <CreatePromoOfferPositionModel>
          <CountMax>1</CountMax>
          <CountMin>1</CountMin>
          <EntityPropertyId>sample string 4</EntityPropertyId>
          <EntityPropertyMax>1.1</EntityPropertyMax>
          <EntityPropertyMin>1.1</EntityPropertyMin>
          <PackagingId>sample string 3</PackagingId>
          <PackagingMax>1.1</PackagingMax>
          <PackagingMin>1.1</PackagingMin>
          <Price>1</Price>
          <ProductId>sample string 1</ProductId>
          <Required>true</Required>
          <SumMax>1</SumMax>
          <SumMin>1</SumMin>
        </CreatePromoOfferPositionModel>
      </Positions>
      <SkuMax>1</SkuMax>
      <SkuMin>1</SkuMin>
      <SumMax>1</SumMax>
      <SumMin>1</SumMin>
    </CreatePromoOfferPositionGroupModel>
  </PositionGroups>
  <Priority>7</Priority>
  <Provinces xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:guid>5578d7e8-4668-41c8-b39e-05be2da9ff4e</d2p1:guid>
    <d2p1:guid>7a4e35f9-2c99-4eae-8562-4e0be20961b9</d2p1:guid>
  </Provinces>
  <Routes xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </Routes>
  <SkuMax>1</SkuMax>
  <SkuMin>1</SkuMin>
  <SumMax>1</SumMax>
  <SumMin>1</SumMin>
  <TradeOutletCategories xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </TradeOutletCategories>
  <TradeOutletFormats xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </TradeOutletFormats>
  <TradeOutlets xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </TradeOutlets>
  <Type>Discount</Type>
  <UsedDiscountsSum>1</UsedDiscountsSum>
  <UsedGiftsSum>1</UsedGiftsSum>
  <UsedLimitTotal>1</UsedLimitTotal>
  <VendorId>sample string 1</VendorId>
</CreatePromoOfferModel>

Sample not available.

Информация об ответе

ResourceIdModel
НазваниеОписаниеТип данныхДополнительная информация
Id

globally unique identifier

Нет

Форматы ответа

{
  "id": "945c9228-84f2-4844-9de1-7c00c6bb692c"
}

<ResourceIdModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DDApp.Alt.Api.Models.Response">
  <Id>945c9228-84f2-4844-9de1-7c00c6bb692c</Id>
</ResourceIdModel>