Yurtici Kargo Shipping Shopify Integration Setup Guide

Yurtici kargo Shipping Shopify integration is an infrastructure solution that can be installed through the official app in the Shopify App Store, automating the entire process from order confirmation to shipping label. This guide covers every step you need to integrate Yurtici kargo into your Shopify store, technical requirements, and solutions to common issues.

What is Yurtici kargo Shipping Shopify Integration?

Domestic Shipping Shopify integration is an API link that automatically forwards your store's order data to the Yurtici kargo system and automates the label, tracking number, and notification processes. Before the integration is established, each order requires manual label printing, entering an address into the shipping system, and copying the tracking number, which takes 3—6 minutes per order.

With more than 780 branches in Turkey, Yurtiçi Kargo is a powerful option, especially in accessing the second and third tier cities of Anatolia. Yurtici kargo integration, one of the most commented official shipping apps in Turkey on the Shopify App Store, has a scalable structure from 10 orders per month to 10,000 orders.

The main advantages of Yurtici kargo compared to competing shipping companies are: a large branch network, the absence of minimum volume requirements for access to the API, and return management API support.

Shopify Compatibility for Yurtici kargo and Other Shipping Companies

The Shopify integration features of the main shipping companies in Turkey differ significantly from each other. Choosing the right shipping company depends on your delivery regions, order volume, and price expectations.

Yurtici kargo is one of the rare shipping companies that doesn't impose a minimum volume requirement for API access, which is a major advantage for newly opened Shopify stores. Aras Cargo similarly does not impose volume requirements; however, the official Shopify app from Yurtiçi has a more mature structure in terms of user interface.

Pre-Installation Requirements

There are four prerequisites that must be completed before launching the Yurtici kargo Shipping Shopify integration: Domestic enterprise agreement, API credentials, Shopify product data verification, and delivery zone configuration.

Yurtici kargo Corporate Account Opening

Fill out the customer representative request form by contacting the corporate customer department of Yurtiçi Kargo (yurticikargo.com.tr → Corporate Solutions). After the appointment of the agent, the contract process begins and is usually completed within 3—5 business days. Once the contract is signed, the customer number and API access password are defined for you.

Inform your estimated monthly shipment volume and target delivery areas in advance at the contract negotiation. If you can commit more than 200 shipments per month, you can get a 10% to 20% discount on unit shipping.

💡 TIP: Also ask your Domestic Shipping representative for API Sandbox (test environment) access. Sandbox allows you to perform integration tests without producing actual cargo, making it easy to debug before it goes live.

Shopify Product Data Check

All products must have their weight information entered in the Shopify admin panel prior to integration. Export all products as CSV with Products → Export, check the 'Variant Grams' column and update the products with a value of 0. For stores with more than 1000 products, you can do this batch update with the CSV import method.

Step-by-step Yurtici kargo Shipping Shopify Setup

Yurtici kargo Shipping Shopify integration is completed in four main steps: app installation, API connection, shipping zone identification, and test verification. The whole process takes an average of 2—4 hours.

Step 1: Install the App

1. In the Shopify admin panel, go to Apps → App Store.
2. Type 'Domestic Shipping' in the search box.
3. Find the official Domestic Shipping app and click on the 'Add app' button.
4. Confirm the necessary permissions (read orders, write consignment permissions).

Step 2: Establish API Connection

5. On the Domestic Shipping app settings screen, go to the 'API Settings' section.
6. Enter your customer number (received through the corporate portal) in the corresponding field.
7. Enter your API password. We recommend that you write the password manually, not by copy-paste (avoids the problem of the hidden whitespace character).
8. Enter your branch code (mandatory for some regions; get it from your agent).
9. Click on the 'Verify Connection' button. A green check appears on successful connection.

⚠️ ATTENTION: If the API connection fails, check the case sensitive of the customer number. In some cases, the Domestic Shipping API generates a lowercase input error while waiting for an uppercase CustomerCode.

