> ## Documentation Index > Fetch the complete documentation index at: https://docs.muhasip.pro/llms.txt > Use this file to discover all available pages before exploring further. # Alış-satış belgesi oluştur > E-belgesiz alış veya satış kaydeder; cari bakiyesine etki eder. > [!WARNING] > > Bu çağrı kayıt değiştirir. `Idempotency-Key` zorunludur. Zaman aşımından sonra yeni anahtarla tekrar başlatmadan işlem > durumunu okuyun. ## Ne yapar? E-belgesiz alış veya satış kaydeder; cari bakiyesine etki eder. Tahsilat oluşturmaz ve e-belge göndermez. productId ve warehouseId birlikte verilen satırlar için stok etkisi oluşturur. Serbest satır ürün kartı oluşturmaz. ## Ön koşullar ve izin Gereken izin: **`muhasip:transactions:write`**. Bu kaynak için açık izin tanımlanmalıdır; genel erişim veya yönetici yetkisi bu iznin yerine geçmez. İlişkili bütün kimlikler aynı firma kapsamında olmalıdır. Yeni mali kayıt için kullanılan cari, kasa veya hesap aktif olmalıdır. Ürün/depo kimlikleri verilirse geçerli, aynı firmaya ait ve yeni işlem için aktif olmalıdır. [Kimlik ve izinler](https://docs.muhasip.pro/baslangic/kimlik-ve-izinler.md) · [Muhasebe veri kuralları](https://docs.muhasip.pro/rehberler/muhasebe-veri-kurallari.md) ## İstek örnekleri Kimlikleri kendi kayıtlarınızla değiştirin. Yazmada iş niyetine özel anahtarı istekten önce saklayın; örnek anahtarını farklı işler için yeniden kullanmayın. Alan ve cevap tanımları bu sayfanın API referansında yer alır. ```bash cURL theme={null} curl --request POST 'https://api.muhasip.pro/accounting/invoices' \ --user "$MUHASIP_API_USER_ID:$MUHASIP_API_SECRET" \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'Idempotency-Key: ORNEK-ACCOUNTINGTRANSACTIONSCREATE-001' \ --data '{"contactId":"507f1f77bcf86cd799439011","direction":"sale","issueDate":"2026-10-19","currencyCode":"TRY","exchangeRate":"1","receiptNumber":"SATIS-ORNEK-001","lines":[{"name":"Danışmanlık hizmeti","quantity":"2","unitCode":"C62","unitPrice":"100.00","vatRate":"20"}]}' ``` ```php PHP theme={null} true, CURLOPT_USERPWD => $apiUserId . ":" . $secret, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_TIMEOUT => 30, CURLOPT_HTTPHEADER => [ "Accept: application/json", "Content-Type: application/json", "Idempotency-Key: ORNEK-ACCOUNTINGTRANSACTIONSCREATE-001" ], CURLOPT_POSTFIELDS => json_encode($body, JSON_THROW_ON_ERROR) ]); $response = curl_exec($curl); $httpStatus = curl_getinfo($curl, CURLINFO_HTTP_CODE); if ($response === false) { curl_close($curl); throw new RuntimeException("Bağlantı sonucu belirsiz; yazma işlemini yeniden göndermeden durumunu kontrol edin."); } curl_close($curl); $result = json_decode($response, true, 512, JSON_THROW_ON_ERROR); echo json_encode(["httpStatus" => $httpStatus, "response" => $result], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR); ``` ```javascript Node.js theme={null} async function main() { const apiUserId = process.env.MUHASIP_API_USER_ID const secret = process.env.MUHASIP_API_SECRET if (!apiUserId || !secret) throw new Error("API kimlik bilgileri eksik.") const authorization = Buffer.from(`${apiUserId}:${secret}`, "utf8").toString("base64") const response = await fetch("https://api.muhasip.pro/accounting/invoices", { method: "POST", headers: { Authorization: `Basic ${authorization}`, Accept: "application/json", "Content-Type": "application/json", "Idempotency-Key": "ORNEK-ACCOUNTINGTRANSACTIONSCREATE-001" }, body: JSON.stringify({ contactId: "507f1f77bcf86cd799439011", direction: "sale", issueDate: "2026-10-19", currencyCode: "TRY", exchangeRate: "1", receiptNumber: "SATIS-ORNEK-001", lines: [ { name: "Danışmanlık hizmeti", quantity: "2", unitCode: "C62", unitPrice: "100.00", vatRate: "20" } ] }), signal: AbortSignal.timeout(30000) }) const result = await response.json() console.log({ httpStatus: response.status, response: result }) } main().catch(() => { console.error("İstek tamamlanamadı; yazma sonucunu kontrol etmeden yeniden göndermeyin.") process.exitCode = 1 }) ``` ## Cevabı değerlendirin Aşağıdaki cevap temsilîdir. ```json theme={null} { "status": true, "result": { "id": "507f1f77bcf86cd799439014", "version": 0, "contactId": "507f1f77bcf86cd799439011", "direction": "sale", "issueDate": "2026-10-19", "dueDate": "2026-10-19", "currencyCode": "TRY", "exchangeRate": 1, "description": "", "receiptNumber": "SATIS-ORNEK-001", "notes": [], "lines": [ { "name": "Danışmanlık hizmeti", "description": "", "quantity": 2, "unitCode": "C62", "unitPrice": 100, "grossAmount": 200, "discountAmount": 0, "vatRate": 20, "vatAmount": 40, "withholdingPercent": 0, "withheldVatAmount": 0, "lineTotal": 240 } ], "totals": { "grossAmount": 200, "lineDiscountAmount": 0, "documentDiscountAmount": 0, "discountAmount": 0, "taxes": [ { "code": "0015", "rate": 20, "amount": 40 } ], "withheldVatAmount": 0, "payableAmount": 240 }, "baseCurrencyCode": "TRY", "payableBaseAmount": 240, "paidBaseAmount": 0, "remainingBaseAmount": 240, "overpaidBaseAmount": 0, "isClosed": false, "tracksStock": false, "createdAt": "2026-10-19T09:00:00.000Z" }, "operation": { "operationId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "type": "transactions.create", "state": "succeeded", "reviewRequired": false, "retryable": false, "result": { "resultId": "507f1f77bcf86cd799439014" }, "statusUrl": "/apps/operations/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "createdAt": "2026-10-19T09:00:00.000Z", "updatedAt": "2026-10-19T09:00:01.000Z" } } ``` İlk başarılı çağrı `result` ile kayıt sonucunu ve `operation` ile makbuzu döndürür. Aynı iş anahtarıyla tamamlanmış tekrar **200** ve `replayed:true` döndürür; ilk ayrıntı gövdesi tekrarlanmaz. Sonuç kimliğiyle ilgili okuma ucunu kullanın. `reviewRequired:true` sonucunu başarılı mali işlem kabul etmeyin. ## Hata durumunda | HTTP / kod | İzlenecek adım | | - | - | | `400 INVALID_REQUEST` | Alanları, tarihi, ondalık hassasiyeti ve desteklenmeyen alanları kontrol edin. | | `401` / `403` | Kimlik, IP ve açık modül iznini doğrulayın. | | `404 RESOURCE_NOT_FOUND` | Kaynağın ve bağlı kimliklerin doğru olduğunu, bu kaynak türünde kullanılabildiğini kontrol edin. | | `409 RESOURCE_ARCHIVED` | Yeni işlemden önce kartı arşivden çıkarın. | | `409 IDEMPOTENCY_PAYLOAD_CONFLICT` | Aynı iş anahtarıyla farklı gövde, kimlik veya If-Match göndermeyin. Önce mevcut işlemi inceleyin. | | `409 OPERATION_TARGET_LOCKED` / `OPERATION_IN_PROGRESS` | Dönen işlem kimliğini takip edin; beklemek veya anahtarı değiştirmek işlem izni vermez. | | `502` / `503` | Otomatik tekrar yapmayın. İşlem durumunu ve kayıtları inceleyin. | [Hata yönetimi](https://docs.muhasip.pro/rehberler/hata-yonetimi.md) · [İşlem takibi](https://docs.muhasip.pro/rehberler/islem-takibi.md) ## Sonraki adım [Belgeden tahsilata ilerleyin](https://docs.muhasip.pro/rehberler/alis-satis-entegrasyonu.md). Dönen kimlikleri ve `version` değerini saklayın; mali yazma sonrasında ilgili belge ve cari bakiyesini okuyun. ## OpenAPI ````yaml openapi.json POST /accounting/invoices openapi: 3.0.3 info: title: Muhasip API version: 2026-10-25.1 description: >- Fatura, banka, POS ve tahsilat, GİB e-Arşiv, pazaryeri, online işlemler, görevler, ajanda ve takvim entegrasyonları. İşlem alanları, izinler, istek ve cevap örnekleri ile hata yönetimi. servers: - url: https://api.muhasip.pro description: Muhasip API security: - BasicAuth: [] tags: - name: Uygulamalar - name: Görev yönetimi - name: Ajanda ve takvim - name: Fatura description: Fatura bağlantısı, belge işlemleri ve muhasebeye aktarım. - name: Banka description: >- Banka hesapları, hareketler, mahsup ve mevcut çalışma alanı alt kaynakları. - name: POS ve tahsilat description: POS hesapları, komisyonlar ve tahsilat bağlantıları. - name: GİB e-Arşiv description: GİB hesabı, sorgu, taslak ve SMS imzalama. - name: Pazaryeri description: Trendyol bağlantısı ve sipariş aktarımı. - name: Online işlemler description: Online işlem ekranı yapılandırması. - name: İşlem takibi description: Mali işlem durumu ve tekrar çağrı makbuzları. - name: Cari hesaplar description: Cari hesaplar işlemleri. - name: Kasa ve transferler description: Kasa ve transferler işlemleri. - name: Alış-satış (e-belgesiz) description: Alış-satış (e-belgesiz) işlemleri. - name: Ödemeler ve mahsuplaşma description: Ödemeler ve mahsuplaşma işlemleri. - name: Muhasebe seçenekleri description: Muhasebe seçenekleri işlemleri. - name: E-Pos description: >- Firmanın kendi banka/ödeme kuruluşu sanal POS hesapları, tarifeler, ödeme talepleri ve tam iptal/iade. paths: /accounting/invoices: post: tags: - Alış-satış (e-belgesiz) summary: Alış-satış belgesi oluştur description: >- E-belgesiz alış veya satış kaydeder; cari bakiyesine etki eder. Tahsilat oluşturmaz ve e-belge göndermez. productId ve warehouseId birlikte verilen satırlar için stok etkisi oluşturur. Serbest satır ürün kartı oluşturmaz. Idempotency-Key zorunludur. Tamamlanmış tekrar, ilk result ayrıntısını değil operation ve güvenli sonuç kimliklerini döndürür. operationId: accountingTransactionsCreate parameters: - name: Idempotency-Key in: header required: true schema: type: string minLength: 1 maxLength: 128 pattern: ^[!-~]+$ description: >- Her yeni iş niyeti için kalıcı, farklı anahtar. Aynı anahtar+işlem+firma ve farklı içerik 409 üretir; tamamlanmış tekrar 200 replay makbuzu döner. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AccountingInvoiceInput' example: contactId: 507f1f77bcf86cd799439011 direction: sale issueDate: '2026-10-19' currencyCode: TRY exchangeRate: '1' receiptNumber: SATIS-ORNEK-001 lines: - name: Danışmanlık hizmeti quantity: '2' unitCode: C62 unitPrice: '100.00' vatRate: '20' responses: '200': description: >- Aynı anahtarla daha önce tamamlanan işlem; ilk ayrıntı gövdesi yerine güvenli sonuç kimlikleri. content: application/json: schema: $ref: '#/components/schemas/ApiOperationReplay' example: status: true replayed: true operation: operationId: >- aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa type: transactions.create state: succeeded reviewRequired: false retryable: false result: resultId: 507f1f77bcf86cd799439014 statusUrl: >- /apps/operations/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa createdAt: '2026-10-19T09:00:00.000Z' updatedAt: '2026-10-19T09:00:01.000Z' operations: - operationId: >- aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa type: transactions.create state: succeeded reviewRequired: false retryable: false result: resultId: 507f1f77bcf86cd799439014 statusUrl: >- /apps/operations/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa createdAt: '2026-10-19T09:00:00.000Z' updatedAt: '2026-10-19T09:00:01.000Z' resultId: 507f1f77bcf86cd799439014 '201': description: İşlem tamamlandı. Yazma cevabındaki operation makbuzunu saklayın. content: application/json: schema: type: object properties: status: type: boolean enum: - true result: $ref: '#/components/schemas/AccountingInvoice' operation: $ref: '#/components/schemas/ApiOperation' required: - status - result - operation additionalProperties: false example: status: true result: id: 507f1f77bcf86cd799439014 version: 0 contactId: 507f1f77bcf86cd799439011 direction: sale issueDate: '2026-10-19' dueDate: '2026-10-19' currencyCode: TRY exchangeRate: 1 description: '' receiptNumber: SATIS-ORNEK-001 notes: [] lines: - name: Danışmanlık hizmeti description: '' quantity: 2 unitCode: C62 unitPrice: 100 grossAmount: 200 discountAmount: 0 vatRate: 20 vatAmount: 40 withholdingPercent: 0 withheldVatAmount: 0 lineTotal: 240 totals: grossAmount: 200 lineDiscountAmount: 0 documentDiscountAmount: 0 discountAmount: 0 taxes: - code: '0015' rate: 20 amount: 40 withheldVatAmount: 0 payableAmount: 240 baseCurrencyCode: TRY payableBaseAmount: 240 paidBaseAmount: 0 remainingBaseAmount: 240 overpaidBaseAmount: 0 isClosed: false tracksStock: false createdAt: '2026-10-19T09:00:00.000Z' operation: operationId: >- aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa type: transactions.create state: succeeded reviewRequired: false retryable: false result: resultId: 507f1f77bcf86cd799439014 statusUrl: >- /apps/operations/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa createdAt: '2026-10-19T09:00:00.000Z' updatedAt: '2026-10-19T09:00:01.000Z' '400': description: Alan, tarih, hassasiyet, gövde veya başlık geçersiz. content: application/json: schema: $ref: '#/components/schemas/ApiOperationError' example: status: false code: INVALID_REQUEST message: Alan, tarih, hassasiyet, gövde veya başlık geçersiz. '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '409': description: >- İlişki, bakiye, kur, sürüm veya işlem kilidi çakışması. İlgili kaydı ve işlem durumunu okuyun. content: application/json: schema: $ref: '#/components/schemas/ApiOperationError' example: status: false code: RECORD_CHANGED message: >- İlişki, bakiye, kur, sürüm veya işlem kilidi çakışması. İlgili kaydı ve işlem durumunu okuyun. '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' '502': description: >- Mali sonuç kesinleştirilemedi. İşlemi tekrar göndermeden operation durumunu ve ilgili kayıtları inceleyin. content: application/json: schema: $ref: '#/components/schemas/ApiOperationError' example: status: false code: UPSTREAM_RESULT_UNCERTAIN message: >- Mali sonuç kesinleştirilemedi. İşlemi tekrar göndermeden operation durumunu ve ilgili kayıtları inceleyin. '503': description: >- İşlem makbuzu oluşturulamadı veya kesinleştirilemedi. Yeniden göndermeden durumunu okuyun. content: application/json: schema: $ref: '#/components/schemas/ApiOperationError' example: status: false code: OPERATION_RECORD_UNAVAILABLE message: >- İşlem makbuzu oluşturulamadı veya kesinleştirilemedi. Yeniden göndermeden durumunu okuyun. components: schemas: AccountingInvoiceInput: type: object properties: contactId: type: string description: 24 karakterli kayıt kimliği. pattern: ^[a-f0-9A-F]{24}$ direction: type: string enum: - sale - purchase issueDate: type: string description: YYYY-MM-DD; 1900-01-01–2199-12-31. Saat gönderilmez. format: date dueDate: type: string description: Varsayılan issueDate; belge tarihinden önce olamaz. format: date currencyCode: $ref: '#/components/schemas/AccountingCurrency' exchangeRate: $ref: '#/components/schemas/AccountingRate' description: type: string maxLength: 2000 receiptNumber: type: string description: İsteğe bağlı belge referansı; mükerrer koruma anahtarı değildir. maxLength: 100 notes: type: array items: type: string maxLength: 1000 maxItems: 20 discountAmount: allOf: - $ref: '#/components/schemas/AccountingMoney' description: >- Satır indirimlerinden sonra, KDV öncesi dağıtılacak belge indirimi; varsayılan 0. lines: type: array items: $ref: '#/components/schemas/AccountingInvoiceLineInput' minItems: 1 maxItems: 100 required: - contactId - direction - issueDate - lines additionalProperties: false description: >- Tam belge gövdesidir. TRY ve exchangeRate=1 varsayılandır; yabancı para biriminde kur zorunludur. Hesaplanan toplamlar veya sistem alanları kabul edilmez. ApiOperationReplay: type: object properties: status: type: boolean replayed: type: boolean enum: - true operation: $ref: '#/components/schemas/ApiOperation' operations: type: array items: $ref: '#/components/schemas/ApiOperation' resultId: type: string transactionId: type: string uuid: type: string id: type: string providerId: type: string documentId: type: string paymentId: type: string orderId: type: string uuids: type: array items: type: string sourcePaymentId: type: string description: 24 karakterli kayıt kimliği. pattern: ^[a-f0-9A-F]{24}$ destinationPaymentId: type: string description: 24 karakterli kayıt kimliği. pattern: ^[a-f0-9A-F]{24}$ required: - status - replayed - operation - operations additionalProperties: false AccountingInvoice: type: object properties: id: type: string description: Hesaplama cevabında null; kayıtta belge kimliği. pattern: ^[a-f0-9A-F]{24}$ nullable: true version: type: integer minimum: 0 description: If-Match için kullanılan kayıt sürümü. contactId: type: string description: 24 karakterli kayıt kimliği. pattern: ^[a-f0-9A-F]{24}$ direction: type: string enum: - sale - purchase issueDate: type: string description: YYYY-MM-DD; 1900-01-01–2199-12-31. Saat gönderilmez. format: date dueDate: type: string description: YYYY-MM-DD; 1900-01-01–2199-12-31. Saat gönderilmez. format: date currencyCode: $ref: '#/components/schemas/AccountingCurrency' exchangeRate: type: number description: type: string receiptNumber: type: string notes: type: array items: type: string lines: type: array items: $ref: '#/components/schemas/AccountingInvoiceLine' totals: $ref: '#/components/schemas/AccountingInvoiceTotals' baseCurrencyCode: type: string enum: - TRY payableBaseAmount: type: number paidBaseAmount: type: number remainingBaseAmount: type: number overpaidBaseAmount: type: number isClosed: type: boolean tracksStock: type: boolean createdAt: type: string format: date-time required: - id - version - contactId - direction - issueDate - dueDate - currencyCode - exchangeRate - description - receiptNumber - notes - lines - totals - baseCurrencyCode - payableBaseAmount - paidBaseAmount - remainingBaseAmount - overpaidBaseAmount - isClosed - tracksStock additionalProperties: false ApiOperation: type: object properties: operationId: type: string pattern: ^[a-f0-9]{64}$ type: type: string state: type: string enum: - claimed - dispatching - provider_accepted - succeeded - rejected - failed_before_dispatch - review_required reviewRequired: type: boolean retryable: type: boolean result: $ref: '#/components/schemas/ApiOperationReceipt' statusUrl: type: string createdAt: type: string format: date-time description: ISO 8601 tarih-saat. updatedAt: type: string format: date-time description: ISO 8601 tarih-saat. required: - operationId - type - state - reviewRequired - retryable - result - statusUrl - createdAt - updatedAt ApiOperationError: type: object properties: status: type: boolean code: type: string message: type: string retryable: type: boolean reviewRequired: type: boolean operation: $ref: '#/components/schemas/ApiOperation' operationId: type: string required: - status additionalProperties: true AccountingCurrency: type: string description: >- İşlem para birimi. Uygulama tutar hassasiyeti bütün bu birimlerde 2 basamaktır. enum: - TRY - USD - EUR - GBP - CHF - CAD - AUD - JPY - CNY - AED - SAR - RUB - DKK - NOK - SEK AccountingRate: description: >- 1 birim dövizin TRY karşılığı; pozitif, en fazla 6 basamak. TRY için 1; diğer para birimlerinde zorunlu. oneOf: - type: number minimum: 0 maximum: 999999.999999 multipleOf: 0.000001 exclusiveMinimum: true - type: string pattern: ^(?=\d{1,12}(?:\.\d{1,6})?$)(?!0+(?:\.0+)?$)0*\d{1,6}(?:\.\d{1,6})?$ x-decimal-places: 6 AccountingMoney: description: En fazla 2 ondalık basamak; 0–999999999.99. Sayı veya metin. oneOf: - type: number minimum: 0 maximum: 999999999.99 multipleOf: 0.01 - type: string pattern: ^(?=\d{1,12}(?:\.\d{1,2})?$)0*\d{1,9}(?:\.\d{1,2})?$ x-decimal-places: 2 AccountingInvoiceLineInput: type: object properties: name: type: string description: Serbest kalem açıklaması; ürün kendiliğinden oluşturulmaz. minLength: 1 maxLength: 250 description: type: string maxLength: 2000 productId: type: string description: 24 karakterli kayıt kimliği. pattern: ^[a-f0-9A-F]{24}$ warehouseId: type: string description: >- Verilirse productId zorunludur. İkisi birlikte bu satır için stok hareketi oluşturur. pattern: ^[a-f0-9A-F]{24}$ quantity: description: Pozitif miktar; en fazla 6 basamak. oneOf: - type: number minimum: 0 maximum: 999999.999999 multipleOf: 0.000001 exclusiveMinimum: true - type: string pattern: >- ^(?=\d{1,12}(?:\.\d{1,6})?$)(?!0+(?:\.0+)?$)0*\d{1,6}(?:\.\d{1,6})?$ x-decimal-places: 6 unitCode: type: string description: GET /accounting/options birim kodu; varsayılan C62. maxLength: 10 unitPrice: description: KDV hariç birim fiyat; en fazla 6 basamak. oneOf: - type: number minimum: 0 maximum: 999999999.999999 multipleOf: 0.000001 - type: string pattern: ^(?=\d{1,12}(?:\.\d{1,6})?$)0*\d{1,9}(?:\.\d{1,6})?$ x-decimal-places: 6 discountAmount: $ref: '#/components/schemas/AccountingMoney' discountPercent: $ref: '#/components/schemas/AccountingPercent' vatRate: $ref: '#/components/schemas/AccountingPercent' withholdingPercent: allOf: - $ref: '#/components/schemas/AccountingPercent' description: >- KDV tutarından kesilecek yüzde; varsayılan 0. Vergi matrahının yüzdesi değildir. required: - name - quantity - unitPrice additionalProperties: false description: >- discountAmount ile discountPercent birlikte gönderilemez. Fiyat KDV hariçtir. name, quantity, unitPrice zorunlu; diğer parasal/oransal alanların varsayılanı 0. AccountingInvoiceLine: type: object properties: productId: type: string description: 24 karakterli kayıt kimliği. pattern: ^[a-f0-9A-F]{24}$ warehouseId: type: string description: 24 karakterli kayıt kimliği. pattern: ^[a-f0-9A-F]{24}$ name: type: string description: type: string quantity: type: number unitCode: type: string unitPrice: type: number grossAmount: type: number discountAmount: type: number description: Satır ve belge indirimi payının toplamı. vatRate: type: number vatAmount: type: number withholdingPercent: type: number withheldVatAmount: type: number lineTotal: type: number required: - name - description - quantity - unitCode - unitPrice - grossAmount - discountAmount - vatRate - vatAmount - withholdingPercent - withheldVatAmount - lineTotal additionalProperties: false AccountingInvoiceTotals: type: object properties: grossAmount: type: number lineDiscountAmount: type: number documentDiscountAmount: type: number discountAmount: type: number taxes: type: array items: $ref: '#/components/schemas/AccountingTaxTotal' withheldVatAmount: type: number payableAmount: type: number required: - grossAmount - lineDiscountAmount - documentDiscountAmount - discountAmount - taxes - withheldVatAmount - payableAmount additionalProperties: false ApiOperationReceipt: type: object properties: resultId: type: string minLength: 1 maxLength: 200 pattern: ^[A-Za-z0-9_.:-]+$ transactionId: type: string minLength: 1 maxLength: 200 pattern: ^[A-Za-z0-9_.:-]+$ uuid: type: string minLength: 1 maxLength: 200 pattern: ^[A-Za-z0-9_.:-]+$ id: type: string minLength: 1 maxLength: 200 pattern: ^[A-Za-z0-9_.:-]+$ providerId: type: string minLength: 1 maxLength: 200 pattern: ^[A-Za-z0-9_.:-]+$ documentId: type: string minLength: 1 maxLength: 200 pattern: ^[A-Za-z0-9_.:-]+$ paymentId: type: string minLength: 1 maxLength: 200 pattern: ^[A-Za-z0-9_.:-]+$ orderId: type: string minLength: 1 maxLength: 200 pattern: ^[A-Za-z0-9_.:-]+$ uuids: type: array items: type: string maxLength: 200 pattern: ^[A-Za-z0-9_.:-]+$ maxItems: 100 sourcePaymentId: type: string description: 24 karakterli kayıt kimliği. pattern: ^[a-f0-9A-F]{24}$ destinationPaymentId: type: string description: 24 karakterli kayıt kimliği. pattern: ^[a-f0-9A-F]{24}$ additionalProperties: false Error: type: object properties: status: type: boolean code: type: string message: type: string description: type: string retryable: type: boolean reviewRequired: type: boolean operationId: type: string required: - status additionalProperties: true RateLimitError: type: object properties: status: type: integer enum: - 429 error: type: string message: type: string required: - status - error - message AccountingPercent: description: 0–100; en fazla 4 ondalık basamak. oneOf: - type: number minimum: 0 maximum: 100 multipleOf: 0.0001 - type: string pattern: >- ^(?=\d{1,12}(?:\.\d{1,4})?$)0*(?:\d{1,2}(?:\.\d{1,4})?|100(?:\.0{1,4})?)$ x-decimal-places: 4 AccountingTaxTotal: type: object properties: code: type: string rate: type: number amount: type: number required: - code - rate - amount additionalProperties: false responses: Unauthorized: description: API kimliği/parolası, erişim süresi veya firma doğrulanamadı. headers: WWW-Authenticate: schema: type: string description: Basic realm="Muhasip API", charset="UTF-8" content: application/json: schema: $ref: '#/components/schemas/Error' example: status: false code: UNAUTHORIZED message: API kimlik bilgileri doğrulanamadı. Forbidden: description: Ürün, IP, modül izni veya kaynak kapsamı uygun değil. content: application/json: schema: $ref: '#/components/schemas/Error' example: status: false message: Ürün, IP, modül izni veya kaynak kapsamı uygun değil. NotFound: description: Kayıt bulunamadı veya bu erişim bağlamında kullanılamıyor. content: application/json: schema: $ref: '#/components/schemas/Error' example: status: false RateLimited: description: Ortak istek sınırı aşıldı; sayısal status alanı kullanılır. content: application/json: schema: $ref: '#/components/schemas/RateLimitError' example: status: 429 error: Too Many Requests message: Rate limit exceeded. Please try again later. InternalError: description: İşleme hatası. Bazı işleme hataları 411 olarak dönebilir. content: application/json: schema: $ref: '#/components/schemas/Error' example: status: false message: Üzgünüz, bir hata oluştu. securitySchemes: BasicAuth: type: http scheme: basic description: >- Kullanıcı adı apiUserId, parola secretKey. Aktif ve süresi geçmemiş API kullanıcısı ve uygun firma gerekir. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.