Yurtiçi Kargo Shopify integration is an infrastructure solution that can be set up via the official app in the Shopify App Store and automates the entire process from order confirmation to shipping label. This guide covers every step required to integrate Yurtiçi Kargo into your Shopify store, including technical requirements and solutions to common issues.
What is the Yurtiçi Kargo Shopify Integration?
Yurtiçi Kargo Shopify integration is an API connection that automatically transmits your store's order data to the Yurtiçi Kargo system and automates the label, tracking number, and notification processes. Before the integration is set up, each order requires manual label printing, entering the address into the shipping system, and copying the tracking number; this process takes 3–6 minutes per order.
With over 780 branches in Turkey, Yurtiçi Kargo is a strong option, especially for access to second- and third-tier cities in Anatolia. One of Turkey's most reviewed official shipping apps in the Shopify App Store, the Yurtiçi Kargo integration has a scalable structure from 10 to 10,000 orders per month.
Compared to competing shipping companies, Yurtiçi's key advantages include: a wide branch network, no minimum volume requirement for API access, and return management API support.
Yurtiçi and Other Shipping Companies' Shopify Compatibility
The Shopify integration features of major shipping companies in Turkey vary significantly. Choosing the right shipping company depends on your delivery regions, order volume, and price expectations.
Yurtiçi Kargo is one of the few shipping companies that does not impose a minimum volume requirement for API access; this feature is a significant advantage for newly opened Shopify stores. Aras Kargo similarly does not impose a volume requirement; however, Yurtiçi's official Shopify app has a more mature user interface.
Pre-Installation Requirements
There are four prerequisites that must be completed before initiating the Yurtiçi Kargo Shopify integration: Yurtiçi corporate agreement, API credentials, Shopify product data validation, and delivery region configuration.
Opening a Yurtiçi Kargo Corporate Account
Apply to Yurtiçi Kargo's corporate customer section (yurticikargo.com.tr → Corporate Solutions) and fill out the customer representative request form. Once a representative is assigned, the contract process begins and is usually completed within 3-5 business days. After the contract is signed, you will be assigned a unique customer number and API access password.
During the contract meeting, inform them in advance of your estimated monthly shipment volume and target delivery regions. If you can commit to more than 200 shipments per month, you can get a 10–20% discount on the unit cargo price.
💡 TIP: Request API Sandbox (test environment) access from your Yurtiçi Kargo representative. Sandbox allows you to perform integration tests without generating actual shipments and facilitates debugging before going live.
Shopify Product Data Check
Before integration, all products must have their weight information entered in the Shopify admin panel. Export all products as CSV via Products → Export, check the 'Variant Grams' column, and update products with a value of 0. For stores with over 1000 products, you can perform this bulk update using the CSV import method.
Step-by-Step Yurtiçi Kargo Shopify Setup
The Yurtiçi Kargo Shopify integration is completed in four main steps: app installation, API connection, shipping zone definition, and test verification. The entire process takes an average of 2–4 hours.
Step 1: Install the App
- Go to Apps → App Store in the Shopify admin panel.
- Type 'Yurtiçi Kargo' in the search box.
- Find the official Domestic Cargo app and click the 'Add app' button.
- Approve the necessary permissions (order reading, shipping writing permissions).
Step 2: Set Up the API Connection
- In the Yurtiçi Kargo app settings screen, go to the 'API Settings' section.
- Enter your customer number (obtained from the corporate portal) in the relevant field.
- Enter your API password. We recommend typing the password manually rather than copying and pasting it (to prevent issues with hidden space characters).
- Enter your branch code (required for some regions; obtain it from your representative).
- Click the 'Verify Connection' button. A green checkmark will appear if the connection is successful.
⚠️ CAUTION: If the API connection fails, check the case sensitivity of the customer number. In some cases, the Domestic Cargo API expects a capitalized CustomerCode, and entering it in lowercase will generate an error.
Step 3: Configure Shipping Zones
- Go to Settings → Shipping and delivery → Manage.
- Under the 'Turkey' region, click the 'Add rate' button.
- Select Yurtiçi Kargo as the carrier.
- Select the pricing model (see table below).
- If you want to add a free shipping threshold, click 'Add condition' → 'Order price' → set the minimum amount.
Step 4: Testing and Going Live
- Create a test order via Shopify admin → Orders → Create order.
- Use a real Turkish address (sandbox addresses may not generate labels).
- Click the 'Create shipping label' button on the Fulfillment screen.
- If the label opens as a PDF and the number works in the domestic tracking system, the integration is successful.
- Verify whether the customer notification email includes the tracking number.
Shipping Pricing and Optimization
When pricing is set up correctly with Yurtiçi Kargo in Shopify, you can control your shipping costs and increase your customer's cart value. Approximately 68% of stores in Turkey use the 'free shipping over a certain amount' model.
When setting the free shipping threshold, base it on your average cart value and set the threshold 15–20% above that. For example, if your average cart value is 350 TL, set the threshold to 400–420 TL. This strategy encourages customers to add extra items to fill their cart.
For stores selling heavy or bulky products, consider the desi (volumetric weight) calculation. Yurtiçi Kargo calculates 1 desi = 1 kg equivalent; however, the volumetric weight, which is greater than the actual weight, is billed. To address this in Shopify, you can update the product weight with the volumetric weight instead of the actual weight.
Common Errors and Solutions
The most common issues encountered in the Yurtiçi Kargo Shopify integration are API connection errors, label generation failures, and incorrect delivery time displays. The vast majority of these errors are configuration-related and can be resolved without requiring technical knowledge.
Error: 'Invalid credentials'
Solution: Recopy your customer number and API password from the Yurtiçi corporate portal. If the password field contains Turkish characters (ş, ğ, ü, ç, ö, ı), ensure these characters are encoded correctly.
Error: Label PDF is not being generated
Solution: Check whether the province and district information in the order address matches the equivalent in Yurtiçi's system. Especially in small settlements, Shopify's address format may not match Yurtiçi's region code system. In this case, you can perform a manual match using the 'Default branch code' field.
Error: Tracking number is not working even after 24 hours
Solution: The tracking system will not be updated until the physical package is delivered to the Yurtiçi branch after the Yurtiçi shipping label is created. The tracking number will become active within 2–4 hours after the package is delivered.
Frequently Asked Questions
How do I integrate Domestic Cargo with Shopify?
Install the official Yurtiçi Kargo app from the Shopify App Store, then enter your Yurtiçi corporate customer number and API password in the app settings. You must first sign a corporate contract with Yurtiçi Kargo and obtain API access. The process can be completed within 2–4 hours.
Is the Yurtiçi Kargo Shopify app free?
The official Yurtiçi Kargo Shopify app is free. The shipping fee you pay per shipment is determined according to the corporate contract rate you have signed with Yurtiçi. For Shopify's own plan, you must choose between Shopify Basic, Shopify, or Advanced.
Can I make same-day deliveries with Yurtiçi Kargo?
Yurtiçi Kargo offers 'Fast' and 'Same Day' delivery options in certain areas within Istanbul. For these services, the ServiceType parameter must be set appropriately in the API; this service must be defined in your current contract. It is not valid for all of Turkey.
Can I use Yurtiçi Kargo alongside another shipping company?
Yes. Shopify allows you to keep multiple shipping companies active at the same time. You can assign different companies to different delivery regions; for example, Yurtiçi for Istanbul and Ankara, and Aras Kargo for other provinces. This configuration is managed in the Shipping zones section.
When properly set up, the Yurtiçi Kargo Shopify integration automates 85% of your store's shipping operations. The official app offers a powerful and free solution for small and medium-sized stores, while the custom API integration provides greater flexibility for larger stores.
You can check out our blog page to guide you as you set up your new Shopify store from scratch.
At Nodus Works, we provide comprehensive technical and operational setup for Yurtiçi Kargo and other shipping companies' Shopify integrations.
Content that may interest you:
Shopify Shipping Integration - https://nodusworks.com/blog/shopify-kargo-entegrasyonu
Shopify Aras Kargo Integration - https://nodusworks.com/blog/aras-kargo-shopify-entegrasyonu-nasil-yapilir
MNG Cargo Integration - https://nodusworks.com/blog/mng-kargo-shopify-entegrasyonu-kurulum-ve-yapilandirma-rehberi
