VedronERP · Shipping & Carriers
FedEx Integration
FedEx provides international and express shipping worldwide. The integration uses the FedEx Ship API v1 (REST) with OAuth2 authentication to create shipments, generate PDF labels, and produce customs documents for non-EU destinations.
Step 1 — Create a FedEx Developer Account
- Go to developer.fedex.com and click 'Sign Up' (or log in if you already have a FedEx.com account).
- Create or join your company's Organization in the portal.
- Click 'My Projects' → 'Create a Project'.
- Select 'Ship API' (and optionally 'Track API') from the API catalog.
- Enter your FedEx Account Number when prompted — this links billing to your project.
- Complete the project setup to receive your test (sandbox) credentials.
Step 2 — Obtain Your API Credentials
After creating the project, go to the Project Overview page and open the 'API credentials' tab. You will find:
- [API Key] — also called Client ID. This identifies your application.
- [Secret Key] — also called Client Secret. IMPORTANT: this is shown only once. Copy and save it immediately — if lost, you must regenerate it.
- [Account Number] — your 9-digit FedEx billing account number. Appears separately in the project overview.
Warning: The Secret Key is displayed only once when first generated. Save it to a secure location immediately. If you lose it, you will need to regenerate it and update all systems using it.
Step 3 — Test Environment (Sandbox)
FedEx provides a sandbox environment for testing. The sandbox uses separate test credentials (also shown in your project) and the base URL apis-sandbox.fedex.com. Use sandbox to verify your integration produces valid labels before going live.
Step 4 — Production Certification
FedEx requires a validation process before you can print live production labels. This includes:
- Submit a Product Information Worksheet and Validation Cover Sheet to FedEx.
- Provide sample labels generated during testing for barcode review.
- FedEx's Bar Code Analysis Group reviews labels within 3 business days.
- Once approved, your project moves to Production status.
- Retrieve your production API Key and Secret Key from the Project Overview page.
Step 5 — Configure Credentials in the ERP
Go to the Credentials page, select FedEx, and enter the following fields:
- [API Key] — your production API Key (Client ID) from the FedEx Developer Portal.
- [Secret Key] — your production Secret Key (Client Secret).
- [Account Number] — your 9-digit FedEx billing account number.
- [Sender Name] — the name printed on the label as the shipper.
- [Sender Company] — your company name.
- [Sender Street] — your dispatch address.
- [Sender Postal Code] — dispatch postcode.
- [Sender City] — dispatch city.
- [Sender Country] — 2-letter country code (e.g., DE, NL, PL).
- [Sender Phone] — contact phone for the shipper.
- [Sender Email] — contact email for the shipper.
Creating a FedEx Shipment
- Open the order you want to ship.
- Click 'Create Shipment' and select FedEx as the carrier.
- Verify the recipient name, address, city, postal code, and country.
- Enter the package weight in KG.
- Optionally enter dimensions (length, width, height in cm).
- Select the FedEx service type (see below).
- Select the pickup type: 'Drop off at FedEx location' or 'Scheduled pickup'.
- For shipments outside the EU, fill in the customs declaration details.
- Click 'Create Shipment' to submit the request.
- Download the PDF label (4x6 inch format) and print it.
Available FedEx Service Types
- INTERNATIONAL_PRIORITY — Fastest international service, time-definite delivery
- INTERNATIONAL_ECONOMY — Cost-effective international, day-definite delivery
- EUROPE_FIRST_INTERNATIONAL_PRIORITY — Priority delivery to European destinations by 9:00 or 10:00 AM
- FEDEX_EXPRESS_SAVER — Economy express within Europe/international
- PRIORITY_OVERNIGHT — Next-business-day delivery by 10:30 AM (US and select markets)
- FEDEX_GROUND — Ground delivery (US, Canada)
- FEDEX_2_DAY — 2-business-day delivery (US and select markets)
Customs Documentation (Non-EU Shipments)
For shipments to destinations outside the EU (e.g., UK, US, Switzerland, Norway), a commercial invoice and customs declaration are required. The ERP will prompt you for the following additional details:
- Commodity description — what is in the parcel (e.g., 'electronic components', 'accessories')
- HS/Tariff code — the Harmonized System code for the goods (look up the correct code for your product category)
- Country of manufacture — where the goods were produced
- Declared value — value per unit in the shipment currency
- Number of pieces — quantity
- Duties payment — typically 'SENDER' (you pay) or 'RECIPIENT' (customer pays)
Tip: For EU exporters, you may also need your EORI number for customs compliance when exporting outside the EU. Contact FedEx or your customs broker if you are unsure.
OAuth Token & Authentication
The ERP handles OAuth2 authentication automatically. It uses your API Key and Secret Key to request an access token from FedEx (valid for 1 hour) and refreshes it before each shipment request. No manual token management is required.
Warning: If you see authentication errors (401 Unauthorized), your credentials may have been regenerated on the FedEx Developer Portal. Update the API Key and Secret Key in the ERP Credentials page.