The parcel object
A comprehensive list of the parcel resource's attributes and relationships
A parcel object is returned as part of the response body of each successful list, retrieve, create or update API call to the /api/parcels
endpoint.
Fields
Field | Type | Description |
---|---|---|
type |
|
|
id |
| The parcel unique identifier |
links.self |
| The parcel endpoint URL |
attributes.carrier_weight_oz |
| The weight of the parcel as measured by the carrier in ounces (if available). |
attributes.contents_explanation |
| If you specify 'other' in the 'contents_type' attribute, you must supply a brief description in this attribute. |
attributes.contents_type |
| The type of item you are sending. |
attributes.created_at |
| Time at which the resource was created. |
attributes.customs_certify |
| Indicates if the provided information is accurate. |
attributes.customs_info_required |
| Indicates if the parcel requires customs info to get the shipping rates. |
attributes.customs_signer |
| This is the name of the person who is certifying that the information provided on the customs form is accurate. Use a name of the person in your organization who is responsible for this. |
attributes.delivery_confirmation |
| The type of delivery confirmation option upon delivery. |
attributes.eel_pfc |
| When shipping outside the US, you need to provide either an Exemption and Exclusion Legend (EEL) code or a Proof of Filing Citation (PFC). Which you need is based on the value of the goods being shipped. Value can be one of "EEL" o "PFC". |
attributes.incoterm |
| The type of Incoterm (if available). |
attributes.metadata |
| Set of key-value pairs that you can attach to the resource. This can be useful for storing additional information about the resource in a structured format. |
attributes.non_delivery_option |
| In case the shipment cannot be delivered, this option tells the carrier what you want to happen to the parcel. You can pass either 'return', or 'abandon'. The value defaults to 'return'. If you pass 'abandon', you will not receive the parcel back if it cannot be delivered. |
attributes.number |
| Unique identifier for the parcel. |
attributes.reference |
| A string that you can use to add any external identifier to the resource. This can be useful for integrating the resource to an external system, like an ERP, a marketing tool, a CRM, or whatever. |
attributes.reference_origin |
| Any identifier of the third party system that defines the reference code. |
attributes.restriction_comments |
| If you specify 'other' in the restriction type, you must supply a brief description of what is required. |
attributes.restriction_type |
| Describes if your parcel requires any special treatment or quarantine when entering the country. Can be one of 'none', 'other', 'quarantine', or 'sanitary_phytosanitary_inspection'. |
attributes.shipping_label_file_type |
| The shipping label file type. One of 'application/pdf', 'application/zpl', 'application/epl2', or 'image/png'. |
attributes.shipping_label_resolution |
| The shipping label resolution. |
attributes.shipping_label_size |
| The shipping label size. |
attributes.shipping_label_url |
| The shipping label url, ready to be downloaded and printed. |
attributes.signed_by |
| The name of the person who signed for the parcel (if available). |
attributes.tracking_details |
| The parcel's full tracking history, automatically updated in real time by the shipping carrier. |
attributes.tracking_number |
| The tracking number associated to this parcel. |
attributes.tracking_status |
| The tracking status for this parcel, automatically updated in real time by the shipping carrier. |
attributes.tracking_status_detail |
| Additional information about the tracking status, automatically updated in real time by the shipping carrier. |
attributes.tracking_status_updated_at |
| Time at which the parcel's tracking status was last updated. |
attributes.unit_of_weight |
| The unit of weight. One of 'gr', 'oz', or 'lb'. |
attributes.updated_at |
| Time at which the resource was last updated. |
attributes.weight |
| The parcel weight, used to automatically calculate the tax rates from the available carrier accounts. |
relationships.attachments |
| The associated attachments. |
relationships.events |
| The associated events. |
relationships.package |
| The associated package. |
relationships.parcel_line_items |
| The line items in this parcel. |
relationships.shipment |
| The associated shipment. |
relationships.versions |
| The associated changes. |
meta.mode |
| The resource environment (can be one of |
Last updated