The Aras Kargo Shopify integration automatically generates shipping labels and instantly sends tracking numbers to customers by connecting your store's order management system with Aras Kargo's API infrastructure. In this guide, we explain all methods step by step, from Aras Kargo's official app in the Shopify App Store to custom API integration.
Why is Aras Kargo Shopify Integration Important?
Aras Kargo is one of Turkey's largest shipping companies with the most extensive distribution network, handling over 500 million shipments annually. Integrating your Shopify store with Aras Kargo reduces the manual labeling time per order from 3–5 minutes to zero, while also lowering the error rate from 4% to below 0.2%.
For every store operating in e-commerce in Turkey and processing over 50 orders per month, Aras Kargo integration is an essential operational step. While a worker can manually print and apply approximately 80 labels per day in the manual shipping process, after integration is set up, the same person reduces this time to under 10 minutes and uses their time to focus on customer service and growth.
Aras Kargo's Shopify compatibility offers advantages over competing shipping companies, as it provides both an App Store application for small-scale stores and direct API access for corporate needs.
Prerequisites for Integration
Three basic requirements must be met before starting the Aras Kargo Shopify integration: Aras Kargo corporate contract, API access information, and Shopify store preparation. If any of these steps are missing, the integration will fail during the setup phase or when processing the first orders.
1. Aras Kargo Corporate Agreement
To access the Aras Kargo API, you must first sign Aras' corporate customer agreement. To obtain the agreement, fill out the corporate customer representative request form at aras.com.tr. The process usually takes 3–5 business days. Individual accounts that send individual shipments are not eligible for API access.
If you inform the representative in advance of your average monthly shipment volume and delivery regions, the negotiated shipping price can be finalized more quickly. For shipments to western provinces of Turkey (Istanbul, Izmir, Bursa), Aras's volume discount can range from 15–30%.
2. Obtain API Access Information
After signing the contract, you will access your API information through the Aras corporate portal (b2b.araskargo.com.tr). The table below summarizes the API parameters required for integration:
⚠️ CAUTION: The Aras Kargo API password can be renewed every 90 days as per security policy. When the password is renewed, remember to update the API settings in the Shopify app; otherwise, shipping labels cannot be created.
3. Shopify Store Preparation
Before integration, verify the following two settings in the Shopify admin panel: First, ensure that the weight information has been entered for all products (Settings > Products > Weight unit). For products without weight entered, the Aras API uses the default 0.5 kg; this leads to incorrect price calculations. Second, ensure that the shipping zones are defined for Turkey.
Integration Method Selection
The Aras Kargo Shopify integration can be set up using three different methods. Choosing the right method depends on your monthly order volume, technical infrastructure, and budget. Choosing the wrong method can result in unnecessary costs or insufficient automation.
TIP: If you process fewer than 200 orders per month, the official Aras Kargo Shopify app is sufficient and free. Plan to switch to a custom API solution once you reach 500+ orders.
Step-by-Step Aras Kargo Shopify Setup (Official App)
Aras Kargo's official Shopify app provides all the features necessary for a standard e-commerce store: automatic labeling, tracking numbers, and notifications. Setup can be completed in 1–3 hours.
Step 1: Install the App
- Go to Apps → App Store in your Shopify admin panel.
- Type 'Aras Kargo' into the search box.
- Find the official Aras Kargo app and click the 'Add app' button.
- Confirm by clicking 'Install app' on the app permissions screen.
Step 2: Enter API Information
- The app settings screen will open. Go to the 'Connection Settings' or 'API Settings' section.
- Enter your Aras corporate customer number in the CustomerCode field.
- Enter your API password in the Password field (the password you received from the corporate portal).
- Click the 'Test Connection' button — if a green checkmark appears, the connection is successful.
⚠️ WARNING: If you receive a 'Connection failed' error from the test button, first delete the spaces at the beginning and end of the CustomerCode. Hidden space characters are a common problem when copying and pasting.
Step 3: Define Shipping Zones
- Go to Shopify admin → Settings → Shipping and delivery → Manage.
- Add Aras Kargo as the shipping provider for the 'Turkey' region.
- Configure shipping pricing: fixed price (e.g., 49.90 TL for all orders), weight-based, or conditional free shipping (e.g., over 500 TL).
Step 4: Create a Test Order
- Create a test order from the Shopify admin → Orders section using 'Create order'.
- After the order is confirmed, verify that the 'Create shipping label' button appears on the Fulfillment screen.
- Create the label and check whether the tracking number works in the Aras tracking system (kargo.aras.com.tr).
Common Issues and Solutions
The four most common issues encountered in the Aras Kargo Shopify integration are API authentication errors, inability to create labels, incorrect weight calculations, and tracking numbers not being generated. All of these issues can be resolved within a few minutes.
Issue: 'Authentication Failed' Error
Solution: Your API password may have expired. Log in to the Aras corporate portal, renew your API password, and update the Password field in the Shopify app. Aras automatically renews the password during security updates and invalidates the old password.
Issue: Shipping Label Not Generated
Solution: At least one of the products in the order may be missing weight information. Fill in the weight information under Products → [relevant product] → Shipping tab. Also, if the delivery address is outside Turkey, the Aras API will not generate a label; check your shipping zone settings.
Issue: Tracking Number Not Visible in Email
Solution: Go to Settings → Notifications → Shipping confirmation template and verify that the {{ fulfillment.tracking_number }} variable is present. This variable may have been deleted in customized email templates; check by comparing with the original Shopify template.
Issue: Incorrect Shipping Cost is Charged to the Customer
Solution: There may be multiple overlapping rules in the Shipping zones section. List all shipping rules and delete any unnecessary or overlapping rules. The most specific rule (e.g., Istanbul) should take precedence over the general rule (Turkey).
Frequently Asked Questions
Is the Aras Kargo Shopify integration free?
The official Aras Kargo Shopify app can be downloaded and installed for free. Shipping costs are determined by the corporate agreement you sign with Aras.
Where can I obtain Aras Kargo API information?
You can obtain Aras Kargo API information after signing a corporate customer contract via the corporate portal at b2b.araskargo.com.tr or through your assigned corporate customer representative. Individual sender accounts do not have API access.
Can I offer same-day delivery with Aras Kargo on Shopify?
Aras Kargo offers same-day delivery (AYS) service in certain areas within Istanbul. This service can be activated via the API by setting the ServiceType parameter to 'AY'. However, this service must be defined in your store's contract, and delivery times (usually until 2:00 PM) must be observed.
Will the Aras Kargo integration still work after migrating from WooCommerce?
Yes. After the transition to Shopify is complete, the Aras Kargo integration is set up from scratch; the old integration from WooCommerce is not transferred to Shopify. Your order history is preserved during the transition process, but the shipping integration must be reconfigured through the new store.
How is the Aras Kargo Shopify integration set up?
The Aras Kargo Shopify integration is performed by downloading the official Aras Kargo app from the Shopify App Store and entering the Aras corporate customer information (customer number + API password) into the app. To do this, a corporate contract must first be signed with Aras Kargo and API access must be requested. The entire process can be completed within 1–3 hours.
Does Aras Kargo have a Shopify app?
Yes, Aras Kargo has an official app published on the Shopify App Store. The app includes basic shipping label creation, tracking number integration, and notification sending features. For high-volume operations, a custom API integration is recommended.
Why isn't the Aras Kargo API password working?
The Aras Kargo API password can be renewed every 90 days as a security policy requirement. When the password is renewed, the connection in the Shopify app is broken. To resolve this, obtain the new API password from the Aras corporate portal and update the app's connection settings.
When set up correctly, the Aras Kargo Shopify integration greatly automates your store's logistics processes. The official app is a powerful starting point for small and medium-sized stores; as you scale, you can easily transition to middleware or custom API solutions.
To compare shipping carriers on Shopify, check out our article Shopify Shipping Integration: The Complete Guide.
If you're migrating to Shopify from other platforms, the Shopify Migration Technical Guide is an essential resource you shouldn't miss.
Contact us to set up your Aras Kargo integration with Nodus Works. The initial consultation is free.
Request a Free Integration Consultation Now
