Advanced Shipment Notice (ASN)

This document describes ASN file format and gives examples.

Fields

Field	Type	Description
actual_arrival_time	string (date-time)	The actual arrival time of the shipment, used for received shipments only
actual_release_date deprecated	string (date)	The actual date on which the material is released from the shipment
bill_of_lading	string	The bill of lading number for the shipment
release_bundle_count	integer	The number of bundles in the shipment
buyer_reference_id	string	The buyer reference ID for the shipment
estimated_arrival_time	string (date-time)	The estimated arrival time of the shipment
expected_release_date deprecated	string (date-time)	The expected date on which the material is released from the shipment
gross_weight	integer	The gross weight of the shipment
inbound_batch_id	string	The inbound batch ID for a line item in a shipment
material_brand	string	The grade/brand information of the material in the shipment
net_scale_weight	integer	The net scale weight of the shipment, used for received shipments only
net_weight	integer	The net weight of the shipment
occurred_at	string (date-time)	The time the record is taken to have occurred. This is used to determine the order in which updates are applied
order_type	"TRADE" | "CONSIGNMENT" | "STOCK_TRANSFER"	The order type for this shipment i.e. if this trade is being received against a trade or into csignment
outbound_batch_id	string	The outbound batch ID for a line item in a shipment
purchase_order	string	The PO number associated with the shipment
rail_car_number	string	The rail car number. If it is provided then the shipment will be created as a rail car
rail_carrier_org	string	The rail carrier. If it is provided then the shipment will be created as a rail car
rail_waybill_number	string	The rail waybill number. If it is provided then the shipment will be created as a rail car
received_status	"RECEIVED" | "NOT_RECEIVED" | "REVERSED"	The receiving status of the shipment
sales_order	string	The Sales order number associated with the shipment
seal_numbers	string	The seal numbers of the shipment. Used for truck and rail shipments
seller_reference_id	string	The seller reference ID for the shipment
ship_from_location	string	The location the shipment originated from, it can be owned by either the ship_to_org or ship_from_org. When parsing the ship from location we check if a location translation exists that is owned by the ship from org first. If no location translation exists then we check if a location translation exists that is owned by the ship to org.
ship_from_org_integration_id	string	The integration ID (e.g from an ERP system) of the organization that handles the shipping of the material. This field is required if ship_from_org is not provided.
ship_from_org	string	The organization that handles the shipping of the material. This field is required if ship_from_org_id is not provided.
ship_to_location required	string	The location where the shipment will be received. It has to be owned by the ship_to_org or - the case of a third party location - one of its counterparties. This must be provided when creating a new shipment i.e. if the waybridge_shipment_id is not specified
ship_to_org_integration_id	string	The integration ID (e.g from an ERP system) of the organization that will receive the shipment.his field is required if ship_to_org is not provided.
ship_to_org	string	The organization that will receive the shipment. This field is required if ship_to_org_id is provided.
shipping_datetime	string	The datetime at which the shipment was loaded
sold_to_org	string	The organization that the shipment was sold to
storage_location	string	The storage location for the shipment, used for received shipments only
trade_period	string (YYYY-MM)	The trade quotation period for the shipment
transportation_method required	"TRUCK" | "RAIL" | "VESSEL" | "ON_SITE"	The transportation method for the shipment
truck_carrier_org	string	The truck’s carrier. If it is provided then the shipment will be created as a truck
truck_driver_license_number	string	The truck driver’s license number
truck_driver_name	string	The truck driver’s name
truck_driver_phone_number	string	The truck driver’s phone number
truck_license_plate_number	string	The truck’s license plate number
truck_tractor_number	string	The truck’s tractor number. If it is provided then the shipment will be created as a truck
truck_trailer_number	string	The truck’s trailer number. If it is provided then the shipment will be created as a truck
truck_transportation_provider_org	string	The transportation provider that will facilitate the delivery of the truck shipment. If it is provided then the shipment will be created as a truck
vessel_carrier	string	The vessel carrier. If it is provided then the shipment will be created as a vessel
vessel_name	string	The vessel name. If it is provided then the shipment will be created as a vessel
vessel_type	"BARGE" | "BREAK_BULK" | "CONTAINER"	The vessel type. If it is provided then the shipment will be creed as a vessel
waybill_creation_datetime	string	The datetime at which the waybill was created
waybridge_bol_line_item_id	string	The MineHub Batch ID for a shipment. It is globally unique within the MineHub platform. It used to specify the batch (BOL Line Item) that the bulk upload is trying to update.
weight_uom	"MT" | "LB"	The unit of measurement for the weights of the shipment