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": "8c1197da-80d7-408c-a0a6-a82869fec4d4", "ContragentGuid": "05bebdf7-8509-4e3f-9d90-6ae369c7f8d9", "ApiKey": "sample string 1", "Brand": "sample string 2", "Article": "sample string 3", "WarehouseId": "7bc6294d-b69f-4a55-bf23-b8c894be19bc", "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":"8c1197da-80d7-408c-a0a6-a82869fec4d4","ContragentGuid":"05bebdf7-8509-4e3f-9d90-6ae369c7f8d9","ApiKey":"sample string 1","Brand":"sample string 2","Article":"sample string 3","WarehouseId":"7bc6294d-b69f-4a55-bf23-b8c894be19bc","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>8c1197da-80d7-408c-a0a6-a82869fec4d4</UserGuid> <ContragentGuid>05bebdf7-8509-4e3f-9d90-6ae369c7f8d9</ContragentGuid> <ApiKey>sample string 1</ApiKey> <Brand>sample string 2</Brand> <Article>sample string 3</Article> <WarehouseId>7bc6294d-b69f-4a55-bf23-b8c894be19bc</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": "8f5f54a8-68c4-4490-8046-50c79d093379", "OrderNumber": "sample string 2", "Article": "sample string 3", "Brand": "sample string 4", "WarehouseId": "95e2418a-5493-468f-9a17-6d911222aaa9", "NewPrice": 1.0, "NewCount": 1, "Error": "sample string 6" }, { "OrderItemId": 1, "OrderGuid": "8f5f54a8-68c4-4490-8046-50c79d093379", "OrderNumber": "sample string 2", "Article": "sample string 3", "Brand": "sample string 4", "WarehouseId": "95e2418a-5493-468f-9a17-6d911222aaa9", "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":"8f5f54a8-68c4-4490-8046-50c79d093379","OrderNumber":"sample string 2","Article":"sample string 3","Brand":"sample string 4","WarehouseId":"95e2418a-5493-468f-9a17-6d911222aaa9","NewPrice":1.0,"NewCount":1,"Error":"sample string 6"},{"OrderItemId":1,"OrderGuid":"8f5f54a8-68c4-4490-8046-50c79d093379","OrderNumber":"sample string 2","Article":"sample string 3","Brand":"sample string 4","WarehouseId":"95e2418a-5493-468f-9a17-6d911222aaa9","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>8f5f54a8-68c4-4490-8046-50c79d093379</OrderGuid> <OrderNumber>sample string 2</OrderNumber> <Article>sample string 3</Article> <Brand>sample string 4</Brand> <WarehouseId>95e2418a-5493-468f-9a17-6d911222aaa9</WarehouseId> <NewPrice>1</NewPrice> <NewCount>1</NewCount> <Error>sample string 6</Error> </OrderItemCreateResult> <OrderItemCreateResult> <OrderItemId>1</OrderItemId> <OrderGuid>8f5f54a8-68c4-4490-8046-50c79d093379</OrderGuid> <OrderNumber>sample string 2</OrderNumber> <Article>sample string 3</Article> <Brand>sample string 4</Brand> <WarehouseId>95e2418a-5493-468f-9a17-6d911222aaa9</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>