Configuration Guide
Onboarding Requirements
Before setting up carrier integrations, ensure you have:
Carrier Contracts
Active commercial agreements with carriers you want to use
Negotiated shipping rates for return volumes
Account numbers or customer IDs from each carrier
Carrier Credentials
API keys, authentication tokens, or customer numbers (provided by carrier)
Access to carrier’s online portal (for verification and testing)
Return Warehouse Address
Physical warehouse or returns facility address configured in Ingrid
Address must be within carrier’s service coverage area
Business Requirements Defined
Which carriers to offer in which markets
Return shipping cost strategy (free for customer, paid, or tiered)
Customer segments (if offering different options to VIP vs. standard customers)
Technical Coordination
Coordination with Ingrid implementation team to enable carriers in your account
Testing plan to validate carrier integrations before launch
Step-by-Step Setup Guide
Step 1: Access Carrier Configuration
Log in to Ingrid Returns Back-office with your admin credentials
Navigate to Returns → Shipment Integrations in the menu
Review any existing carrier integrations already configured
Step 2: Add New Carrier
Click the Create integration button
A configuration form appears
Step 3: Select Your Carrier
Click the Shipment carrier dropdown menu
Browse available carriers (listed alphabetically)
Select the carrier you want to integrate (e.g., UPS, Royal Mail, Budbee)
Note: If your preferred carrier isn’t listed, contact Ingrid support to request enablement.
Step 4: Enter Carrier Details
The form will show fields specific to your selected carrier. Common fields include:
For UPS:
Account number (from your UPS contract)
Company name and address (your business details)
Contact phone and email
Trade terms (for international shipments)
For Budbee:
API key (from Budbee account portal)
API secret
Warehouse ID (assigned by Budbee)
For Royal Mail:
Account number
Contract reference
Shipper address and contact details
Tip: Have your carrier contract documents and portal login details ready to copy information accurately.
Step 5: Verify Return Address
Ensure the warehouse address you enter matches your actual returns facility
Double-check postal code format (UK: SW1A 1AA, US: 75201)
Confirm the address is within the carrier’s service area
Step 6: Save and Test
Click SUBMIT to save the integration
The system validates your credentials with the carrier
If successful, the carrier appears in your active integrations list
If errors occur, review error message and correct any incorrect details
Step 7: Test Return Label Generation
Create a test return:
Use your Returns Portal (or staging environment)
Initiate a test return for your own address
Select the newly configured carrier
Confirm you receive a return label via email
Verify label format is correct (PDF or QR code)
Check for issues:
Label generates within 5 seconds
Email delivery is immediate
Label includes correct return address (your warehouse) • Tracking number is present
Step 8: Activate in Your Return Policy
Navigate to Returns → Price Setups (your return policy configuration)
Ensure the new carrier is included in relevant policies
Configure which customers see this carrier (all customers, specific countries, VIP only, etc.)
Set whether the carrier is free or paid for customers
Step 9: Go Live
Announce new return option to customers (email, website banner, help centre)
Monitor return volumes using the new carrier
Check for support tickets related to carrier issues
Review carrier performance after 2-4 weeks
Implementation Examples
Example 1: UK Retailer with Multi-Carrier Setup
Requirements:
Royal Mail for standard returns
Evri for drop-off convenience
InPost for locker-based returns
Configuration:
Integration 1: Royal Mail Tracked Returns 48
Carrier: Royal Mail Product: trackedreturns48 Account Number: RM123456 Shipper Name: UK Fashion Ltd Shipper Address: 123 Warehouse Lane, London, E1 6AN, UK Shipper Email: [email protected] Shipper Phone: +442012345678
Integration 2: Evri Return Drop-off
Carrier: Evri Product: returndropoff Account Number: EVRI789456 Shipper Postcode: E1 6AN Shipper Name: UK Fashion Ltd Shipper Email: [email protected]
Integration 3: InPost UK Returns
Carrier: InPost Product: ukreturns Account Email: [email protected] Token: ip_tok_abc123xyz789 Returns Account Email: [email protected] Returns Token: ip_ret_tok_xyz456abc Default Carrier Method: Standard
Outcome:
Customers in London see all three options
Rural customers see Royal Mail and Evri (InPost lockers not available)
Urban customers with nearby InPost lockers see all three options
Price Setup rules control availability based on customer postal code
Example 2: Nordic Retailer with Regional Carriers
Requirements:
PostNord for Sweden, Denmark, Norway, Finland
Budbee for Sweden (urban home pickup)
Bring for Norway
Configuration:
Integration 1: PostNord Parcel Return
Carrier: PostNord Product: postnl-parcel (internal code) Customer Number: PN987654 Shipper Name: Nordic Fashion AB Shipper Address: Storgatan 12, Stockholm, 111 22, Sweden Shipper Email: [email protected]
Integration 2: Budbee Standard Home Pickup
Carrier: Budbee Product: budbee-std API Key: budbee_api_key_123abc API Secret: budbee_secret_xyz789 Warehouse ID: WH-SE-01
Integration 3: Bring (Helthjem) Return from Home
Carrier: HJE (Helthjem) Product: returnfromhome Customer Number: HJE456123 Shipper Name: Nordic Fashion AB Shipper Address: Storgatan 12, Stockholm, 111 22, Sweden
Market-Specific Price Setups:
Sweden: PostNord (all areas), Budbee (Stockholm, Gothenburg, Malmö)
Denmark: PostNord only
Norway: PostNord and Bring
Finland: PostNord only
Outcome:
Swedish urban customers see Budbee for convenient home pickup
All Nordic customers have PostNord as baseline option
Norwegian customers have Bring as additional local option
Carrier selection driven by Price Setup preconditions (country, postal code)
Example 3: US Retailer with Cost Tiers
Requirements:
Low-cost option for standard returns (USPS Ground Advantage)
Mid-tier option for tracked returns (UPS Ground)
Premium option for urgent returns (UPS 2nd Day Air)
Configuration:
Integration 1: USPS Ground Advantage
Carrier: USPS Product: groundadvantage Account Number: USPS123456789 Shipper Name: ACME Retail Inc Shipper Address: 500 Returns Way, Dallas, TX 75201, USA Shipper Email: [email protected]
Integration 2: UPS Ground
Carrier: UPS Product: ground Account Number: UPS987654 Incoterm Agreement: DAP Shipper Name: ACME Retail Inc Shipper Company Name: ACME Retail Inc Shipper Address: 500 Returns Way, Dallas, TX 75201, USA Shipper Email: [email protected] Shipper Phone: +12145551234
Integration 3: UPS 2nd Day Air
Carrier: UPS Product: 2nddayair Account Number: UPS987654 Incoterm Agreement: DAP Shipper Name: ACME Retail Inc Shipper Company Name: ACME Retail Inc Shipper Address: 500 Returns Way, Dallas, TX 75201, USA Shipper Email: [email protected] Shipper Phone: +12145551234
Price Setup Configuration:
USPS Ground Advantage: Always available, free for customer
UPS Ground: Available for orders >$100, free for customer
UPS 2nd Day Air: Available for exchanges or orders >$200, customer pays $15
Outcome:
Budget-conscious customers use USPS
Customers wanting faster processing use UPS Ground
Urgent exchanges use UPS 2nd Day Air with expedited processing
Return costs balanced between customer convenience and business cost