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

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

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/pkgs_pickups?login=[login]&token=[token]

Возвращаются заборы со статусом Создан и Запланирован

Ответ

[
  {
      "id": "09340934", // номер накладной
      "pkgs": "2039023,9203902,9203923", // номера заказов Интернет магазина
      "date": "2018-05-06", // дата забора
      "comment": "Забрать срочно", // комментарий
      "status": "Создан/Запланирован" // статус забора
  }
]

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

{
   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 : "сообщение об ошибке"
}