Step 3: Configure Cargo Zones

1. Go to Settings → Shipping and delivery → Manage.
2. Click on the 'Add rate' button under the 'Turkey' area.
3. Select Domestic Cargo as the carrier.
4. Determine the pricing model (see table below).
5. If you want to add a free shipping threshold, set 'Add condition' → 'Order price' → minimum amount.

Step 4: Test and Bring It to Life

1. Create a test order with Shopify admin → Orders → Create order.
2. Use a real Turkey address (sandbox addresses may not produce tags).
3. Click the 'Create shipping label' button on the Fulfillment screen.
4. The integration is successful if the label opens as PDF and the number is running in the Domestic tracking system.
5. Verify if the customer notification email contains the tracking number.

Cargo Pricing and Optimization

With Domestic Shipping, when the pricing configuration in Shopify is set up correctly, you can both control your shipping costs and increase the customer cart amount. Approximately 68% of stores in Turkey use the “free shipping over a certain amount” model.

When setting the free shipping threshold, base your average cart amount and set the threshold above 15-20%. For example, if your average basket amount is 350 TL, set the threshold to 400—420 TL. This strategy encourages customers to add additional products to fill the cart.

Consider the desi (volumetric weight) account for stores selling heavy or bulky items. Domestic Cargo calculates the equivalent of 1 desi = 1 kg; however, volumetric weight that is greater than the actual weight is billed. To meet this situation in Shopify, you can update the product weight with volumetric weight instead of actual weight.

Common Errors and Solutions

Domestic Shipping The most common issues with Shopify integration are API connection errors, label manufacturing failures, and incorrect delivery time display. The vast majority of these errors are due to configuration and can be solved without the need for technical knowledge.

Error: 'Invalid credentials'

Solution: Re-copy your customer number and API password from the Domestic enterprise portal. Especially if the password field contains Turkish characters (ş, ğ, ü, ç, ö, ı), make sure that these characters are encoded correctly.

Error: Label does not create PDF

Solution: Check if the province and county information at the order address matches its counterpart in the Domestic's system. Especially in small settlements, Shopify's address format and Domestic's area code system may not match. In this case, you can do manual mapping using the 'Default branch code' field.

Error: Tracking number does not work even though it has passed 24 hours

Solution: After the domestic shipping label is created, the tracking system will not be updated until the physical package is delivered to the Domestic branch. Within 2—4 hours after delivering the package, the tracking number becomes active.

Frequently Asked Questions

How to integrate Yurtici kargo Shipping into Shopify

Install the official Domestic Shipping app from the Shopify App Store, then enter your Domestic corporate customer number and API password in the app settings. First, a corporate contract with Domestic Cargo must be signed and API access provided. The process can be completed in 2—4 hours.

Is Domestic Shipping Shopify app paid?

The official Domestic Shipping Shopify app is free. The shipping cost you pay per shipment is determined according to the corporate contract tariff you have signed with Yurtiçi. For Shopify's own plan, you'll need to choose between Shopify Basic, Shopify, or Advanced.

Can I deliver same day as Domestic Cargo?

Domestic Cargo offers' Fast 'and 'Same Day' delivery options in some 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 does not apply to all of Turkey.

Can I use Domestic Cargo with another shipping company?

Yep. Shopify allows you to keep multiple shipping companies active at the same time. You can assign different companies to different delivery areas, for example, Yurtiçi for Istanbul and Ankara, Aras Cargo for other provinces. This configuration is managed from Shipping zones.

‍

Domestic Shipping Shopify integration automates your store's shipping operations by 85% when set up properly. The official application offers a powerful and free solution for small and medium-sized stores, while custom API integration for large stores provides more flexibility.

Setting up your new Shopify store from scratch Our blog page will guide you you can examine.

As Nodus Works, we are technically and operationally installing Shopify integrations for Domestic Shipping and other shipping companies.

‍

Request a Free Consultation Interview

‍