Добавление заявки на забор заказов в ИС TopDelivery


В разделе описаны различные методы добавления заказов в ИС ТопДеливери


Общие положения по добавлению заявок на забор через api:

intake (параметры забора)
Блок параметров, содержащий информацию по забору
  1. need (требуется ли забор заказов) - Показывает, каким образом будут доставлены заказы на склад ТД. Принимаемые значения:
    • "0" - забор не требуется. ИМ решает доставить группу заказов самостоятельно
    • "1" - требуется забор. ИМ требуется услуга забора заказов со склада ИМ с привлечением ресурсов ТД
  2. address (адрес забора) - Устанавливается только для заявок, по которым требуется забор (need = 1). Адрес, по которому ТД заберет заказы у ИМ
  3. contacts (контакты для связи) - Устанавливается только для заявок, по которым требуется забор (need = 1). Содержит, как правило, текст с телефоном или другими контактами для связи
  4. intakeDate (дата и интервал забора) - Устанавливается только для заявок, по которым требуется забор (need = 1). Показывает на какую дату и время назначена отгрузка заказов со склада ИМ. Имеет атрибуты:
    • —— date (дата забора) - дата забора заказов, не может быть выходным или праздничным днем, должна быть сторого больше текущей даты, не может быть больше 14 дней относительно текущей даты
    • —— bTime (верхняя граница интервала забора) - время, после которого ИМ готов отгрузить заказы экспедиторам ТД
    • —— eTime (нижняя граница интервала забора) - время, до которого ИМ готов отгрузить заказы экспедиторам ТД
responsibleFace(ответственное лицо)
Ответственное лицо со стороны ИМ (из справочников ТД). На текущий момент список id соответствий ответственных лиц высылается отдельным письмом. Впоследствии получение id соответствий будет доступно через api. Принимаемые значения:
  • "id" - означает, что ответственное лицо будет определяться по id (в ИС ТД)
  • "name" - означает, что ФИО ответственного лица будет передано строкой
comment
Комментарий ИМ по данной заявке (не обязательно для заполнения)
orders (заказы в заявке)
Данный блок содержит параметры заказов, прикрепляемых к данной заявке
  1. orderId - Идентификатор заказа в системе ТД
  2. barcode - Строковое представление штрих-кода заказа
  3. webshopNumber - Номер заказа в ИМ
setOnTheWay (установка статуса "В пути")
Блок, указывающий, что создаваемая заявка переводится в статус "В пути". Указывается при необходимости перевести заявку в статус "В пути"
  1. claimId - Идентификатор заявки, для которой будет установлен статус "В пути". Чтобы установить статус "В пути для данной заявки", передавать равным 0
  2. places - Параметры грузовых мест. Имеет атрибуты:
    • —— number - Номер пломбы грузового места
    • —— weight - Вес грузовго места
  3. comment - Комментарий по заявки при переводе в статус "В пути" (не обязательно для заполнения)