Post Packing Flow

The Post Packing flow confirms that the parcel is physically packed and ready for home delivery pickup. Call this once the parcel is prepared in your warehouse. It follows the Post Purchase call and triggers the final delivery planning with Instabee.

API Endpoint

Endpoint	Method	Content-Type
`api.integration.instabee.com/orders` (production) · `sandbox-api.integration.instabee.com/orders` (sandbox)	PUT	application/json

When to Use

Call this endpoint after:

A parcel has been registered with the Post Purchase API
The order has been physically packed and prepared for shipping
The final dimensions and weight are known (if different from initial estimates)

Integration Levels

Merchants can send information in different steps depending on their workflow:

Bare Minimum: If everything was sent in Post Purchase, just confirm packing
Minimum: Basic confirmation with essential parcel details
Maximum: Complete order details with final dimensions and product information

Key Benefits

Pickup Scheduling: Triggers pickup scheduling and route optimization
Label Generation: Provides shipping labels for the packed parcels
Final Confirmation: Confirms actual dimensions and weight for accurate delivery
Status Updates: Updates tracking status for customers

Integration Workflow

Post Purchase: Initial prebooking reserves delivery capacity
Physical Packing: Pack the order in your warehouse
Post Packing: Confirm packing with this API (final dimensions, weight)
Label Download: Download shipping labels from the response
Pickup: Prepare parcels for scheduled pickup

Next Steps

Complete Parameter Reference: See the Create Order API page for all available parameters
Initial Setup: Start with the Post Purchase API for the prebooking
Integration Guide: Check the Authentication section for API setup

Quick Links

Post Purchase API - Initial prebooking before packing
Availability API - Check delivery options and get tokens

Create Order API (Post Packing)

The Post Packing API is used to update a parcel's status after it has been physically packed and is ready for pickup and delivery. This is the final confirmation step after the initial Post Purchase prebooking.

Post Purchase vs Post Packing: The Post Purchase flow is like a prebooking that reserves delivery capacity. The Post Packing flow is the final confirmation after physical packing, providing actual dimensions and confirming the parcel is ready for pickup.

This endpoint should be called after:

A parcel has been registered with the Post Purchase API
The order has been physically packed and prepared for shipping
The final dimensions and weight are known

Merchants can send information in different steps - some may provide all details in Post Purchase, others may provide minimal information initially and complete details in Post Packing.

Request Body

Parameter	Type	Required	Description	Constraints	Enum	Comment
parcelPackingConfrimed	boolean	optional*	1. Set to true if only the post packing call is made. 2. If you want to make more edits then actively set to false. 3. The post packing call will automatically set this param to true if nothing is sent.			`true` or `false`
brand	string	optional	Define brand of the delivery options			`instabox` or `budbee`
product	string	required	Define the product of the delivery options	Must be one		`HOME_DELIVERY`
countryCode	string	required*	Recipient country code. Can be sent in query param	ISO 3166 alpha 2	DK, FI, NO, SE
parcelPackingConfirmed	boolean	conditional*	Confirm parcel is packed and ready for pickup	See docs
availabilityToken	string	optional	Availability token from availability response
orderId	string	optional	Unique order reference for subsequent calls
parcelId	string	optional	Unique identifier/barcode for parcel	Auto-generated if omitted
sender	object	optional	Sender information object			Not normally needed for Home Delivery
recipient	object	required	Recipient information object
dispatch	object	optional	Dispatch readiness and warehouse
options	object	optional	Response options / language
deliveryInstructions	object	optional	Delivery instruction details
additionalServices	object	optional	Additional services
cart	object	optional	Parcel and/or product details

recipient

Parameter	Type	Required	Description	Constraints	Enum	Comment
name	string	required	Recipient name
email	string	required	Recipient email address	Valid email format		Used for delivery notifications
phone	string	required	Recipient phone number	Box: Min 6 digits, Home delivery: Min 10 digits, Max 15 digits		Can be made optional with setting
ssn	string	optional	Social security number			For age verification services
street	string	required	Recipient street address
street2	string	optional	Additional address information			Floor, apartment, etc.
postalCode	string	required	Recipient postal code
city	string	required	Recipient city
countryCode	string	required	Recipient country code	ISO 3166 alpha 2	DK, FI, NO, SE
coordinates	object	optional	GPS coordinates			For precise location

