@extends('docs.api.layouts.main') @section('content')

Создание заказа

Данный метод позволяет создавать заказ в системе. По данному заказу будет произведена комплектация, упаковка и передача в службу доставки / доставка этого заказа.

Запрос к методу /orders/create
Тип запроса POST
						
                            {{ print_r( json_encode( [
                                        [
                                            'owner'=>1,
                                            'name'=>'x01',
                                            'type'=>1,
                                            'description'=>'Обмотайте фирменным скотчем',
                                            'weight'=>3500,
                                            'seats'=>1,
                                            'delivery'=>[
                                                'service'=>105,
                                                'tariff'=>1,
                                                'type'=>1,
                                                'code'=>'1',
                                                'comment'=>'Позвонить за 30 минут',
                                            ],
                                            'price'=>[
                                                'insurance'=>50000,
                                                'cod'=>[
                                                    'price'=>50000,
                                                    'type'=>0
                                                ],
                                                'shipping'=>[
                                                    'price'=>25000,
                                                    'vat'=>20
                                                ]
                                            ],
                                            'profiles'=>[
                                                'completeness',
                                                'thermal'
                                            ],
                                            'sender'=>[
                                                'store'=>1,
                                                'contact'=>[
                                                    'fio'=>'Петров Сергей Валерьевич',
                                                    'entity'=>[
                                                        'name'=>'ООО Ромашка',
                                                        'address'=>'г.Москва, ул.Летчика Гастелло, д.11, оф.9'
                                                    ],
                                                    'phone'=>[
                                                        'number'=>79001234567,
                                                        'extension'=>153
                                                    ],
                                                    'phone2'=>'+7(900)123-4567#153',
                                                    'email'=>'test@test.ru'
                                                ],
                                                'address'=>[
                                                    'country'=>173,
                                                    'zip'=>'101000',
                                                    'city'=>'Москва',
                                                    'street'=>'1-ый Варшавский проезд',
                                                    'house'=>'2',
                                                    'corpus'=>'',
                                                    'stroenie'=>'',
                                                    'flat'=>'5',
                                                    'string'=>'1-ый Варшавский проезд, д.2, стр.21, ворота 5'
                                                ],
                                                'delivery'=>[
                                                    'date'=> date('Y-m-d'),
                                                    'time'=>1
                                                ]
                                            ],
                                            'recipient'=>[
                                                'store'=>1,
                                                'contact'=>[
                                                    'fio'=>'Петров Сергей Валерьевич',
                                                    'entity'=>[
                                                        'name'=>'ООО Ромашка',
                                                        'address'=>'г.Москва, ул.Летчика Гастелло, д.11, оф.9'
                                                    ],
                                                    'phone'=>[
                                                        'number'=>79001234567,
                                                        'extension'=>153
                                                    ],
                                                    'phone2'=>'+7(900)123-4567#153',
                                                    'email'=>'test@test.ru'
                                                ],
                                                'address'=>[
                                                    'country'=>173,
                                                    'zip'=>'101000',
                                                    'city'=>'Москва',
                                                    'street'=>'1-ый Варшавский проезд',
                                                    'house'=>'2',
                                                    'corpus'=>'',
                                                    'stroenie'=>'',
                                                    'flat'=>'5',
                                                    'string'=>'1-ый Варшавский проезд, д.2, стр.21, ворота 5'
                                                ],
                                                'delivery'=>[
                                                    'date'=>date('Y-m-d'),
                                                    'time'=>1
                                                ]
                                            ],
                                            'services'=>[
                                                [
                                                    'code'=>'1.4',
                                                    'quantity'=>1
                                                ],
                                            ],
                                            'goods'=>[
                                                [
                                                    'code'=>'code23',
                                                    'article'=>'art15',
                                                    'quantity'=>3,
                                                    'price'=>10000,
                                                    'vat'=>0,
                                                    'discount'=>10.1501802,
                                                    'name'=>'Название товара',
                                                    'barcodes'=>[
                                                        '1234567890123',
                                                        '4567890123456'
                                                    ],
                                                    'weight'=>700,
                                                    'insurance'=>2000,
                                                ]
                                            ],
                                            'file'=>[
                                                'extension'=>'txt',
                                                'data'=>'MTEx',
                                            ],
                                        ],
                                    ], JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT ), 1 ) }}
						
					
