Post Packing Flow
The Post Packing flow confirms that the parcel is physically packed and ready for pickup. For Locker Light, you have two options at this stage:
- Option 1 — Use our label: Create the order using the special
sortCodefrom the availability response. We will return a label URL with the correct sort code already printed. - Option 2 — Use your own label: Before calling Post Packing, call the Resolve sortCode endpoint first. This returns the real
sortCoderepresenting the actual delivery locker. Use this on both your label and in the Post Packing request.
Create Order API (Post Packing)
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 parcel is packed and ready for pickup
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
Request Body
| Parameter | Type | Required | Description | Constraints | Enum | Comment |
|---|---|---|---|---|---|---|
| parcelPackingConfirmed | boolean | required | Confirm parcel is packed and ready for pickup | Can be set to false, and order can be updated unlimited amount of times. If omitted then we will default to packing confirmed if we have a post purchase order. | ||
| 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 | LOCKER_AREA | |
| availabilityToken | string | required | Availability token from availability response | Can be optional if agreed with your Implementation Manager | ||
| orderId | string | optional | Unique order reference for subsequent calls. This is returned in the post purchase response | |||
| parcelId | string | optional | Unique identifier/barcode for parcel | Auto-generated if omitted | ||
| communicationName | string | optional | Communication name override | Note! This will only change the name in Instabee communication such as notifications, SMS or email for locker deliveries. Will not change partner name in our partner portal nor change any specs on invoices | ||
| recipient | object | required | Recipient information object | |||
| dispatch | object | optional | Dispatch readiness and warehouse | |||
| 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 | |||
| 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 | BE, DK, FI, NL, NO, SE | |
| coordinates | object | optional | GPS coordinates | For precise location |
sortCode
| Parameter | Type | Required | Description | Enum | Comment |
|---|---|---|---|---|---|
| sortCode | string | required | Temporary sort code received from the Availability API. Send at the top level of the request body — do not wrap in a deliveryOption object. | Must be sent exactly as received, do not truncate |
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 | |
| collectionPointId | string | optional | Specific warehouse/pickup point | Configured by Instabee | ||
| returnPointId | string | optional | Not yet implemented. Return address point ID | For failed deliveries |
additionalServices
| Parameter | Type | Required | Description | Enum |
|---|---|---|---|---|
| identification | object | optional | Identity verification requirements |
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 |
type explanations
| Type | Description |
|---|---|
| AGE_LIMIT | Verify the consumer age. This verification will be triggered when the parcel is created. Only live with Swedish BankID |
| AGE_LIMIT_AT_HANDOVER | Verify the consumer age when they pickup the parcel (at handover). Only live with Swedish BankID |
| SPECIFIC_PERSON | Verify the consumer identify by matching SSN sent on the order with the SSN from the verification. Only live with Swedish BankID |
| SPECIFIC_PERSON_AT_HANDOVER | Verify the consumer identify by matching SSN sent on the order with the SSN from the verification when they pickup the parcel (at handover). Only live with Swedish BankID |
| ANY_PERSON | Verify the consumer identify by matching doing a BankID or NemID verification. Currently live in Sweden, Denmark and Norway |
| AGE_LIMIT_BY_MERCHANT_AT_HANDOVER | Accepted by the API. Contact your Instabee representative before using it |
| ALREADY_IDENTIFIED | Accepted by the API. Contact your Instabee representative before using it |
| FRAUD_DETECTION | Accepted by the API. Contact your Instabee representative before using it |
cart
| Parameter | Type | Required | Description | Enum | Comment |
|---|---|---|---|---|---|
| checkoutId | string | optional | Checkout session ID | Used as a link in Instabee system | |
| orderNumber | string | required* | Your order number | Used as a link in Instabee system | |
| totalValueInCents | number | optional | Total order value in cents | This helps us with claims process | |
| totalWeightInGrams | number | optional | Total weight in grams | This helps us with claims process | |
| 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 | If you do not have this data, do not send anything | |
| widthMm | number | optional | Parcel width in mm | If you do not have this data, do not send anything | |
| lengthMm | number | optional | Parcel length in mm | If you do not have this data, do not send anything | |
| volumeDm3 | number | optional | Parcel volume in dm³ | If you do not have this data, do not send anything | |
| 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 | Enum | 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 | Enum |
|---|---|---|---|---|---|
| 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 | Enum | 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 8. Temperature in Celsius | |
| max | number | optional | Maximum 15. Temperature in Celsius |
cart.parcel.products[].packages[]
| Parameter | Type | Required | Description | Enum | Comment |
|---|---|---|---|---|---|
| widthMm | string | optional | Package width in mm | If you do not have this data, do not send anything | |
| heightMm | string | optional | Package height in mm | If you do not have this data, do not send anything | |
| lengthMm | string | optional | Package length in mm | If you do not have this data, do not send anything | |
| weightGram | string | optional | Package weight in grams | If you do not have this data, do not send anything | |
| volumeDm3 | string | optional | Package volume in dm³ (liters) | If you do not have this data, do not send anything | |
| 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 |
|---|---|---|
| orderId | string | The Instabee order ID |
| parcelId | string | The parcel ID |
| state | string | Updated status ("FINALIZED" after packing confirmation) |
| links | object | Object with label and tracking links |
| attributes | object | Additional attributes including the resolved label code |
links (object)
| Field | Type | Description |
|---|---|---|
| label | string | URL to download the shipping label (contains the correct sort code) |
| 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 |
attributes (object)
| Field | Type | Description |
|---|---|---|
| labelCode | string | The resolved label code (e.g., "IN30") |
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) |
|---|---|---|---|---|
| Locker - Small | 39 | 39 | 59 | 20 |
Exceeding these limitations may result in additional charges or delivery refusal.
Quick Links
- Post Purchase API - Initial prebooking before packing
- Availability API - Check delivery options and get tokens