Every merchant running a Shopify store in Turkey will sooner or later run into this question: "How do I issue an e-Invoice or e-Archive document for my orders?" Mandated by the Turkish Revenue Administration (GİB), this electronic document system is something Shopify — as a global platform — does not support out of the box. However, with the right architecture, the right integrator partner, and proper automation, you can make the process both legally compliant and operationally flawless.
In this guide, we walk through how to set up e-Invoice and e-Archive integration on a Shopify store from scratch, which integrators are available, how to manage Turkish VAT rates, and how to avoid the most common pitfalls. At the end you'll find a compliance checklist for a fully e-Invoice-ready Shopify store.
What Are e-Invoice and e-Archive? Key Differences
Electronic document requirements in Turkey have been phased in gradually since 2014. Shopify merchants need to understand two core document types:
e-Invoice
e-Invoice is an electronic invoice issued from one taxpayer to another (B2B). That is, if both buyer and seller are registered e-Invoice taxpayers, the transaction between them must be documented via e-Invoice. It is transmitted through GİB and appears in the buyer's e-Invoice inbox.
e-Archive Invoice
e-Archive is the invoice issued to non-taxpayers (B2C — end consumers) or to businesses that are not e-Invoice taxpayers. For the vast majority of Shopify stores, this is the document you will be issuing. It can be delivered to the customer via email or SMS.
Which Document When?
- Buyer is an e-Invoice taxpayer: issue e-Invoice (via GİB)
- Buyer is an end consumer: issue e-Archive invoice
- Buyer is abroad: issue an e-Archive export invoice
The Challenges of Shopify e-Invoice Integration
Because Shopify is a global platform, it does not ship with a solution specific to Turkey's local tax regulations. This creates several challenges for Turkish merchants:
- Mandatory local integrator: Shopify cannot connect directly to GİB. A "private integrator" must sit in between.
- VAT calculation gaps: Shopify's built-in tax engine may not correctly calculate Turkish VAT rates.
- Automated invoice flow: Issuing invoices manually for every order does not scale. Automation is essential.
- Refunds and cancellations: If an order is cancelled or refunded, the invoice flow must stay in sync.
- TCKN/VKN validation: The correct document type must be selected based on the customer's tax number type.
What Is a Private Integrator and Which One Should You Choose?
Private integrators are authorised service providers that act as a bridge between GİB and your Shopify store. The most popular integrators in Turkey are:
Popular e-Invoice Integrators
- Nilvera: Modern API, Shopify-friendly documentation, reasonable pricing
- Logo e-Fatura: Strong enterprise infrastructure, integrates with Logo accounting
- Mikro e-Çözümler: Practical solution for small and mid-sized businesses
- Uyumsoft: Broad feature set, multi-document-type support
- İzibiz: Friendly interface, quick onboarding
- Foriba (QNB): Banking-backed, reliable infrastructure
What to Look for When Choosing an Integrator
- REST API support (must be compatible with Shopify webhooks)
- Monthly document limits and overage fees
- Support for refund and cancellation invoices
- Export invoice support (in foreign currency)
- Quality of customer support and documentation
- Integration with your accounting software (Logo, Mikro, Netsis, etc.)
Shopify e-Invoice Integration Methods
Method 1: Use a Ready-Made Shopify App
There are e-Invoice apps in the Shopify App Store built specifically for Turkey. This is the fastest path — no technical skills required. Install the app, connect your integrator account, and orders are automatically converted into invoices.
Pros: Fast setup, no technical expertise required, updates are automatic.
Cons: Monthly subscription, limited customisation, may fall short in multi-store scenarios.
Method 2: Custom Webhook Integration
For businesses that want more control, custom development is possible. When Shopify's orders/paid webhook fires, a middleware server receives the order, translates it into the integrator's API format, and submits the invoice request.
Pros: Full control, custom business rules, multiple stores managed centrally.
Cons: Development cost, ongoing maintenance.
Method 3: Shopify Flow + API Combination
For Shopify Plus users, Shopify Flow can capture order events and trigger HTTP requests. This method strikes a balance between ready-made apps and fully custom development.
Configuring Turkish VAT Rates Correctly in Shopify
As of 2026, Turkey's VAT rates are: 1%, 10% and 20%. Assigning the correct rate to each product in Shopify is critical.
Step-by-Step VAT Setup
- Go to Shopify Admin → Settings → Taxes and duties
- Add Turkey as a tax region
- Set the default VAT rate to 20%
- Create tax override collections for 1% and 10% rates
- Add reduced-rate products (food, medication, books) to the corresponding collections
- Define a zero-rated zone for export sales
Common Pitfall: Tax Included or Not?
Turkish law requires that product prices are shown VAT-inclusive. In Shopify, the setting "All prices include tax" must be enabled. Publishing your site without this setting means you will both violate consumer-protection regulations and mis-calculate invoice amounts.
How to Set Up Automated Invoice Flow
The goal is for an invoice to be issued and delivered to the customer within seconds of order completion. An ideal flow looks like this:
- Order is placed: customer completes payment, Shopify marks the order as "paid"
- Webhook fires: the
orders/paidevent is sent to the integrator - Document type is determined: TCKN/VKN is checked, e-Invoice or e-Archive is selected
- Submission to GİB: integrator pushes the document to the GİB system
- Customer email: invoice PDF is automatically delivered to the customer
- Shopify note: invoice number is appended to the order's notes field
Refund and Cancellation Scenarios
In the e-Invoice and e-Archive system, once a document is issued, it cannot be deleted — only a refund invoice can reverse it. In Shopify:
- Full refund: a refund invoice cancelling the entire original is issued
- Partial refund: an adjustment invoice is issued for the refunded amount
- Pre-payment cancellation: if no invoice has been issued yet, no action is needed; otherwise a refund invoice is required
Common Mistakes and How to Fix Them
Mistake 1: Wrong Document Type
Issuing an e-Archive without first checking whether the customer is an e-Invoice taxpayer will produce an invalid document. Solution: use your integrator's TCKN/VKN validation API.
Mistake 2: VAT-Inclusive vs Exclusive Confusion
If you enter prices excluding VAT in Shopify but tick "include tax", the invoice amount may not match the order amount. Solution: enter prices VAT-inclusive from the start.
Mistake 3: Missing Export Invoice Flow
Using the domestic e-Archive format for international orders will cause problems at both customs and tax levels. Solution: set up a separate flow for export orders.
Mistake 4: Exceeding the Monthly Document Limit
Integrators usually come with a monthly document cap. Fast-growing stores can hit this cap mid-month and stop issuing invoices. Solution: scale your integrator plan as your volume grows.
e-Invoice-Compliant Shopify Store Checklist
- ✅ GİB e-Invoice or e-Archive taxpayer registration completed
- ✅ Private integrator selected and contract signed
- ✅ Turkish VAT rates correctly configured in Shopify (1%, 10%, 20%)
- ✅ Product prices set as VAT-inclusive
- ✅ TCKN/VKN field added to checkout
- ✅ Automated invoice flow via webhook or ready app
- ✅ Refund/cancellation flow ready for refund invoices
- ✅ Separate process defined for export orders
- ✅ Accounting software (Logo, Mikro, etc.) integration in place
- ✅ Monthly document limits reviewed
- ✅ Invoice PDFs automatically delivered to customers
Why a Professional Setup Matters
At first glance, e-Invoice and e-Archive integration might look like "install an app and you're done". In reality, it sits at the very core of your business operations. A badly implemented invoice flow leads to tax penalties, customer dissatisfaction, operational bottlenecks and — worst of all — brand reputation damage.
At 34Devs we deliver enterprise-grade e-Invoice integration to Shopify stores across Izmir, Istanbul and the rest of Turkey. From integrator selection and webhook development to accounting-system bridges and export workflows, we design the entire pipeline end-to-end. Reach out to our Izmir Shopify agency for a free consultation.
Frequently Asked Questions
Can Shopify issue e-Invoices directly?
No. Shopify does not offer infrastructure specific to Turkish legislation. You must connect to the GİB system through a private integrator.
Should I issue e-Archive or e-Invoice?
If your buyer is an e-Invoice taxpayer, issue an e-Invoice; if they are an end consumer (individual) or a non-taxpayer business, issue an e-Archive. This decision can be automated via TCKN and VKN validation.
Which invoice is issued for international orders?
For sales going abroad, an e-Archive export invoice is issued. It is VAT-exempt (zero-rated) and can be in foreign currency.
How much do integrators cost per month?
Integrator fees range from around 250 TRY to 2,500 TRY per month. Pricing depends on document volume, feature set and accounting software integration.
What happens to the invoice when a refund is issued?
An issued invoice cannot be deleted. For a refund or cancellation, a refund invoice (reverse entry) is issued to balance the original. Automated integrations trigger this when the refund event fires in Shopify.
How do I show VAT-inclusive prices in Shopify?
Go to Shopify Admin → Settings → Taxes and duties and enable "All prices include tax". In Turkey, prices must legally be displayed VAT-inclusive.
Does Shopify Plus offer any advantages for e-Invoice?
Yes. Shopify Plus merchants can build custom automations with Shopify Flow, validate TCKN/VKN at checkout via Scripts, and centrally manage invoice flows across multiple stores.
