Registers a new yard movement

POST /api/yard/{yardId}/movement

If a trailer_id/truck_id is not given a new trailer/truck will be created, if given, then it will be looked up and if it does not exist that id will be ignored

Headers

  • Specify effective organization_id for Admin and Group Organization Admins. This is a global header for all endpoints only taken into consideration when it makes sense (it won't be used in Auth, for example)

Path parameters

application/json

Body

Responses

POST /api/yard/{yardId}/movement
curl \
 -X POST http://localhost:8080/api/yard/{yardId}/movement \
 -H "Content-Type: application/json" \
 -d '{"attachment_ids":[42],"attachment_picture_ids":[42],"bill_of_lading_photo_id":42,"bol_number":"string","chassis_number":"string","chassis_size":"string","comments":"string","destination":"string","direction":"IN","driver_id":42,"driver_license":"string","driver_license_expiration":"2024-05-04T09:42:00+00:00","driver_license_picture_id":42,"driver_name":"string","driver_notification_email":"string","driver_notification_phone":"string","driver_notification_preference_channel":"EMAIL","driver_photo_id":42,"driver_safety_card_picture_id":42,"extra_trailers":[{"carrier_id":42,"client":"string","custom_fields":{"key":"string"},"id":42,"inside_picture_id":42,"left_image_id":42,"no_seal":true,"number":"string","number_inference":"string","other_carrier":"string","priority":true,"rear_picture_id":42,"right_image_id":42,"seal":"string","seal_picture_ids":[42],"status":"EMPTY","type":"string"}],"inside_trailer_picture_id":42,"left_trailer_image_id":42,"license_plate_photo_id":42,"load":"string","main_trailer":{"carrier_id":42,"client":"string","custom_fields":{"key":"string"},"id":42,"inside_picture_id":42,"left_image_id":42,"no_seal":true,"number":"string","number_inference":"string","other_carrier":"string","priority":true,"rear_picture_id":42,"right_image_id":42,"seal":"string","seal_picture_ids":[42],"status":"EMPTY","type":"string"},"movement_timestamp":"2024-05-04T09:42:00+00:00","no_seal":true,"other_trailer_carrier":"string","other_truck_carrier":"string","pager_number":"string","precheck_id":42,"purpose":"string","rear_trailer_picture_id":42,"right_trailer_image_id":42,"safety_video_confirmation":true,"seal":"string","seal_picture_ids":[42],"shipment_id":"string","sku":"string","spare_tire_truck_photo_id":42,"status":"EMPTY","tanker_status":"string","trailer":"string","trailer_carrier_id":42,"trailer_client":"string","trailer_custom_fields":{"key":"string"},"trailer_id":42,"trailer_location":{"level":"string","row":"string","values":["string"],"zone":"string"},"trailer_number_inference":"string","trailer_priority":true,"trailer_type":"string","truck_carrier_id":42,"truck_carrier_info_photo_id":42,"truck_fuel_type":"CNG","truck_id":42,"truck_image_id":42,"truck_left_photo_id":42,"truck_number":"string","truck_right_photo_id":42,"truck_type":"BOX","vehicle_image_id":42,"visit_type":"TRACTOR","visitor_badge_number":"string","visitor_company":"string","visitor_email":"string","visitor_host":"string","visitor_host_account_id":42,"visitor_name":"string","visitor_person_photo_id":42,"visitor_phone_number":"string","visitor_type":"PERSON","wash_out_slip_photo_id":42}'
Request examples
# Headers

# Payload
{
  "attachment_ids": [
    42
  ],
  "attachment_picture_ids": [
    42
  ],
  "bill_of_lading_photo_id": 42,
  "bol_number": "string",
  "chassis_number": "string",
  "chassis_size": "string",
  "comments": "string",
  "destination": "string",
  "direction": "IN",
  "driver_id": 42,
  "driver_license": "string",
  "driver_license_expiration": "2024-05-04T09:42:00+00:00",
  "driver_license_picture_id": 42,
  "driver_name": "string",
  "driver_notification_email": "string",
  "driver_notification_phone": "string",
  "driver_notification_preference_channel": "EMAIL",
  "driver_photo_id": 42,
  "driver_safety_card_picture_id": 42,
  "extra_trailers": [
    {
      "carrier_id": 42,
      "client": "string",
      "custom_fields": {
        "key": "string"
      },
      "id": 42,
      "inside_picture_id": 42,
      "left_image_id": 42,
      "no_seal": true,
      "number": "string",
      "number_inference": "string",
      "other_carrier": "string",
      "priority": true,
      "rear_picture_id": 42,
      "right_image_id": 42,
      "seal": "string",
      "seal_picture_ids": [
        42
      ],
      "status": "EMPTY",
      "type": "string"
    }
  ],
  "inside_trailer_picture_id": 42,
  "left_trailer_image_id": 42,
  "license_plate_photo_id": 42,
  "load": "string",
  "main_trailer": {
    "carrier_id": 42,
    "client": "string",
    "custom_fields": {
      "key": "string"
    },
    "id": 42,
    "inside_picture_id": 42,
    "left_image_id": 42,
    "no_seal": true,
    "number": "string",
    "number_inference": "string",
    "other_carrier": "string",
    "priority": true,
    "rear_picture_id": 42,
    "right_image_id": 42,
    "seal": "string",
    "seal_picture_ids": [
      42
    ],
    "status": "EMPTY",
    "type": "string"
  },
  "movement_timestamp": "2024-05-04T09:42:00+00:00",
  "no_seal": true,
  "other_trailer_carrier": "string",
  "other_truck_carrier": "string",
  "pager_number": "string",
  "precheck_id": 42,
  "purpose": "string",
  "rear_trailer_picture_id": 42,
  "right_trailer_image_id": 42,
  "safety_video_confirmation": true,
  "seal": "string",
  "seal_picture_ids": [
    42
  ],
  "shipment_id": "string",
  "sku": "string",
  "spare_tire_truck_photo_id": 42,
  "status": "EMPTY",
  "tanker_status": "string",
  "trailer": "string",
  "trailer_carrier_id": 42,
  "trailer_client": "string",
  "trailer_custom_fields": {
    "key": "string"
  },
  "trailer_id": 42,
  "trailer_location": {
    "level": "string",
    "row": "string",
    "values": [
      "string"
    ],
    "zone": "string"
  },
  "trailer_number_inference": "string",
  "trailer_priority": true,
  "trailer_type": "string",
  "truck_carrier_id": 42,
  "truck_carrier_info_photo_id": 42,
  "truck_fuel_type": "CNG",
  "truck_id": 42,
  "truck_image_id": 42,
  "truck_left_photo_id": 42,
  "truck_number": "string",
  "truck_right_photo_id": 42,
  "truck_type": "BOX",
  "vehicle_image_id": 42,
  "visit_type": "TRACTOR",
  "visitor_badge_number": "string",
  "visitor_company": "string",
  "visitor_email": "string",
  "visitor_host": "string",
  "visitor_host_account_id": 42,
  "visitor_name": "string",
  "visitor_person_photo_id": 42,
  "visitor_phone_number": "string",
  "visitor_type": "PERSON",
  "wash_out_slip_photo_id": 42
}
Response examples (201)
{"attachment_ids"=>[42], "attachment_picture_ids"=>[42], "bill_of_lading_photo_id"=>42, "bol_number"=>"string", "chassis_number"=>"string", "chassis_size"=>"string", "comments"=>"string", "created_at"=>"2024-05-04T09:42:00+00:00", "created_by"=>"string", "destination"=>"string", "direction"=>"IN", "driver_id"=>42, "driver_license"=>"string", "driver_license_picture_id"=>42, "driver_name"=>"string", "driver_notification_email"=>"string", "driver_notification_phone"=>"string", "driver_notification_preference_channel"=>"EMAIL", "driver_photo_id"=>42, "driver_safety_card_picture_id"=>42, "extra_trailers"=>[{"carrier_id"=>42, "carrier_name"=>"string", "client"=>"string", "destination"=>"string", "id"=>42, "inside_picture_id"=>42, "left_image_id"=>42, "load"=>"string", "movement_id"=>42, "movement_trailer_number"=>"string", "no_seal"=>true, "number"=>"string", "other_carrier"=>"string", "priority"=>true, "purpose"=>"string", "rear_picture_id"=>42, "right_image_id"=>42, "seal"=>"string", "seal_picture_ids"=>[42], "shipment_id"=>"string", "sku"=>"string", "status"=>"EMPTY", "status_desc"=>"string", "tags"=>[{"color"=>"string", "created_at"=>"2024-05-04T09:42:00+00:00", "id"=>42, "last_modified_at"=>"2024-05-04T09:42:00+00:00", "name"=>"string"}], "trailer_location"=>{"level"=>"string", "row"=>"string", "values"=>["string"], "zone"=>"string"}, "trailer_out_movement_id"=>42, "trailer_stay_seconds"=>42, "type"=>"string"}], "id"=>42, "inside_trailer_picture_id"=>42, "inspections"=>[{"attachments"=>[{"attachment_id"=>42, "name"=>"string"}], "created_at"=>"2024-05-04T09:42:00+00:00", "id"=>42, "inspection_content"=>{}, "inspection_type"=>"string", "last_modified_at"=>"2024-05-04T09:42:00+00:00", "trailer_id"=>42, "trailer_number"=>"string", "truck_id"=>42, "truck_number"=>"string", "yard_movement_id"=>42}], "last_modified_at"=>"2024-05-04T09:42:00+00:00", "last_modified_by"=>"string", "left_trailer_image_id"=>42, "license_plate_photo_id"=>42, "load"=>"string", "movement_driver_name"=>"string", "movement_driver_photo_id"=>42, "movement_timestamp"=>"2024-05-04T09:42:00+00:00", "movement_trailer_number"=>"string", "movement_truck_number"=>"string", "no_seal"=>true, "other_trailer_carrier"=>"string", "other_truck_carrier"=>"string", "pager_number"=>"string", "pin"=>42, "pin_valid_until"=>"2024-05-04T09:42:00+00:00", "purpose"=>"string", "rear_trailer_picture_id"=>42, "right_trailer_image_id"=>42, "safety_video_confirmation"=>true, "seal"=>"string", "seal_picture_ids"=>[42], "shipment_id"=>"string", "sku"=>"string", "spare_tire_truck_photo_id"=>42, "status"=>"string", "tanker_status"=>"string", "trailer"=>"string", "trailer_carrier_id"=>42, "trailer_carrier_name"=>"string", "trailer_client"=>"string", "trailer_custom_fields"=>{"key"=>"string"}, "trailer_id"=>42, "trailer_inspection"=>{"attachments"=>[{"attachment_id"=>42, "name"=>"string"}], "created_at"=>"2024-05-04T09:42:00+00:00", "id"=>42, "inspection_content"=>{}, "inspection_type"=>"string", "last_modified_at"=>"2024-05-04T09:42:00+00:00", "trailer_id"=>42, "trailer_number"=>"string", "truck_id"=>42, "truck_number"=>"string", "yard_movement_id"=>42}, "trailer_invalidated"=>true, "trailer_location"=>{"level"=>"string", "row"=>"string", "values"=>["string"], "zone"=>"string"}, "trailer_number"=>"string", "trailer_number_inference"=>"string", "trailer_out_movement_id"=>42, "trailer_priority"=>true, "trailer_stay_seconds"=>42, "trailer_tags"=>[{"associated_at"=>"2024-05-04T09:42:00+00:00", "color"=>"string", "created_at"=>"2024-05-04T09:42:00+00:00", "id"=>42, "last_modified_at"=>"2024-05-04T09:42:00+00:00", "name"=>"string"}], "trailer_type"=>"string", "truck_carrier_id"=>42, "truck_carrier_info_photo_id"=>42, "truck_carrier_name"=>"string", "truck_class"=>"CLASS_2B_3", "truck_fuel_type"=>"CNG", "truck_id"=>42, "truck_image_id"=>42, "truck_inspection"=>{"attachments"=>[{"attachment_id"=>42, "name"=>"string"}], "created_at"=>"2024-05-04T09:42:00+00:00", "id"=>42, "inspection_content"=>{}, "inspection_type"=>"string", "last_modified_at"=>"2024-05-04T09:42:00+00:00", "trailer_id"=>42, "trailer_number"=>"string", "truck_id"=>42, "truck_number"=>"string", "yard_movement_id"=>42}, "truck_invalidated"=>true, "truck_left_photo_id"=>42, "truck_number"=>"string", "truck_out_movement_id"=>42, "truck_right_photo_id"=>42, "truck_stay_seconds"=>42, "truck_type"=>"BOX", "vehicle_image_id"=>42, "visit_type"=>"string", "visitor_badge_number"=>"string", "visitor_company"=>"string", "visitor_email"=>"string", "visitor_host"=>"string", "visitor_host_account_id"=>42, "visitor_name"=>"string", "visitor_person_photo_id"=>42, "visitor_phone_number"=>"string", "visitor_type"=>"PERSON", "wash_out_slip_photo_id"=>42, "yard_id"=>42, "yard_name"=>"string"}