The package
object is included in the Create Package and Update Package requests and returned as part of some webhook callbacks.
About Packages
Send the create, update, or upsert package requests to send Bringg details about the dimensions of packages included in an order. In the API response, Bringg provides a label that you can print and attach to the package.
The label is provided as a link to a ZPL file and a ZPL file encoded in base64 format.
Package Details
Below is a list of parameters you can send to Bringg as part of the package
object, for example, when sending the Create Package request.
Read our Data Formatting article for more details about how different parameter types, such as datetime, are formatted and used in Bringg.
Parameter | Description | Validations and Notes |
---|---|---|
| A description of the package. | For example, a detailed description of the package contents. |
| Your external system's ID for this package. | Required if |
| Your external system's ID for the associated order. | Required if |
| Custom attributes associated with this package. | JSON format of field and value. For example: |
| Your external system's ID for the carrier assigned with the package. | |
| The measurement unit for the package height. | Required. |
| The package height. | Required. |
| Bringg's ID for the package. | Required if |
| The measurement unit for the package length. | Required. |
| The package length. | Required. |
| The package title. | For example, a short description of what is included in the package. |
| A note related to this package. | |
| When an order contains multiple packages, include a sequence number for each package to quickly identify individual packages. | |
| Bringg's ID for the associated order. | Required if |
| The measurement unit for the package volume. | Required if |
| The package volume. | Required if |
| The measurement unit for the package weight. | Required. |
| The measurement unit for the package weight. | Required. |
| The measurement unit for the package width. | Required. |
| The package width. | Required. |
Response & Webhook Data
Below is a list of the data returned in webhooks and responses to your API requests. The inclusion of specific parameters may depend on your use case, your API request, and the webhook fields you have subscribed to.