recipient.coordinates

Parameter	Type	Required	Description	Enum
lat	number	optional	Latitude
lon	number	optional	Longitude

sender

Parameter	Type	Required	Description	Constraints	Enum	Comment
name	string	optional	Sender/merchant name
email	string	optional	Sender email address	Valid email format
phone	string	optional	Sender phone number	Box: Min 6 digits, Home delivery: Min 10 digits, Max 15 digits
street	string	optional	Sender street address
street2	string	optional	Additional sender address info
postalCode	string	optional	Sender postal code
city	string	optional	Sender city
countryCode	string	optional	Sender (merchant) country code	ISO 3166 alpha 2	BE, DE, DK, FI, NL, NO, PL, SE	DE and PL are merchant address countries only, not delivery markets
coordinates	object	optional	Sender GPS coordinates

sender.coordinates

Parameter	Type	Required	Description	Enum
lat	number	optional	Latitude
lon	number	optional	Longitude

deliveryOption

Parameter	Type	Required	Description	Enum	Comment
sortCode	string	required	Sort code for the selected home delivery slot		Identifies the specific home delivery option
etaInterval	object	optional	Preferred delivery time window

deliveryOption.etaInterval

Parameter	Type	Required	Description	Constraints	Enum	Comment
from	string	required*	Start of delivery window	ISO-8601 datetime		Required when etaInterval is sent
to	string	required*	End of delivery window	ISO-8601 datetime		Required when etaInterval is sent. Defaults to best available if it doesn't match

dispatch

Parameter	Type	Required	Description	Constraints	Enum	Comment
readyToShip	string	optional	When parcel is ready for pickup	ISO-8601 datetime		Only one of readyToShip/readyToPack/outOfStock
readyToPack	string	optional	When packing process will start	ISO-8601 datetime		Instabee adds packing time to this
outOfStock	boolean	optional	Product is out of stock		`true`/`false`	Removes ETA from delivery options
packingTime	number	optional	Required packing time in minutes
collectionPointId	string	optional	Specific warehouse/pickup point			Configured by Instabee
returnPointId	string	optional	Return address point ID			For failed deliveries

options

Parameter	Type	Required	Description	Constraints	Enum	Comment
languageCode	string	optional	Language for customer communications	ISO 639-1	da, en, fi, nl, no, sv	Defaults to the main language of the countryCode
localEtas	boolean	optional	Return local delivery terms		`true`/`false`	Different local terms for delivery promise
estimatedParcelType	boolean	optional	Return estimated parcel size		`true`/`false`	Calculated based on cart contents

deliveryInstructions

Parameter	Type	Required	Description	Enum	Comment
notifyBy	string	optional	How to notify recipient	ring_doorbell, knock_on_door
doorCode	string	optional	Door or building access code
message	string	optional	Special delivery instructions		Free text message
intercom	boolean	optional	Use intercom if available	`true`/`false`

additionalServices

Parameter	Type	Required	Description	Constraints	Enum	Comment
identification	object	optional	Identity verification requirements
leaveOutsideDoor	boolean	optional	Allow leaving the parcel outside the door		`true`/`false`	Default is true
leaveWithNeighbour	boolean	optional	Allow leaving the parcel with a neighbour		`true`/`false`	Default is false
numberOfMissRetries	number	optional	Number of delivery retry attempts	Min: 1, Max: 5		null = default. Extra cost applies

additionalServices.identification

Parameter	Type	Required	Description	Constraints	Enum	Comment
type	string	required*	Type of verification		AGE_LIMIT, AGE_LIMIT_AT_HANDOVER, AGE_LIMIT_BY_MERCHANT_AT_HANDOVER, ALREADY_IDENTIFIED, ANY_PERSON, FRAUD_DETECTION, SPECIFIC_PERSON, SPECIFIC_PERSON_AT_HANDOVER	Required when the identification object is sent
ageLimit	number	optional	Minimum age required	Min: 0, Max: 20		Used with AGE_LIMIT types
ssn	string	optional	Required SSN for verification
name	string	optional	Required name for verification

cart

Parameter	Type	Required	Description	Constraints	Comment
checkoutId	string	optional	Checkout session ID	OneOf this, orderNumber, or availabilityToken
orderNumber	string	required*	Your order number	OneOf this, checkoutId, or availabilityToken	Used to link with your system
totalValueInCents	number	optional	Total order value in cents		Used for insurance purposes
totalWeightInGrams	number	optional	Total weight in grams		For logistics planning
parcel	object	optional	Parcel dimensions and contents		Detailed parcel information

