We use necessary cookies to make this site work. With your permission we also use Google Analytics to understand how the site is used and Google Ads cookies to measure which of our ads lead to purchases. You can accept all cookies, reject the optional ones or choose which ones to allow. Cookie policy
Choose which cookies you allow. Necessary cookies are always on because the shop cannot work without them. You can change your choice at any time with the "Cookie settings" link.
Needed for the basket, checkout, login and security. They do not track you.
Google Analytics: how many people visit, which pages they read and how they found the site. It sets the _ga cookies and sends usage data to Google.
Google Ads: measures which of our ads lead to a purchase. It sets the cookies _gcl_au and _gcl_aw (90 days) and, when you buy, sends Google the order details and a hashed form of your contact details for matching. See our cookie and privacy policies.
Create Aras, Yurtiçi and Geliver shipments from Magento, with desi, labels and tracking. Carrier support and beta status vary by provider.
Free
No payment needed, with 12 months of updates.
Add it to your cart and complete the free checkout. Your ZIP downloads and Composer access will be in your account.
No subscription or automatic renewal. Keep using the versions included in your update period. Update and licence details
Composer package commercegears/module-shipping-turkey
Use Türkiye Shipping (Aras, Yurtiçi, Geliver) from the Magento order workflow through Shipping Connect. Configure the connection once, offer the relevant delivery methods and keep label and tracking work close to the order instead of copying shipment data into a separate portal.
Requires the shipping core package and the selected carrier's contract credentials or geliver token. Add a Carrier Connection, use Test Connection, configure checkout methods and validate a shipment with your own parcel data. External carrier charges and contracts are separate.
Install with Composer using composer require commercegears/module-shipping-turkey, then run bin/magento setup:upgrade. Composer installs the required CommerceGears dependencies: commercegears/module-shipping-core ^2.0.
Aras label creation was checked against its test service; Aras tracking, Yurtiçi and Geliver remain beta. Aras uses one parcel per label. Yurtiçi labels are generated by the module with the cargo key. Returns are available through Geliver only; MNG and DHL eCommerce Türkiye are not included.
Release 2.0.0; Magento 2.4.7 – 2.4.9; PHP 8.2 – 8.5. Read the included user guide and test your own theme, checkout and integrations before production use.
Create the label and the Magento shipment with its tracking number from the order view, or for up to 50 orders at once from the order grid.
A cron job reads the carrier's tracking, stores the status, events and delivery date and shows them on the customer's order page on Luma and Hyvä.
State/Province is sent as the province (il) and City as the district (ilçe); the province plate code is added for the carriers that need it.
All features
Live demo
A full Magento store with the module installed, on Luma and on Hyvä. The admin demo signs you in with one click.
Compatibility
| Magento | 2.4.7 – 2.4.9 |
|---|---|
| Platforms | Magento Open Source and Adobe Commerce |
| Storefront themes | Luma Blank Hyvä |
| PHP | 8.2 – 8.5 |
| Latest version | 2.0.1 |
| composer.json requires | php ~8.2.0||~8.3.0||~8.4.0||~8.5.0 magento/framework ~103.0.7 commercegears/module-shipping-core ^2.0 free, installed by Composer with this module |
Installation
Get it free, create a Composer key in your account, then in the root of your Magento project:
01Add the repository and your key (once per project)
composer config repositories.commercegears composer https://repo.commercegears.com composer config --auth http-basic.repo.commercegears.com PUBLIC_KEY PRIVATE_KEY
02Install the module
composer require commercegears/module-shipping-turkey
03Enable it
bin/magento setup:upgrade bin/magento setup:di:compile bin/magento setup:static-content:deploy bin/magento cache:flush
The last three are only needed in production mode.
Prefer a zip? Every version you are entitled to can be downloaded from My modules. More about Composer access
User guide
The user guide has its own page: how to install Türkiye Shipping (Aras, Yurtiçi, Geliver), what each option does and how to use it in your store. Written for version 2.0.1; a copy ships with the module.
Changelog
FAQ
Something else on your mind? The developers who wrote the module answer before and after you buy.
Ask a question →Already installed it? Open a support ticket
Aras Kargo, Yurtiçi Kargo and Geliver. Geliver is an aggregator: through one Geliver account you reach Aras, Yurtiçi, PTT, Sürat, HepsiJet and Kolay Gelsin, with the cheapest offer or a fixed carrier service code. MNG Kargo and DHL eCommerce Türkiye are not included.
For Aras Kargo: the web service (SetOrder) user, password and customer code from your Aras branch, plus an XML service user for tracking (esasweb.araskargo.com.tr > Entegrasyon > XML Servisleri). For Yurtiçi Kargo: a contract with a web service user (wsUserName) and password. For Geliver: an account at app.geliver.io, an API token and the ID of your sender address. The module does not create carrier accounts for you.
Yes. Each connection has a Sandbox / Test Mode switch. Aras uses its test web service with the integration test user from Aras, Yurtiçi its test web service with the test user YKTEST, and Geliver creates test shipments on your account that are not charged. Test labels are not valid for shipping.
Yurtiçi Kargo's web services only answer requests from Turkish IP addresses or addresses Yurtiçi has whitelisted. If your server is hosted outside Türkiye, ask Yurtiçi to whitelist its IP address.
State/Province is used as the province (il) and City as the district (ilçe). When State/Province is empty, the City is used as the province. Geliver also receives the province plate code, which the module fills in automatically.
Yes, for Aras Kargo and Yurtiçi Kargo, collected as cash or card (a setting per connection). The amount is pre-filled in the label form for the payment methods you list under Cash on Delivery Payment Methods. Geliver labels have no cash on delivery.
Desi is the volumetric weight Turkish carriers charge by. The label form shows the desi of each parcel from its dimensions, and the desi and weight are sent to the carrier with the shipment.
Yurtiçi's createShipment registers the shipment under your cargo key and returns no label. The module prints a PDF label with the cargo key as a Code 128 barcode, which the Yurtiçi branch scans.
Yes. A cron job reads the carrier's tracking and stores the status, the events and the delivery date. Customers see the carrier, the tracking number with a link to the carrier's tracking page, a progress bar and the latest events on their order page in My Account (Luma and Hyvä) and on the guest order view. You can also e-mail customers on delivery milestones and set an order status when the parcel is delivered.
With Geliver, yes: a return of the original Geliver shipment, with a signed download link for the customer. Aras Kargo and Yurtiçi Kargo connections do not create return labels.
Shipping Connect is CommerceGears's shipping framework for Magento. The free package commercegears/module-shipping-core holds the checkout methods, labels, tracking, returns and the API log; this package adds the Turkish carriers. Composer installs Shipping Core automatically, and you can add other carrier packages, such as DPD Germany, next to it.
Aras Kargo order, label, cash on delivery and cancel are tested against the Aras test web service; Aras tracking is beta. Yurtiçi Kargo and Geliver are beta: written from the carriers' documentation and tested with recorded responses. Test with your own account before going live.
Support
From the blog
With a hosted payment page, the order and the payment live in two systems. Most days they agree. This is about the days they do not, and how to make Magento catch up with iyzico on its own.
Magento was not built around Turkish addresses, volumetric weight or cash on delivery. What goes wrong when you connect it to Aras Kargo or Yurtiçi Kargo, and how to set it up so labels come out right.