Integration Process
Overview
The integration process in Fredi explains how your organization is onboarded and enabled to manage shipments through the platform.
Your account is initially configured by the Fredi administration team using the Admin UI. During this process, your organization details, login credentials, and carrier services are set up based on your existing contracts with shipping carriers.
Once onboarding is completed, you can log in to the Fredi UI and start creating and managing shipments using the carriers and services available to your account. In addition to the user interface, shipments can also be managed programmatically using the Fredi API, once API access is enabled for your account.
Note
The carriers and services visible in your account depend on your existing contracts with those carriers!
Onboarding Workflow
Getting started with Fredi typically involves the following stages:
- Account Setup
- Credential Creation & Verification
- Carrier & Product Configuration
- Accessing the Fredi UI
- Managing Shipments
Account Setup
Before you can start using Fredi, the Fredi team creates an account for your organization. During this step, your organization’s basic details are configured, including:
- Organization information
- Contact details
- Default operational settings
This setup creates your organization’s workspace within Fredi.
Credential Creation & Verification
Once your account is created, login credentials are generated for your users.
You will typically receive an email containing an account verification or activation link. To activate your account:
- Open the verification email.
- Follow the activation link.
- Confirm your account access.
After completing this step, you will be able to securely log in to the Fredi platform.
Carrier & Product Configuration
The Fredi administration team configures the carriers and shipping services that your organization can use. These configurations are based on your existing contract with the carrier. Depending on your agreement, your account may include:
- Multiple carriers
- Specific shipping services (for example, express or standard delivery)
- Carrier-specific shipping options
Once configured, these carriers and services automatically appear in your Fredi UI.
Note
Only carriers and services enabled for your account will be visible when creating shipments!
Accessing the Fredi UI
After your account has been activated, you can log in to the Fredi UI using your verified credentials. Once logged in, you will be able to view:
- Available carriers
- Supported shipping services
- Shipment management actions
- Label generation options
The features you see depend on the configuration applied to your account.
Managing Shipments
After your account is set up, you can start managing shipments through Fredi. Shipments can be created and managed using either:
- Fredi UI – for manual shipment creation and management
- Fredi API – for automated shipment processing from external systems
Typical shipment operations include:
- Creating shipments
- Selecting carrier services
- Generating shipping labels
- Tracking shipments
- Reviewing shipment history
Fredi communicates with carrier systems in the background to process shipment requests and return the required information.
Integration Architecture (Conceptual)
Fredi acts as an integration layer between your system (or the Fredi UI) and the carrier systems.
Typical workflow:
You create a shipment in the Fredi UI or via API.
Fredi validates and prepares the shipment request.
The request is sent to the relevant carrier system.
The carrier processes the shipment and returns:
- Shipping label
- Tracking number (if applicable)
- Shipment confirmation
Fredi returns the result to the user interface or connected system.
This architecture allows you to work with multiple carriers through a single consistent platform.
Error Handling
If an issue occurs while processing a shipment, the system may return different types of errors:
- Authentication errors – carrier credentials may be invalid or expired.
- Validation errors – shipment data may be incomplete or incorrect.
- Service errors – the selected carrier service may not be enabled for your account.
- Carrier-side errors – issues returned directly from the carrier system.
Error messages are returned through the Fredi UI or API responses.
Best Practices
To ensure smooth shipping operations:
- Ensure your carrier contracts remain active.
- Verify shipment information before submitting requests.
- Monitor shipment responses and system logs if using the API.
- Contact the Fredi team if new carrier services need to be enabled.