Получение информации о заказах

Получить статус заказа

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: "Sennaya-M3", // пункт, куда заказ был отгружен (на какой пункт поступил)
    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: "Sennaya-M3",
    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/track_code?login=[login]&token=[token]&sku=[sku]

Возвращаются трекинг код, который идентифицирует заказ в системе Главпункт.

Данные так же можно передавать POST запросом.

Ответ

{
  trackingCode: "4531-3266-59"
}

если произошла ошибка

{
   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" // адрес доставки (для курьерской доставки)

}

если произошла ошибка

{
   result  : "error",
   message : "сообщение об ошибке"
}