Short answer
A Kolay Gelsin Shopify integration automatically sends Shopify orders to the Kolay Gelsin system, creates the shipment barcode, writes the tracking number to the Shopify fulfillment and carries delivery statuses back to Shopify. Kolay Gelsin is an e-commerce carrier focused on home delivery that lets recipients change the delivery time and address; in 2024 it merged with Koç Group’s Sendeo under the Kolay Gelsin name.
The integration is built with Kolay Gelsin apps on the Shopify App Store, a multi-carrier platform that supports Kolay Gelsin, or a custom middleware layer built with API credentials from the Kolay Gelsin panel. With a ready-made app you can go live in 2–5 business days; a custom build with ERP and return flows takes 3–5 weeks.
This guide was prepared from the field experience of the Byte Digital team, a Shopify Plus Partner that has served Shopify brands since 2020.
What is Kolay Gelsin and how is it different from other carriers?
Kolay Gelsin is a carrier brand set up within Ekol Lojistik for e-commerce shipments, which began operating in 2018. According to industry press, its merger with Koç Holding’s carrier Sendeo was approved by the Turkish Competition Board on 29 May 2024, and the combined company continued under the Kolay Gelsin name.
Kolay Gelsin’s key difference for Shopify brands is that delivery is planned together with the recipient. The recipient is informed by SMS on the delivery day and shortly before delivery, can change the delivery time or address through a link, and, if not at home, can choose to have it left with a neighbour or collect it from a delivery point. This flexibility reduces failed “we came, you weren’t home” deliveries; but if it is not handled properly on the Shopify side, customer communication gets messy.
Kolay Gelsin flow | Recipient experience | Shopify counterpart |
|---|---|---|
Shipment record | Order confirmation | FulfillmentOrder is read, shipment is opened |
Barcode and tracking number | “Shipped” notice | trackingInfo (company, number, url) via fulfillmentCreate |
Pre-delivery SMS | Link to change time or address | Content planned so it does not clash with Shopify notifications |
Time or address change | Delivery is rescheduled | FulfillmentEvent (DELAYED or IN_TRANSIT) and an order note |
Neighbour drop-off or delivery point | Parcel collected elsewhere | DELIVERED or READY_FOR_PICKUP event |
Returns | Return code or return shipment | Return record and return tracking number |
Which data is synced between Kolay Gelsin and Shopify?
Order and package details flow from Shopify to Kolay Gelsin; barcodes, tracking numbers and delivery statuses flow from Kolay Gelsin to Shopify. We explained the general structure in our Shopify shipping integration guide; the Kolay Gelsin-specific points are:
Tracking company and URL: Kolay Gelsin is not among the carriers for which Shopify generates tracking links automatically. The company name should be sent as “Kolay Gelsin” along with an explicit tracking URL.
Status events: Statuses from Kolay Gelsin are written to Shopify with fulfillmentEventCreate (Shopify fulfillmentEventCreate). Values such as READY_FOR_PICKUP for a parcel left at a delivery point and DELAYED for a rescheduled delivery give customer support a clear picture.
Volumetric weight and weight: Pricing is based on weight, volumetric weight (desi) and distance band. Variant weights and package dimensions (as metafields) should be kept in Shopify.
Address accuracy: In a home delivery model, a missing door number or wrong district means a failed delivery. Adding district selection and address validation at checkout with Checkout Extensibility lowers the failed delivery rate with Kolay Gelsin.
Cash on delivery: The terms of Kolay Gelsin’s cash on delivery service are not published openly. If you will use cash on delivery, confirm its scope and how collections are transferred in writing with your account representative at the contract stage.
Kolay Gelsin Shopify integration methods
A ready-made app suits stores working with one carrier, a multi-carrier platform suits those who want to manage several carriers from one panel, and a custom middleware layer suits those with an ERP or warehouse software.
Method | When to choose it | Setup time | Flexibility | Ongoing cost |
|---|---|---|---|---|
Shopify app (Kolay Gelsin apps on the App Store) | Kolay Gelsin only, standard flow | 2–5 business days | Low–medium | Monthly subscription |
Multi-carrier platform (supporting Kolay Gelsin) | Kolay Gelsin together with other carriers | 1–2 weeks | Medium | Per shipment or monthly |
Custom middleware (Kolay Gelsin API) | ERP, warehouse software, custom notification and return rules | 3–5 weeks | Highest | Hosting + maintenance |
The App Store has shipping apps built for Kolay Gelsin and multi-carrier apps that list Kolay Gelsin among supported carriers. Kolay Gelsin also provides API credentials from its own panel, which integrators use to connect. Many brands use Kolay Gelsin for metropolitan deliveries and a carrier such as Sürat Kargo or HepsiJET in other regions; in that case you need a layer that selects the carrier per order by rule.
Kolay Gelsin Shopify integration step by step: time and cost
It takes 2–5 business days with a ready-made app and 3–5 weeks with a custom build; in custom projects a large part of the time goes to notification design and return scenarios.
Application and contract (1–2 weeks): Kolay Gelsin’s corporate customer application form is filled in with your tax number, volume and volumetric weight details are shared, and the contract is signed. Cash on delivery and return scope are clarified at this stage.
API credentials (1–3 days): API credentials are taken from the Kolay Gelsin panel or requested from the account representative.
Shopify preparation (1–3 days): Variant weights, package dimensions, shipping location and checkout address fields are set up.
Setup or development (1 day – 3 weeks): Shipment records, barcodes, fulfillments, status events and the return flow are built; the content of Shopify and Kolay Gelsin notifications is planned together.
Testing and go-live (1 week): Time change, address change, neighbour drop-off and return scenarios are tested; failed deliveries are monitored daily in the first week.
The main cost drivers: shipment volume, distance and volumetric weight distribution, return rate, ERP or warehouse software connection and whether carriers are selected by rule. Shipping rates depend on your agreement with Kolay Gelsin.
The double notification problem: how do Kolay Gelsin SMS and Shopify emails fit together?
Kolay Gelsin sends its own SMS messages to the recipient; Shopify also sends shipping confirmation, out for delivery and delivered emails. If both run unplanned, the customer gets four or five messages on the same day and cannot tell which one counts.
The setup we recommend is simple: operational messages such as delivery time and address changes stay with Kolay Gelsin, while brand communication (shipping confirmation, post-delivery review and repeat purchase) goes out from Shopify or your email marketing tool. For most brands, turning off Shopify’s “Out for delivery” email and setting up a post-delivery review email instead works better. Designing these flows together on the email marketing side turns the shipping experience into a loyalty touchpoint.
The 6 most common Kolay Gelsin Shopify integration mistakes
Most mistakes come from the recipient’s flexibility not being visible in Shopify and from address quality.
Not sending the tracking URL: Since Kolay Gelsin is not among the carriers Shopify recognises, the customer sees a tracking number that cannot be clicked.
Skipping address validation: In a home delivery model, an incomplete address means a second attempt and a delay.
Not writing rescheduled deliveries to Shopify: When the customer changes the time, the status in Shopify does not change and customer support gives wrong information.
Overlapping notifications: Kolay Gelsin SMS and Shopify emails go out at the same time and confuse the customer.
Enabling cash on delivery without confirmation: Offering cash on delivery at checkout before scope and collection transfer are clear in the contract creates reconciliation problems.
Counting delivery point drop-offs as DELIVERED: Showing the order as delivered while the parcel waits at a point leads to “my parcel never came” complaints; use READY_FOR_PICKUP.
Kolay Gelsin Shopify integration with Byte Digital
Byte Digital is an Istanbul-based Shopify Plus Partner that has provided Shopify store setup, integration and technical support to leading Turkish brands since 2020. We handle the Kolay Gelsin integration together with checkout address quality, notification design and the return flow, making Shopify the single hub for orders and stock.
Share your shipment volume, the regions you deliver to and the other carriers you use; we will prepare a free preliminary assessment with the right method, timeline and estimated budget.
Request a free Kolay Gelsin Shopify assessment →
Frequently asked questions
Does Kolay Gelsin work with Shopify?
Yes. It can be connected to Shopify through Kolay Gelsin apps on the App Store, multi-carrier platforms that support Kolay Gelsin, or a custom middleware layer built on the Kolay Gelsin API.
Where do you get Kolay Gelsin API credentials?
After the corporate contract, API credentials are taken from the Kolay Gelsin panel or requested from the account representative. Ready-made apps work by entering these credentials in the app settings.
Are Sendeo and Kolay Gelsin the same company?
According to industry press, the merger of Sendeo and Kolay Gelsin was approved by the Turkish Competition Board in May 2024 and the company continues under the Kolay Gelsin name. For existing integrations built with Sendeo, confirm the current API credentials with your account representative.
What happens in Shopify if the recipient changes the delivery time?
If the integration takes this information from Kolay Gelsin and writes it to Shopify as a fulfillment event, it appears in the order timeline. Otherwise Shopify keeps showing the old status.
Does Kolay Gelsin offer cash on delivery?
The terms of cash on delivery are not published openly. We recommend confirming the scope, extra fees and how long it takes for collections to be transferred to you in writing at the contract stage.
How long does Kolay Gelsin delivery take?
Delivery time depends on the distance between origin and destination. Measure your real times for a few weeks and adjust the delivery promise you show on product pages and at checkout accordingly.
