API - Добавление заказов

Метод добавляет заказы переданные в параметре orders на статус "Новый заказ". Заказы добавленные с помощью данного метода можно редактировать в личном кабинете. Заказа на статусе "Новый заказ" не могут быть обработаны нашими менеджерами и переданы курьерам, до тех пор, пока заказ не будет отправлен в работу.

Параметры запроса
Параметр Тип Описание
key string Ваш API-ключ
method string addOrdersToNew
orders string JSON-массив с заказами. Параметры элемента массива соответствуют колонкам в бланке-заявке.
Пример json-объекта заказа:
{
"number":"11111",                       // номер заказа
"date":"01.09.2016",                    // дата доставки заказа в формате mm.dd.yyyy
"timeFrom":"10",                        // время доставки С
"timeTo":"14",                          // время доставки ПО
"serviceType":"москва",                 // тип услуги
"zipcode":"",                           // почтовый индекс
"recipientCity":"Москва",               // город доставки
"address":"г Москва, ул Чаянова, д 14", // адрес
"comment":"тестовая заявка",            // примечание
"contactPerson":"Иван",                 // контактное лицо
"contactPhone":"903-222-22-22",         // контактный телефон
"payment":"2000",                       // оплата
"paymentType":"наличными",              // тип оплаты
"costSending":"2000",                   // стоимость отправления
"items":[{                              // контейнер с товарными позициями
	"name" => "",                       // название товара
	"barcode" => "FR11111",             // штрихкод
	"article" => "",                    // артикул
	"weight" => "0.5",                  // вес в кг
	"quantity" => "",                   // количество
	"price" => "",                      // цена
	"nds" => "0",                       // ставка НДС
	}]
}
Пример запроса

$orders[] = array(
	'number' => '11111',
	'date' => '01.09.2016',
	'timeFrom' => '10',
	'timeTo' => '14',
	'serviceType' => 'москва',
	'zipcode' => '',
	'recipientCity' => 'Москва',
	'address' => 'москва ул Чаянова 14',
	'comment' => 'тестовая заявка',
	'contactPerson' => 'Иван',
	'contactPhone' => '903-222-22-22',
	'payment' => '2000',
	'paymentType' => '',
	'costSending' => '2000',
	'items' => array(
		array(

			'barcode' => 'FR11111',
			'name' => 'Чехол',
			'article' => '',
			'weight' => '0.2',
			'quantity' => '1', // если не указать, то по-умолчанию будет 1
			'price' => '',
			'nds' => '0',
);

$orders = json_encode($orders);

$url = 'https://www.algocom.ru/personal/api/v1.0/json/index.php';

$data = array(
	'key' => 'ВАШ API-КЛЮЧ',
	'method' => 'addOrdersToNew',
	'orders' => $orders
);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 60);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

$json = curl_exec($ch);
print $json;

Порядок возвращаемых объектов с информацией о добавлении, соответствует порядоку заказов в исходном массиве.
Для каждого заказа возвращается следующая информация:
id - уникальный идентификатор заказа или 0, если заказ не добавлен.
created - 0|1 - 0 заказ не добавлен, 1 - заказ добавлен.
address - в процесее добавления получаемый адрес проверяется на корректность и может быть исправлен. В данной строке возвращается исправленый адрес.
hasError - 0|1 - 0 в заказе нет ошибок, 1 - в заказе есть ошибка.
error - строка с ошибкой.
errors - массив с ошибками в параметрах заказа.

Пример успешного ответа
{
	"createdOrders":[
		{
			"id":1842,
			"created":1,
			"address":"г Москва, ул Чаянова, д 14",
			"hasError":0,
			"error":"",
			"errors":[]
		}
	]
}
Пример ответа с не критической ошибкой (заказ добавляется)
{
	"createdOrders":[
		{
			"id":1842,
			"created":1,
			"address":"г Москва, ул Чаянова, д 14",
			"hasError":1,
			"error":"Дата доставки заказа меньше текущей даты.",
			"errors":{
				"date":"Дата доставки заказа меньше текущей даты."
				}
		}
	]
}
Пример ответа с критической ошибкой (заказ не добавляется)
{
	"createdOrders":[
		{
			"id":0,
			"created":0,
			"hasError":1,
			"error":"В списке заказов найден заказ со всеми пустыми полями."
		}
	]
}


Вернуться назад