{ "openapi": "3.0.3", "info": { "title": "Vergi Merkezi | Dijital Agentic API", "version": "1.4.0", "description": "Vergi Merkezi müşteri API’si. Muhasebe işlemlerine ek olarak firma bazlı Turkcell bağlantısı, 93 sağlayıcı işlemi, şirket arama, belge durumu, PDF ve UBL erişimi sunar. Hesap hizmet yetkisi, firma bağlantı doğrulaması ve gönderimde kontör gerekir. Muhasebe kaydı tek başına resmî gönderim değildir.", "x-documentation-version": "1.1", "x-reviewed-at": "2026-10-30" }, "servers": [ { "url": "https://portal.vergimerkezi.com.tr/api/v1", "description": "Üretim ortamı" } ], "security": [ { "bearerAuth": [] } ], "paths": { "/auth/login": { "post": { "summary": "E-posta ve şifre ile API token al", "description": "Müşteri (client) hesabı için yeni Bearer token üretir. Başarılı yanıtta dönen token, profil sayfasından oluşturulan token ile aynı şekilde kullanılır. Her başarılı çağrı önceki api_token değerini geçersiz kılar. Sözleşme onayı zorunluysa ve web üzerinden kabul edilmemişse 403 döner.", "security": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "email", "password" ], "properties": { "email": { "type": "string", "format": "email" }, "password": { "type": "string" } } } } } }, "responses": { "200": { "description": "success, data.token, data.user_id", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "E-posta veya şifre hatalı" }, "403": { "description": "Müşteri değil veya sözleşme onayı eksik" }, "422": { "description": "Validasyon hatası" }, "429": { "description": "Çok fazla deneme (throttle)", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Kimlik" ], "operationId": "postAuthLogin", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "x-side-effect": "Rotasyona veya üretimde kalıcı kayıt değişikliğine neden olabilir." } }, "/agent/companies": { "get": { "summary": "Şirket listesi", "description": "Oturum açan kullanıcının şirketleri. Sipariş için company_id kullanılır.", "responses": { "200": { "description": "companies, currency", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Şirket ve ürün" ], "operationId": "getAgentCompanies", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review_and_live_read", "parameters": [] } }, "/agent/products": { "get": { "summary": "Ürün/hizmet listesi", "description": "Kontör ve hizmet fiyatları. items (düz liste), kontor, services (kategori bazlı).", "responses": { "200": { "description": "currency, year, items, kontor ve services. Firma stok kartı kataloğu değildir.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Şirket ve ürün" ], "operationId": "getAgentProducts", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "parameters": [] } }, "/agent/orders": { "post": { "summary": "Sipariş oluştur", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id" ], "properties": { "company_id": { "type": "integer", "description": "Şirket ID (GET companies ile alınır)" }, "pricing_key": { "type": "string", "description": "Kontör paketi key (tek ürün)", "maxLength": 50, "minLength": 1 }, "pricing_keys": { "type": "array", "items": { "type": "string" }, "description": "Hizmet key listesi", "minItems": 1 } }, "anyOf": [ { "required": [ "pricing_key" ] }, { "required": [ "pricing_keys" ] } ] } } } }, "responses": { "201": { "description": "order_id, order_no, token, checkout_url, status, status_label, currency", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "422": { "description": "Validasyon hatası" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Sipariş" ], "operationId": "postAgentOrders", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "x-side-effect": "Rotasyona veya üretimde kalıcı kayıt değişikliğine neden olabilir." } }, "/agent/orders/{id}": { "get": { "summary": "Sipariş durumu", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "order_id, order_no, token, status, status_label, checkout_url, grand_total, currency, payment_confirmed_at", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "404": { "description": "Sipariş bulunamadı" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Sipariş" ], "operationId": "getAgentOrdersId", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" } }, "/agent/formation": { "get": { "summary": "Şirket kuruluş başvuruları listesi", "responses": { "200": { "description": "applications[]", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Kuruluş" ], "operationId": "getAgentFormation", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "parameters": [] }, "post": { "summary": "Şirket kuruluş başvurusu oluştur", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "applicant_email", "applicant_name", "applicant_phone", "company_type", "proposed_name" ], "properties": { "company_type": { "type": "string", "enum": [ "sahis_isletme", "sahis_serbest", "sahis_bilanco", "ltd", "anonim" ] }, "proposed_name": { "type": "string", "maxLength": 255 }, "capital": { "type": "string", "nullable": true, "maxLength": 64 }, "partners": { "type": "array", "items": {}, "nullable": true }, "applicant_name": { "type": "string", "maxLength": 191 }, "applicant_email": { "type": "string", "format": "email" }, "applicant_phone": { "type": "string", "maxLength": 191 }, "webhook_url": { "type": "string", "description": "Statü değişince POST atılır", "format": "uri", "nullable": true, "maxLength": 500 }, "documents": { "type": "array", "items": {}, "nullable": true } } } } }, "required": true }, "responses": { "201": { "description": "application_id, order_id, checkout_url, status; e-posta + webhook ile geri bildirim", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Kuruluş" ], "operationId": "postAgentFormation", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "x-side-effect": "Rotasyona veya üretimde kalıcı kayıt değişikliğine neden olabilir." } }, "/agent/formation/{id}": { "get": { "summary": "Tek başvuru durumu", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "application_id, status, status_label, message (admin_note)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Kuruluş" ], "operationId": "getAgentFormationId", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" } }, "/agent/accounting/categories": { "get": { "summary": "Gider kategorileri", "description": "Fatura kaydında category (key) seçimi için. record-invoice çağrılmadan önce isteğe bağlı.", "responses": { "200": { "description": "categories[] (key, name, parent_group)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Muhasebe" ], "operationId": "getAgentAccountingCategories", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "parameters": [] } }, "/agent/accounting/record-invoice": { "post": { "summary": "Faturayı muhasebeye kaydet", "description": "Evrak ve create_booking varsayılanı true olduğundan defter tipine göre muhasebe kaydı oluşturur. Bilanço defterinde yevmiye, işletme ve serbest meslekte basit hareket kaydı açılabilir. Yerel muhasebe işlemidir; resmî e Fatura oluşturmaz, GİB’e göndermez ve gerçek PDF dosyası üretmez.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "amount", "company_id", "invoice_date", "type" ], "properties": { "company_id": { "type": "integer", "description": "Şirket ID (GET companies)" }, "type": { "type": "string", "enum": [ "gelir", "gider" ] }, "invoice_date": { "type": "string", "format": "date", "description": "Y-m-d" }, "amount": { "type": "number", "minimum": 0.01 }, "supplier_name": { "type": "string", "nullable": true, "maxLength": 255 }, "supplier_tax_id": { "type": "string", "nullable": true, "maxLength": 20 }, "invoice_no": { "type": "string", "nullable": true, "maxLength": 100 }, "category": { "type": "string", "description": "GET accounting/categories key", "nullable": true, "maxLength": 100 }, "description": { "type": "string", "nullable": true, "maxLength": 1000 }, "create_booking": { "type": "boolean", "default": true, "description": "Fiş oluşturulsun mu", "nullable": true }, "matrah": { "type": "number", "description": "Opsiyonel: vergi matrahı", "nullable": true, "minimum": 0 }, "kdv_amount": { "type": "number", "description": "Opsiyonel: KDV tutarı", "nullable": true, "minimum": 0 }, "kdv_rate": { "type": "integer", "description": "Opsiyonel: KDV oranı (0-100)", "nullable": true, "minimum": 0, "maximum": 100 } } } } } }, "responses": { "201": { "description": "document_id, transaction_id?, booking_created, message, create_from_document_url? (bilanço)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "422": { "description": "Validasyon veya dönem kapalı hatası" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Muhasebe" ], "operationId": "postAgentAccountingRecordInvoice", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "x-side-effect": "Rotasyona veya üretimde kalıcı kayıt değişikliğine neden olabilir." } }, "/agent/accounting/record-invoice-draft": { "post": { "summary": "Fatura taslağı oluştur", "description": "Kullanıcı onayı almadan önce taslak oluşturur. Yanıtta draft_summary ve confirm_url döner; kullanıcı onayladıktan sonra POST confirm-draft/{id} ile kesinleştirin. Yerel muhasebe işlemidir; resmî e Fatura oluşturmaz, GİB’e göndermez ve gerçek PDF dosyası üretmez.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "amount", "company_id", "invoice_date", "type" ], "properties": { "company_id": { "type": "integer" }, "type": { "type": "string", "enum": [ "gelir", "gider" ] }, "invoice_date": { "type": "string", "format": "date" }, "amount": { "type": "number", "minimum": 0.01 }, "supplier_name": { "type": "string", "nullable": true, "maxLength": 255 }, "supplier_tax_id": { "type": "string", "nullable": true, "maxLength": 20 }, "invoice_no": { "type": "string", "nullable": true, "maxLength": 100 }, "category": { "type": "string", "nullable": true, "maxLength": 100 }, "description": { "type": "string", "nullable": true, "maxLength": 1000 }, "matrah": { "type": "number", "nullable": true, "minimum": 0 }, "kdv_amount": { "type": "number", "nullable": true, "minimum": 0 }, "kdv_rate": { "type": "integer", "nullable": true, "minimum": 0, "maximum": 100 }, "create_booking": { "type": "boolean", "nullable": true } } } } } }, "responses": { "201": { "description": "document_id, draft_summary, message, confirm_url, transaction_id? (bilanço)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "422": { "description": "Validasyon veya dönem kapalı" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Muhasebe" ], "operationId": "postAgentAccountingRecordInvoiceDraft", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "x-side-effect": "Rotasyona veya üretimde kalıcı kayıt değişikliğine neden olabilir." } }, "/agent/accounting/confirm-draft/{id}": { "post": { "summary": "Taslağı kesinleştir", "description": "record-invoice-draft ile oluşturulan taslak evrakı kullanıcı onayı sonrası kesinleştirir. Bilanço: fiş posted olur; işletme/serbest: fiş oluşturulur. Yerel muhasebe işlemidir; resmî e Fatura oluşturmaz, GİB’e göndermez ve gerçek PDF dosyası üretmez.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "description": "document_id" } } ], "responses": { "200": { "description": "document_id, status: completed, message", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "404": { "description": "Evrak bulunamadı veya yetkisiz" }, "422": { "description": "Taslak değil veya zaten kesinleştirilmiş" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Muhasebe" ], "operationId": "postAgentAccountingConfirmDraftId", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "x-side-effect": "Rotasyona veya üretimde kalıcı kayıt değişikliğine neden olabilir." } }, "/agent/reports/trial-balance": { "get": { "summary": "Mizan", "description": "Bilanço defteri tutan şirketler için mizan. Ajan: \"mizanımı getir\" veya \"Haziran mizanı\" gibi sorularda company_id, year, month ile çağrılır.", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "year", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 2020, "maximum": 2100 } }, { "name": "month", "in": "query", "required": false, "schema": { "type": "integer", "nullable": true, "minimum": 1, "maximum": 12 } }, { "name": "include_draft", "in": "query", "required": false, "description": "Taslak muhasebe kayıtlarını da dahil etmek için 1 kullanın.", "schema": { "type": "integer", "enum": [ 0, 1 ] } } ], "responses": { "200": { "description": "supported, rows (account_code, account_name, total_debit, total_credit, balance), totals; supported=false ise message", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Raporlar" ], "operationId": "getAgentReportsTrialBalance", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" } }, "/agent/reports/income-statement": { "get": { "summary": "Gelir tablosu / Kâr-zarar", "description": "Bilanço şirketleri için yıllık gelir-gider ve net kâr. \"Haziran ayı kâr durumum\" için summary raporu kullanılabilir.", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "year", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 2020, "maximum": 2100 } }, { "name": "include_draft", "in": "query", "required": false, "description": "Taslak muhasebe kayıtlarını da dahil etmek için 1 kullanın.", "schema": { "type": "integer", "enum": [ 0, 1 ] } } ], "responses": { "200": { "description": "supported, income[], expense[], total_income, total_expense, net_profit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Raporlar" ], "operationId": "getAgentReportsIncomeStatement", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" } }, "/agent/reports/vat": { "get": { "summary": "KDV özeti", "description": "Evrak bazlı KDV özeti (gelir/gider matrah ve vergi). Tüm şirket tipleri.", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "year", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 2020, "maximum": 2100 } }, { "name": "month", "in": "query", "required": false, "schema": { "type": "integer", "nullable": true, "minimum": 1, "maximum": 12 } } ], "responses": { "200": { "description": "summary (gelir/gider base,tax), by_rate, document_count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Raporlar" ], "operationId": "getAgentReportsVat", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" } }, "/agent/reports/summary": { "get": { "summary": "Yıllık özet (aylık gelir/gider/net)", "description": "Tüm şirket tipleri için aylık gelir, gider ve net. \"Yıllık kârım\", \"Haziran ayı durumu\" gibi sorularda kullanılır.", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "year", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 2020, "maximum": 2100 } }, { "name": "include_draft", "in": "query", "required": false, "description": "Taslak muhasebe kayıtlarını da dahil etmek için 1 kullanın.", "schema": { "type": "integer", "enum": [ 0, 1 ] } } ], "responses": { "200": { "description": "monthly[] (month, income, expense, net), total_income, total_expense, total_net", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Raporlar" ], "operationId": "getAgentReportsSummary", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" } }, "/agent/reports/documents": { "get": { "summary": "Evrak listesi", "description": "Tarih aralığı ve tip filtresi ile evrak listesi. Tüm şirket tipleri.", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "date_from", "in": "query", "required": false, "schema": { "type": "string", "format": "date", "nullable": true }, "description": "Başlangıç tarihi (Y-m-d)" }, { "name": "date_to", "in": "query", "required": false, "schema": { "type": "string", "format": "date", "nullable": true, "description": "date_from tarihinden önce olamaz." }, "description": "Bitiş tarihi (Y-m-d)" }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "gelir", "gider" ], "nullable": true } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "draft", "pending", "completed" ], "nullable": true } }, { "name": "per_page", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "maximum": 200, "nullable": true, "minimum": 1 } } ], "responses": { "200": { "description": "documents[], total, per_page, current_page, last_page", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Raporlar" ], "operationId": "getAgentReportsDocuments", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" } }, "/agent/accounting/propose-delete/{id}": { "post": { "summary": "Silme teklifi", "description": "Evrak özetini ve onay ifadesini (confirm_phrase) döner; henüz silmez. Asistan bu yanıtı kullanıcıya gösterir.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "Evrak ID" } ], "responses": { "200": { "description": "document_id, summary, warning, confirm_phrase, confirm_url", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "422": { "description": "Dönem kapalı veya evrak bulunamadı" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Muhasebe" ], "operationId": "postAgentAccountingProposeDeleteId", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "x-side-effect": "Rotasyona veya üretimde kalıcı kayıt değişikliğine neden olabilir." } }, "/agent/accounting/confirm-delete/{id}": { "post": { "summary": "Silmeyi kesinleştir", "description": "propose-delete'den dönen confirm_phrase, body'deki confirmation alanına yazılır. Eşleşirse evrak ve bağlı draft kayıtları silinir.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "Evrak ID" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "confirmation" ], "properties": { "confirmation": { "type": "string", "example": "SİL-42", "description": "propose-delete'den dönen confirm_phrase" } } } } } }, "responses": { "200": { "description": "document_id, status=deleted, message", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "422": { "description": "Onay ifadesi hatalı veya dönem kapalı" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Muhasebe" ], "operationId": "postAgentAccountingConfirmDeleteId", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "x-side-effect": "Rotasyona veya üretimde kalıcı kayıt değişikliğine neden olabilir." } }, "/agent/lookup/caris": { "get": { "summary": "Cari listesi", "description": "Müşteri ve/veya tedarikçi listesi. Fatura/dekont kaydında cari seçimi için kullanılır.", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "customer", "supplier", "both" ], "nullable": true }, "description": "Filtreleme: müşteri / tedarikçi / her ikisi" }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string", "nullable": true, "maxLength": 100 }, "description": "Ad, kod veya vergi numarasıyla arama" }, { "name": "per_page", "in": "query", "required": false, "schema": { "type": "integer", "default": 100, "maximum": 500, "nullable": true, "minimum": 1 } }, { "name": "has_balance", "in": "query", "required": false, "schema": { "type": "integer", "nullable": true, "enum": [ 0, 1 ], "description": "Sorgu parametresinde 0 veya 1 kullanın." }, "description": "true: yalnızca bakiyesi sıfır olmayan cariler" } ], "responses": { "200": { "description": "caris[], total, per_page, current_page, last_page — Her kayıt: id, code, name, type, tax_id, balance, currency, account_code", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Arama ve listeler" ], "operationId": "getAgentLookupCaris", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" }, "post": { "summary": "Yeni cari oluştur", "description": "Cari hesap kartı oluşturur (web formları ile uyumlu kurallar).", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "type" ], "properties": { "company_id": { "type": "integer" }, "code": { "type": "string", "nullable": true, "maxLength": 255 }, "name": { "type": "string", "nullable": true, "maxLength": 255 }, "type": { "type": "string", "enum": [ "customer", "supplier", "both" ] }, "category": { "type": "string", "enum": [ "individual", "company" ], "nullable": true }, "group": { "type": "string", "nullable": true, "maxLength": 100 }, "tax_id": { "type": "string", "nullable": true, "maxLength": 255 }, "tax_office": { "type": "string", "nullable": true, "maxLength": 255 }, "phone": { "type": "string", "nullable": true, "maxLength": 30 }, "email": { "type": "string", "format": "email", "nullable": true, "maxLength": 255 }, "address": { "type": "string", "nullable": true }, "city": { "type": "string", "nullable": true, "maxLength": 100 }, "currency": { "type": "string", "nullable": true, "maxLength": 3 }, "account_code": { "type": "string", "nullable": true, "maxLength": 50 }, "opening_balance": { "type": "number", "nullable": true }, "first_name": { "type": "string", "nullable": true, "maxLength": 255 }, "last_name": { "type": "string", "nullable": true, "maxLength": 255 }, "title": { "type": "string", "nullable": true, "maxLength": 255 } }, "anyOf": [ { "required": [ "name" ] }, { "required": [ "title" ] }, { "required": [ "first_name", "last_name" ] } ], "description": "Adlandırma için name veya title ya da first_name ve last_name birlikte kullanın. Kimlikler aynı firmaya ait olmalıdır." } } } }, "responses": { "201": { "description": "cari_id, code, name, type, balance, message", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "422": { "description": "Validasyon hatası" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Arama ve listeler" ], "operationId": "postAgentLookupCaris", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "x-side-effect": "Rotasyona veya üretimde kalıcı kayıt değişikliğine neden olabilir." } }, "/agent/lookup/caris/{id}": { "get": { "summary": "Tek cari detayı", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }, { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Cari alanları", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "404": { "description": "Bulunamadı" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Arama ve listeler" ], "operationId": "getAgentLookupCarisId", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" } }, "/agent/lookup/bank-accounts": { "get": { "summary": "Banka hesapları listesi", "description": "Şirkete tanımlı banka hesapları. Ödeme/tahsilat kaydında banka seçimi için kullanılır.", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string", "nullable": true, "maxLength": 3 }, "description": "Para birimi filtresi (ör. TRY, USD)" }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string", "nullable": true, "maxLength": 100 } } ], "responses": { "200": { "description": "bank_accounts[], total — Her kayıt: id, bank_name, branch (şube), iban, currency, balance, account_code, is_default", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Arama ve listeler" ], "operationId": "getAgentLookupBankAccounts", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" } }, "/agent/lookup/cash-registers": { "get": { "summary": "Kasa listesi", "description": "Şirkete tanımlı kasalar. Nakit ödeme/tahsilat kaydında kasa seçimi için kullanılır.", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string", "nullable": true, "maxLength": 3 } } ], "responses": { "200": { "description": "cash_registers[], total — Her kayıt: id, name, currency, balance, account_code, is_default", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Arama ve listeler" ], "operationId": "getAgentLookupCashRegisters", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" } }, "/agent/lookup/items": { "get": { "summary": "Stok kartı / ürün-hizmet listesi", "description": "Tanımlı stok kartları ve hizmet kalemleri. Fatura satır kalemleri için kullanılır.", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "product", "service", "raw_material" ], "nullable": true } }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string", "nullable": true, "maxLength": 100 }, "description": "Ad, kod veya barkodla arama" }, { "name": "per_page", "in": "query", "required": false, "schema": { "type": "integer", "default": 100, "maximum": 500, "nullable": true, "minimum": 1 } } ], "responses": { "200": { "description": "items[], total — Her kayıt: id, code, name, type, unit, purchase_price, sale_price, tax_rate, quantity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Arama ve listeler" ], "operationId": "getAgentLookupItems", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" }, "post": { "summary": "Yeni stok / hizmet kartı", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "name", "type" ], "properties": { "company_id": { "type": "integer" }, "name": { "type": "string", "maxLength": 255 }, "type": { "type": "string", "enum": [ "product", "service", "raw_material" ] }, "code": { "type": "string", "nullable": true, "maxLength": 50 }, "category": { "type": "string", "nullable": true, "maxLength": 100 }, "unit": { "type": "string", "nullable": true, "maxLength": 20 }, "purchase_price": { "type": "number", "minimum": 0, "nullable": true }, "sale_price": { "type": "number", "minimum": 0, "nullable": true }, "tax_rate": { "type": "number", "minimum": 0, "maximum": 100, "nullable": true }, "quantity": { "type": "number", "minimum": 0, "nullable": true }, "description": { "type": "string", "nullable": true }, "currency": { "type": "string" }, "is_stock_item": { "type": "boolean" }, "is_sales_item": { "type": "boolean" }, "is_purchase_item": { "type": "boolean" } } } } } }, "responses": { "201": { "description": "item_id, code, name, type, quantity, message", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "422": { "description": "Validasyon hatası" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Arama ve listeler" ], "operationId": "postAgentLookupItems", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "x-side-effect": "Rotasyona veya üretimde kalıcı kayıt değişikliğine neden olabilir." } }, "/agent/lookup/chart-of-accounts": { "get": { "summary": "Hesap planı (bilanço şirketleri)", "description": "Tek düzen hesap planı. Bilanço defteri tutan şirketlerde muhasebe kaydı için hesap kodu seçiminde kullanılır.", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "account_type", "in": "query", "required": false, "schema": { "type": "string", "nullable": true }, "description": "Hesap tipi filtresi" }, { "name": "root_type", "in": "query", "required": false, "schema": { "type": "string", "nullable": true }, "description": "Kök tip (Asset, Liability, Income, Expense, Equity)" }, { "name": "is_group", "in": "query", "required": false, "schema": { "type": "integer", "nullable": true, "enum": [ 0, 1 ], "description": "Sorgu parametresinde 0 veya 1 kullanın." }, "description": "true: grup hesaplar, false/varsayılan: detay hesaplar" }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string", "nullable": true, "maxLength": 100 } } ], "responses": { "200": { "description": "accounts[], total — Her kayıt: id, code, name, account_type, root_type, is_group, level", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Arama ve listeler" ], "operationId": "getAgentLookupChartOfAccounts", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" } }, "/agent/lookup/vkn-info": { "get": { "summary": "VKN / TCKN Sorgulama", "description": "Turkcell GİB alıcı listesinde tam VKN veya TCKN arar. Unvan ve alıcı etiketleri döner. Vergi levhası, adres ve vergi dairesi bilgisi döndürmez. company_id zorunludur.", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "vkn", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^\\d{10,11}$" } } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "tags": [ "Arama ve listeler" ], "operationId": "getAgentLookupVknInfo", "x-implementation-status": "implemented_in_code", "x-review-evidence": "isolated_tests" } }, "/agent/accounting/document/{id}": { "get": { "summary": "Tek evrak detayı", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }, { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Evrak alanları", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "404": { "description": "Bulunamadı" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Muhasebe" ], "operationId": "getAgentAccountingDocumentId", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" }, "patch": { "summary": "Evrak güncelle (draft/pending)", "description": "Yalnızca draft veya pending statüsündeki evraklar güncellenebilir. completed evraklar reddedilir.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "Evrak ID" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "invoice_date": { "type": "string", "format": "date", "nullable": true }, "amount": { "type": "number", "nullable": true, "minimum": 0.01 }, "supplier_name": { "type": "string", "nullable": true, "maxLength": 255 }, "supplier_tax_id": { "type": "string", "nullable": true, "maxLength": 50 }, "invoice_no": { "type": "string", "nullable": true, "maxLength": 100 }, "category": { "type": "string", "nullable": true, "maxLength": 100 }, "description": { "type": "string", "nullable": true, "maxLength": 500 }, "matrah": { "type": "number", "nullable": true, "minimum": 0 }, "kdv_amount": { "type": "number", "nullable": true, "minimum": 0 }, "kdv_rate": { "type": "integer", "nullable": true, "minimum": 0, "maximum": 100 } } } } } }, "responses": { "200": { "description": "document_id, status, updated_fields, message, summary", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "422": { "description": "Kesinleşmiş evrak veya dönem kapalı" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Muhasebe" ], "operationId": "patchAgentAccountingDocumentId", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "x-side-effect": "Rotasyona veya üretimde kalıcı kayıt değişikliğine neden olabilir." } }, "/agent/accounting/document/{id}/formalize": { "post": { "summary": "Taslağı resmileştir (e-Fatura gönder)", "description": "Yerel evrakla ilişkili ayrıntılı payload veya bağlı invoice_id üzerinden resmî gönderim yapar. family, confirm_send ve idempotency_key gerekir. Yerel muhasebe evrakı tek başına yeterli değildir. İstemci yerel evrak ve sağlayıcı UUID ilişkisini saklamalıdır.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "family", "confirm_send" ], "properties": { "company_id": { "type": "integer" }, "family": { "type": "string", "enum": [ "outboxinvoice", "earchive", "voucher" ] }, "confirm_send": { "type": "boolean", "enum": [ true ] }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128 }, "payload": { "type": "object", "additionalProperties": true }, "invoice_id": { "type": "integer" } } } } } }, "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "tags": [ "Muhasebe" ], "operationId": "postAgentAccountingDocumentIdFormalize", "x-implementation-status": "implemented_in_code", "x-review-evidence": "isolated_tests", "x-side-effect": "Rotasyona veya üretimde kalıcı kayıt değişikliğine neden olabilir." } }, "/agent/accounting/inbox": { "get": { "summary": "Gelen e-Faturalar (Inbox)", "description": "Turkcell gelen kutusuna bağlıdır. company_id ve pageIndex, pageSize, isNew, tarih filtreleri desteklenir. Sağlayıcı bağlantı doğrulaması gerekir.", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "isNew", "in": "query", "schema": { "type": "string" } }, { "name": "invoiceNumber", "in": "query", "schema": { "type": "string" } }, { "name": "targetVknTckn", "in": "query", "schema": { "type": "string" } }, { "name": "type", "in": "query", "schema": { "type": "string" } }, { "name": "tipType", "in": "query", "schema": { "type": "string" } }, { "name": "status", "in": "query", "schema": { "type": "string" } }, { "name": "startDate", "in": "query", "schema": { "type": "string" } }, { "name": "endDate", "in": "query", "schema": { "type": "string" } }, { "name": "pageIndex", "in": "query", "schema": { "type": "integer" } }, { "name": "pageSize", "in": "query", "schema": { "type": "integer" } }, { "name": "isDesc", "in": "query", "schema": { "type": "string" } }, { "name": "executionStartDate", "in": "query", "schema": { "type": "string" } }, { "name": "executionEndDate", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "tags": [ "Muhasebe" ], "operationId": "getAgentAccountingInbox", "x-implementation-status": "implemented_in_code", "x-review-evidence": "isolated_tests" } }, "/agent/accounting/inbox/{id}/respond": { "post": { "summary": "Gelen e-Faturaya yanıt (Kabul/Ret)", "description": "Gelen ticari faturaya action accept veya reject ile cevap verir. UUID yol kimliği ve idempotency_key zorunludur. Sağlayıcıya InvoiceId, Status ve Reason alanlarıyla iletilir.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "company_id" ], "properties": { "company_id": { "type": "integer" }, "action": { "type": "string", "enum": [ "accept", "reject" ] }, "reason": { "type": "string", "maxLength": 500, "nullable": true }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128 } } } } } }, "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "tags": [ "Muhasebe" ], "operationId": "postAgentAccountingInboxIdRespond", "x-implementation-status": "implemented_in_code", "x-review-evidence": "isolated_tests", "x-side-effect": "Rotasyona veya üretimde kalıcı kayıt değişikliğine neden olabilir." } }, "/agent/accounting/record-collection": { "post": { "summary": "Tahsilat kaydı", "description": "Cari tahsilatı; banka için Transaction, nakit+kasa için CashTransaction; yanıtta document_id, direction. Aynı idempotency_key ile tekrar: 200 ve idempotent_replay. Muhasebe ve hareket kaydı oluşturur; bankadan gerçek para transferi başlatmaz. Aynı firma ve yön için idempotency_key veya client_reference desteklenir. Aynı anahtarla değişen işlem göndermeyin. Tarayıcı istemcilerinde JSON gövdesindeki idempotency_key kullanılır.", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "maxLength": 191 }, "description": "Body'deki idempotency_key ile aynı işlev; biri yeterli" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "amount", "cari_id", "collection_date", "company_id", "payment_method" ], "properties": { "company_id": { "type": "integer" }, "cari_id": { "type": "integer" }, "amount": { "type": "number", "minimum": 0.01 }, "collection_date": { "type": "string", "format": "date" }, "payment_method": { "type": "string", "enum": [ "bank", "cash", "card", "check" ] }, "bank_account_id": { "type": "integer", "nullable": true }, "cash_register_id": { "type": "integer", "nullable": true }, "document_id": { "type": "integer", "nullable": true }, "description": { "type": "string", "maxLength": 1000, "nullable": true }, "invoice_no": { "type": "string", "maxLength": 255, "nullable": true }, "reference_no": { "type": "string", "maxLength": 255, "nullable": true }, "idempotency_key": { "type": "string", "maxLength": 191, "nullable": true }, "client_reference": { "type": "string", "maxLength": 191, "nullable": true }, "currency": { "type": "string", "description": "Servis tarafından okunur; varsayılan TRY." }, "exchange_rate": { "type": "number", "description": "Servis tarafından okunan kur. Pozitif ve işlemle tutarlı değer kullanın." } } } } } }, "responses": { "201": { "description": "document_id, direction, payment_id, cari balance vb.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "200": { "description": "Aynı idempotency_key ile önceki kayıt (idempotent_replay)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "422": { "description": "Validasyon veya dönem kapalı" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Muhasebe" ], "operationId": "postAgentAccountingRecordCollection", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "x-side-effect": "Rotasyona veya üretimde kalıcı kayıt değişikliğine neden olabilir." } }, "/agent/accounting/record-payment": { "post": { "summary": "Ödeme kaydı (cariye giden)", "description": "Tedarikçi/cari ödemesi. Idempotency: header veya body. Muhasebe ve hareket kaydı oluşturur; bankadan gerçek para transferi başlatmaz. Aynı firma ve yön için idempotency_key veya client_reference desteklenir. Aynı anahtarla değişen işlem göndermeyin. Tarayıcı istemcilerinde JSON gövdesindeki idempotency_key kullanılır.", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "maxLength": 191 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "amount", "cari_id", "company_id", "payment_date", "payment_method" ], "properties": { "company_id": { "type": "integer" }, "cari_id": { "type": "integer" }, "amount": { "type": "number", "minimum": 0.01 }, "payment_date": { "type": "string", "format": "date" }, "payment_method": { "type": "string", "enum": [ "bank", "cash", "card", "check" ] }, "bank_account_id": { "type": "integer", "nullable": true }, "cash_register_id": { "type": "integer", "nullable": true }, "document_id": { "type": "integer", "nullable": true }, "description": { "type": "string", "maxLength": 1000, "nullable": true }, "invoice_no": { "type": "string", "maxLength": 255, "nullable": true }, "reference_no": { "type": "string", "maxLength": 255, "nullable": true }, "idempotency_key": { "type": "string", "maxLength": 191, "nullable": true }, "client_reference": { "type": "string", "maxLength": 191, "nullable": true }, "currency": { "type": "string", "description": "Servis tarafından okunur; varsayılan TRY." }, "exchange_rate": { "type": "number", "description": "Servis tarafından okunan kur. Pozitif ve işlemle tutarlı değer kullanın." } } } } } }, "responses": { "201": { "description": "document_id, direction, payment_id vb.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "200": { "description": "Idempotent tekrar", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "422": { "description": "Validasyon veya dönem kapalı" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Muhasebe" ], "operationId": "postAgentAccountingRecordPayment", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "x-side-effect": "Rotasyona veya üretimde kalıcı kayıt değişikliğine neden olabilir." } }, "/agent/accounting/record-cash-transaction": { "post": { "summary": "Kasa giriş/çıkış", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "amount", "cash_register_id", "company_id", "transaction_date", "type" ], "properties": { "company_id": { "type": "integer" }, "cash_register_id": { "type": "integer" }, "type": { "type": "string", "enum": [ "in", "out" ] }, "amount": { "type": "number", "minimum": 0.01 }, "transaction_date": { "type": "string", "format": "date" }, "description": { "type": "string", "maxLength": 1000, "nullable": true }, "bank_account_id": { "type": "integer", "nullable": true }, "cari_id": { "type": "integer", "nullable": true }, "reference_no": { "type": "string", "maxLength": 100, "nullable": true } } } } } }, "responses": { "201": { "description": "Kasa hareketi oluşturuldu", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "422": { "description": "Validasyon" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Muhasebe" ], "operationId": "postAgentAccountingRecordCashTransaction", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "x-side-effect": "Rotasyona veya üretimde kalıcı kayıt değişikliğine neden olabilir." } }, "/agent/accounting/record-bank-transfer": { "post": { "summary": "Banka virmanı", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "amount", "company_id", "from_bank_account_id", "to_bank_account_id", "transfer_date" ], "properties": { "company_id": { "type": "integer" }, "from_bank_account_id": { "type": "integer" }, "to_bank_account_id": { "type": "integer" }, "amount": { "type": "number", "minimum": 0.01 }, "transfer_date": { "type": "string", "format": "date" }, "description": { "type": "string", "maxLength": 500, "nullable": true }, "fee": { "type": "number", "minimum": 0, "nullable": true } } } } } }, "responses": { "201": { "description": "Virman oluşturuldu", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "422": { "description": "Validasyon" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Muhasebe" ], "operationId": "postAgentAccountingRecordBankTransfer", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "x-side-effect": "Rotasyona veya üretimde kalıcı kayıt değişikliğine neden olabilir." } }, "/agent/accounting/record-stock-movement": { "post": { "summary": "Stok hareketi", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "item_id", "movement_date", "quantity", "type" ], "properties": { "company_id": { "type": "integer" }, "item_id": { "type": "integer" }, "type": { "type": "string", "enum": [ "in", "out" ] }, "quantity": { "type": "number", "minimum": 0.0001 }, "movement_date": { "type": "string", "format": "date" }, "unit_price": { "type": "number", "minimum": 0, "nullable": true }, "description": { "type": "string", "maxLength": 500, "nullable": true }, "document_id": { "type": "integer", "nullable": true } } } } } }, "responses": { "201": { "description": "Hareket oluşturuldu", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "422": { "description": "Validasyon" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Muhasebe" ], "operationId": "postAgentAccountingRecordStockMovement", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review", "x-side-effect": "Rotasyona veya üretimde kalıcı kayıt değişikliğine neden olabilir." } }, "/agent/lookup/cari-statement": { "get": { "summary": "Cari ekstre", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "cari_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "date_from", "in": "query", "required": false, "schema": { "type": "string", "format": "date", "nullable": true } }, { "name": "date_to", "in": "query", "required": false, "schema": { "type": "string", "format": "date", "nullable": true } }, { "name": "per_page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 200, "nullable": true } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "nullable": true } } ], "responses": { "200": { "description": "transactions[] (satırlarda document_id olabilir), sayfalama", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Arama ve listeler" ], "operationId": "getAgentLookupCariStatement", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" } }, "/agent/lookup/bank-statement": { "get": { "summary": "Banka ekstre", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "bank_account_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "date_from", "in": "query", "required": false, "schema": { "type": "string", "format": "date", "nullable": true } }, { "name": "date_to", "in": "query", "required": false, "schema": { "type": "string", "format": "date", "nullable": true } }, { "name": "per_page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 200, "nullable": true } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "nullable": true } } ], "responses": { "200": { "description": "transactions[]", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "404": { "description": "Banka hesabı yok" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Arama ve listeler" ], "operationId": "getAgentLookupBankStatement", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" } }, "/agent/lookup/cash-statement": { "get": { "summary": "Kasa ekstre", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "cash_register_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "date_from", "in": "query", "required": false, "schema": { "type": "string", "format": "date", "nullable": true } }, { "name": "date_to", "in": "query", "required": false, "schema": { "type": "string", "format": "date", "nullable": true } }, { "name": "per_page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 200, "nullable": true } } ], "responses": { "200": { "description": "transactions[]", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "404": { "description": "Kasa yok" }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Arama ve listeler" ], "operationId": "getAgentLookupCashStatement", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" } }, "/agent/reports/aged-receivables": { "get": { "summary": "Yaşlandırılmış alacaklar", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "as_of_date", "in": "query", "required": false, "schema": { "type": "string", "format": "date", "nullable": true } } ], "responses": { "200": { "description": "summary, by_cari", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Raporlar" ], "operationId": "getAgentReportsAgedReceivables", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" } }, "/agent/reports/aged-payables": { "get": { "summary": "Yaşlandırılmış borçlar", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "as_of_date", "in": "query", "required": false, "schema": { "type": "string", "format": "date", "nullable": true } } ], "responses": { "200": { "description": "summary, by_cari", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Raporlar" ], "operationId": "getAgentReportsAgedPayables", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" } }, "/agent/reports/balance-sheet": { "get": { "summary": "Bilanço özeti", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "year", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 2020, "maximum": 2100 } }, { "name": "month", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 12, "nullable": true } }, { "name": "include_draft", "in": "query", "required": false, "description": "Taslak muhasebe kayıtlarını da dahil etmek için 1 kullanın.", "schema": { "type": "integer", "enum": [ 0, 1 ] } } ], "responses": { "200": { "description": "assets, liabilities", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Raporlar" ], "operationId": "getAgentReportsBalanceSheet", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" } }, "/agent/reports/cash-flow": { "get": { "summary": "Nakit akış özeti", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "year", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 2020, "maximum": 2100 } }, { "name": "month", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 12, "nullable": true } } ], "responses": { "200": { "description": "operating, closing_balance vb.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "description": "Bearer token eksik veya geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Rol veya firma yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Alan doğrulaması veya iş kuralı hatası", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/ValidationError" } ] } } } }, "429": { "description": "Hız sınırı", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ApiError" }, { "$ref": "#/components/schemas/HttpError" } ] } } } } }, "tags": [ "Raporlar" ], "operationId": "getAgentReportsCashFlow", "x-implementation-status": "implemented_in_code", "x-review-evidence": "source_review" } }, "/agent/einvoice/operations/invoice_create": { "post": { "operationId": "turkcell_invoice_create", "summary": "Giden e Fatura: invoice/create", "description": "Giden e Fatura. Sağlayıcı işlemi: POST /v1/outboxinvoice/create. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/invoice/create", "tags": [ "Turkcell, Giden e Fatura" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "invoice_create", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/invoice/create", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/invoice_update": { "post": { "operationId": "turkcell_invoice_update", "summary": "Giden e Fatura: invoice/update", "description": "Giden e Fatura. Sağlayıcı işlemi: PUT /v1/outboxinvoice/update/{id}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/invoice/update", "tags": [ "Turkcell, Giden e Fatura" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "invoice_update", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/invoice/update", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload", "parameters" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/invoice_updatestatus": { "post": { "operationId": "turkcell_invoice_updatestatus", "summary": "Giden e Fatura: invoice/updatestatus", "description": "Giden e Fatura. Sağlayıcı işlemi: PUT /v1/outboxinvoice/updatestatuslist. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/invoice/updatestatus", "tags": [ "Turkcell, Giden e Fatura" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "invoice_updatestatus", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/invoice/updatestatus", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/invoice_create_ubl": { "post": { "operationId": "turkcell_invoice_create_ubl", "summary": "Giden e Fatura: invoice/create-ubl", "description": "Giden e Fatura. Sağlayıcı işlemi: POST /v2/outboxinvoice. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. UBL dosyasını ubl_base64 içinde ham XML’in Base64 değeri olarak iletin. Sunucu invoiceFile adıyla multipart yükler. Kaynak: https://developer.turkcellesirket.com/fatura#operation/invoice/create-ubl", "tags": [ "Turkcell, Giden e Fatura" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "invoice_create_ubl", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/invoice/create-ubl", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload", "ubl_base64" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." }, "ubl_base64": { "type": "string", "format": "byte", "description": "Ham UBL XML dosyasının Base64 değeri." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/invoice_update_ubl": { "post": { "operationId": "turkcell_invoice_update_ubl", "summary": "Giden e Fatura: invoice/update-ubl", "description": "Giden e Fatura. Sağlayıcı işlemi: PUT /v2/outboxinvoice/{id}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. UBL dosyasını ubl_base64 içinde ham XML’in Base64 değeri olarak iletin. Sunucu invoiceFile adıyla multipart yükler. Kaynak: https://developer.turkcellesirket.com/fatura#operation/invoice/update-ubl", "tags": [ "Turkcell, Giden e Fatura" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "invoice_update_ubl", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/invoice/update-ubl", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload", "parameters", "ubl_base64" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." }, "ubl_base64": { "type": "string", "format": "byte", "description": "Ham UBL XML dosyasının Base64 değeri." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/invoice_statu": { "get": { "operationId": "turkcell_invoice_statu", "summary": "Giden e Fatura: invoice/statu", "description": "Giden e Fatura. Sağlayıcı işlemi: GET /v2/outboxinvoice/{id}/status. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/invoice/statu", "tags": [ "Turkcell, Giden e Fatura" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "invoice_statu", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/invoice/statu", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/invoice_getreason": { "get": { "operationId": "turkcell_invoice_getreason", "summary": "Giden e Fatura: invoice/getreason", "description": "Giden e Fatura. Sağlayıcı işlemi: GET /v1/outboxinvoice/invoicereason/{id}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/invoice/getreason", "tags": [ "Turkcell, Giden e Fatura" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "invoice_getreason", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/invoice/getreason", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/invoice_withnulllocalreferences": { "get": { "operationId": "turkcell_invoice_withnulllocalreferences", "summary": "Giden e Fatura: invoice/withnulllocalreferences", "description": "Giden e Fatura. Sağlayıcı işlemi: GET /v2/outboxinvoice/withnulllocalreferences. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/invoice/withnulllocalreferences", "tags": [ "Turkcell, Giden e Fatura" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "invoice_withnulllocalreferences", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/invoice/withnulllocalreferences", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "query", "in": "query", "style": "deepObject", "explode": true, "required": false, "schema": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" } }, "additionalProperties": false } } ] } }, "/agent/einvoice/operations/outboxinvoice_html": { "get": { "operationId": "turkcell_outboxinvoice_html", "summary": "Giden e Fatura: outboxinvoice/html", "description": "Giden e Fatura. Sağlayıcı işlemi: GET /v2/outboxinvoice/{id}/html/{isStandartXslt}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/outboxinvoice/html", "tags": [ "Turkcell, Giden e Fatura" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "text/html": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "outboxinvoice_html", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/outboxinvoice/html", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "isStandartXslt": { "type": "boolean", "default": true } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/outboxinvoice_pdf": { "get": { "operationId": "turkcell_outboxinvoice_pdf", "summary": "Giden e Fatura: outboxinvoice/pdf", "description": "Giden e Fatura. Sağlayıcı işlemi: GET /v2/outboxinvoice/{id}/pdf/{isStandartXslt}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/outboxinvoice/pdf", "tags": [ "Turkcell, Giden e Fatura" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/pdf": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "outboxinvoice_pdf", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/outboxinvoice/pdf", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "isStandartXslt": { "type": "boolean", "default": true } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/outboxinvoice_ubl": { "get": { "operationId": "turkcell_outboxinvoice_ubl", "summary": "Giden e Fatura: outboxinvoice/ubl", "description": "Giden e Fatura. Sağlayıcı işlemi: GET /v2/outboxinvoice/{id}/ubl. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/outboxinvoice/ubl", "tags": [ "Turkcell, Giden e Fatura" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/xml": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "outboxinvoice_ubl", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/outboxinvoice/ubl", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/outboxinvoice_excel_export": { "post": { "operationId": "turkcell_outboxinvoice_excel_export", "summary": "Giden e Fatura: outboxinvoice/excel/export", "description": "Giden e Fatura. Sağlayıcı işlemi: POST /v2/outboxinvoice/excel/export. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/outboxinvoice/excel/export", "tags": [ "Turkcell, Giden e Fatura" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "outboxinvoice_excel_export", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/outboxinvoice/excel/export", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/outboxinvoice_excel_id": { "get": { "operationId": "turkcell_outboxinvoice_excel_id", "summary": "Giden e Fatura: outboxinvoice/excel/{id}", "description": "Giden e Fatura. Sağlayıcı işlemi: GET /v2/outboxinvoice/excel/{id}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/outboxinvoice/excel/{id}", "tags": [ "Turkcell, Giden e Fatura" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "outboxinvoice_excel_id", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/outboxinvoice/excel/{id}", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/outboxinvoice_excel_history": { "get": { "operationId": "turkcell_outboxinvoice_excel_history", "summary": "Giden e Fatura: outboxinvoice/excel/history", "description": "Giden e Fatura. Sağlayıcı işlemi: GET /v2/outboxinvoice/excel/history. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/outboxinvoice/excel/history", "tags": [ "Turkcell, Giden e Fatura" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "outboxinvoice_excel_history", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/outboxinvoice/excel/history", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } } ] } }, "/agent/einvoice/operations/inboxinvoice_list": { "get": { "operationId": "turkcell_inboxinvoice_list", "summary": "Gelen e Fatura ve ticari yanıt: inboxinvoice/list", "description": "Gelen e Fatura ve ticari yanıt. Sağlayıcı işlemi: GET /v1/inboxinvoice/list. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/list", "tags": [ "Turkcell, Gelen e Fatura ve ticari yanıt" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "inboxinvoice_list", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/list", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "query", "in": "query", "style": "deepObject", "explode": true, "required": false, "schema": { "type": "object", "properties": { "isNew": { "type": "string" }, "invoiceNumber": { "type": "string" }, "targetVknTckn": { "type": "string" }, "type": { "type": "string" }, "tipType": { "type": "string" }, "status": { "type": "string" }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "pageIndex": { "type": "integer", "minimum": 1 }, "pageSize": { "type": "integer", "minimum": 1 }, "isDesc": { "type": "string" }, "executionStartDate": { "type": "string" }, "executionEndDate": { "type": "string" } }, "additionalProperties": false } } ] } }, "/agent/einvoice/operations/inboxinvoice_getreturninvoice": { "get": { "operationId": "turkcell_inboxinvoice_getreturninvoice", "summary": "Gelen e Fatura ve ticari yanıt: inboxinvoice/getreturninvoice", "description": "Gelen e Fatura ve ticari yanıt. Sağlayıcı işlemi: GET /v1/inboxinvoice/getreturninvoice. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/getreturninvoice", "tags": [ "Turkcell, Gelen e Fatura ve ticari yanıt" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "inboxinvoice_getreturninvoice", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/getreturninvoice", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "query", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "guid": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "guid" ] } } ] } }, "/agent/einvoice/operations/inboxinvoice_status": { "get": { "operationId": "turkcell_inboxinvoice_status", "summary": "Gelen e Fatura ve ticari yanıt: inboxinvoice/status", "description": "Gelen e Fatura ve ticari yanıt. Sağlayıcı işlemi: GET /v2/inboxinvoice/{id}/status. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/status", "tags": [ "Turkcell, Gelen e Fatura ve ticari yanıt" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "inboxinvoice_status", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/status", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/inboxinvoice_html": { "get": { "operationId": "turkcell_inboxinvoice_html", "summary": "Gelen e Fatura ve ticari yanıt: inboxinvoice/html", "description": "Gelen e Fatura ve ticari yanıt. Sağlayıcı işlemi: GET /v2/inboxinvoice/{id}/html/{isStandartXslt}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/html", "tags": [ "Turkcell, Gelen e Fatura ve ticari yanıt" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "text/html": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "inboxinvoice_html", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/html", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "isStandartXslt": { "type": "boolean", "default": true } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/inboxinvoice_pdf": { "get": { "operationId": "turkcell_inboxinvoice_pdf", "summary": "Gelen e Fatura ve ticari yanıt: inboxinvoice/pdf", "description": "Gelen e Fatura ve ticari yanıt. Sağlayıcı işlemi: GET /v2/inboxinvoice/{id}/pdf/{isStandartXslt}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/pdf", "tags": [ "Turkcell, Gelen e Fatura ve ticari yanıt" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/pdf": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "inboxinvoice_pdf", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/pdf", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "isStandartXslt": { "type": "boolean", "default": true } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/inboxinvoice_zip": { "get": { "operationId": "turkcell_inboxinvoice_zip", "summary": "Gelen e Fatura ve ticari yanıt: inboxinvoice/zip", "description": "Gelen e Fatura ve ticari yanıt. Sağlayıcı işlemi: GET /v2/inboxinvoice/{id}/zip/{isStandartXslt}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/zip", "tags": [ "Turkcell, Gelen e Fatura ve ticari yanıt" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "inboxinvoice_zip", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/zip", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "isStandartXslt": { "type": "boolean", "default": true } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/inboxinvoice_ubl": { "get": { "operationId": "turkcell_inboxinvoice_ubl", "summary": "Gelen e Fatura ve ticari yanıt: inboxinvoice/ubl", "description": "Gelen e Fatura ve ticari yanıt. Sağlayıcı işlemi: GET /v2/inboxinvoice/{id}/ubl. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/ubl", "tags": [ "Turkcell, Gelen e Fatura ve ticari yanıt" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/xml": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "inboxinvoice_ubl", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/ubl", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/inboxinvoice_updateisnew": { "post": { "operationId": "turkcell_inboxinvoice_updateisnew", "summary": "Gelen e Fatura ve ticari yanıt: inboxinvoice/updateisnew", "description": "Gelen e Fatura ve ticari yanıt. Sağlayıcı işlemi: PUT /v1/inboxinvoice/updateisnew. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/updateisnew", "tags": [ "Turkcell, Gelen e Fatura ve ticari yanıt" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "inboxinvoice_updateisnew", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/updateisnew", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/inboxinvoice_excel_export": { "post": { "operationId": "turkcell_inboxinvoice_excel_export", "summary": "Gelen e Fatura ve ticari yanıt: inboxinvoice/excel/export", "description": "Gelen e Fatura ve ticari yanıt. Sağlayıcı işlemi: POST /v1/inboxinvoice/excel/export. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/excel/export", "tags": [ "Turkcell, Gelen e Fatura ve ticari yanıt" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "inboxinvoice_excel_export", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/excel/export", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/inboxinvoice_excel_id": { "get": { "operationId": "turkcell_inboxinvoice_excel_id", "summary": "Gelen e Fatura ve ticari yanıt: inboxinvoice/excel/{id}", "description": "Gelen e Fatura ve ticari yanıt. Sağlayıcı işlemi: GET /v1/inboxinvoice/excel/{id}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/excel/{id}", "tags": [ "Turkcell, Gelen e Fatura ve ticari yanıt" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "inboxinvoice_excel_id", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/excel/{id}", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/inboxinvoice_excel_history": { "get": { "operationId": "turkcell_inboxinvoice_excel_history", "summary": "Gelen e Fatura ve ticari yanıt: inboxinvoice/excel/history", "description": "Gelen e Fatura ve ticari yanıt. Sağlayıcı işlemi: GET /v1/inboxinvoice/excel/history. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/excel/history", "tags": [ "Turkcell, Gelen e Fatura ve ticari yanıt" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "inboxinvoice_excel_history", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/inboxinvoice/excel/history", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } } ] } }, "/agent/einvoice/operations/earchive_create": { "post": { "operationId": "turkcell_earchive_create", "summary": "e Arşiv: earchive/create", "description": "e Arşiv. Sağlayıcı işlemi: POST /v2/earchive/create. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/earchive/create", "tags": [ "Turkcell, e Arşiv" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "earchive_create", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/earchive/create", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/earchive_update": { "post": { "operationId": "turkcell_earchive_update", "summary": "e Arşiv: earchive/update", "description": "e Arşiv. Sağlayıcı işlemi: PUT /v2/earchive/update/{id}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/earchive/update", "tags": [ "Turkcell, e Arşiv" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "earchive_update", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/earchive/update", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload", "parameters" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/earchive_create_ubl": { "post": { "operationId": "turkcell_earchive_create_ubl", "summary": "e Arşiv: earchive/create-ubl", "description": "e Arşiv. Sağlayıcı işlemi: POST /v2/earchive. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. UBL dosyasını ubl_base64 içinde ham XML’in Base64 değeri olarak iletin. Sunucu invoiceFile adıyla multipart yükler. Kaynak: https://developer.turkcellesirket.com/fatura#operation/earchive/create-ubl", "tags": [ "Turkcell, e Arşiv" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "earchive_create_ubl", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/earchive/create-ubl", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload", "ubl_base64" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." }, "ubl_base64": { "type": "string", "format": "byte", "description": "Ham UBL XML dosyasının Base64 değeri." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/earchive_update_ubl": { "post": { "operationId": "turkcell_earchive_update_ubl", "summary": "e Arşiv: earchive/update-ubl", "description": "e Arşiv. Sağlayıcı işlemi: PUT /v2/earchive/{id}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. UBL dosyasını ubl_base64 içinde ham XML’in Base64 değeri olarak iletin. Sunucu invoiceFile adıyla multipart yükler. Kaynak: https://developer.turkcellesirket.com/fatura#operation/earchive/update-ubl", "tags": [ "Turkcell, e Arşiv" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "earchive_update_ubl", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/earchive/update-ubl", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload", "parameters", "ubl_base64" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." }, "ubl_base64": { "type": "string", "format": "byte", "description": "Ham UBL XML dosyasının Base64 değeri." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/earchive_statu": { "get": { "operationId": "turkcell_earchive_statu", "summary": "e Arşiv: earchive/statu", "description": "e Arşiv. Sağlayıcı işlemi: GET /v2/earchive/{id}/status. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/earchive/statu", "tags": [ "Turkcell, e Arşiv" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "earchive_statu", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/earchive/statu", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/earchive_html": { "get": { "operationId": "turkcell_earchive_html", "summary": "e Arşiv: earchive/html", "description": "e Arşiv. Sağlayıcı işlemi: GET /v2/earchive/{id}/html/{isStandartXslt}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/earchive/html", "tags": [ "Turkcell, e Arşiv" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "text/html": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "earchive_html", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/earchive/html", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "isStandartXslt": { "type": "boolean", "default": true } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/earchive_pdf": { "get": { "operationId": "turkcell_earchive_pdf", "summary": "e Arşiv: earchive/pdf", "description": "e Arşiv. Sağlayıcı işlemi: GET /v2/earchive/{id}/pdf/{isStandartXslt}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/earchive/pdf", "tags": [ "Turkcell, e Arşiv" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/pdf": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "earchive_pdf", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/earchive/pdf", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "isStandartXslt": { "type": "boolean", "default": true } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/earchive_ubl": { "get": { "operationId": "turkcell_earchive_ubl", "summary": "e Arşiv: earchive/ubl", "description": "e Arşiv. Sağlayıcı işlemi: GET /v2/earchive/{id}/ubl. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/earchive/ubl", "tags": [ "Turkcell, e Arşiv" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/xml": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "earchive_ubl", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/earchive/ubl", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/earchive_withnulllocalreferences": { "get": { "operationId": "turkcell_earchive_withnulllocalreferences", "summary": "e Arşiv: earchive/withnulllocalreferences", "description": "e Arşiv. Sağlayıcı işlemi: GET /v2/earchive/withnulllocalreferences. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/earchive/withnulllocalreferences", "tags": [ "Turkcell, e Arşiv" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "earchive_withnulllocalreferences", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/earchive/withnulllocalreferences", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "query", "in": "query", "style": "deepObject", "explode": true, "required": false, "schema": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" } }, "additionalProperties": false } } ] } }, "/agent/einvoice/operations/earchive_getmaildetail": { "get": { "operationId": "turkcell_earchive_getmaildetail", "summary": "e Arşiv: earchive/getmaildetail", "description": "e Arşiv. Sağlayıcı işlemi: GET /v1/earchive/getmaildetail. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/earchive/getmaildetail", "tags": [ "Turkcell, e Arşiv" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "earchive_getmaildetail", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/earchive/getmaildetail", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "query", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/earchive_retryinvoiceerrormail": { "post": { "operationId": "turkcell_earchive_retryinvoiceerrormail", "summary": "e Arşiv: earchive/retryinvoiceerrormail", "description": "e Arşiv. Sağlayıcı işlemi: GET /v1/earchive/retryinvoicemail/{id}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/earchive/retryinvoiceerrormail", "tags": [ "Turkcell, e Arşiv" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "earchive_retryinvoiceerrormail", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/earchive/retryinvoiceerrormail", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "parameters" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/earchive_retryinvoicemail": { "post": { "operationId": "turkcell_earchive_retryinvoicemail", "summary": "e Arşiv: earchive/retryinvoicemail", "description": "e Arşiv. Sağlayıcı işlemi: POST /v1/earchive/retryinvoicemail. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/earchive/retryinvoicemail", "tags": [ "Turkcell, e Arşiv" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "earchive_retryinvoicemail", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/earchive/retryinvoicemail", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/earchive_cancelinvoice": { "post": { "operationId": "turkcell_earchive_cancelinvoice", "summary": "e Arşiv: earchive/cancelinvoice", "description": "e Arşiv. Sağlayıcı işlemi: PUT /v1/earchive/cancelinvoice. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/earchive/cancelinvoice", "tags": [ "Turkcell, e Arşiv" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "earchive_cancelinvoice", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/earchive/cancelinvoice", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/earchive_excel_export": { "post": { "operationId": "turkcell_earchive_excel_export", "summary": "e Arşiv: earchive/excel/export", "description": "e Arşiv. Sağlayıcı işlemi: POST /v2/outboxinvoice/excel/export. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/earchive/excel/export", "tags": [ "Turkcell, e Arşiv" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "earchive_excel_export", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/earchive/excel/export", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/earchive_excel_id": { "get": { "operationId": "turkcell_earchive_excel_id", "summary": "e Arşiv: earchive/excel/{id}", "description": "e Arşiv. Sağlayıcı işlemi: GET /v2/outboxinvoice/excel/{id}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/earchive/excel/{id}", "tags": [ "Turkcell, e Arşiv" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "earchive_excel_id", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/earchive/excel/{id}", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/earchive_excel_history": { "get": { "operationId": "turkcell_earchive_excel_history", "summary": "e Arşiv: earchive/excel/history", "description": "e Arşiv. Sağlayıcı işlemi: GET /v2/outboxinvoice/excel/history. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/earchive/excel/history", "tags": [ "Turkcell, e Arşiv" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "earchive_excel_history", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/earchive/excel/history", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } } ] } }, "/agent/einvoice/operations/earchivereport_getpartdetailsbydate": { "get": { "operationId": "turkcell_earchivereport_getpartdetailsbydate", "summary": "e Arşiv: earchivereport/getpartdetailsbydate", "description": "e Arşiv. Sağlayıcı işlemi: GET /v1/earchivereport/getpartdetailsbydate/{reportDate}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/earchivereport/getpartdetailsbydate", "tags": [ "Turkcell, e Arşiv" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "earchivereport_getpartdetailsbydate", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/earchivereport/getpartdetailsbydate", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "reportDate": { "type": "string", "format": "date" } }, "additionalProperties": false, "required": [ "reportDate" ] } }, { "name": "query", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "pageIndex": { "type": "integer", "minimum": 1 }, "pageSize": { "type": "integer", "minimum": 1 } }, "additionalProperties": false, "required": [ "pageIndex", "pageSize" ] } } ] } }, "/agent/einvoice/operations/invoiceresponse_getbyinvoiceid": { "get": { "operationId": "turkcell_invoiceresponse_getbyinvoiceid", "summary": "Gelen e Fatura ve ticari yanıt: invoiceresponse/getbyinvoiceid", "description": "Gelen e Fatura ve ticari yanıt. Sağlayıcı işlemi: GET /v1/invoiceresponse/getbyinvoiceid/{invoiceid}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/invoiceresponse/getbyinvoiceid", "tags": [ "Turkcell, Gelen e Fatura ve ticari yanıt" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "invoiceresponse_getbyinvoiceid", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/invoiceresponse/getbyinvoiceid", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "invoiceid": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "invoiceid" ] } } ] } }, "/agent/einvoice/operations/invoiceresponse_post": { "post": { "operationId": "turkcell_invoiceresponse_post", "summary": "Gelen e Fatura ve ticari yanıt: invoiceresponse/post", "description": "Gelen e Fatura ve ticari yanıt. Sağlayıcı işlemi: POST /v1/invoiceresponse. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/invoiceresponse/post", "tags": [ "Turkcell, Gelen e Fatura ve ticari yanıt" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "invoiceresponse_post", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/invoiceresponse/post", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/invoiceresponse_retryinvoiceresponselist": { "post": { "operationId": "turkcell_invoiceresponse_retryinvoiceresponselist", "summary": "Gelen e Fatura ve ticari yanıt: invoiceresponse/retryinvoiceresponselist", "description": "Gelen e Fatura ve ticari yanıt. Sağlayıcı işlemi: PUT /v1/invoiceresponse/retryinvoiceresponselist. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/invoiceresponse/retryinvoiceresponselist", "tags": [ "Turkcell, Gelen e Fatura ve ticari yanıt" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "invoiceresponse_retryinvoiceresponselist", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/invoiceresponse/retryinvoiceresponselist", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/gibuser_recipientzip": { "get": { "operationId": "turkcell_gibuser_recipientzip", "summary": "Mükellef listesi: gibuser/recipientzip", "description": "Mükellef listesi. Sağlayıcı işlemi: GET /v2/gibuser/recipient/zip. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/gibuser/recipientzip", "tags": [ "Turkcell, Mükellef listesi" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "gibuser_recipientzip", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/gibuser/recipientzip", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } } ] } }, "/agent/einvoice/operations/staticlist_unit": { "get": { "operationId": "turkcell_staticlist_unit", "summary": "Referans listeleri: staticlist/unit", "description": "Referans listeleri. Sağlayıcı işlemi: GET /v1/staticlist/unit. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/staticlist/unit", "tags": [ "Turkcell, Referans listeleri" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "staticlist_unit", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/staticlist/unit", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } } ] } }, "/agent/einvoice/operations/staticlist_country": { "get": { "operationId": "turkcell_staticlist_country", "summary": "Referans listeleri: staticlist/country", "description": "Referans listeleri. Sağlayıcı işlemi: GET /v1/staticlist/country. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/staticlist/country", "tags": [ "Turkcell, Referans listeleri" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "staticlist_country", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/staticlist/country", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } } ] } }, "/agent/einvoice/operations/staticlist_taxoffice": { "get": { "operationId": "turkcell_staticlist_taxoffice", "summary": "Referans listeleri: staticlist/taxoffice", "description": "Referans listeleri. Sağlayıcı işlemi: GET /v1/staticlist/taxoffice. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/staticlist/taxoffice", "tags": [ "Turkcell, Referans listeleri" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "staticlist_taxoffice", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/staticlist/taxoffice", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } } ] } }, "/agent/einvoice/operations/staticlist_taxtypecode": { "get": { "operationId": "turkcell_staticlist_taxtypecode", "summary": "Referans listeleri: staticlist/taxtypecode", "description": "Referans listeleri. Sağlayıcı işlemi: GET /v1/staticlist/taxtypecode. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/staticlist/taxtypecode", "tags": [ "Turkcell, Referans listeleri" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "staticlist_taxtypecode", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/staticlist/taxtypecode", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } } ] } }, "/agent/einvoice/operations/staticlist_withholding": { "get": { "operationId": "turkcell_staticlist_withholding", "summary": "Referans listeleri: staticlist/withholding", "description": "Referans listeleri. Sağlayıcı işlemi: GET /v1/staticlist/withholding. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/staticlist/withholding", "tags": [ "Turkcell, Referans listeleri" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "staticlist_withholding", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/staticlist/withholding", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } } ] } }, "/agent/einvoice/operations/staticlist_taxexemptionreason": { "get": { "operationId": "turkcell_staticlist_taxexemptionreason", "summary": "Referans listeleri: staticlist/taxexemptionreason", "description": "Referans listeleri. Sağlayıcı işlemi: GET /v1/staticlist/taxexemptionreason. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/staticlist/taxexemptionreason", "tags": [ "Turkcell, Referans listeleri" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "staticlist_taxexemptionreason", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/staticlist/taxexemptionreason", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } } ] } }, "/agent/einvoice/operations/producerreceipt_create_ubl": { "post": { "operationId": "turkcell_producerreceipt_create_ubl", "summary": "e Müstahsil Makbuzu: producerreceipt/create-ubl", "description": "e Müstahsil Makbuzu. Sağlayıcı işlemi: POST /v1/producerreceipt. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/producerreceipt/create-ubl", "tags": [ "Turkcell, e Müstahsil Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "producerreceipt_create_ubl", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/producerreceipt/create-ubl", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/producerreceipt_updatestatuslist": { "post": { "operationId": "turkcell_producerreceipt_updatestatuslist", "summary": "e Müstahsil Makbuzu: producerreceipt/updatestatuslist", "description": "e Müstahsil Makbuzu. Sağlayıcı işlemi: PUT /v1/producerreceipt/updatestatuslist. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/producerreceipt/updatestatuslist", "tags": [ "Turkcell, e Müstahsil Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "producerreceipt_updatestatuslist", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/producerreceipt/updatestatuslist", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/producerreceipt_update_ubl": { "post": { "operationId": "turkcell_producerreceipt_update_ubl", "summary": "e Müstahsil Makbuzu: producerreceipt/update-ubl", "description": "e Müstahsil Makbuzu. Sağlayıcı işlemi: PUT /v1/producerreceipt/{id}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/producerreceipt/update-ubl", "tags": [ "Turkcell, e Müstahsil Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "producerreceipt_update_ubl", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/producerreceipt/update-ubl", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload", "parameters" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/producerreceipt_cancel": { "post": { "operationId": "turkcell_producerreceipt_cancel", "summary": "e Müstahsil Makbuzu: producerreceipt/cancel", "description": "e Müstahsil Makbuzu. Sağlayıcı işlemi: POST /v1/producerreceipt/cancel. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/producerreceipt/cancel", "tags": [ "Turkcell, e Müstahsil Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "producerreceipt_cancel", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/producerreceipt/cancel", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/producerreceipt_statu": { "get": { "operationId": "turkcell_producerreceipt_statu", "summary": "e Müstahsil Makbuzu: producerreceipt/statu", "description": "e Müstahsil Makbuzu. Sağlayıcı işlemi: GET /v1/producerreceipt/{id}/status. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/producerreceipt/statu", "tags": [ "Turkcell, e Müstahsil Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "producerreceipt_statu", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/producerreceipt/statu", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/producerreceipt_html": { "get": { "operationId": "turkcell_producerreceipt_html", "summary": "e Müstahsil Makbuzu: producerreceipt/html", "description": "e Müstahsil Makbuzu. Sağlayıcı işlemi: GET /v1/producerreceipt/{id}/html/{isStandartXslt}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/producerreceipt/html", "tags": [ "Turkcell, e Müstahsil Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "text/html": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "producerreceipt_html", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/producerreceipt/html", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "isStandartXslt": { "type": "boolean", "default": true } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/producerreceipt_pdf": { "get": { "operationId": "turkcell_producerreceipt_pdf", "summary": "e Müstahsil Makbuzu: producerreceipt/pdf", "description": "e Müstahsil Makbuzu. Sağlayıcı işlemi: GET /v1/producerreceipt/{id}/pdf/{isStandartXslt}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/producerreceipt/pdf", "tags": [ "Turkcell, e Müstahsil Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/pdf": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "producerreceipt_pdf", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/producerreceipt/pdf", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "isStandartXslt": { "type": "boolean", "default": true } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/producerreceipt_zip": { "get": { "operationId": "turkcell_producerreceipt_zip", "summary": "e Müstahsil Makbuzu: producerreceipt/zip", "description": "e Müstahsil Makbuzu. Sağlayıcı işlemi: GET /v1/producerreceipt/{id}/zip/{isStandartXslt}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/producerreceipt/zip", "tags": [ "Turkcell, e Müstahsil Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "producerreceipt_zip", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/producerreceipt/zip", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "isStandartXslt": { "type": "boolean", "default": true } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/producerreceipt_ubl": { "get": { "operationId": "turkcell_producerreceipt_ubl", "summary": "e Müstahsil Makbuzu: producerreceipt/ubl", "description": "e Müstahsil Makbuzu. Sağlayıcı işlemi: GET /v1/producerreceipt/{id}/ubl. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/producerreceipt/ubl", "tags": [ "Turkcell, e Müstahsil Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/xml": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "producerreceipt_ubl", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/producerreceipt/ubl", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/producerreceipt_excel_export": { "post": { "operationId": "turkcell_producerreceipt_excel_export", "summary": "e Müstahsil Makbuzu: producerreceipt/excel/export", "description": "e Müstahsil Makbuzu. Sağlayıcı işlemi: POST /v1/producerReceipt/excel/export. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/producerreceipt/excel/export", "tags": [ "Turkcell, e Müstahsil Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "producerreceipt_excel_export", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/producerreceipt/excel/export", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/producerreceipt_excel_id": { "get": { "operationId": "turkcell_producerreceipt_excel_id", "summary": "e Müstahsil Makbuzu: producerreceipt/excel/{id}", "description": "e Müstahsil Makbuzu. Sağlayıcı işlemi: GET /v1/producerreceipt/excel/{id}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/producerreceipt/excel/{id}", "tags": [ "Turkcell, e Müstahsil Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "producerreceipt_excel_id", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/producerreceipt/excel/{id}", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/producerreceipt_excel_history": { "get": { "operationId": "turkcell_producerreceipt_excel_history", "summary": "e Müstahsil Makbuzu: producerreceipt/excel/history", "description": "e Müstahsil Makbuzu. Sağlayıcı işlemi: GET /v1/producerreceipt/excel/history. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/producerreceipt/excel/history", "tags": [ "Turkcell, e Müstahsil Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "producerreceipt_excel_history", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/producerreceipt/excel/history", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } } ] } }, "/agent/einvoice/operations/voucher_create": { "post": { "operationId": "turkcell_voucher_create", "summary": "e Serbest Meslek Makbuzu: voucher/create", "description": "e Serbest Meslek Makbuzu. Sağlayıcı işlemi: POST /v1/voucher/create. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/voucher/create", "tags": [ "Turkcell, e Serbest Meslek Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "voucher_create", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/voucher/create", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/voucher_create_ubl": { "post": { "operationId": "turkcell_voucher_create_ubl", "summary": "e Serbest Meslek Makbuzu: voucher/create-ubl", "description": "e Serbest Meslek Makbuzu. Sağlayıcı işlemi: POST /v1/voucher. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/voucher/create-ubl", "tags": [ "Turkcell, e Serbest Meslek Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "voucher_create_ubl", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/voucher/create-ubl", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/voucher_update_ubl": { "post": { "operationId": "turkcell_voucher_update_ubl", "summary": "e Serbest Meslek Makbuzu: voucher/update-ubl", "description": "e Serbest Meslek Makbuzu. Sağlayıcı işlemi: PUT /v1/voucher/{id}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/voucher/update-ubl", "tags": [ "Turkcell, e Serbest Meslek Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "voucher_update_ubl", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/voucher/update-ubl", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload", "parameters" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/voucher_updatestatuslist": { "post": { "operationId": "turkcell_voucher_updatestatuslist", "summary": "e Serbest Meslek Makbuzu: voucher/updatestatuslist", "description": "e Serbest Meslek Makbuzu. Sağlayıcı işlemi: PUT /v1/voucher/updatestatuslist. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/voucher/updatestatuslist", "tags": [ "Turkcell, e Serbest Meslek Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "voucher_updatestatuslist", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/voucher/updatestatuslist", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/voucher_cancel": { "post": { "operationId": "turkcell_voucher_cancel", "summary": "e Serbest Meslek Makbuzu: voucher/cancel", "description": "e Serbest Meslek Makbuzu. Sağlayıcı işlemi: POST /v1/voucher/cancel. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/voucher/cancel", "tags": [ "Turkcell, e Serbest Meslek Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "voucher_cancel", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/voucher/cancel", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/voucher_statu": { "get": { "operationId": "turkcell_voucher_statu", "summary": "e Serbest Meslek Makbuzu: voucher/statu", "description": "e Serbest Meslek Makbuzu. Sağlayıcı işlemi: GET /v1/voucher/{id}/status. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/voucher/statu", "tags": [ "Turkcell, e Serbest Meslek Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "voucher_statu", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/voucher/statu", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/voucher_html": { "get": { "operationId": "turkcell_voucher_html", "summary": "e Serbest Meslek Makbuzu: voucher/html", "description": "e Serbest Meslek Makbuzu. Sağlayıcı işlemi: GET /v1/voucher/{id}/html/{isStandartXslt}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/voucher/html", "tags": [ "Turkcell, e Serbest Meslek Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "text/html": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "voucher_html", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/voucher/html", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "isStandartXslt": { "type": "boolean", "default": true } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/voucher_pdf": { "get": { "operationId": "turkcell_voucher_pdf", "summary": "e Serbest Meslek Makbuzu: voucher/pdf", "description": "e Serbest Meslek Makbuzu. Sağlayıcı işlemi: GET /v1/voucher/{id}/pdf/{isStandartXslt}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/voucher/pdf", "tags": [ "Turkcell, e Serbest Meslek Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/pdf": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "voucher_pdf", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/voucher/pdf", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "isStandartXslt": { "type": "boolean", "default": true } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/voucher_zip": { "get": { "operationId": "turkcell_voucher_zip", "summary": "e Serbest Meslek Makbuzu: voucher/zip", "description": "e Serbest Meslek Makbuzu. Sağlayıcı işlemi: GET /v1/voucher/{id}/zip/{isStandartXslt}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/voucher/zip", "tags": [ "Turkcell, e Serbest Meslek Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "voucher_zip", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/voucher/zip", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "isStandartXslt": { "type": "boolean", "default": true } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/voucher_ubl": { "get": { "operationId": "turkcell_voucher_ubl", "summary": "e Serbest Meslek Makbuzu: voucher/ubl", "description": "e Serbest Meslek Makbuzu. Sağlayıcı işlemi: GET /v1/voucher/{id}/ubl. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/voucher/ubl", "tags": [ "Turkcell, e Serbest Meslek Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/xml": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "voucher_ubl", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/voucher/ubl", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/voucher_excel_export": { "post": { "operationId": "turkcell_voucher_excel_export", "summary": "e Serbest Meslek Makbuzu: voucher/excel/export", "description": "e Serbest Meslek Makbuzu. Sağlayıcı işlemi: POST /v1/voucher/excel/export. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/voucher/excel/export", "tags": [ "Turkcell, e Serbest Meslek Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "voucher_excel_export", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/voucher/excel/export", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/voucher_excel_id": { "get": { "operationId": "turkcell_voucher_excel_id", "summary": "e Serbest Meslek Makbuzu: voucher/excel/{id}", "description": "e Serbest Meslek Makbuzu. Sağlayıcı işlemi: GET /v1/voucher/excel/{id}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/voucher/excel/{id}", "tags": [ "Turkcell, e Serbest Meslek Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "voucher_excel_id", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/voucher/excel/{id}", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/voucher_excel_history": { "get": { "operationId": "turkcell_voucher_excel_history", "summary": "e Serbest Meslek Makbuzu: voucher/excel/history", "description": "e Serbest Meslek Makbuzu. Sağlayıcı işlemi: GET /v1/voucher/excel/history. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/voucher/excel/history", "tags": [ "Turkcell, e Serbest Meslek Makbuzu" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "voucher_excel_history", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/voucher/excel/history", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } } ] } }, "/agent/einvoice/operations/adisyon_create": { "post": { "operationId": "turkcell_adisyon_create", "summary": "e Adisyon: adisyon/create", "description": "e Adisyon. Sağlayıcı işlemi: POST /v1/eadisyon/create. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/adisyon/create", "tags": [ "Turkcell, e Adisyon" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "adisyon_create", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/adisyon/create", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/adisyon_update": { "post": { "operationId": "turkcell_adisyon_update", "summary": "e Adisyon: adisyon/update", "description": "e Adisyon. Sağlayıcı işlemi: PUT /v1/eadisyon/update/{id}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/adisyon/update", "tags": [ "Turkcell, e Adisyon" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "adisyon_update", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/adisyon/update", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload", "parameters" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/adisyon_create_ubl": { "post": { "operationId": "turkcell_adisyon_create_ubl", "summary": "e Adisyon: adisyon/create-ubl", "description": "e Adisyon. Sağlayıcı işlemi: POST /v1/eadisyon. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/adisyon/create-ubl", "tags": [ "Turkcell, e Adisyon" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "adisyon_create_ubl", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/adisyon/create-ubl", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/adisyon_update_ubl": { "post": { "operationId": "turkcell_adisyon_update_ubl", "summary": "e Adisyon: adisyon/update-ubl", "description": "e Adisyon. Sağlayıcı işlemi: PUT /v1/eadisyon/{id}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/adisyon/update-ubl", "tags": [ "Turkcell, e Adisyon" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "adisyon_update_ubl", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/adisyon/update-ubl", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload", "parameters" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/adisyon_updatestatuslist": { "post": { "operationId": "turkcell_adisyon_updatestatuslist", "summary": "e Adisyon: adisyon/updatestatuslist", "description": "e Adisyon. Sağlayıcı işlemi: PUT /v1/eadisyon/updatestatuslist. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/adisyon/updatestatuslist", "tags": [ "Turkcell, e Adisyon" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "adisyon_updatestatuslist", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/adisyon/updatestatuslist", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/adisyon_cancel": { "post": { "operationId": "turkcell_adisyon_cancel", "summary": "e Adisyon: adisyon/cancel", "description": "e Adisyon. Sağlayıcı işlemi: POST /v1/eadisyon/cancel. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/adisyon/cancel", "tags": [ "Turkcell, e Adisyon" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "adisyon_cancel", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/adisyon/cancel", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/adisyon_status": { "get": { "operationId": "turkcell_adisyon_status", "summary": "e Adisyon: adisyon/status", "description": "e Adisyon. Sağlayıcı işlemi: GET /v1/eadisyon/{id}/status. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/adisyon/status", "tags": [ "Turkcell, e Adisyon" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "adisyon_status", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/adisyon/status", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/adisyon_html": { "get": { "operationId": "turkcell_adisyon_html", "summary": "e Adisyon: adisyon/html", "description": "e Adisyon. Sağlayıcı işlemi: GET /v1/eadisyon/{id}/html/{isStandartXslt}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/adisyon/html", "tags": [ "Turkcell, e Adisyon" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "text/html": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "adisyon_html", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/adisyon/html", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "isStandartXslt": { "type": "boolean", "default": true } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/adisyon_pdf": { "get": { "operationId": "turkcell_adisyon_pdf", "summary": "e Adisyon: adisyon/pdf", "description": "e Adisyon. Sağlayıcı işlemi: GET /v1/eadisyon/{id}/pdf/{isStandartXslt}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/adisyon/pdf", "tags": [ "Turkcell, e Adisyon" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/pdf": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "adisyon_pdf", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/adisyon/pdf", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "isStandartXslt": { "type": "boolean", "default": true } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/adisyon_zip": { "get": { "operationId": "turkcell_adisyon_zip", "summary": "e Adisyon: adisyon/zip", "description": "e Adisyon. Sağlayıcı işlemi: GET /v1/eadisyon/{id}/zip/{isStandartXslt}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/adisyon/zip", "tags": [ "Turkcell, e Adisyon" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "adisyon_zip", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/adisyon/zip", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "isStandartXslt": { "type": "boolean", "default": true } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/adisyon_ubl": { "get": { "operationId": "turkcell_adisyon_ubl", "summary": "e Adisyon: adisyon/ubl", "description": "e Adisyon. Sağlayıcı işlemi: GET /v1/eadisyon/{id}/ubl. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/adisyon/ubl", "tags": [ "Turkcell, e Adisyon" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "application/xml": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "adisyon_ubl", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/adisyon/ubl", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/eadisyon_getmaildetails": { "get": { "operationId": "turkcell_eadisyon_getmaildetails", "summary": "e Adisyon: eadisyon/getmaildetails", "description": "e Adisyon. Sağlayıcı işlemi: GET /v1/eadisyon/getmaildetails. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/eadisyon/getmaildetails", "tags": [ "Turkcell, e Adisyon" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "eadisyon_getmaildetails", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/eadisyon/getmaildetails", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "query", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] } } ] } }, "/agent/einvoice/operations/eadisyon_retryeadisyonmail": { "post": { "operationId": "turkcell_eadisyon_retryeadisyonmail", "summary": "e Adisyon: eadisyon/retryeadisyonmail", "description": "e Adisyon. Sağlayıcı işlemi: POST /v1/eadisyon/retryeadisyonmail. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/eadisyon/retryeadisyonmail", "tags": [ "Turkcell, e Adisyon" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "eadisyon_retryeadisyonmail", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/eadisyon/retryeadisyonmail", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "payload" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": {}, "additionalProperties": false }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." }, "payload": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "array", "items": {} } ], "description": "Sağlayıcının özgün JSON gövdesi. Alan adlarını ve büyük küçük harfleri koruyun. JSON belge oluşturmada status varsayılanı 0. Ayrıntılı alanlar için kaynak kılavuz bağlantısını kullanın." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/eadisyon_retryeadisyonmail_id": { "post": { "operationId": "turkcell_eadisyon_retryeadisyonmail_id", "summary": "e Adisyon: eadisyon/retryeadisyonmail/id", "description": "e Adisyon. Sağlayıcı işlemi: GET /v1/eadisyon/retryeadisyonmail/{id}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. idempotency_key veya Idempotency-Key zorunludur. status 20 gönderimlerinde confirm_send true gerekir; kontör rezerve edilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/eadisyon/retryeadisyonmail/id", "tags": [ "Turkcell, e Adisyon" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "eadisyon_retryeadisyonmail_id", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/eadisyon/retryeadisyonmail/id", "description": "Sağlayıcı alan sözleşmesi" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "parameters" ], "properties": { "company_id": { "type": "integer", "minimum": 1 }, "idempotency_key": { "type": "string", "minLength": 8, "maxLength": 128, "description": "Aynı mantıksal istek için kalıcı anahtar. Başlıkta da verilebilir." }, "parameters": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "id" ] }, "query": { "type": "object", "properties": {}, "additionalProperties": false }, "confirm_send": { "type": "boolean", "default": false, "description": "status 20 resmî gönderimi için true olmalıdır." } } } } } }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 }, "description": "JSON idempotency_key alanına alternatif." } ] } }, "/agent/einvoice/operations/eadisyon_invoicelist_eadisyonid": { "get": { "operationId": "turkcell_eadisyon_invoicelist_eadisyonid", "summary": "e Adisyon: eadisyon/invoicelist/eadisyonId", "description": "e Adisyon. Sağlayıcı işlemi: GET /v1/eadisyon/invoicelist/{eadisyonId}. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/eadisyon/invoicelist/eadisyonId", "tags": [ "Turkcell, e Adisyon" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "eadisyon_invoicelist_eadisyonid", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/eadisyon/invoicelist/eadisyonId", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "parameters", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "eadisyonId": { "type": "string", "format": "uuid" } }, "additionalProperties": false, "required": [ "eadisyonId" ] } }, { "name": "query", "in": "query", "style": "deepObject", "explode": true, "required": false, "schema": { "type": "object", "properties": { "eadisyonId": { "type": "string", "format": "uuid" } }, "additionalProperties": false } } ] } }, "/agent/einvoice/operations/eadisyon_invoicehtml": { "get": { "operationId": "turkcell_eadisyon_invoicehtml", "summary": "e Adisyon: eadisyon/invoicehtml", "description": "e Adisyon. Sağlayıcı işlemi: GET /v1/eadisyon/invoicehtml. parameters yol değerlerini, query sağlayıcı filtrelerini, payload sağlayıcı gövdesini taşır. Firma anahtarı sunucuda seçilir. Kaynak: https://developer.turkcellesirket.com/fatura#operation/eadisyon/invoicehtml", "tags": [ "Turkcell, e Adisyon" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sağlayıcının özgün dosyası, ek olarak indirilir", "content": { "text/html": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "x-review-evidence": "official_contract_and_isolated_tests", "x-provider-operation": "eadisyon_invoicehtml", "externalDocs": { "url": "https://developer.turkcellesirket.com/fatura#operation/eadisyon/invoicehtml", "description": "Sağlayıcı alan sözleşmesi" }, "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "query", "in": "query", "style": "deepObject", "explode": true, "required": true, "schema": { "type": "object", "properties": { "eadisyonId": { "type": "string", "format": "uuid" }, "isStandartXslt": { "type": "string" } }, "additionalProperties": false, "required": [ "eadisyonId" ] } } ] } }, "/agent/einvoice/capabilities": { "get": { "operationId": "getEInvoiceCapabilities", "summary": "Firma bağlantısı, kontör ve 93 işlem kataloğu", "tags": [ "Turkcell bağlantısı ve şirket arama" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } } ] } }, "/agent/einvoice/documents": { "get": { "operationId": "listEInvoiceApiDocuments", "summary": "Bu entegrasyon üzerinden oluşturulan belgeler", "tags": [ "Turkcell bağlantısı ve şirket arama" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "page", "in": "query", "schema": { "type": "integer", "default": 1, "minimum": 1 } }, { "name": "per_page", "in": "query", "schema": { "type": "integer", "default": 20, "minimum": 1, "maximum": 100 } } ] } }, "/agent/einvoice/recipients": { "get": { "operationId": "searchEInvoiceRecipients", "summary": "Unvan veya tam vergi numarasıyla alıcı arama", "tags": [ "Turkcell bağlantısı ve şirket arama" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "minLength": 3, "maxLength": 120 } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 20, "minimum": 1, "maximum": 30 } } ] } }, "/agent/einvoice/connection/verify": { "post": { "operationId": "verifyEInvoiceConnection", "summary": "Mevcut belgeyle firma anahtarı bağlantısını doğrulama", "tags": [ "Turkcell bağlantısı ve şirket arama" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_id", "family", "proof_document_id" ], "properties": { "company_id": { "type": "integer" }, "family": { "type": "string", "enum": [ "outboxinvoice", "inboxinvoice", "earchive", "voucher", "producerreceipt", "eadisyon" ] }, "proof_document_id": { "type": "string", "format": "uuid" } } } } } } } }, "/agent/einvoice/documents/{id}/{format}": { "get": { "operationId": "getEInvoiceDocumentFile", "summary": "Özgün PDF, HTML, UBL, ZIP veya belge durumu", "tags": [ "Turkcell bağlantısı ve şirket arama" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Başarılı sonuç", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } }, "application/pdf": { "schema": { "type": "string", "format": "binary" } }, "application/xml": { "schema": { "type": "string", "format": "binary" } }, "text/html": { "schema": { "type": "string" } }, "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Sağlayıcı isteği reddetti", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Token geçersiz", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Firma veya belge yetkisi yok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "İşlem, belge veya seçilen dosya biçimi bulunamadı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Bağlantı, kontör veya tekrar kontrolü", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "422": { "description": "Geçersiz alan veya sağlayıcı iş kuralı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "424": { "description": "Sağlayıcı kimlik doğrulaması veya servis yetkisi başarısız", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "İstek sınırı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Sağlayıcı yanıt hatası", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Dizin veya kayıt deposu hazır değil", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "504": { "description": "Sağlayıcı bağlantı zaman aşımı", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-implementation-status": "implemented_in_code", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "format", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "pdf", "html", "ubl", "zip", "status" ] } }, { "name": "family", "in": "query", "schema": { "type": "string", "default": "outboxinvoice", "enum": [ "outboxinvoice", "inboxinvoice", "earchive", "voucher", "producerreceipt", "eadisyon" ] } }, { "name": "standard_xslt", "in": "query", "schema": { "type": "boolean", "default": true } } ] } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "API Token", "description": "POST /auth/login yanıtındaki token veya profil sayfasından oluşturulan API token" } }, "schemas": { "SuccessEnvelope": { "type": "object", "required": [ "success", "data" ], "properties": { "success": { "type": "boolean", "enum": [ true ] }, "data": {} } }, "ApiError": { "type": "object", "required": [ "success", "error", "code" ], "properties": { "success": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" }, "code": { "type": "integer" }, "error_code": { "type": "string" }, "provider_http_status": { "type": "integer", "nullable": true }, "result_uncertain": { "type": "boolean" }, "details": { "type": "object", "additionalProperties": true } } }, "ValidationError": { "type": "object", "properties": { "message": { "type": "string" }, "errors": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } } } } }, "HttpError": { "type": "object", "properties": { "message": { "type": "string" } } } } }, "tags": [ { "name": "Kimlik", "description": "Bearer token: POST /auth/login veya müşteri profilinden API token." }, { "name": "Şirket ve ürün", "description": "Şirket listesi ve ürün/kontör hizmet bilgisi." }, { "name": "Sipariş", "description": "Sipariş oluşturma ve durum sorgulama." }, { "name": "Kuruluş", "description": "Şirket kuruluş başvuruları." }, { "name": "Muhasebe", "description": "Fatura, tahsilat/ödeme, kasa/banka, stok, evrak." }, { "name": "Raporlar", "description": "Mizan, gelir tablosu, KDV, yaşlandırma, bilanço vb." }, { "name": "Arama ve listeler", "description": "Cari, banka, kasa, stok, hesap planı, ekstreler." } ], "externalDocs": { "description": "Entegrasyon rehberi ve PDF", "url": "https://portal.vergimerkezi.com.tr/developers/" } }