PttAvm Integration: API, XML, Fulfillment and Unified Store Management

About PttAvm: Founding, Ownership and Market Position

Founding and History (1840 – Today)

PTT (Posta ve Telgraf Teşkilatı — Turkey's Postal & Telegraph Organization) was established in 1840 during the Ottoman Empire and is one of the world's oldest postal organizations. Modernized during the Republican era, PTT was converted to a joint-stock company in 2013. PttAvm was launched in 2017 as part of PTT's digital transformation initiative; its purpose was to enable SMEs, local producers, women entrepreneurs and geographical-indication product holders to operate e-commerce with low commissions under state assurance.

After the e-commerce boom triggered by the post-2020 pandemic, PttAvm's volume grew rapidly. Today PttAvm has evolved into a state-backed e-commerce ecosystem comprising the marketplace (3P), the PTT Kargo delivery network, the PTT Logistics fulfillment service, the Local Producer Showcase, and the Geographical-Indication Products and Women Entrepreneurs programs.

PttAvm Ownership Structure (2025)

• PTT Anonim Şirketi (PTT Inc.) — Sole shareholder (100%, state-owned entity)
• Republic of Turkey Ministry of Transport and Infrastructure — Sole shareholder of PTT Inc. (100%)
• Türkiye Wealth Fund — Strategic public-asset coordination
• State-owned entity — Official protocol partnerships with KOSGEB (Turkey's SME agency), Tarım Kredi (Agricultural Credit Cooperative) and the Turkish Patent and Trademark Office

Position in Turkish E-Commerce

As of 2024, PttAvm is positioned as Turkey's most trusted state-backed marketplace. Unlike private-sector marketplaces such as Trendyol and Hepsiburada, it differentiates itself through state subsidies, low commissions and SME-protective policies. It holds a particularly unmatched position in the geographical-indication, local producer, women entrepreneur and KOSGEB ecosystems. Thanks to PTT's network of 17,000+ post offices, it offers delivery reach across all 81 provinces of Turkey.

PttAvm Sales Volume and Scale (2024–2025 Data)

Since its 2017 launch — and accelerated especially by the pandemic-era digital transformation — PttAvm has grown 50–80% year over year. State subsidies and low commissions have rapidly increased seller numbers.

Year	GMV (TRY)	Orders	Active Customers	Active Sellers
2020	~₺500 million	3 million	1.5M	5K
2022	~₺2 billion	12 million	3M	12K
2024	~₺4.5 billion	28 million	4M+	20K+
2025 (projected)	~₺6.5 billion	42 million	5.5M	28K

This growth has been driven by PTT Kargo's 81-province network, state-subsidized low commissions, and the dedicated Local Producer Showcase, Geographical-Indication Product and Women Entrepreneurs programs. Becoming a seller on PttAvm represents the lowest-commission, most trusted state-backed e-commerce route — especially for SMEs and local producers.

Opening a Store on PttAvm (2026 Current Rules)

1. Legal and Financial Requirements

To become a seller on PttAvm, you must hold an active tax registration in Turkey. Sole proprietorship, limited or joint-stock company are all acceptable; however, you must be an e-Invoice taxpayer and capable of issuing e-Archive invoices. Dedicated application channels exist for businesses enrolled in KOSGEB (Turkey's SME agency), Tarım Kredi (Agricultural Credit Cooperative) and Geographical Indication programs.

• Tax certificate (current year)
• Tax number and Turkish ID number (for sole proprietorships)
• Trade registry gazette (for Ltd./Inc.)
• Signature circular
• Bank account (IBAN) — payouts are transferred to this account
• GİB-approved e-Invoice/e-Archive integrator or the GİB (Turkish Revenue Administration) portal
• Trademark certificate (for protected categories such as cosmetics, food, toys)
• Geographical Indication Registration (from the Turkish Patent and Trademark Office for products such as Antep Fıstığı, Hereke carpets, etc.)

2. Applying to the PttAvm Seller Panel

You apply via satici.pttavm.com. The approval period is 5–7 business days due to the government-agency process (slightly longer than private-sector marketplaces; however, post-approval advantages are far greater). Upon approval you receive a store ID, an API key (apiKey) and an API secret (apiSecret) — these are critical for integration.

📥 Official PttAvm Seller Application satici.pttavm.com — free application, 5–7 business days approval →

3. Product Upload and Content Rules

PttAvm enforces content rules consistent with Turkish e-commerce standards for product listings:

• Title: 50–150 characters, brand + product name + key feature
• Image: white background, minimum 1000×1000px, up to 8 photos, no watermark or text
• Description: HTML-supported, minimum 200 characters
• Category mapping: PttAvm category ID + attributes (color, size, material, country of origin)
• Barcode (GTIN/EAN): where possible — substantially increases match speed
• Local Producer / Geographical Indication tags: badge eligibility on qualifying products, with lower commissions

PttAvm Commission Rates (2026)

PttAvm 2026 commission rates range from 3% to 18% depending on category — significantly below Trendyol and Hepsiburada thanks to state subsidies. 20% VAT, a service fee and PTT Kargo cost are added to the commission. Producers enrolled in the KOSGEB, Tarım Kredi and Geographical Indication programs receive additional commission discounts.

Net earnings formula: Sale price − Commission − VAT − Service fee − PTT Kargo fee − Product cost = Net profit. The Zunapro pricing module calculates this automatically for every product and category; it also factors in KOSGEB, Geographical Indication and Local Producer incentive discounts.

PttAvm API Integration — Technical Details

The PttAvm API is a RESTful interface that enables sellers to programmatically synchronize product, stock, order, price, shipping and return data with the PttAvm system. API base URL: https://ws.pttavm.com/api/v1/

API Authorization

The PttAvm API uses an API Key + Secret (HMAC SHA-256) signing scheme. Each request includes a timestamp + HMAC SHA-256 signature, sent in the Authorization header. There is no token expiry; however, rotating credentials every 6–12 months for security is recommended. Official documentation: ws.pttavm.com/docs.

Main Endpoint Categories

• Products API — product creation, updates, category mapping, local-producer/geographical-indication badge queries
• Stock API — stock and price synchronization (bulk endpoint, max 100 products/request)
• Orders API — order listing, status updates, package creation
• Categories API — PttAvm category tree, attribute templates, incentive categories
• Cargo API — PTT Kargo label creation, tracking number sync
• Claims API — querying return requests, accept/reject
• Webhooks — instant callbacks on order and stock changes

Rate Limit and Error Handling

The PttAvm API rate limit is 40 requests per minute per seller. When exceeded, it returns 429 Too Many Requests. Common error codes: 400 (invalid product data), 401 (HMAC signature error), 404 (category/barcode not found), 500 (PttAvm system error — retry). The Zunapro integrator manages these errors automatically with exponential backoff retry and a dead-letter queue.

PttAvm XML Integration — Bulk Product Transfer

PttAvm XML integration is a system that automatically reads the product catalog from your supplier or your own e-commerce site in XML format and transfers it to the PttAvm seller panel. The PttAvm XML schema conforms to Turkish e-commerce standards. As an alternative to manual product entry, it enables you to upload thousands of products within minutes.

XML Schema Structure (PttAvm-Compatible)

Core fields for the XML uploaded to PttAvm:

• productMainId — Main product code (groups variants)
• brand, title, productCode, stockCode, barcode
• categoryId (PttAvm category), attributes (color, size, material, country of origin)
• quantity (stock), listPrice, salePrice, vatRate
• cargoCompanyId (PTT Kargo by default), shipmentAddressId
• geographicalIndication (geographical-indication code — if applicable)
• domesticProducer (local-producer flag), womanEntrepreneur (women-entrepreneur flag)
• images (1–8 URLs), description (HTML)

Transfer from Supplier XML to PttAvm

Most Turkish wholesalers/suppliers and local producers (particularly SMEs in Anatolian provinces and producers of geographical-indication products) share their product catalogs as XML. The Zunapro XML module:

1. Reads the supplier XML URL (hourly/daily cron)
2. Learns category mapping (first mapping is manual, then automatic)
3. Normalizes attributes such as brand, material, country of origin and size
4. Automatically assigns local-producer / geographical-indication badges
5. Adds profit margin + commission to the price (including state incentive discounts)
6. Tracks inventory — automatically deactivates products no longer available at the supplier
7. Uploads to PttAvm via API

PttAvm Fulfillment (PTT Logistics) — State-Backed Logistics Solution

PTT Logistics Fulfillment is a service built on PTT's long-established postal + cargo infrastructure. Once you deliver your products to PTT's network of 17,000+ post offices, storage, packaging, last-mile delivery via PTT Kargo and returns management are handled entirely by PTT. Expanded in 2024, this service offers PttAvm sellers a discounted storage + shipping package.

PTT Logistics Fulfillment Advantages

• Full 81-province delivery — PTT Kargo + 17,000+ post office network
• State-infrastructure assurance — guarantee of the Turkish postal & telegraph authority
• Customer service handled by PTT — returns, exchanges, complaints
• "Delivered with PTT assurance" label — boosts conversion, especially in provincial and rural markets
• Zero operational overhead — you do not handle packaging or shipping
• Discounted package — state-subsidized pricing exclusive to PttAvm sellers

PTT Logistics Fulfillment Costs (2025, approximate)

• Storage: ₺60–120 per m³/month (state-subsidized, below private sector)
• Order processing: ₺4–10 per item
• Return processing: ₺6–12 per return
• Commission: standard PttAvm commission + 0.5–1.5% fulfillment fee

PTT Logistics Fulfillment is cost-effective for sellers handling 300+ orders per month. Low-volume sellers may prefer to ship directly from their own warehouse via PTT Kargo.

PttAvm Store Performance Score and Cancellation Rates

PttAvm assigns each seller a store score on a scale of 1–10; this score directly affects storefront visibility. Store prestige is further enhanced by the "Local Producer", "Women Entrepreneurs" and "Geographical Indication" badges. Main factors that lower the score:

• Cancellation rate — out-of-stock cancellations are the biggest penalty; above 3% triggers a warning, above 6% risks store closure
• Late shipments — orders not handed over to PTT Kargo within the preparation window
• Return rate — returns above expected thresholds
• Customer reviews — must stay above 4.0 stars
• Response time — messages must be answered within 24 hours (state marketplace standard)

With Zunapro's automatic stock synchronization, you reduce your cancellation risk by 90%; products sold on your site, in your warehouse or on another marketplace are instantly deactivated on PttAvm.

PttAvm Advertising, State Incentives and Smart Pricing

PttAvm Advertising Platforms

• PttAvm Sponsored Products — top placements in search results (CPC-based, TRY/click)
• Local Producer Showcase — dedicated ad space for products with the local-producer badge
• Geographical Indication Showcase — sponsorship dedicated to geographical-indication products
• Women Entrepreneur Store Showcase — dedicated banner for sellers certified as women entrepreneurs

State Incentives and Programs

• KOSGEB — SME support programs via PttAvm, with special commission discounts
• Tarım Kredi Cooperatives — discounted commissions for farmers and agricultural producers
• Turkish Patent — Geographical Indication — dedicated category and lower commissions for officially geographical-indication products such as Antep Fıstığı (Antep pistachio), Erzurum Cağ Kebabı (Erzurum skewer kebab) and Çorum Leblebisi (Çorum roasted chickpeas)
• Women Entrepreneur Certificate — a dedicated program for women entrepreneurs certified by KAGİDER or KOSGEB
• Local Producer Certificate — commission discounts for products carrying the TOBB-approved local-producer badge

Smart Pricing (Repricer)

Price competition exists on PttAvm, though it is not as intense as on Trendyol because the seller pool is more selective. The Zunapro repricer module automatically adjusts prices against your competitors within seconds — it never drops below your minimum profit threshold and factors in state incentive discounts.

PttAvm E-Invoice and E-Archive Integration (GİB Compliance)

All sellers on PttAvm are required to issue e-Archive invoices to B2C customers and e-Invoices to B2B customers (GİB (Turkish Revenue Administration) regulation). Manual invoicing is not feasible once you exceed 50+ orders per day.

The Zunapro e-Invoice module:

• Automatically issues e-Archive/e-Invoice the moment PttAvm order data arrives
• Integrates with GİB-approved third-party integrators (Logo, Mikro, Uyumsoft, Foriba, Veriban, etc.)
• Automatic return invoices on returns
• Monthly KDV1, KDV2 (VAT) reporting
• Automatic PDF e-Archive sent to customers via email + SMS

PttAvm Shipping Integration — PTT Kargo + Alternatives

PttAvm orders are shipped by default via PTT Kargo (PTT's own courier, the most extensive cargo network in Turkey with 81 provinces + 17,000+ post offices). Alternative couriers can also be integrated: Yurtiçi Kargo, Aras Kargo, MNG Kargo, Sürat Kargo.

The Zunapro multi-carrier module automatically selects the most suitable courier based on order weight, destination city and customer preference; it prints labels and submits tracking numbers back to PttAvm automatically. PTT Kargo's provincial and rural coverage is unmatched, particularly for delivery to villages and towns beyond the 81 provincial centers.

PttAvm Returns and Customer Service Management

In Turkish e-commerce, return rates are 25–35% in fashion, 4–8% in electronics, 8–12% in home & living and 2–4% in food (especially in geographical-indication products). If the return process is not managed properly, store score declines.

PttAvm Standard Returns Process:

1. The customer opens a return request from the PttAvm panel (within 14 days of delivery)
2. PTT Kargo picks up the product free of charge (1–3 business days; it can also be dropped off at a post office)
3. The PTT warehouse inspects, routes to the seller, or grants the return
4. The seller approves or rejects the return within 1–3 business days
5. If approved, the customer's funds are refunded to the PttAvm wallet

The Zunapro returns module tracks all of these steps automatically; it sends panel notifications to the seller and automatically issues a return invoice for customer returns.

PttAvm Integration with Zunapro — 4-Step Setup (10 Minutes)

1. Enter Your PttAvm Store Details — In the Zunapro panel, go to Marketplace → PttAvm and enter your Store ID, API key and API secret.
2. Connect Your Existing Site — Prebuilt connectors for Shopify, WooCommerce, OpenCart, İkas, Ticimax, PrestaShop and Magento. Enter the API URL + access key.
3. Category Mapping Wizard — Map your site's categories to PttAvm categories via drag-and-drop. Local-producer / geographical-indication badges are assigned automatically.
4. Initial Synchronization — Product, stock, price, order, PTT Kargo — all sync automatically. Within 10 minutes, your PttAvm store can be managed from the Zunapro panel.

Frequently Asked Questions About PttAvm Integration (FAQ)