owner - [integer] юр.лицо
name - [string] номер заказа
type - [integer] тип заказа
description - [string] комментарий к заказу
weight - [integer] вес, в граммах
seats - [integer] количество мест
delivery - доставка
service - [integer] код службы доставки
tariff - [integer] тариф службы доставки
type - [integer] тип доставки
code - [string] уточняющий код
comment - [string] комментарий курьеру
price
insurance - [integer] страховая стоимость, в копейках
cod - наложенный платеж
price - [integer] цена, в копейках [7] [8]
type - способ оплаты [8]
shipping - стоимость доставки для получателя
price - [integer] цена, в копейках (так же будет отображаться в комплектовочном листе)
vat - НДС доставки
profiles - [array] профили заказа
sender - данные отправителя [1]
store - [integer] код склада
contact - контактные данные
fio - [string] ФИО
entity - данные юр.лица
name - [string] название юр.лица
address - [string] адрес юр.лица
phone - основной номер телефона в международном формате
number - [integer] номер телефона в международном формате
extension - [integer] добавочный номер телефона
phone2 - [string] дополнительный(запасной) номер телефона
email - [string] e-mail
address - адрес места отправления заказа
country - id страны
zip - [string] индекс
city - [string] страна
street - [string] улица
house - [string] дом
corpus - [string] корпус
stroenie - [string] строение
flat - [string] квартира/офис
string - [string] адрес строкой, на случай когда адрес невозможно разбить на составляющие
delivery - дата и время отправления заказа [2]
date - [string] дата отправления заказа
time - [integer] время окончания
recipient - данные получателя [1]
store - [integer] код склада
contact - контактные данные
fio - [string] ФИО
entity - данные юр.лица
name - [string] название юр.лица
address - [string] адрес юр.лица
phone - основной номер телефона в международном формате
number - [integer] номер телефона в международном формате
extension - [integer] добавочный номер телефона
phone2 - [string] дополнительный(запасной) номер телефона
email - [string] e-mail
address - адрес места получения заказа
country - id страны
zip - [string] индекс
city - [string] страна
street - [string] улица
house - [string] дом
corpus - [string] корпус
stroenie - [string] строение
flat - [string] квартира/офис
string - [string] адрес строкой, на случай когда адрес невозможно разбить на составляющие
delivery - желаемая дата и время получения заказа [3]
date - [string] дата получения заказа
time - [integer] время окончания
services - услуги ExpressRMS
code - [string] код услуги
quantity - [integer] количество
goods - товары и услуги для комплектации заказа (так же отображаются в комплектовочном листе)
code - [string] код товара, обязателен если нет артикула [6]
article - [string] артикул товара, обязателен если нет кода [6]
quantity - [integer] количетсво товара
price - [integer] цена 1 единицы товара, в копейках
vat - НДС товара
discount - [float] скидка на этот товар, в процентах [4]
name - [string] название товара [5]
barcodes - [array] массив штрих-кодов [5]
weight - [integer] вес 1 единицы товара, в граммах [5]
insurance - [integer] страховая стоимость 1 единицы товара, в копейках [5]
file - файл, который надо прикрепить/вложить в заказ
extension - [string] расширение передаваемого файла
data - [string] сам файл закодированный в base64

[1] - Если заказ отправляется (поле sender) со склада ExpressRMS или принимается (поле recipient) на склад ExpressRMS, то достаточно указать только поле store (код склада).
При одновременном указании и кода склада и адреса (c контактным лицом), приоритет имеет код склада.

[2] - Дата отправления заказа со склада особо актуально для заказов на забор груза, когда надо забрать груз в определенную дату.
Время отправления заказа со склада особо актуально для заказов на забор груза, когда надо забрать груз в определенное время.
При отсутствии данных, забор грузу будет осуществляться в ближайший возможный день в соответствии с графиком службы доставки.

[3] - Желаемая дата и время доставки заказа получателю.
При отсутствии данных, заказ доставляется в близжайший возможный рабочий день службы доставки (согласно графику доставки), в рабочее время (обычно с 10 до 18 часов).

[4] - Конечная стоимость товара считается автоматически с учетом математического округления полученной стоимости до ценых копеек (0.0-0.4 округляется до 0, а 0.5-1.0 - округляется до 1).

[5] - Создать заказ можно только из тех товаров которые предварительно созданы в системе.
Если нужный товар ещё не создан, то товар может быть создан автоматически при наличии необходимых полей в товаре (name, barcodes, weight, insurance).

[6] - При одновременном указании и кода и артикула, приоритет имеет код товара.

[7] - В величине наложенного платежа должна быть указана вся сумма, которую необходимо взять с получателя. Обычно это стоимость товаров, стоимость доставки и прочие услуги, которые оплачивает получатель.

[8] - Если в поле способ оплаты указано, что заказ предоплачен, это означает что за заказ все деньги уже уплачены получателем и наложенный платеж не требуется. Поэтому для предоплаченных заказов наложенный платеж будет отсутствовать, даже если в поле price будет указана цена.

						
							[
								{
									"x01":{
										"message":"Заказ создан"
									}
								},
								{
									"x02":{
										"errors":[
											"Заказ с таким номером уже существует"
										]
									}
								},
								{
									"x03":{
										"errors":[
											"Поле вес обязательно для заполнения",
											"Не указан код доставки"
										]
									}
								}
							]
						
					
x01, x02, x03 - номер заказа
message - сообщение
errors - массив ошибок
@endsection