Manifests

Models

# Article Model

An article model is an item or asset inside of a manifest, fulfillment, or parcel.

object "article"
The enum for this object

id string
The unique ID of this article, prefixed with art_

item_id string
The ID of the item associated with this article

attributes Array.<"alcohol", "marijuana", "pharma", "dry_ice", "lithium">
Indicates certain aspects of the item that will impact shipping and handling

comment string
A free text field to add any comments about this item

damaged_qty integer (deprecated)
The count of defective items. Deprecated: use defective_qty instead.

defective_qty integer
The count of items identified as defective.

verified_qty integer (deprecated)
The count of verified items. Deprecated: use received_qty instead.

received_qty integer
The count of items that have been received.

manifested_qty integer
This value can be updated by the end user for staging inventory, like in a common two-step pick & pack process for a fulfillment. For a manifest, this value is prefilled indicating how many items are expected in the manifest.

requested_qty integer
The count of items being requested in a fulfillment or parcel. When used for a manifest, it counts how many items were requested.

picked_qty integer
The picked quantity of the item or asset.

packed_qty integer
The packed quantity of the item or asset.

gtin string
The Global Trade Item Number, typically found on barcodes

sku string
The unique identifier that is added by you for this item

harmonized_code string
The harmonized system code for the item. This is required if you will be shipping this item internationally

image_url string
A thumbnail image for the inventory

image_urls Array.<string>
Other images for the inventory

name string
The name of the item

origin_country string
The two character country code. ISO 3166-1 alpha-2

vendor string
The company that created the inventory

value integer
The value of the inventory

value_added_services object[]
Value-added services requested for the inventory item. See Value Added Services

packaged_length float
The length in inches of the product packaging

packaged_width float
The width in inches of the product packaging

packaged_height float
The height in inches of the product packaging

packaged_weight float
The weight in pounds (lbs) of the product packaging

order_line_number string
The order line number for the item in the article

ship_ready boolean
Indicates whether the item associated to the article is ready to ship.

metadata object
These are your metadata key value pairs added to the article

description string
The description of the item associated to this article.

tariff_codes array
The tariff codes of the item associated to this article

manufacturer_numbers Array.<string>
The manufacturer or serial numbers of the individual assets in this article.

is_asset boolean
Indicates whether this article represents an asset item.

asset_id string
The ID of the asset associated with this article, if applicable.

layout object
Layout information associated with this article.

article_levels object
Represents the layouts from which the article quantity is picked or packed. The object contains two keys; recommended and others. recommended contains an array of layouts from which the user has picked the items from, or the layouts that the user should pick the items from, based on org settings. others is an array of layouts on which additional quantity for the article item is available. Each entry in these arrays contains the layout and location information, as well the quantity of the item available, picked and packed from the said layout when fulfilling an order.

reason_code ReasonCode
Reason code associated with this article

# Manifest Model

The manifest model represents a unique manifest containing the inventory that you would like to track.

object "manifest"
The description of the model.

created_at integer
Time in epoch seconds when this resource was created

estimated_delivery_at integer
Time in epoch seconds when the last package of the manifest is going to arrive. This date is derived from tracking numbers entered when creating the manifest.

id string
The unique ID given to this manifest prefixed with mfst_

inventory Array.<Article>
The inventory that is included in the manifest

articles Array.<Article>
The articles that are included in the manifest

location_id string
The ID of the location to which this manifest is being delivered

metadata object
These are your metadata key value pairs added to the manifest

order_number string
The order number that either you provided to the manifest or that PackageX added automatically

organization_id string
The ID of the organization that owns this manifest. In almost all cases, this will be your organization ID.

arrived_at integer
The timestamp at which the manifest arrived.

processing_at integer
The timestamp at which the manifest processing was started.

processed_at integer
The timestamp at which the manifest processing was completed.

rejected_at integer
The timestamp at which the manifest was rejected.

reason_code object
The reason code associated to the manifest. See the Reason Codes.

external_id string
The external id of the manifest.

alternate_external_id string
Alternate external id of the manifest.

invoice_number string
The invoice number of the manifest.

purchase_order_number string
The purchase order number of the manifest.

reference_number string
The reference number of the manifest.

customer_purchase_order_number string
The customer purchase order number of the manifest.

container_number string
Container number of the overall manifest.

load_number string
The load number of the manifest.

linked_fulfillment object
An object containing the id of the associated fulfillment. This is populated when fulfilling goods from one location within the org to another.

parent_manifest object
If the org setting for manifest partial completion option is set to create_new, a new manifest is created from any remaining article quantities not received in the current manifest. parent_manifest is populated in the newly created manifest with the id of the current one.

options object
Additional options for the manifest

tracking_number string
The primary tracking number for this manifest.

tracking_numbers Array.<string>
A list of all tracking numbers for this manifest. When added, trackers will be created for each tracking number which will then update the estimated_delivery_at property.

tracker_id string
The ID of the tracker associated with this manifest, prefixed with trk_.

special_handling_tags Array.<string>
An array of special handling tags applied to the manifest. These indicate handling requirements such as ftl, ltl, lithium, frozen, hazmat, fragile, etc.

location object
The location object associated with this manifest.

checksum string
A checksum hash computed from the manifest data, used for change detection.

updated_by string
The ID of the user or API key that last updated this manifest.

attachments Array.<ManifestAttachment>
An array of documents associated with this manifest.

recipient object
Details about the contact receiving this shipment

sender object
Details about the contact sending this shipment

shipment_info object
Details about the shipment being received

parcels Array.<Parcel>
All parcels in the manifest and the inventory packed within them. See the Parcel Model for full details.

status string
The status of the manifest

updated_at integer
Time in epoch seconds when this manifest was last updated