cart.parcel

Parameter	Type	Required	Description	Enum	Comment
heightMm	number	optional	Parcel height in mm
widthMm	number	optional	Parcel width in mm
lengthMm	number	optional	Parcel length in mm
volumeDm3	number	optional	Parcel volume in dm³
estimatedSize	string	optional	Estimated size of the parcel. The sizes will be configured together with Instabee	SMALL, LARGE, TOOLARGE
weightGram	number	optional	Parcel weight in grams
type	string	optional	Parcel type	BOX, BAG
products	array	optional	Array of products in parcel		Detailed product information

cart.parcel.products[]

Parameter	Type	Required	Description	Comment
name	string	optional	Product name
quantity	string	optional	Quantity of this product	Sent as a string, not a number
productId	string	optional	Your product identifier
details	object	optional	Detailed product information
temperature	object	optional	Temperature requirements for the product
packages	array	optional	Physical packages the product is shipped in

cart.parcel.products[].details

Parameter	Type	Required	Description	Constraints
productType	string	optional	Type of product	e.g., "Prescription"
imgUrl	string	optional	Product image URL
category	string	optional	Product category
brand	string	optional	Product brand
description	string	optional	Product description
price	object	optional	Price information

cart.parcel.products[].details.price

Parameter	Type	Required	Description	Constraints	Comment
priceInCents	number	optional	Price in cents
taxValueInCents	number	optional	Tax amount in cents
discountRateInCents	number	optional	Discount amount in cents
currency	string	optional	Currency code	ISO 4217	e.g., "SEK"

cart.parcel.products[].temperature

Parameter	Type	Required	Description	Enum
min	number	optional	Minimum temperature in Celsius
max	number	optional	Maximum temperature in Celsius

cart.parcel.products[].packages[]

Parameter	Type	Required	Description	Comment
widthMm	string	optional	Package width in mm
heightMm	string	optional	Package height in mm
lengthMm	string	optional	Package length in mm
weightGram	string	optional	Package weight in grams
volumeDm3	string	optional	Package volume in dm³ (liters)
barcodes	object	optional	Barcode object for the package	Single object, not an array

cart.parcel.products[].packages[].barcodes

Parameter	Type	Required	Description	Enum
code	string	optional	Barcode value
type	string	optional	The barcode type	EAN13

Response

The API returns an updated parcel object with:

Field	Type	Description
parcelId	string	The Instabee parcel ID
status	string	Updated status (e.g., "PENDING_PACKING" or "FINALIZED")
links	object	And object with tracking and label links

links (object)

Field	Type	Description
label	string	URL to download the shipping label
tracking	string	Preliminary tracking URL — see the note below

Preliminary tracking link: links.tracking in this response is preliminary. It is generated before the parcel exists in our tracking system, so it does not resolve yet — opening it gives a broken link. Retrieve the working link with Get Tracking or Fetch Order once the parcel has been registered.

Separate senderTracking and recipientTracking links are not returned here. They only exist for LOCKER_TO_LOCKER (Consumer to Consumer) parcels — see Fetch Tracking Links.

label URL parameters

The label URL supports optional query parameters to customize the output:

Param	Type	Default	Options	Description
fileFormat	string	`pdf`	`png`, `zpl`, `pdf`	Output file format
encoding	string		`base64`	Return label as base64-encoded string
template	string	`a6`	`a6`, `a7`	Label paper size
dpi	integer	`96`		Resolution in dots per inch
debug	boolean	`false`	`true`, `false`	Enable debug mode

Best Practices

Accurate Measurements: Always provide accurate dimensions and weight
Prompt Confirmation: Confirm packing as soon as possible after physical packing
Error Handling: Implement proper error handling for failed confirmations
Label Management: Download and store shipping labels immediately
Status Tracking: Monitor the parcel status via the Instabee API or dashboard

Size Limitations

Each delivery method has maximum size and weight limitations:

Delivery Type	Max Length (cm)	Max Width (cm)	Max Height (cm)	Max Weight (kg)
Home Delivery	120	X	X (max total 300cm girth)	20

Exceeding these limitations may result in additional charges or delivery refusal.