How Do You Issue Automatic e-Invoices for Marketplace Orders?

Automatic e-invoicing means transferring order data from a marketplace (buyer name, address, product, price, discount, shipping) into invoice fields without typing it in by hand, issuing it as an e-invoice (e-Fatura) or an e-archive invoice (e-Arşiv) depending on the seller's and buyer's status, and sending the invoice back to the marketplace. When it is set up correctly, you never miss the 7-day invoicing deadline, amounts match the marketplace exactly, and no order gets two invoices. In this guide, we walk through every step of the setup, the field mapping rules, and the tax rules you need to watch in Türkiye.

How does the automatic e-invoicing flow work?

Whatever software the seller uses, the flow consists of the same steps:

1. The order is pulled. The order and package number, buyer, address, product lines, discounts and payment details are retrieved from the marketplace API.
2. The document type is determined. If the seller is an e-invoice taxpayer and the order is corporate, the tax number is checked against the Turkish Revenue Administration (GİB) registered user list. For a seller that only uses e-archive, all orders are invoiced as e-archive invoices.
3. A draft invoice is created. Order fields are transferred to invoice fields using the mapping rules below.
4. Checks are run. The VAT (KDV) rate, grand total, mandatory fields, and whether an invoice has already been issued for the same package are checked.
5. The invoice is issued. The invoice is created as an e-invoice or e-archive invoice through a private integrator or the GİB infrastructure. e-Archive invoice data is reported to GİB no later than the end of the day following the day the invoice is issued.
6. The invoice is sent to the marketplace. The file is uploaded or the invoice link is sent.
7. The order is marked as "invoiced." The invoice number is stored with the order.

Decide up front at which moment the invoice will be issued. The most common choice is the moment the order is packed and the shipping label is created; that way, canceled orders are not invoiced and the deadline is not exceeded.

Mapping table: order data to invoice fields

The quality of the automation depends on order fields being transferred correctly to the invoice. The table below shows the most common mappings and the points to watch:

Converting a tax-inclusive price to a tax-exclusive unit price can create small kuruş differences; for formulas and rounding, see our VAT calculation article. The invoice's grand total must equal the amount the customer paid.

For coupon and discount amounts covered by Trendyol, the seller issues a separate e-invoice to Trendyol (Finance > Invoice Listing > Invoices I Need to Issue to Trendyol). These invoices are a separate process from the customer invoice; add them to your calendar when you set up the automation.

e-Invoice or e-archive?

The document type is determined first by the seller's status, then by the buyer's. A seller that is an e-invoice taxpayer issues an e-invoice if the buyer is a registered e-invoice user with GİB, and an e-archive invoice otherwise (including for final consumers). A seller that is not an e-invoice taxpayer and only uses e-archive issues an e-archive invoice even if the buyer is a registered company; this invoice is valid and is not canceled and reissued as an e-invoice.

The paper invoice option has also largely disappeared: from January 1, 2026, all taxpayers other than those under the simplified method and the business-account basis issue all their invoices as e-archive invoices regardless of amount; simplified-method and business-account taxpayers issue invoices exceeding 3,000 TL including taxes as e-archive invoices throughout 2026.

In Trendyol order data, the commercial=true field indicates that the order is corporate. If you are an e-invoice taxpayer, your automation should then check the tax number against the GİB registered user list; because the list is constantly updated, don't cache the query result for long. If you only use e-archive, the query does not change the document type, but the company's trade name, tax office and tax number must be written in full on the invoice. We explained how to run the query in our e-invoice taxpayer lookup article, and the differences between the two documents in our e-invoice vs. e-archive article.

When should the invoice be issued? The 7-day rule

Under Article 231/5 of the Tax Procedure Law (VUK), an invoice must be issued no later than 7 days from the date the goods are delivered or the service is performed; an invoice not issued within this period is deemed not to have been issued at all. We explained how the period is counted in detail in our how many days do you have to issue an invoice article.

The marketplaces' own rules also fall within this legal period:

• Hepsiburada: The invoice is uploaded to the relevant order or sent via integration; check the current deadline and file rules in the seller panel.
• n11: The invoice is issued for the store invoice amount shown in the panel and before the product is handed over to the carrier.
• Trendyol: Future-dated invoices cannot be added.

The safest approach in automation is to tie the invoice to the shipping step and not allow the label to be printed before the invoice is issued. That way, no package leaves without an invoice.

Uploading the invoice to the marketplace

Issuing the invoice is only half the job; it has to be sent to the marketplace so the customer can see it on their order screen.

If the upload fails, the invoice has been issued but has not reached the customer. Your automation should also record the upload result and show failed uploads in a separate list. You can find other invoicing rules for each marketplace in our marketplace invoicing guide.

Preventing duplicate invoices

The most common error caused by automation is issuing two invoices for the same order. To prevent this:

• Make the order or package number a unique key. If an invoice already exists for a package, the system must not create a second one.
• Don't keep manual and automatic invoicing on at the same time. If an invoice issued manually from the panel isn't reported to the automation, a second invoice goes out for the same order.
• Check the status before retrying. An invoice that shows as "could not be sent" due to a connection error may actually have been issued; check its status at the integrator before resending.
• Watch out for split packages. On Trendyol, one invoice is uploaded per package; if you split an order into multiple packages, each product line must appear in only one package and one invoice.
• Run a daily count. A simple end-of-day report comparing the number of invoiced orders with the number of invoices catches duplicates on the same day.

If a duplicate invoice was issued, cancel the extra one within 8 days from the date the document was delivered to the buyer; after 8 days, the GİB system does not allow a cancellation request. We explained how cancellations are reported to GİB in our e-archive invoice cancellation deadline article.

Invoices for returns and cancellations

No withholding tax (stopaj) is applied to an expense voucher issued for a consumer return; for details, see our expense voucher for consumer returns article. The automation should detect returned orders, prepare the relevant document, and add the returned product back to stock after inspection.

Setup checklist

1. Define the VAT rate and the unit (C62 for pieces) on every product card.
2. Match product barcodes with the listing on each marketplace.
3. Add the order or package number to the invoice note template.
4. If you are an e-invoice taxpayer, run the GİB registered user query automatically for corporate orders.
5. Clarify with your accountant how seller discounts, marketplace discounts and the shipping fee will be reflected on the invoice.
6. Decide the moment the invoice will be issued (such as shipping label creation) and turn off manual invoicing.
7. In the first few days, compare automatically issued invoices with orders one by one.
8. Regularly check the daily order-invoice count report and the failed upload list.

For matters that require interpretation, such as discounts and coupons, confirm your approach and your document type choices with your certified public accountant.