How to Integrate Aras Cargo Shopify (2026 Current Guide)

Aras Cargo Shopify integration connects your store's order management system and Aras Kargo's API infrastructure to automatically generate shipping labels and instantly forward tracking numbers to the customer. In this guide, we explain step by step all the methods, from the official application of Aras Kargo in the Shopify App Store to the custom API integration.

Why Aras Cargo Shopify Integration is Important

Aras Cargo is one of the largest cargo companies in Turkey with the largest distribution network and carries over 500 million shipments annually. Integrating your Shopify store with Aras Cargo reduces manual label time spent per order from 3—5 minutes to zero, while reducing the error rate from 4% to less than 0.2%.

The integration of Aras Cargo is a mandatory step from an operational point of view for every store that deals with e-commerce in Turkey and processes more than 50 orders per month. While in the manual shipping process, an employee can manually print and paste about 80 labels per day, once the integration is established, the same person reduces this time to less than 10 minutes and uses their time to focus on growth with customer service.

Aras Kargo's Shopify compliance is advantageous over competing shipping companies in that it provides both the App Store app for small stores and direct API access for enterprise needs.

Pre-Integration Requirements

Three basic requirements must be completed before Aras Cargo can start Shopify integration: Aras Cargo enterprise agreement, API access information, and Shopify store prepping. When any of these steps are missing, the integration gives an error during the installation phase or initial orders.

1. Aras Cargo Corporate Agreement

In order to access the Aras Cargo API, you must first sign Aras's corporate customer agreement. For the contract, the corporate customer representative request form is filled in via aras.com.tr. The process usually takes 3—5 working days. Ordinary individual accounts that send individual cargo are closed to API access.

Negotiating the agreed shipping price will be completed faster if you notify the agent in advance of your average monthly shipment volume and delivery regions. For shipments to the western provinces of Turkey (Istanbul, Izmir, Bursa), the volume discount of ARAS can be in the range of 15-30%.

2. Provide API Access Information

Once the contract is signed, you can access your API information via the Aras corporate portal (b2b.araskargo.com.tr). The following table summarizes the API parameters required for integration:

⚠️ ATTENTION: Aras Cargo API password can be renewed every 90 days according to security policy. Remember to update the API settings in the Shopify app when the password is renewed, otherwise shipping labels cannot be created.

3. Shopify Store Prep

Before integration, verify these two settings in the Shopify admin panel: First, that all products have weight information entered (Settings > Products > Weight unit). For products without weight entered, the Aras API uses 0.5 kg by default, which leads to incorrect price calculation. Second, shipping zones are defined for Turkey.

Selection of Integration Method

Aras Cargo Shopify integration can be set up in three different ways. Choosing the right method depends on your monthly order volume, technical infrastructure and budget. The wrong choice of method means unnecessary costs or insufficient automation.

HINT: If you process less than 200 orders per month, the official Aras Kargo Shopify app is completely adequate and free. Plan the transition to the custom API solution when you reach 500+ orders.

Step-by-step Aras Shipping Shopify Setup (Official App)

Aras Kargo's official Shopify app offers all the features necessary for a standard ecommerce store: automatic label, tracking number, and notification. Installation can be completed in 1—3 hours.

Step 1: Install the App

1. In your Shopify admin panel, go to Apps → App Store.
2. Type 'Aras Cargo' in the search box.
3. Find the official Aras Kargo app, click on the 'Add app' button.
4. Confirm with 'Install app' on the app permission screen.

Step 2: Enter API Information

5. The application settings screen opens. Go to 'Connection Settings' or 'API Settings'.
6. Enter your Aras corporate customer number in the CustomerCode field.
7. In the Password field, enter your API password (the password you received from the corporate portal).
8. Click on the 'Test Connection' button — if the green confirmation appears, the connection is successful.

⚠️ WARNING: If you get a 'Connection failed' error from the Test button, first delete the spaces at the beginning and end of the CustomerCode. Hidden whitespace characters are a common problem in the copy-paste process.

