Skip to content
Last updated

Orchestration Status for Empty Returns

If the container has gated out from the facility, the orchestration is now ready to receive a drop empty (Empty Return) appointment request (see “Empty Returns” section above). Once the request is accepted, another location will appear in the ‘locations’ array with ‘locationstatus_cd’ = ‘PND’ (Pending). This location will hold the information regarding the requested appointment. Please note that the active location continues to be the last facility to report the container. See example below. Locations array has two locations: ‘locationtype_cd’ = ‘D’ (destination) holds the information about the empty return appointment. Appointment information is located under “arrivalinfo”:

{ 
  "unitinfo": { 
    "unit_cat": "CONTAINER", 
    "unit_nbr": "ABCD1234567", 
    "unittypeiso_cd": "22G1", 
    "unitsztype_cd": "20SD", 
    "ownerline_scac": "ABCD", 
    "ownerline_cd": "AB", 
    "tare_wgt": "2200.0",
    "tarewgt_unit": "Kilograms", 
    "lastpretrip_dttm": null 
  },  
  "unitstatusinfo": { 
    "status_cd": "O" 
    "status_desc": "GATE OUT", 
    "unituse_cd": "I",  
    "unituse_desc": "IMPORT" 
  }, 
  "locations": [
    {
      "port_cd": "PORTA",
      "port_nm": "Port of A",
      "facility_cd": "FCLTA",
      "facility_nm": "Facility A",
      "locationtype_cd": "O",
      "guarantee_through_date": "2022-10-25",
      "reservation_preferences": null,
      "seq_nbr": "1",
      "locationstatus_cd": "ACT",
      "locationinfo": {
        "arrivalinfo": {
          "carriertype_cd": "VC",
          "carriertype_desc": "VESSEL",
          "vesselinfo": {
            "vessel_cd": "12345678",
            "voyage_nbr": "011A",
            "vesseltype_cd": "L",
            "estarrival_dt": "",
            "actarrival_dt": ""
          }
        },
        "departureinfo": { 
          "carriertype_cd": "MC", 
          "carriertype_desc": "Motor Carrier", 
          "appointment_info": { 
            "reservation_status": "COMPLETED",  
            "ticket_nbr": "FCLTA-1234-1234",  
      	     "gate_cd": "1234",  
            "trucker_info": { 
              "trucker_scac": "ABCT", 
              "rfid_nbr": "", 
              "plate_nbr": "", 
              "company_nm": "ABCT TRANSPORT INC"
            }, 
            "driverinfo": { 
              "first_nm": "J", 
              "last_nm": "Doe" 
            }, 
            "slot_info": { 
              "visit_dt": "2022-10-21", 
              "visitstart_tm": "07:00", 
              "visitend_tm": "07:30", 
            },
            "units: [
              {
                "move": "IP",
                "unit_nbr": " ABCD1234567",
                "unit_category": "CN",
                "line_scac": "ABCL",
                "sztype_iso": "22G1",
                "sztype_cd": "20SD",
                "yard_spot": "B013",
                "seal_nbrs": [],
                "spcl_instructions": [
                  {
                    "instructions": ""
                  } 
                ]
              }
            ]
          }
        },
        "cargoinfo": { 
          "bol_nbr": "ABC12345", 
          "reefer_flg": null, 
          "temp_min": null, 
          "mintemp_uom": null, 
          "temp_max": null, 
          "maxtemp_uom": null, 
          "hazmat_flg": null, 
          "imoclass_cd": null, 
          "od_flg": null, 
          "seal_nbr": null, 
          "bcocompany_nm": null, 
          "userline_scac": null 
        },
        "currentconditioninfo": { 
          "damaged_flg": null, 
          "yard_loc": "AB10", 
          "block_nbr": null, 
          "supply_temp": null, 
          "return_temp": null, 
          "set_temp": null, 
          "fullempty_cd": "FULL", 
          "gross_wgt": 30480, 
          "grosswgt_unit": "Kilograms", 
          "actual_wgt": null, 
          "actualwgt_unit": null
        } 
      }
    },
    {
      "port_cd": "PORTA",
      "port_nm": "Port of A",
      "facility_cd": "FCTLA",
      "facility_nm": "Facility A",
      "locationtype_cd": "D",
      "guarantee_through_date": null,
      "reservation_preferences: null,
      "seq_nbr": "2",
      "locationstatus_cd": "PND",
      "locationinfo": {
        "arrivalinfo": {
          "carriertype_cd": "MC",
          "carriertype_desc": "Motor Carrier",
          "vesselinfo": null,
          "carrier_cd": null,
          "appointment_info": {
            "reservation_status": "CONFIRMED",
            "ticket_nbr": "FCTA-4321-4321",
            "gate_code": "",
            "trucker_info": {
              "trucker_scac": "ABCT",
              "rfid_nbr": "",
              "plate_nbr": "",
              "company_nm": null
            },
            "driverinfo": {
              "first_nm": "",
              "last_nm": ""
            },
            "slot_info": {
              "visit_dt": "2022-09-29",
              "visitstart_tm": "08:00",
              "visitend_tm": "09:00"
            },
            "units": [
              {
                "move": "MD",
                "unit_nbr": " ABCD1234567",
                "unit_category": "CN",
                "line_scac": "ABCL",
                "sztype_iso": "4270",
                "sztype_cd": null,
                "yard_spot": "",
                "seal_nbrs": [],
                "spcl_instructions": [
                  {
                    "instructions": ""
                  }
                ]
              }
            ]
          }
        },
        "departureinfo": null,
        "cargoinfo": { 
          "bol_nbr": "ABC12345", 
          "reefer_flg": null, 
          "temp_min": null, 
          "mintemp_uom": null, 
          "temp_max": null, 
          "maxtemp_uom": null, 
          "hazmat_flg": null, 
          "imoclass_cd": null, 
          "od_flg": null, 
          "seal_nbr": null, 
          "bcocompany_nm": null, 
          "userline_scac": null 
        },
        "currentconditioninfo": { 
          "damaged_flg": null, 
          "yard_loc": "AB10", 
          "block_nbr": null, 
          "supply_temp": null, 
          "return_temp": null, 
          "set_temp": null, 
          "fullempty_cd": "FULL", 
          "gross_wgt": 30480, 
          "grosswgt_unit": "Kilograms", 
          "actual_wgt": null, 
          "actualwgt_unit": null
        } 
      }
    }

  ], 
  "holdinfo": [
    { 
      "type": "FEE", 
      "status": "RELEASED", 
      "status_dttm": "2022-10-20T17:17:34.294476", 
      "details": [ 
        { 
          "hold_dttm": "2022-10-20T15:15:51.287916", 
          "holdreason_cd": "DWELL", 
          "holdreason_desc": "DWELL", 
          "release_dttm": "2022-10-20T17:17:34.294476", 
          "reportedby": "ABCL" 
        } 
      ] 
    }
  ],
  "fee_receipts": [
    {
      "fee_cd": "DWT",
      "fee_desc": "Extended Dwell Time Fee Through 2022-10-20",
      "fee_amt": "70.00",
      "fee_paid_dttm": "2022-10-20T17:17:34.294476"
    },
    {
      "fee_cd": "4I",
      "fee_desc": "Demurrage Through 2022-10-20",
      "fee_amt": "285.00",
      "fee_paid_dttm": "2022-10-20T17:17:34.294476"
    }
  ],
  "lfdinfo": {
    "good_through_date": "2022-10-20",
    "last_free_day": "2022-10-17"
  },
  "activity": [ 
    {
      "seq_nbr": 1,
      "event_cd": "CNMAN",
      "event_desc": "Container Manifested",
      "event_dttm": null,
      "facility_cd": null,
      "facility_nm": null,
    },
    {
      "seq_nbr": 2,
      "event_cd": "DISCH",
      "event_desc": "Discharged",
      "event_dttm": "2022-10-11T15:13:11",
      "facility_cd": "FCLTA",
      "facility_nm": "Facility A",
    },
    {
      "seq_nbr": 3,
      "event_cd": "LFDAY",
      "event_desc": "Last Free Day",
      "event_dttm": "2022-10-17T23:59:00",
      "facility_cd": "FCLTA",
      "facility_nm": "Facility A"
    },
    {
      "seq_nbr": 4,
      "event_cd": "PLAVI",
      "event_desc": "Ready for pick up",
      "event_dttm": "2022-10-11T15:16:07",
      "facility_cd": "FCLTA",
      "facility_nm": "Facility A"
    },
    {
      "seq_nbr": 5,
      "event_cd": "APNMT",
      "event_desc": "Pregate",
      "event_dttm": "2022-10-21T07:00:00",
      "facility_cd": "FCLTA",
      "facility_nm": "Facility A"
    },
    {
      "seq_nbr": 6,
      "event_cd": "DPTRM",
      "event_desc": "Departed Terminal",
      "event_dttm": "2022-10-21T07:30:00",
      "facility_cd": "FCLTA",
      "facility_nm": "Facility A"

    },
    {
      "seq_nbr": 9,
      "event_cd": "ARCUS",
      "event_desc": "Arrived at customer",
      "event_dttm": null,
      "facility_cd": null,
      "facility_nm": null,
    },
    {
      "seq_nbr": 10,
      "event_cd": "EMTOT",
      "event_desc": "Empty released by customer",
      "event_dttm": null,
      "facility_cd": null,
      "facility_nm": null,
    },
    {
      "seq_nbr": 11,
      "event_cd": "EMTRC",
      "event_desc": "Empty Received",
      "event_dttm": null,
      "facility_cd": null,
      "facility_nm": null,
      "unitevent_uid": ""
    }
  ]
}