The following is our "middle of the road" file format in terms of amount of data provided. It is typically sent via email, and can be sent either hourly (when data is available) or daily. Once you are ready to begin receiving data in this format, please send email to firstname.lastname@example.org specifying that you want to receive the gen-disp format, give us the email address to which you want it sent, and let us know the schedule (hourly or daily) on which you want us to generate the data.
The file uses standard CSV (comma-separated values) format.
Name Field Max Size, Format ====================================================== Our internal shipment identifier 11 IBC's HAWB 11 only digits Customer Reference 11 Full HAWB 22 Only if requested Shipment creation date 10 YYYYMMDD, Only if requested US port of entry 3 Only if requested & appropriate Disposition Code Date 10 YYYYMMDD Disposition Code Time 4 HHMM Disposition Code 2 Disposition Code Explanation 63 POD Date 10 YYYYMMDD POD Time 4 HHMM POD 25
If you want either of the fields that say "Only if Requested" above, then please indicate this in your email request.
The disp code (disposition code) fields are used to provide updates other than PODs. For a complete list of codes and their meanings see our disposition code list.
A shipment's creation and POD aren't normally considered events in our system, but if you request we can send them to you as such. We'll use "_A" as the disposition code for the creation (add) event and "_P" for the POD event.
Here are some sample data files in Gen-Disp format.