From fec92dd95525a73d66ec343e7222278dc8c0ba6a Mon Sep 17 00:00:00 2001 From: Burak Kara Date: Thu, 19 Jan 2023 17:46:54 +0300 Subject: [PATCH 1/4] add accommodation tax related fields --- spec/swagger.yaml | 72 ++++++++++++++++++++++++++++++++++++----------- 1 file changed, 55 insertions(+), 17 deletions(-) diff --git a/spec/swagger.yaml b/spec/swagger.yaml index 9abddd9..cfcc362 100644 --- a/spec/swagger.yaml +++ b/spec/swagger.yaml @@ -9,17 +9,15 @@ info: # CHANGE LOG - ### **2021-10-11** + ### **2023-01-19** #### Added - - Belirli Firmalar İçin Özel Gereksinimler alanına Amazon için gerekli özel alanlar eklendi. - - - #### Changed - - - Fatura oluşturmada `order_no` ve `order_date` alanlarının tanımlamaları değiştirildi. + - Satış Faturası'na Konaklama Vergisi için `total_accommodation_tax` ve + `accommodation_tax_exemption_reason_code` alanları eklendi. + - Satış Faturası Detayı'na Konaklama Vergisi için `accommodation_tax_rate`, + `accommodation_tax` ve `accommodation_tax_exempt` alanları eklendi. # GİRİŞ @@ -452,7 +450,6 @@ info: Buradaki data'nın içindeki alanların anlamları: - - `additional_invoice_type`: ilave fatura tipi - `tax_payer_code`: mükellef kodu @@ -472,10 +469,11 @@ info: Available: *SAGLIK_ECZ, SAGLIK_HAS, SAGLIK_OPT, SAGLIK_MED, ABONELIK, MAL_HIZMET, DIGER* - ### Amazon için gerekli özel alanlar - Amazon'a kesilen faturalarda adres bilgisi doğru girilmelidir. Uygulamada kullanılan adres bilgileri: + ### Amazon için gerekli özel alanlar + Amazon'a kesilen faturalarda adres bilgisi doğru girilmelidir. Uygulamada + kullanılan adres bilgileri: - `billing_address`: Esentepe Mahallesi, Bahar Sk. No: 13/52 @@ -487,10 +485,15 @@ info: - `city`: İstanbul - - Amazon'a kesilen faturalarda sipariş bilgileri (`order_no` ve `order_date`) doldurulmalıdır. + - Amazon'a kesilen faturalarda sipariş bilgileri (`order_no` ve + `order_date`) doldurulmalıdır. - Tedarikçi kodu ve EAN / ASIN kodlarını girebileceğiniz alan `custom_requirement_params` alanıdır. `product_id` yerine ürünlerin paraşüt üzerindeki id sini girebilirsiniz. Örnek olarak aşağıdaki json'u inceleyebilirsiniz. + Tedarikçi kodu ve EAN / ASIN kodlarını girebileceğiniz alan + `custom_requirement_params` alanıdır. `product_id` yerine ürünlerin paraşüt + üzerindeki id sini girebilirsiniz. Örnek olarak aşağıdaki json'u + inceleyebilirsiniz. + ```json @@ -518,6 +521,7 @@ info: ``` + Buradaki data'nın içindeki alanların anlamları: - `supplier_code`: tedarikçi kodu @@ -14016,9 +14020,9 @@ definitions: readOnly: false description: İlçe postal_code: + description: Posta kodu type: string readOnly: false - description: Posta kodu city: type: string readOnly: false @@ -16196,6 +16200,10 @@ definitions: type: number readOnly: true description: Vergiler Hariç Toplam + total_accommodation_tax: + type: number + readOnly: true + description: Toplam Konaklama Vergisi remaining: type: number readOnly: true @@ -16323,12 +16331,24 @@ definitions: order_no: type: string readOnly: false - description: Sipariş no (resmileştirmek için order_date dolu ise bu alan zorunludur) + description: >- + Sipariş no (resmileştirmek için order_date dolu ise bu alan + zorunludur) order_date: type: string format: date readOnly: false - description: Sipariş tarihi (resmileştirmek için order_no dolu ise bu alan zorunludur) + description: >- + Sipariş tarihi (resmileştirmek için order_no dolu ise bu alan + zorunludur) + accommodation_tax_exemption_reason_code: + type: string + enum: + - '001' + readOnly: false + description: >- + Konaklama Vergisi İstisna Kodu boş ya da belirtilen değerlerden biri + olmalı. shipment_addres: type: string readOnly: false @@ -16341,11 +16361,11 @@ definitions: readOnly: false description: Peşin satış payer_tax_numbers: - description: Kamu faturaları için zorunludur. type: array items: type: string readOnly: false + description: Kamu faturaları için zorunludur. required: - item_type - issue_date @@ -16577,8 +16597,8 @@ definitions: description: KDV oranı vat_withholding_rate: type: number - description: Tevkifat oranı readOnly: false + description: Tevkifat oranı discount_type: type: string enum: @@ -16640,10 +16660,28 @@ definitions: - Sabit taşıma tesisleri - İç su taşımacılığı readOnly: false + accommodation_tax_rate: + description: Konaklama Vergisi Oranı + type: number + enum: + - 0 + - 2 + readOnly: false + accommodation_tax: + description: Konaklama Vergisi Miktarı + type: number + readOnly: false + accommodation_tax_exempt: + description: Konaklama Vergisi İstisna mı + type: boolean + readOnly: false required: - quantity - unit_price - vat_rate + - accommodation_tax_rate + - accommodation_tax + - accommodation_tax_exempt SalesInvoiceDetail: type: object properties: From 7e09e936d9052f9df37d27033f10ff2e9d3ad52f Mon Sep 17 00:00:00 2001 From: Burak Kara Date: Mon, 20 Feb 2023 11:46:22 +0300 Subject: [PATCH 2/4] fix webhook changes --- spec/swagger.yaml | 46 +++++++++++++--------------------------------- 1 file changed, 13 insertions(+), 33 deletions(-) diff --git a/spec/swagger.yaml b/spec/swagger.yaml index cfcc362..0378d6d 100644 --- a/spec/swagger.yaml +++ b/spec/swagger.yaml @@ -69,10 +69,11 @@ info: - 10 saniyede 10 adet istek gönderebilirsiniz. - - Oluşturuduğunuz Webhook'un URL'ine gönderilen requestlerin `Signature` headerı `event data` ve size tanımlanan - `encryption key` değerlerini SHA256 ile hash'leyerek ile oluşturulur. + - Oluşturuduğunuz Webhook'un URL'ine gönderilen requestlerin `Signature` + headerı `event data` ve size tanımlanan `encryption key` değerlerini SHA256 + ile hash'leyerek ile oluşturulur. - Örnek bir Webhook URL'ine gönderilen request şöyle görünür; - + `Content-Type: www-url-encoded` ```json @@ -89,13 +90,12 @@ info: "operated_by_type": null, "operated_by_id": null, "included": [ ... ], # array of related objects - "data": { ... } # unparsed (ayrıştırılmamış), string halinde object modal. İlgili modeli dönen API ile aynı formatta + "data": { ... } # unparsed (ayrıştırılmamış), string halinde object model. İlgili modeli dönen API ile aynı formatta # data bu örnekte sales invoice, ilgili API: /#operation/showSalesInvoice } } ``` - # Authentication @@ -13228,36 +13228,11 @@ paths: enum: - webhook attributes: - type: object - required: - - model - - action - - uri - properties: - model: - type: string - enum: - - shipment_document - - employee - - product - - contact - - stock_movement - - sales_invoice - description: Model name to create its webhook - action: - type: string - enum: - - create - - update - - delete - description: Action name to create related webhook - uri: - type: string - description: URI to use webhook + $ref: '#/definitions/WebhookAttributes' in: body required: true responses: - '200': + '201': description: Webhook schema: type: object @@ -13410,7 +13385,7 @@ paths: summary: Delete description: Deletes Webhook record responses: - '200': + '204': description: No content schema: type: object @@ -17648,6 +17623,10 @@ definitions: type: string description: URI to use webhook readOnly: false + required: + - model + - action + - uri Webhook: type: object properties: @@ -17662,5 +17641,6 @@ definitions: - webhook attributes: $ref: '#/definitions/WebhookAttributes' + relationships: {} required: - attributes From 7ea78a354473187ba3e84aa30b0ee3580d4b474c Mon Sep 17 00:00:00 2001 From: Burak Kara Date: Mon, 20 Feb 2023 12:40:35 +0300 Subject: [PATCH 3/4] add acc tax --- spec/swagger.yaml | 51 +++++++++++++++++++++++++++++++++++------------ 1 file changed, 38 insertions(+), 13 deletions(-) diff --git a/spec/swagger.yaml b/spec/swagger.yaml index 0378d6d..6b78806 100644 --- a/spec/swagger.yaml +++ b/spec/swagger.yaml @@ -14421,6 +14421,12 @@ definitions: - 63 - 9077 readOnly: false + accommodation_tax_exemption_reason_code: + description: Konaklama Vergisi istisna kodu + type: string + enum: + - '001' + readOnly: false EDocumentCommonForm: type: object properties: @@ -15347,6 +15353,13 @@ definitions: type: number readOnly: false description: ÖİV oranı + accommodation_tax_rate: + description: Konaklama Vergisi oranı + type: number + enum: + - 0 + - 2 + readOnly: false archived: type: boolean readOnly: false @@ -15884,6 +15897,17 @@ definitions: communications_tax_rate: type: number readOnly: false + accommodation_tax_rate: + description: Konaklama Vergisi oranı + type: number + enum: + - 0 + - 2 + readOnly: false + accommodation_tax_exempt: + description: Konaklama Vergisi muafiyeti + type: boolean + readOnly: false description: type: string readOnly: false @@ -15986,6 +16010,17 @@ definitions: - percentage - amount readOnly: false + accommodation_tax_rate: + description: Konaklama Vergisi oranı + type: number + enum: + - 0 + - 2 + readOnly: false + accommodation_tax_exempt: + description: Konaklama Vergisi muafiyeti + type: boolean + readOnly: false required: - item_type - issue_date @@ -16178,7 +16213,6 @@ definitions: total_accommodation_tax: type: number readOnly: true - description: Toplam Konaklama Vergisi remaining: type: number readOnly: true @@ -16321,9 +16355,7 @@ definitions: enum: - '001' readOnly: false - description: >- - Konaklama Vergisi İstisna Kodu boş ya da belirtilen değerlerden biri - olmalı. + description: Konaklama Vergisi istisna kodu shipment_addres: type: string readOnly: false @@ -16636,27 +16668,20 @@ definitions: - İç su taşımacılığı readOnly: false accommodation_tax_rate: - description: Konaklama Vergisi Oranı type: number enum: - 0 - 2 readOnly: false - accommodation_tax: - description: Konaklama Vergisi Miktarı - type: number - readOnly: false + description: Konaklama Vergisi oranı accommodation_tax_exempt: - description: Konaklama Vergisi İstisna mı type: boolean readOnly: false + description: Konaklama Vergisi İstisna mı required: - quantity - unit_price - vat_rate - - accommodation_tax_rate - - accommodation_tax - - accommodation_tax_exempt SalesInvoiceDetail: type: object properties: From 207cfa912e9a85357548b07cbf2a1f562a8ba390 Mon Sep 17 00:00:00 2001 From: Burak Kara Date: Mon, 20 Feb 2023 12:52:23 +0300 Subject: [PATCH 4/4] update change log --- spec/swagger.yaml | 27 +++++++++++++++++++++------ 1 file changed, 21 insertions(+), 6 deletions(-) diff --git a/spec/swagger.yaml b/spec/swagger.yaml index 6b78806..78055e4 100644 --- a/spec/swagger.yaml +++ b/spec/swagger.yaml @@ -9,15 +9,30 @@ info: # CHANGE LOG - ### **2023-01-19** + ### **2023-02-20** - #### Added + #### Konaklama Vergisi - - Satış Faturası'na Konaklama Vergisi için `total_accommodation_tax` ve - `accommodation_tax_exemption_reason_code` alanları eklendi. + - Satış Faturası üzerine `accommodation_tax_exemption_reason_code` alanı + eklendi. - - Satış Faturası Detayı'na Konaklama Vergisi için `accommodation_tax_rate`, - `accommodation_tax` ve `accommodation_tax_exempt` alanları eklendi. + - Satış Faturası Detayı üzerine `accommodation_tax_rate` ve + `accommodation_tax_exempt` alanları eklendi. + + - E-Arşiv ve E-Fatura üzerine `accommodation_tax_exemption_reason_code` + alanı eklendi. + + - Ürün üzerine `accommodation_tax_rate` eklendi. + + - Gider Faturası Detayı üzerine `accommodation_tax_rate` ve + `accommodation_tax_exempt` alanları eklendi. + + + ### **2023-02-02** + + #### Webhook + + - Webhook GET, POST, PUT ve DELETE endpoint'leri eklendi. # GİRİŞ