Получение информации о заказах¶
Получить статус заказа¶
GET /api-1.1/pkg_status¶
Возвращает статус одного или нескольких заказов.
Возможные статусы:
not found- информация о заказе отсутствует в системеnone- еще не поступил в пункт выдачиwaiting- ожидает покупателя в пунктеdelivering- заказ в процессе курьерской доставкиcompleted- выдан покупателюawaiting_return- возвращен покупателем в ПВ, но еще не возвращен в интернет-магазин/контрагенту, либо отказ покупателя от заказа до выдачи, либо превышен срок хранения заказаreturned- возвращен в интернет-магазин/контрагентуtransfering- заказ в процессе перемещения между ПВ
Запрос¶
{
login: "userlogin", // логин интернет-магазина
token: "xxxx_token_xxxx", // token для авторизации
sku: [ "номер заказа1" , "номер заказа2", ... ]
}
Ответ¶
{
24053 : "completed",
24054 : "not found", // заказ с номером 24054 не найден
}
Получить заказы, находящиеся в Главпункте¶
GET /api/pkgs_list?login=[login]&token=[token]¶
Возвращаются заказы со статусами: waiting, awaiting_return, transfering
Ответ¶
[
{
id: "649655",
create_date: "2016-02-02 11:21:23", // дата создания заказа
modify_date: "2016-02-03 12:49:50",
acceptance_date: "2016-02-03 12:49:50", // дата поступления заказа, либо дата поступления с перемещения на пункт назначения
sku: "92866", // код заказа (номер)
barcode: "", // штрих-код заказа
status: "waiting", // статус заказа
price: "1625.50", // оценочная стоимость
weight: "1.00", // вес
items_count: "1", // кол-во мест
buyer_fio: "Наталья Иванова", // ФИО покупателя
buyer_phone: "79871234567", // телефон покупателя
comment: "3 книги", // комментарий к заказу
punkt_id: "Prosveshenia-E133", // пункт, где в данный момент числится заказ
src_punkt_id: "SZ-SPB-Sennaya", // пункт, куда заказ был отгружен (на какой пункт поступил)
dst_punkt_id: "Prosveshenia-E133", // пункт назначения (где будет выдан покупателю)
to_pay: "1625.50", // сумма к оплате покупателем
return_before: "2016-02-10 12:49:50", // срок хранения,
// по истечении этого срока могут быть начислены пени
awaiting_return_reason: "" // Причина отказа (по которой заказ помечен на возврат),
tracking_code: "4531-3266-59", // Трекинг код, который идентифицирует заказ в системе Главпункт
},
{
id: "649524",
create_date: "2016-02-02 11:08:11",
modify_date: "2016-02-02 15:23:46",
acceptance_date: "2016-02-02 15:23:46",
sku: "92568",
barcode: "",
status: "waiting",
price: "15894.00",
weight: "1.00",
items_count: "2",
buyer_fio: "Иван Петров",
buyer_phone: "79871234567",
comment: "2 книги",
punkt_id: "hub-delivery",
src_punkt_id: "SZ-SPB-Sennaya",
dst_punkt_id: "hub-delivery",
to_pay: "15894.00",
return_before: "2016-02-09 15:23:46",
awaiting_return_reason: "" // Причина отказа (по которой заказ помечен на возврат),
tracking_code: "4531-3568-73",
},
]
если произошла ошибка
{
result : "error",
message : "сообщение об ошибке"
}
Получить трекинг код Главпункт¶
Трекинг код Почты России¶
GET /api/pochta_track_code?login=[login]&token=[token]&sku=[sku]¶
Используется номер заказа(sku)
GET /api/pochta_track_code?login=[login]&token=[token]&pkgId=[pkgId]¶
Используется id заказа(pkgId)
GET /api/pochta_track_code?login=[login]&token=[token]&trackCode=[trackCode]¶
Используется номер отслеживания системы главпункт Получить трекинг код Главпункт
Возвращает трек-номер для отслеживания статуса перемещения на Почте России.
Данные так же можно передавать POST запросом.
Ответ¶
{
pochtaTrackingCode: "12345654321096"
}
если произошла ошибка
{
result : "error",
message : "сообщение об ошибке"
}
Трекинг код заказов, выдачаемых по РФ (Boxberry/Cdek и т.д.)¶
GET /api/rf_track_code?login=[login]&token=[token]&sku=[sku]¶
Используется номер заказа(sku)
GET /api/rf_track_code?login=[login]&token=[token]&pkgId=[pkgId]¶
Используется id заказа(pkgId)
GET /api/rf_track_code?login=[login]&token=[token]&trackCode=[trackCode]¶
Используется номер отслеживания системы главпункт Получить трекинг код Главпункт
Возвращает трек-номер для отслеживания статуса заказа для отправки по РФ.
Данные так же можно передавать POST запросом.
Ответ¶
{
trackingCode: "ECB967041777777",
operator: "boxberry"
}
если произошла ошибка
{
result : "error",
message : "сообщение об ошибке"
}
Получить информацию о заказе¶
GET /api/pkg_info?login=[login]&token=[token]&sku=[sku]&id=[id]&tracking_code=[tracking_code]¶
Возвращает информацию о заказе, по коду заказа или по идентификатору заказа, или же по трек-коду. При передаче всех параметров, самым приоритетным является sku.
Ответ¶
{
"id": "89931537", // идентификатор заказа
"tracking_code": "0544-9839-11", // трек-код
"create_date": "2019-05-21 12:57:42", // дата создания
"serv": "курьерская доставка", // тип доставки
"sku": "566-0522-89931537", // номер заказа
"barcode": "", // штрих-код
"status": "waiting", // текущий статус заказа
"price": "1000.00", // цена заказа
"insurance_val": "1000.00", // страховая стоимость
"weight": "2.00", // вес заказа
"items_count": "1", // кол-во мест
"buyer_fio": "Петр", // ФИО покупателя
"buyer_phone": "+7 921 555 55 55", // контактный номер покупателя
"comment": "", // комментарий к заказу
"punkt_id": "hub-delivery-gp", // пункт, на котором заказ находится
"src_punkt_id": "hub-delivery-gp", // в какой пункт поступил первоначально заказ
"dst_punkt_id": "hub-delivery-gp", // для какого пункта предназначен заказ
"to_pay": "1000.00", // Итого к оплате клиентом
"return_before": "2019-05-28 12:57:42", // срок хранения, после которого заказ должен быть возвращен
"awaiting_return_reason": "", // причина возврата
"arrival_move_id": "1085921", // номер накладной поступления
"buyer_address": "Московский, 1" // адрес доставки (для курьерской доставки)
}
Пример ответа для заказа, доставляемого в ПВЗ сторонним оператором (боксберри, сдек и т.д.)
{
id: "1048928", // идентификатор заказа
tracking_code: "5209-7", // трек-код
create_date: "2018-07-13 09:59:18", // дата создания
serv: "выдача по РФ", // тип доставки
sku: "777-1", // номер заказа
barcode: "", // штрих-код
status: "transfering", // текущий статус заказа
price: "3500.00", // цена заказа
insurance_val: "0.00", // страховая стоимость
weight: "1.00", // вес заказа
items_count: "1", // кол-во мест
buyer_fio: "Вячеслав", // ФИО покупателя
buyer_phone: "+7 921 555 55 55", // контактный номер покупателя
comment: "", // комментарий к заказу
punkt_id: "AB-SPB-Avtovo", // пункт, на котором заказ находится
src_punkt_id: "AB-SPB-Avtovo", // в какой пункт поступил первоначально заказ
dst_punkt_id: "hub-rf", // для какого пункта предназначен заказ
to_pay: "3500.00", // Итого к оплате клиентом
return_before: "2018-08-03 13:16:26", // срок хранения, после которого заказ должен быть возвращен
awaiting_return_reason: "", // причина возврата
arrival_move_id: "1031027", // номер накладной поступления
operator_punkt_id: "RF86181" // индификатор пункта выдачи по РФ
}
если произошла ошибка
{
result : "error",
message : "сообщение об ошибке"
}
