Short answer
A HepsiJET Shopify integration automatically sends orders from your own Shopify store to the HepsiJET system, creates the shipping label, writes the tracking number to the Shopify fulfillment, and carries statuses such as “in transit”, “out for delivery” and “delivered” back to Shopify. HepsiJET grew out of the Hepsiburada ecosystem but also serves e-commerce companies outside Hepsiburada, so it can be used for your Shopify store as well.
The integration is built with HepsiJET apps on the Shopify App Store, a shipping aggregator platform, or a custom middleware layer built on the API access HepsiJET provides to corporate customers. With a ready-made app you can go live in 2–5 business days; a custom build with cash on delivery, returns and an ERP flow takes 3–6 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.
Who is HepsiJET and what does it offer Shopify stores?
HepsiJET is an e-commerce carrier founded in 2017 which, by its own account, operates in all 81 provinces of Turkey with 21 transfer centres and 250 branches. It also ships for e-commerce companies outside marketplaces; new customers apply through HepsiJET’s “Become Our Customer” (Müşterimiz Olun) form, and integration details are shared after the contract.
For Shopify brands, what sets HepsiJET apart is the delivery flexibility offered to the recipient. The options listed on HepsiJET’s services page directly affect integration design:
HepsiJET feature | What it means for the recipient | Effect on the Shopify integration |
|---|---|---|
Live map tracking | Courier location can be followed on a map during delivery | The tracking URL must be sent |
Cash on delivery | Payment is collected at delivery | Amount comes from the order; order is marked paid on delivery |
Date change and address update | Recipient postpones delivery or changes the address | The Shopify address and the shipping address can diverge |
Cancel in transit | Shipment is cancelled while on the way | The Shopify order must move into the cancel or refund flow |
Scheduled returns | Courier picks up the return from the address | Return record and return tracking number are linked in Shopify |
HepsiJET XL | Large, high-volume shipments | Separate service type for products like furniture or appliances |
If you also sell on Hepsiburada, shipping for those orders is handled by Hepsiburada’s own flow; this guide covers only orders from your own Shopify store. For the marketplace side, see our Hepsiburada Shopify integration guide.
How does data flow between HepsiJET and Shopify?
Orders flow from Shopify to HepsiJET, labels and tracking numbers from HepsiJET to Shopify, and delivery statuses from HepsiJET to Shopify as events. For the general architecture, read our Shopify shipping integration guide; the HepsiJET-specific technical points are:
Work with FulfillmentOrders: In Shopify, each order is split into one or more FulfillmentOrders by shipping location. The middleware reads these records, opens a shipment at HepsiJET and writes the tracking data with fulfillmentCreate.
Tracking company name and URL: HepsiJET is not on the list of carriers for which Shopify generates tracking links automatically. So the company name should be sent as “HepsiJET” in trackingInfo, along with an explicit tracking URL; otherwise the customer sees no clickable link on the order status page.
Status events: Statuses from HepsiJET are written to Shopify with fulfillmentEventCreate, mapped to values such as IN_TRANSIT, OUT_FOR_DELIVERY, DELIVERED and ATTEMPTED_DELIVERY. Shopify’s “Out for delivery” and “Delivered” emails are sent when an event with that status arrives from the carrier or fulfillment app (Shopify customer notifications).
Second delivery attempt: HepsiJET tries again when the recipient is not home. Writing the first attempt as ATTEMPTED_DELIVERY lets customer support see the situation in Shopify.
HepsiJET Shopify integration methods
A ready-made app suits a single carrier and a standard flow, an aggregator platform suits those working with several carriers, and a custom middleware layer suits brands with heavy cash on delivery and return rules.
Method | When to choose it | Setup time | Flexibility | Ongoing cost |
|---|---|---|---|---|
Shopify app (HepsiJET apps on the App Store) | HepsiJET only, low–medium daily volume | 2–5 business days | Low–medium | Monthly subscription |
Aggregator platform (multi-carrier apps that support HepsiJET) | Using HepsiJET alongside other carriers | 1–2 weeks | Medium | Per shipment or monthly |
Custom middleware (HepsiJET corporate API) | ERP, cash on delivery reconciliation, scheduled returns | 3–6 weeks | Highest | Hosting + maintenance |
The App Store has HepsiJET apps published by third-party developers, offering features such as bulk label printing and automatic tracking number updates; some support cash on delivery, while return support varies by app. Check before installing whether the app is an official HepsiJET product and whether it supports returns. With aggregator platforms, confirm that HepsiJET is among the supported carriers and whether you can use your own agreement. If you will split regions with a second carrier such as DHL eCommerce, you need a layer that manages carrier selection by rule.
HepsiJET Shopify integration step by step: time and cost
It takes 2–5 business days with a ready-made app and 3–6 weeks with a custom build; in a custom build most of the time goes to cash on delivery reconciliation and return scenarios.
Application and contract (1–2 weeks): You apply through the “Become Our Customer” form, share monthly volume and volumetric weight distribution, and sign the contract. API access and technical documentation are requested from the corporate account representative.
Shopify preparation (1–3 days): Variant weights, shipping locations and the cash on delivery method are set up. Large products that will go through HepsiJET XL are separated with a tag or metafield.
Setup or development (1 day – 4 weeks): Shipment creation, labels, fulfillments, status events, cash on delivery and the return flow are built.
Testing (3–5 days): Standard shipment, cash on delivery, date change, cancel in transit and scheduled return scenarios are tested end to end.
Go-live and monitoring (1–2 weeks): For the first two weeks you check that status events land correctly in Shopify and that cash on delivery collections match orders.
The main cost drivers: monthly shipment volume, volumetric weight distribution (XL share), cash on delivery share, return rate, ERP connection and the number of carriers used. Shipping rates depend on your agreement with HepsiJET.
Managing returns and delivery times with HepsiJET
HepsiJET’s scheduled return service has the courier pick up the returned item from the customer’s address; on the Shopify side, this means the return request turns into a return shipment and its tracking number is linked to the return record. In fashion brands, returns are a large part of shipping cost; our article on strategies that lower return rates for textile brands covers that side.
Delivery time promises are also part of the integration. If you show a time such as “delivered in 1–3 business days” on the product page or at checkout, the same time should be consistent in your Google product listings. We recommend measuring your real HepsiJET delivery times for a few weeks and reflecting them in the shipping settings of your Google Merchant Center integration.
The 6 most common HepsiJET Shopify integration mistakes
Most mistakes come from not building a Shopify-side counterpart for the flexibility HepsiJET offers recipients.
Not sending a tracking URL: Since HepsiJET is not among the carriers Shopify recognises, the customer sees a tracking number with no link if the URL is missing.
Not reflecting cancel in transit in Shopify: The shipment is cancelled on the way but the order stays “shipped” in Shopify; stock and accounting break.
Ignoring address updates: When the recipient changes the address through HepsiJET, the Shopify address stays old; invoice and customer records become inconsistent.
Matching cash on delivery collections by hand: If delivered orders are not marked paid automatically, month-end reconciliation takes days.
Shipping large items with the standard service: If XL products are not separated, errors or unexpected charges appear at the label stage.
Not recording delivery attempts: If ATTEMPTED_DELIVERY events are not written, customer support has to go to the HepsiJET panel to answer “where is my order”.
HepsiJET Shopify integration with Byte Digital
Byte Digital is an Istanbul-based Shopify Plus Partner that has provided Shopify builds, migration to Shopify and integration services to leading Turkish brands since 2020. We set up HepsiJET features such as cash on delivery, cancel in transit and scheduled returns so they work consistently with Shopify orders, stock and your ERP.
Share your monthly shipment volume, your cash on delivery and return rates and the other carriers you use; we will prepare a free preliminary assessment with the right method, timeline and estimated budget.
Request a free HepsiJET Shopify assessment →
Frequently asked questions
Does HepsiJET only carry Hepsiburada orders?
No. HepsiJET also serves e-commerce companies outside Hepsiburada as corporate customers. You can apply and sign a contract for orders from your own Shopify store.
How do you get HepsiJET API access?
After signing a corporate contract with HepsiJET, API user details and technical documentation are requested from the corporate account representative. If you use a ready-made Shopify app, you enter these details in the app settings.
Can HepsiJET cash on delivery be used with Shopify?
Yes. HepsiJET offers cash on delivery; in Shopify, cash on delivery is set up as a manual payment method, the amount is passed to the shipment record and the order can be marked paid after delivery.
Does Shopify’s “Delivered” email work for HepsiJET shipments?
Yes, but only if the integration writes the delivered status from HepsiJET to Shopify as a fulfillment event. Shopify does not pull HepsiJET statuses on its own.
I also sell on Hepsiburada; is one HepsiJET account enough for both channels?
Shipping for Hepsiburada orders is managed through the marketplace’s own process. A separate corporate agreement with HepsiJET may be needed for your own store’s shipments; clarify this with your account representative.
Does HepsiJET carry large items such as furniture?
HepsiJET offers the HepsiJET XL service for large, high-volume shipments. In Shopify, these products need to be marked with a tag or metafield so the shipment is opened with the right service type.
