TreeWin Fatura REST Servisleri
Alış Faturalarını Listeleme
Belirtilen kriterlere göre alış faturalarını sayfalamalı olarak listeler. startDate, endDate, invoiceNo veya ettn alanlarından en az biri zorunludur.
Örnek Request
{
"endDate": "01/02/2025 10:30",
"ettn": "6ccf842c-d479-46a2-a90d-147f74c1b4de",
"invoiceNo": "INV202501090001",
"page": 0,
"pageSize": 200,
"startDate": "01/01/2025 10:30"
}
Örnek Response
{
"code": "1",
"message": "Faturalar başarıyla getirildi.",
"invoiceList": [
{
"accountingCustomerPartyBuildingNumber": 8,
"accountingCustomerPartyCityName": "Ankara",
"accountingCustomerPartyCitySubdivisionName": "Çankaya",
"accountingCustomerPartyCountryName": "Türkiye",
"accountingCustomerPartyElectronicMail": "musteri@example.com",
"accountingCustomerPartyId": 11111111111,
"accountingCustomerPartyName": "Müşteri",
"accountingCustomerPartyPersonFamilyName": "Kaya",
"accountingCustomerPartyPersonFirstName": "Ayşe",
"accountingCustomerPartyPostalZone": "06000",
"accountingCustomerPartyStreetName": "567. Cadde",
"accountingCustomerPartyTaxSchemeName": "Çankaya Vergi Dairesi",
"accountingSupplierPartyBuildingNumber": 4,
"accountingSupplierPartyCityName": "Ankara",
"accountingSupplierPartyCitySubdivisionName": "Çankaya",
"accountingSupplierPartyCountryName": "Türkiye",
"accountingSupplierPartyElectronicMail": "tedarikci@example.com",
"accountingSupplierPartyId": 11111111111,
"accountingSupplierPartyName": "Tedarikçi",
"accountingSupplierPartyPersonFamilyName": "Veli",
"accountingSupplierPartyPersonFirstName": "Ali",
"accountingSupplierPartyPostalZone": "06000",
"accountingSupplierPartyStreetName": "123. Cadde",
"accountingSupplierPartyTaxSchemeName": "Çankaya Vergi Dairesi",
"additionalDocumentReferences": [
{
"documentDescription": [
"HepsiJet"
],
"documentReferenceId": "80c0114a-e5aa-41e4-8adb-c4a40b5c4e9d",
"documentType": "CARGO_COMPANY",
"invoiceId": 0,
"issueDate": "2025-01-09T07:45:13.022Z"
}
],
"buyerCustomerPartyBuildingNumber": 30,
"buyerCustomerPartyCityName": "Ankara",
"buyerCustomerPartyCitySubdivisionName": "Çankaya",
"buyerCustomerPartyCompanyId": 1111111111,
"buyerCustomerPartyCountryName": "Türkiye",
"buyerCustomerPartyElectronicMail": "alici@example.com",
"buyerCustomerPartyId": 11111111111,
"buyerCustomerPartyName": "Alıcı Ltd.",
"buyerCustomerPartyPostalZone": "06000",
"buyerCustomerPartyRegistrationName": "Official Receiver Name",
"buyerCustomerPartyStreetName": "Yıldız Mah.",
"buyerCustomerPartyTaxSchemeId": "006257",
"buyerCustomerPartyTaxSchemeName": "Çankaya Vergi Dairesi",
"customizationID": "TR1.2",
"digitalSignatureAttachmentUri": "string",
"discount": 0,
"discountIncludeVatRate": true,
"discountRate": 0,
"documentCurrencyCode": "TRY",
"ettn": "6ccf842c-d479-46a2-a90d-147f74c1b4de",
"increaseAmount": 0,
"increaseAmountIncludeVatRate": true,
"increaseAmountRate": 0,
"invoiceDirection": {
"id": 1,
"desc": "Gelen",
"value": "Incoming"
},
"invoiceLines": [
{
"allowanceChargeAmount": 0,
"allowanceChargeBaseAmount": 0,
"buyersItemIdentificationId": "00123",
"chargeIndicator": true,
"invoicedQuantityUnitCode": "NIU",
"invoicedQuantityValue": 0,
"itemDescription": "Nemlendirici Krem",
"itemName": "ABC Krem",
"lineExtensionAmount": 0,
"manufacturersItemIdentificationId": "CD890",
"multiplierFactorNumeric": 0,
"priceAmount": 0,
"sellersItemIdentificationId": "AB4567",
"taxAmount": 0,
"taxExemptionReason": "11/1-a Mal İhracatı",
"taxExemptionReasonCode": 301,
"taxPercent": 0,
"taxSubtotal": [
{
"invoiceId": 0,
"invoiceLineId": 0,
"percent": 0,
"taxAmount": 0,
"taxExemptionReason": "11/1-a Mal İhracatı (301)",
"taxExemptionReasonCode": 301,
"taxTypeCode": "0015",
"taxableAmount": 0
}
]
}
],
"invoiceNumber": "INV202501090001",
"invoiceTypeCode": "SATIS",
"invoiceUrl": "string",
"issueDate": "09/01/2025 10:30",
"legalMonetaryTotalAllowanceTotalAmount": 0,
"legalMonetaryTotalLineExtensionAmount": 0,
"legalMonetaryTotalPayableAmount": 0,
"legalMonetaryTotalTaxExclusiveAmount": 0,
"legalMonetaryTotalTaxInclusiveAmount": 0,
"lineCountNumeric": 0,
"note": [
"İlk not",
"İkinci not"
],
"orderReferenceId": "SIP20250109001",
"orderReferenceIssueDate": "09/01/2025 10:30",
"orderReferenceSalesOrderID": 123456789,
"paymentType": {
"id": 1,
"desc": "Kredi Kartı/Banka Kartı",
"paymentType": "KREDIKARTI_BANKAKARTI",
"name": "CREDIT_CARD"
},
"profileID": "TEMELFATURA",
"sendingType": {
"id": 1,
"desc": "Kağıt",
"sendingType": "KAGIT"
},
"signatoryPartyBuildingNumber": 4,
"signatoryPartyCityName": "Ankara",
"signatoryPartyCitySubdivisionName": "Çankaya",
"signatoryPartyCountryName": "Türkiye",
"signatoryPartyId": 11111111111,
"signatoryPartyName": "Ali Veli",
"signatoryPartyPostalZone": "06000",
"signatoryPartyStreetName": "123. Cadde",
"signatureId": 1111111111,
"status": {
"bozaInvoiceStatus": {
"value": 4,
"desc": "Hata Aldı"
},
"value": "Sistem_Hatasi",
"desc": "Sistem Hatası",
"type": "e-fatura"
},
"taxAmount": 0,
"taxSubtotals": [
{
"invoiceId": 0,
"invoiceLineId": 0,
"percent": 0,
"taxAmount": 0,
"taxExemptionReason": "11/1-a Mal İhracatı (301)",
"taxExemptionReasonCode": 301,
"taxTypeCode": "0015",
"taxableAmount": 0
}
],
"ublVersionID": 2.1,
"unitConversion": "string"
}
]
}
Satış Faturalarını Listeleme
Belirtilen kriterlere göre satış faturalarını sayfalamalı olarak listeler. startDate, endDate, invoiceNo veya ettn alanlarından en az biri zorunludur.
Örnek Request
{
"endDate": "01/02/2025 10:30",
"ettn": "6ccf842c-d479-46a2-a90d-147f74c1b4de",
"invoiceNo": "INV202501090001",
"page": 0,
"pageSize": 200,
"startDate": "01/01/2025 10:30"
}
Örnek Response
{
"code": "1",
"message": "Faturalar başarıyla getirildi.",
"invoiceList": [
{
"accountingCustomerPartyBuildingNumber": 8,
"accountingCustomerPartyCityName": "Ankara",
"accountingCustomerPartyCitySubdivisionName": "Çankaya",
"accountingCustomerPartyCountryName": "Türkiye",
"accountingCustomerPartyElectronicMail": "musteri@example.com",
"accountingCustomerPartyId": 11111111111,
"accountingCustomerPartyName": "Müşteri",
"accountingCustomerPartyPersonFamilyName": "Kaya",
"accountingCustomerPartyPersonFirstName": "Ayşe",
"accountingCustomerPartyPostalZone": "06000",
"accountingCustomerPartyStreetName": "567. Cadde",
"accountingCustomerPartyTaxSchemeName": "Çankaya Vergi Dairesi",
"accountingSupplierPartyBuildingNumber": 4,
"accountingSupplierPartyCityName": "Ankara",
"accountingSupplierPartyCitySubdivisionName": "Çankaya",
"accountingSupplierPartyCountryName": "Türkiye",
"accountingSupplierPartyElectronicMail": "tedarikci@example.com",
"accountingSupplierPartyId": 11111111111,
"accountingSupplierPartyName": "Tedarikçi",
"accountingSupplierPartyPersonFamilyName": "Veli",
"accountingSupplierPartyPersonFirstName": "Ali",
"accountingSupplierPartyPostalZone": "06000",
"accountingSupplierPartyStreetName": "123. Cadde",
"accountingSupplierPartyTaxSchemeName": "Çankaya Vergi Dairesi",
"additionalDocumentReferences": [
{
"documentDescription": [
"HepsiJet"
],
"documentReferenceId": "80c0114a-e5aa-41e4-8adb-c4a40b5c4e9d",
"documentType": "CARGO_COMPANY",
"invoiceId": 0,
"issueDate": "2025-01-09T07:45:13.022Z"
}
],
"buyerCustomerPartyBuildingNumber": 30,
"buyerCustomerPartyCityName": "Ankara",
"buyerCustomerPartyCitySubdivisionName": "Çankaya",
"buyerCustomerPartyCompanyId": 1111111111,
"buyerCustomerPartyCountryName": "Türkiye",
"buyerCustomerPartyElectronicMail": "alici@example.com",
"buyerCustomerPartyId": 11111111111,
"buyerCustomerPartyName": "Alıcı Ltd.",
"buyerCustomerPartyPostalZone": "06000",
"buyerCustomerPartyRegistrationName": "Official Receiver Name",
"buyerCustomerPartyStreetName": "Yıldız Mah.",
"buyerCustomerPartyTaxSchemeId": "006257",
"buyerCustomerPartyTaxSchemeName": "Çankaya Vergi Dairesi",
"customizationID": "TR1.2",
"digitalSignatureAttachmentUri": "string",
"discount": 0,
"discountIncludeVatRate": true,
"discountRate": 0,
"documentCurrencyCode": "TRY",
"ettn": "6ccf842c-d479-46a2-a90d-147f74c1b4de",
"increaseAmount": 0,
"increaseAmountIncludeVatRate": true,
"increaseAmountRate": 0,
"invoiceDirection": {
"id": 2,
"desc": "Gönderilen",
"value": "Outgoing"
},
"invoiceLines": [
{
"allowanceChargeAmount": 0,
"allowanceChargeBaseAmount": 0,
"buyersItemIdentificationId": "00123",
"chargeIndicator": true,
"invoicedQuantityUnitCode": "NIU",
"invoicedQuantityValue": 0,
"itemDescription": "Nemlendirici Krem",
"itemName": "ABC Krem",
"lineExtensionAmount": 0,
"manufacturersItemIdentificationId": "CD890",
"multiplierFactorNumeric": 0,
"priceAmount": 0,
"sellersItemIdentificationId": "AB4567",
"taxAmount": 0,
"taxExemptionReason": "11/1-a Mal İhracatı",
"taxExemptionReasonCode": 301,
"taxPercent": 0,
"taxSubtotal": [
{
"invoiceId": 0,
"invoiceLineId": 0,
"percent": 0,
"taxAmount": 0,
"taxExemptionReason": "11/1-a Mal İhracatı (301)",
"taxExemptionReasonCode": 301,
"taxTypeCode": "0015",
"taxableAmount": 0
}
]
}
],
"invoiceNumber": "INV202501090001",
"invoiceTypeCode": "SATIS",
"invoiceUrl": "string",
"issueDate": "09/01/2025 10:30",
"legalMonetaryTotalAllowanceTotalAmount": 0,
"legalMonetaryTotalLineExtensionAmount": 0,
"legalMonetaryTotalPayableAmount": 0,
"legalMonetaryTotalTaxExclusiveAmount": 0,
"legalMonetaryTotalTaxInclusiveAmount": 0,
"lineCountNumeric": 0,
"note": [
"İlk not",
"İkinci not"
],
"orderReferenceId": "SIP20250109001",
"orderReferenceIssueDate": "09/01/2025 10:30",
"orderReferenceSalesOrderID": 123456789,
"paymentType": {
"id": 1,
"desc": "Kredi Kartı/Banka Kartı",
"paymentType": "KREDIKARTI_BANKAKARTI",
"name": "CREDIT_CARD"
},
"profileID": "TEMELFATURA",
"sendingType": {
"id": 1,
"desc": "Kağıt",
"sendingType": "KAGIT"
},
"signatoryPartyBuildingNumber": 4,
"signatoryPartyCityName": "Ankara",
"signatoryPartyCitySubdivisionName": "Çankaya",
"signatoryPartyCountryName": "Türkiye",
"signatoryPartyId": 11111111111,
"signatoryPartyName": "Ali Veli",
"signatoryPartyPostalZone": "06000",
"signatoryPartyStreetName": "123. Cadde",
"signatureId": 1111111111,
"status": {
"bozaInvoiceStatus": {
"value": 4,
"desc": "Hata Aldı"
},
"value": "Sistem_Hatasi",
"desc": "Sistem Hatası",
"type": "e-fatura"
},
"taxAmount": 0,
"taxSubtotals": [
{
"invoiceId": 0,
"invoiceLineId": 0,
"percent": 0,
"taxAmount": 0,
"taxExemptionReason": "11/1-a Mal İhracatı (301)",
"taxExemptionReasonCode": 301,
"taxTypeCode": "0015",
"taxableAmount": 0
}
],
"ublVersionID": 2.1,
"unitConversion": "string"
}
]
}