Tạo Job

Body yêu cầu

• jobNamestringBắt buộc
  Tên job
• jobStatusintegerBắt buộc
  0=New, 1=Scheduled, 2=InProgress
• jobTypeintegerBắt buộc
  0=Unknown, 1=Shipment, 2=Service
• jobDescriptionstringTuỳ chọn
  Mô tả job
• metaDatastringTuỳ chọn
  Chuỗi JSON metadata tuỳ chỉnh
• tasksarrayBắt buộc
  Mảng các đối tượng task (xem các trường Task bên dưới)

Các trường Task

• taskNamestringBắt buộc
  Tên task
• taskTypeintegerTuỳ chọn
  0=Unknown, 1=Shipment, 2=Service
• priorityintegerTuỳ chọn
  0=Low, 1=Medium, 2=High
• descriptionstringTuỳ chọn
  Mô tả task
• contactNamestringTuỳ chọn
  Tên người liên hệ
• contactPhonestringTuỳ chọn
  Số liên hệ
• startDtlongTuỳ chọn
  Thời gian bắt đầu theo lịch (Unix ms)
• endDtlongTuỳ chọn
  Thời gian kết thúc theo lịch (Unix ms)
• startTimeintegerTuỳ chọn
  Khung giờ bắt đầu (số phút kể từ nửa đêm)
• endTimeintegerTuỳ chọn
  Khung giờ kết thúc (số phút kể từ nửa đêm)
• serviceTimeintegerTuỳ chọn
  Thời gian dịch vụ tính theo phút
• setupTimeintegerTuỳ chọn
  Thời gian chuẩn bị tính theo phút
• placeobjectTuỳ chọn
  Đối tượng place — xem các trường Place bên dưới. Dùng API Search Places để lấy refId hợp lệ.
• metaDatastringTuỳ chọn
  Chuỗi JSON metadata tuỳ chỉnh ở cấp task
• skillIdUUIDTuỳ chọn
  ID kỹ năng yêu cầu cho task này
• shipmentPropertyobjectCó điều kiện
  Bắt buộc với Shipment job — xem bên dưới

Các trường place

• idUUIDTuỳ chọn
  ID của một place đã tồn tại (nếu đã có trong sổ địa chỉ)
• refIdstringBắt buộc
  ID tham chiếu bên ngoài của bạn cho place này (xem Search Places)
• namestringTuỳ chọn
  Tên place
• addressstringTuỳ chọn
  Địa chỉ đầy đủ
• latnumberTuỳ chọn
  Vĩ độ
• lngnumberTuỳ chọn
  Kinh độ
• contactPersonstringTuỳ chọn
  Tên người liên hệ
• contactNumstringTuỳ chọn
  Số liên hệ
• startTimeintegerTuỳ chọn
  Khung giờ bắt đầu (số phút kể từ nửa đêm)
• endTimeintegerTuỳ chọn
  Khung giờ kết thúc (số phút kể từ nửa đêm)

Các trường shipmentProperty (chỉ cho Shipment job)

• shipmentTypeintegerBắt buộc
  1=Pick, 2=Drop

{
  "jobName": "Delivery Job Q1",
  "jobDescription": "Morning delivery run",
  "jobStatus": 1,
  "jobType": 1,
  "tasks": [
    {
      "taskName": "Pick up goods",
      "taskType": 1,
      "priority": 1,
      "contactName": "Mr. Tuan",
      "contactPhone": "+84901234567",
      "shipmentProperty": { "shipmentType": 1 },
      "place": {
        "refId": "WH-001",
        "name": "Main Warehouse",
        "address": "100 Warehouse St, D7",
        "lat": 10.74,
        "lng": 106.72
      }
    },
    {
      "taskName": "Deliver to Customer A",
      "taskType": 1,
      "priority": 1,
      "contactName": "Ms. Lan",
      "contactPhone": "+84907654321",
      "shipmentProperty": { "shipmentType": 2 },
      "place": {
        "refId": "CUST-A-001",
        "name": "Customer A Location",
        "address": "123 Le Loi, D1",
        "lat": 10.7731,
        "lng": 106.703
      }
    }
  ]
}