Step 3: Define Cargo Zones

1. Go to Shopify admin → Settings → Shipping and delivery → Manage.
2. Add Aras Kargo as cargo provider for 'Turkey' region.
3. Configure shipping pricing: flat price (e.g. all orders £49.90), weight-based or conditional free shipping (e.g. over $500).

Step 4: Create a Test Order

4. Create a test order with 'Create order' from Shopify admin → Orders.
5. Once the order is confirmed, verify that the 'Create shipping label' button appears on the Fulfillment screen.
6. Create the tag and check if the tracking number works in the Aras tracking system (kargo.aras.com.tr).

Common Problems and Solutions

The four most common issues with Aras Cargo Shopify integration are API authentication failure, inability to create tags, incorrect weight account, and tracking number not falling. All of these problems can be solved in a matter of minutes.

Problem: 'Authentication Failed' Error

Solution: Your API password may have expired. Enter the Aras enterprise portal, renew your API password, and update the Password field in the Shopify app. Aras automatically renews the password in security updates and invalidates the old password.

Problem: Shipping Label Not Generating

Solution: The weight information of at least one of the products in the order may be missing. Fill in the weight information in the Products → [related product] → Shipping tab. Also, if the delivery address belongs to a country outside Turkey, the Aras API does not generate labels; check the shipping zone settings.

Problem: Tracking Number Not Appearing in Email

Solution: Verify that the {{fulfillment.tracking_number}} variable is available in Settings → Notifications → Shipping confirmation template. In customized email templates, this variable may have been deleted; check it by comparing it to the original Shopify template.

Problem: Incorrect Shipping Fee Is Reflected on Customer

Solution: There may be more than one conflicting rule in the Shipping zones section. List all shipping rules, delete unnecessary or overlapping rules. The most specific rule (e.g. Istanbul) must prevail over the general rule (Turkey).

Frequently Asked Questions

Is Aras Cargo Shopify integration free?

The official Aras Cargo Shopify app is free to download and install. The shipping costs are determined by the corporate agreement you have signed with Aras.

Where can I get Aras Cargo API information?

You can get Aras Cargo API information after signing the corporate customer contract through b2b.araskargo.com.tr corporate portal or through the corporate customer representative assigned to you. Individual sender accounts are closed to API access.

Can I offer same-day delivery as Aras Cargo on Shopify?

Aras Kargo offers same-day delivery (AYS) service in some areas within Istanbul. This service can be activated by setting the ServiceType parameter to 'AY' via the API. However, this service must be defined in your store's contract and shipping times (usually up to 14:00) must be observed.

Will Aras Cargo integration work after migrating from WooCommerce?

Yep. After the migration to Shopify is complete, the Aras Cargo integration is set up from scratch; the old integration in WooCommerce is not migrated to Shopify. Your order history is preserved during the migration process, but shipping integration must be restructured through the new store.

How to integrate with Aras Cargo Shopify

Aras Cargo Shopify integration is done by installing the official Aras Cargo app from the Shopify App Store and entering Aras corporate customer information (customer number+API password) into the app. For this, a corporate contract with Aras Cargo must first be signed and API access requested. The whole process can be completed within 1—3 hours.

Does Aras Kargo have a Shopify app?

Yes, Aras Kargo has an official app released on the Shopify App Store. The application includes basic shipping label creation, tracking number integration, and sending notifications. For large volume operations, special API integration should be preferred.

Why is Aras Cargo API password not working?

The Aras Cargo API password can be renewed every 90 days according to the security policy. When the password is renewed, the connection in the Shopify app is disconnected. For the solution, get the new API password from the Aras enterprise portal and update the connection settings of the application.

‍

Aras Cargo Shopify integration greatly automates your store's logistics processes when set up correctly. The official application is a powerful starting point for small and medium-sized stores; as it scales, the transition to middleware or custom API solutions can be easily made.

‍

Contact us to set up your Aras Cargo integration with Nodus Works. The first interview is free.

Request Free Integration Consultation Now

‍