Home Return
Home Return is Instabee's main return product where we pick up parcels directly from the consumer's home. The flow is simple: validate that we operate in the consumer's postal code area, then create a return order. The consumer will receive communication from Instabee and can book a pickup time that suits them.
Feature Comparison
The following tables show what features are unlocked at each integration level. Higher levels provide better delivery options, accuracy, and consumer experience.
Availability Features
Level 0 No integration | Level 1 Get All Lockers | Level 2 Availability with: | Level 3 Availability with: | Level 4 Availability with: | Level 5 Availability with: | Level 6 Availability with: | |
|---|---|---|---|---|---|---|---|
• Nothing | • Country Code | • Postal Code • Country Code | • Postal Code • Country Code • Email | • Postal Code • Country Code • Email • Recipient Address | • Postal Code • Country Code • Email • Recipient Address • Cart info - Estimated size | • Postal Code • Country Code • Email • Recipient Address • Cart info - Specific size • Alt, Product Sizes | |
Delivery Options | |||||||
Geolocation | |||||||
Advanced Ranking | |||||||
Estimated Time of Arrival* | |||||||
Capacity Managment | |||||||
Parcel Size Optimisation |
* This also required a commitment of packing times and pickup times for all parcels
Create Return Features
Level 1 Minimum amount of data | Level 2 Regular amount of data | Level 3 Great amount of data | |
|---|---|---|---|
• Selected Brand • Selected Product • Sender Information | • Selected Brand • Selected Product • Sender Information • Parcel Dimensions | • Selected Brand • Selected Product • Sender Information • Parcel Dimensions • Cart Information | |
Pickup Scheduling | |||
Consumer Communication |
Typical Integration Workflow
- Validate Postal Code — Check if Instabee picks up home returns in the consumer's area
- Create Return — Register the return order with the consumer's address
- Consumer Books Pickup — The consumer receives communication from Instabee and books a convenient pickup time
- Pickup & Return — Instabee picks up the parcel from the consumer's home and returns it to you
API base URLs
Send production traffic to the production host and sandbox or test traffic to the sandbox host. Paths, headers, and request bodies are the same in both environments; use credentials issued for the environment you call.
| Environment | Base URL |
|---|---|
| Production | https://api.integration.instabee.com/ |
| Sandbox | https://sandbox-api.integration.instabee.com/ |
Supported Countries
Instabee currently operates in the following countries:
- Sweden (SE)
- Norway (NO)
- Denmark (DK)
- Finland (FI)
- Netherlands (NL)
Next Steps
- Validate Postal Code— Check if we pick up in the consumer's area
- Create Return — Register the home return order
Need help? Our technical support team is available to assist with your integration. Contact us at integration@instabee.com