POST api/Order
Создает новый заказ. Возвращает результат формирования заказа и список позиций. ВНИМАНИЕ! Тестовых функций на данный момент нет, поэтому все сформированные заказы являются действительными. Заказы с наших складов можно отменить до отгрузки, ЗАКАЗЫ ОТ ПОСТАВЩИКОВ (все товары, у которых имеется SupplierCode или SupplierId) ОТМЕНИТЬ НЕВОЗМОЖНО! В некоторых случаях (аппаратные перебои или высокая нагрузка) когда службы формирования заказов недоступны, заказ может быть установлен в очередь и сформирован отложенно, поэтому в некоторых случаях GUID и номер заказа могут быть пустыми
Информация о запросе
URI параметры
Нет.
Параметры тела запроса
Модель для создания заказа
CreateOrderViewModel| Имя | Описание | Тип | Дополнительная информация |
|---|---|---|---|
| UserGuid |
Ваш UserGuid |
globally unique identifier |
Обязательный |
| ContragentGuid |
GUID контрагента Список контрагентов можно получить с помощью метода http://api.phaeton.kz/Help/Api/GET-api-Dictionary_UserGuid_ApiKey |
globally unique identifier |
Обязательный |
| ApiKey |
Ваш ApiKey |
string |
Обязательный |
| Brand |
Бренд |
string |
Обязательный |
| Article |
Артикул |
string |
Обязательный |
| WarehouseId |
Id склада (GUID) |
globally unique identifier |
Обязательный |
| Price |
Цена |
integer |
В диапазоне от 0 до 2147483647 |
| Count |
Количество |
integer |
В диапазоне от 0 до 2147483647 |
| SupplierId |
ID поставщика, полученный при поиске (При заказе от удаленных и локальных поставщиков) |
integer |
Нет. |
| ExpectedDelivery |
Ожидаемый срок поставки (Обязателен при заказе от удаленных поставщиков) |
integer |
Нет. |
| GuaranteedDelivery |
Гарантированный срок поставки (Обязателен при заказе от удаленных поставщиков) |
integer |
Нет. |
| DeliveryProbability |
Вероятность поставки (Обязателен при заказе от удаленных поставщиков) |
decimal number |
Нет. |
| Comment |
Коментарий (необезательно) |
string |
Нет. |
| UseBonus |
Если задана 1 будут использованны бонусы. По умолчанию бонусы не используются. |
integer |
Нет. |
| Force |
Если параметр задан в 1, будут игнорироваться ошибки об изменении цены, и заказ будет сформирован в любом случае (только для товаров со складов Phaeton). По умолчанию - 0. |
integer |
Нет. |
| route |
Вариант доставки, если отсутствует будет задано доставка по умолчанию. |
string |
Нет. |
Формат запроса
application/json, text/json
{
"UserGuid": "6c068550-a77d-499d-92b8-0aca4a3d10cb",
"ContragentGuid": "843ebe13-eb09-4b29-bfa7-f4a0a2eb0bf3",
"ApiKey": "sample string 1",
"Brand": "sample string 2",
"Article": "sample string 3",
"WarehouseId": "3aa1f384-2c52-4633-8467-19fc2c2517a9",
"Price": 4,
"Count": 5,
"SupplierId": 1,
"ExpectedDelivery": 1,
"GuaranteedDelivery": 1,
"DeliveryProbability": 1.1,
"Comment": "sample string 6",
"UseBonus": 7,
"Force": 8,
"route": "sample string 9"
}
multipart/form-data
{"UserGuid":"6c068550-a77d-499d-92b8-0aca4a3d10cb","ContragentGuid":"843ebe13-eb09-4b29-bfa7-f4a0a2eb0bf3","ApiKey":"sample string 1","Brand":"sample string 2","Article":"sample string 3","WarehouseId":"3aa1f384-2c52-4633-8467-19fc2c2517a9","Price":4,"Count":5,"SupplierId":1,"ExpectedDelivery":1,"GuaranteedDelivery":1,"DeliveryProbability":1.1,"Comment":"sample string 6","UseBonus":7,"Force":8,"route":"sample string 9"}
application/xml, text/xml
<CreateOrderViewModel xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <UserGuid>6c068550-a77d-499d-92b8-0aca4a3d10cb</UserGuid> <ContragentGuid>843ebe13-eb09-4b29-bfa7-f4a0a2eb0bf3</ContragentGuid> <ApiKey>sample string 1</ApiKey> <Brand>sample string 2</Brand> <Article>sample string 3</Article> <WarehouseId>3aa1f384-2c52-4633-8467-19fc2c2517a9</WarehouseId> <Price>4</Price> <Count>5</Count> <SupplierId>1</SupplierId> <ExpectedDelivery>1</ExpectedDelivery> <GuaranteedDelivery>1</GuaranteedDelivery> <DeliveryProbability>1.1</DeliveryProbability> <Comment>sample string 6</Comment> <UseBonus>7</UseBonus> <Force>8</Force> <route>sample string 9</route> </CreateOrderViewModel>
application/x-www-form-urlencoded
Нет примера
Информация об ответе
Описание ресурсов
OrderCreateResponse| Имя | Описание | Тип | Дополнительная информация |
|---|---|---|---|
| OrderItems |
Список позиций заказа |
Коллекция OrderItemCreateResult |
Нет. |
| Warnings |
Предупреждения. Если заказ сформирован, но есть замечания, например заказ частично сформирован, или произошли изменения по цене или количеству, но задан флаг force=true |
Коллекция string |
Нет. |
| IsError |
Если задан в true, создание заказа завершено с ошибкой и заказ не сформирован. Если false значит заказ успешно сформирован. |
boolean |
Нет. |
| Errors |
Список всех ошибок |
Коллекция string |
Нет. |
| OptionAddress |
Адрес доставки |
string |
Нет. |
| Code |
Код адреса |
integer |
Нет. |
Форматы ответа
application/json, text/json
{
"OrderItems": [
{
"OrderItemId": 1,
"OrderGuid": "b98f0763-7624-45cc-bce5-0bdd6a43168b",
"OrderNumber": "sample string 2",
"Article": "sample string 3",
"Brand": "sample string 4",
"WarehouseId": "d75de823-c57d-46c3-a841-187901dd16d5",
"NewPrice": 1.0,
"NewCount": 1,
"Error": "sample string 6"
},
{
"OrderItemId": 1,
"OrderGuid": "b98f0763-7624-45cc-bce5-0bdd6a43168b",
"OrderNumber": "sample string 2",
"Article": "sample string 3",
"Brand": "sample string 4",
"WarehouseId": "d75de823-c57d-46c3-a841-187901dd16d5",
"NewPrice": 1.0,
"NewCount": 1,
"Error": "sample string 6"
}
],
"Warnings": [
"sample string 1",
"sample string 2"
],
"IsError": true,
"Errors": [
"sample string 1",
"sample string 2"
],
"OptionAddress": "sample string 2",
"Code": 1
}
multipart/form-data
{"OrderItems":[{"OrderItemId":1,"OrderGuid":"b98f0763-7624-45cc-bce5-0bdd6a43168b","OrderNumber":"sample string 2","Article":"sample string 3","Brand":"sample string 4","WarehouseId":"d75de823-c57d-46c3-a841-187901dd16d5","NewPrice":1.0,"NewCount":1,"Error":"sample string 6"},{"OrderItemId":1,"OrderGuid":"b98f0763-7624-45cc-bce5-0bdd6a43168b","OrderNumber":"sample string 2","Article":"sample string 3","Brand":"sample string 4","WarehouseId":"d75de823-c57d-46c3-a841-187901dd16d5","NewPrice":1.0,"NewCount":1,"Error":"sample string 6"}],"Warnings":["sample string 1","sample string 2"],"IsError":true,"Errors":["sample string 1","sample string 2"],"OptionAddress":"sample string 2","Code":1}
application/xml, text/xml
<OrderCreateResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<OrderItems>
<OrderItemCreateResult>
<OrderItemId>1</OrderItemId>
<OrderGuid>b98f0763-7624-45cc-bce5-0bdd6a43168b</OrderGuid>
<OrderNumber>sample string 2</OrderNumber>
<Article>sample string 3</Article>
<Brand>sample string 4</Brand>
<WarehouseId>d75de823-c57d-46c3-a841-187901dd16d5</WarehouseId>
<NewPrice>1</NewPrice>
<NewCount>1</NewCount>
<Error>sample string 6</Error>
</OrderItemCreateResult>
<OrderItemCreateResult>
<OrderItemId>1</OrderItemId>
<OrderGuid>b98f0763-7624-45cc-bce5-0bdd6a43168b</OrderGuid>
<OrderNumber>sample string 2</OrderNumber>
<Article>sample string 3</Article>
<Brand>sample string 4</Brand>
<WarehouseId>d75de823-c57d-46c3-a841-187901dd16d5</WarehouseId>
<NewPrice>1</NewPrice>
<NewCount>1</NewCount>
<Error>sample string 6</Error>
</OrderItemCreateResult>
</OrderItems>
<Warnings>
<string>sample string 1</string>
<string>sample string 2</string>
</Warnings>
<IsError>true</IsError>
<Errors>
<string>sample string 1</string>
<string>sample string 2</string>
</Errors>
<OptionAddress>sample string 2</OptionAddress>
<Code>1</Code>
</OrderCreateResponse>