Nilvera API v1
  1. Send
Nilvera API v1
  • Notification
    • Satış faturasına ait bildirim kurallarını listeler.
      GET
    • Satış faturasına ait bildirim kurallarını listeler.
      GET
    • Satış faturasına ait bildirim kuralı oluşturur.
      POST
    • Satış faturasına ait bildirim kuralı oluşturur.
      POST
    • Satış faturasına ait bildirim kuralını günceller.
      PUT
    • Satış faturasına ait bildirim kuralını günceller.
      PUT
    • Satış faturasına ait bildirim kuralını siler.
      DELETE
    • Satış faturasına ait bildirim kuralını siler.
      DELETE
    • Satış faturasına ait bildirim kuralını getirir.
      GET
    • Satış faturasına ait bildirim kuralını getirir.
      GET
    • Alış faturaları için bildirim kurallarını listeler.
      GET
    • Alış faturaları için bildirim kurallarını listeler.
      GET
    • Alış faturası için bildirim kuralı oluşturur.
      POST
    • Alış faturası için bildirim kuralı oluşturur.
      POST
    • Alış faturasına ait bildirim kuralını günceller.
      PUT
    • Alış faturasına ait bildirim kuralını günceller.
      PUT
    • Alış faturasına ait bildirimi kuralını siler.
      DELETE
    • Alış faturasına ait bildirimi kuralını siler.
      DELETE
    • Alış faturasına ait bildirim kuralını getirir.
      GET
    • Alış faturasına ait bildirim kuralını getirir.
      GET
  • Old
    • Eski faturaları listeler.
    • Eski faturaları listeler.
    • Eski faturaları yükler.
    • Eski faturaları yükler.
    • Html dosyasını indirir.
    • Html dosyasını indirir.
    • Pdf dosyasını indirir.
    • Pdf dosyasını indirir.
    • Xml dosyasını indirir.
    • Xml dosyasını indirir.
    • Faturaları toplu olarak dışarı aktarır.
    • Faturaları toplu olarak dışarı aktarır.
    • Faturalara toplu olarak yeni durum atar.
    • Faturalara toplu olarak yeni durum atar.
  • Purchase
    • Gelen faturaları listeler.
    • Gelen faturaları listeler.
    • Html dosyasını indirir.
    • Html dosyasını indirir.
    • Pdf dosyasını indirir.
    • Pdf dosyasını indirir.
    • XML dosyasını indirir.
    • XML dosyasını indirir.
    • Faturaya etiket atama yapılır.
    • Faturaya etiket atama yapılır.
    • Faturanın etiket bilgilerini getirir.
    • Faturanın etiket bilgilerini getirir.
    • Faturanın işlem geçmişini getirir.
    • Faturanın işlem geçmişini getirir.
    • Faturanın detayını getirir.
    • Faturanın detayını getirir.
    • Fatura eklerini getirir.
    • Faturanın vergilerini getirir.
    • Faturanın irsaliye bilgisini getirir.
    • Fatura eklerini getirir.
    • Mailin işlem geçmişini getirir.
    • Faturanın irsaliye bilgisini getirir.
    • Whatsapp ın işlem geçmişini getirir.
    • Mailin işlem geçmişini getirir.
    • Sms işlem geçmişini getirir.
    • Whatsapp ın işlem geçmişini getirir.
    • Mail aktivitelerini getirir.
    • Sms işlem geçmişini getirir.
    • Faturaları toplu olarak dışarı aktarır.
    • Mail aktivitelerini getirir.
    • Faturalara toplu olarak yeni durum atar.
    • Faturaları toplu olarak dışarı aktarır.
    • Faturayı mail olarak gönderir.
    • Faturalara toplu olarak yeni durum atar.
    • Faturayı whatsapp üzerinden gönderir.
    • Faturayı mail olarak gönderir.
    • Faturayı sms olarak gönderir.
    • Faturayı whatsapp üzerinden gönderir.
    • Faturayı Gib den kontrol eder.
    • Faturayı sms olarak gönderir.
    • Faturaya ait ETTN numarası ile Zarf bilgilerini getirir.
    • Faturayı Gib den kontrol eder.
    • Gelen faturayı taslak olarak kaydeder.
    • Faturaya ait ETTN numarası ile Zarf bilgilerini getirir.
    • Faturaya yanıt verir.
    • Gelen faturayı taslak olarak kaydeder.
    • Faturanın red cevabını getirir.
    • Faturaya yanıt verir.
    • Gelen faturayı iade faturası olarak kaydeder.
    • Faturanın red cevabını getirir.
    • Faturanın statü bilgilerini getirir.
    • Gelen faturayı iade faturası olarak kaydeder.
    • Faturaya özel kod ataması yapılır.
    • Faturanın statü bilgilerini getirir.
    • Faturaya özel kod ataması yapılır.
  • Sale
    • Giden faturaları listeler.
    • Giden faturaları listeler.
    • Html dosyasını indirir.
    • Html dosyasını indirir.
    • Pdf dosyasını indirir.
    • Pdf dosyasını indirir.
    • XML dosyasını indirir.
    • XML dosyasını indirir.
    • Faturaya etiket atama yapılır.
    • Faturaya etiket atama yapılır.
    • Faturanın etiket bilgilerini getirir.
    • Faturanın etiket bilgilerini getirir.
    • Faturanın işlem geçmişini getirir.
    • Faturanın işlem geçmişini getirir.
    • Faturanın detayını getirir.
    • Faturanın detayını getirir.
    • Fatura eklerini getirir.
    • Faturanın vergilerini getirir.
    • Faturanın irsaliye bilgisini getirir.
    • Fatura eklerini getirir.
    • Mailin işlem geçmişini getirir.
    • Faturanın irsaliye bilgisini getirir.
    • Whatsapp ın işlem geçmişini getirir.
    • Mailin işlem geçmişini getirir.
    • Sms işlem geçmişini getirir.
    • Whatsapp ın işlem geçmişini getirir.
    • Mail aktivitelerini getirir.
    • Sms işlem geçmişini getirir.
    • Faturaları toplu olarak dışarı aktarır.
    • Mail aktivitelerini getirir.
    • Faturalara toplu olarak yeni durum atar.
    • Faturaları toplu olarak dışarı aktarır.
    • Faturayı mail olarak gönderir.
    • Faturalara toplu olarak yeni durum atar.
    • Faturayı whatsapp olarak gönderir.
    • Faturayı mail olarak gönderir.
    • Faturayı sms olarak gönderir.
    • Faturayı whatsapp olarak gönderir.
    • Faturayı Gtb den kontrol eder.
    • Faturayı sms olarak gönderir.
    • Faturayı Gib den kontrol eder.
    • Faturayı Gtb den kontrol eder.
    • Faturaya ait ETTN numarası ile Zarf bilgilerini getirir.
    • Faturayı Gib den kontrol eder.
    • Giden faturayı taslak olarak kaydeder.
    • Faturaya ait ETTN numarası ile Zarf bilgilerini getirir.
    • Giden faturaları toplu taslak oluşturur.
    • Giden faturayı taslak olarak kaydeder.
    • Faturanın red cevabını getirir.
    • Giden faturaları toplu taslak oluşturur.
    • Faturanın durumunu getirir.
    • Faturanın red cevabını getirir.
    • Faturaya özel kod ataması yapılır.
    • Faturanın durumunu getirir.
    • Faturaya özel kod ataması yapılır.
  • Send
    • Faturayı model olarak gönderir.
      POST
    • Faturayı model olarak gönderir.
      POST
    • Model olarak Gönderilecek faturayı ön izler.
      POST
    • Model olarak Gönderilecek faturayı ön izler.
      POST
    • Faturayı UBL-TR Xml formatında zipli yada açık halde (Xml) olarak gönderir.
      POST
    • Faturayı UBL-TR Xml formatında zipli yada açık halde (Xml) olarak gönderir.
      POST
    • Xml olarak Gönderilecek faturayı ön izler.
      POST
    • Xml olarak Gönderilecek faturayı ön izler.
      POST
    • UBL-TR Xml formatındaki faturanın zip halindeki string Base64 değeri göndermek için bu uç kullanılır.
      POST
    • UBL-TR Xml formatındaki faturanın zip halindeki string Base64 değeri göndermek için bu uç kullanılır.
      POST
    • Gönderilecek faturayı ön izler.
      POST
    • Gönderilecek faturayı ön izler.
      POST
    • Ön izlenen faturayı xml olarak indirir.
      POST
    • Ön izlenen faturayı xml olarak indirir.
      POST
    • Ön izlenen faturayı pdf olarak indirir.
      POST
    • Ön izlenen faturayı pdf olarak indirir.
      POST
  • Series
    • Serileri Listeler.
    • Serileri Listeler.
    • Yeni seri oluşturur.
    • Yeni seri oluşturur.
    • Seriyi düzenler.
    • Seriyi düzenler.
    • Serinin detayını getirir.
    • Serinin detayını getirir.
  • Statistics
    • Giden faturalarının istatistiklerini getirir.
    • Giden faturalarının istatistiklerini getirir.
    • Gelen faturalarının istatistiklerini getirir.
    • Gelen faturalarının istatistiklerini getirir.
    • Giden faturaların son 10 kaydını getirir.
    • Giden faturaların son 10 kaydını getirir.
    • Gelen faturaların son 10 kaydını getirir.
    • Gelen faturaların son 10 kaydını getirir.
  • Tags
    • Etiket listesini getirir.
    • Etiket listesini getirir.
    • Etiket oluşturur.
    • Etiket oluşturur.
    • Etiket günceller.
    • Etiket günceller.
    • Etiket silinir
    • Etiket silinir
  • Templates
    • Şablonları Listeler.
    • Şablonları Listeler.
    • Şablon oluşturur.
    • Şablon oluşturur.
    • Şablonu günceller.
    • Şablonu günceller.
    • Şablonun detayını getirir.
    • Şablonun detayını getirir.
    • Şablonu siler.
    • Şablonu siler.
    • Şablonu indirir.
    • Şablonu indirir.
  • Upload
    • Xml olarak fatura yükler.
    • Xml olarak fatura yükler.
    • SGK faturası için pdf olarak dosya yükler
    • SGK faturası için pdf olarak dosya yükler
  • Draft
    • Taslak faturaları listeler.
    • Taslak faturaları siler.
    • Html dosyasını indirir.
    • Pdf dosyasını indirir.
    • XML dosyasını indirir.
    • Model olarak indirir.
    • Taslak faturaya etiket atama yapılır.
    • Taslak faturanın etiket bilgilerini getirir.
    • Belgelerinizi toplu olarak dışarı aktarır.
    • Belgelere toplu olarak yeni durum atar.
    • Taslak faturayı onaylayıp gönderir.
    • Taslak faturayı düzenleyerek gönderir.
    • Taslak fatura oluşturur.
    • Toplu Taslak fatura oluşturur.
    • Whatsapp ın işlem geçmişini getirir.
    • Taslak faturayı whatsapp üzerinden gönderir.
    • Taslak Faturaya özel kod ataması yapılır.
  • Untitled Endpoint
    GET
  1. Send

Faturayı model olarak gönderir.

POST
https://api1.nilvera.com/einvoice/Send/Model
Send
Faturayı model olarak göndermek için bu uç kullanılır.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json
EInvoice
object (EInvoiceDto) 
optional
InvoiceInfo
object (InvoiceInfoDto) 
optional
CompanyInfo
object (PartyInfoDto) 
optional
CustomerInfo
object (PartyInfoDto) 
optional
BuyerCustomerInfo
object (PartyInfoDto) 
optional
ExportCustomerInfo
object (ExportCustomerInfoDto) 
optional
TaxFreeInfo
object (TaxFreeInfoDto) 
optional
InvoiceLines
array[object (EInvoiceLineDto) {23}]  | null 
optional
Notes
array[string] | null 
optional
CustomerAlias
string  | null 
optional
Example
{
    "EInvoice": {
        "InvoiceInfo": {
            "UUID": "b04a62e1-c90d-4b81-88f7-28eb6b8b4576",
            "TemplateUUID": "783f59a3-66b3-46b3-b402-d7fb1765474f",
            "TemplateBase64String": null,
            "InvoiceType": "SATIS",
            "InvoiceSerieOrNumber": "EFT",
            "IssueDate": "2024-10-11T11:39:39.3716578+03:00",
            "CurrencyCode": "TRY",
            "ExchangeRate": null,
            "InvoiceProfile": "TICARIFATURA",
            "DespatchDocumentReference": null,
            "OrderReference": null,
            "OrderReferenceDocument": null,
            "AdditionalDocumentReferences": null,
            "TaxExemptionReasonInfo": null,
            "PaymentTermsInfo": null,
            "PaymentMeansInfo": null,
            "OKCInfo": null,
            "ESUReportInfo": null,
            "ReturnInvoiceInfo": null,
            "AccountingCost": null,
            "InvoicePeriod": null,
            "SGKInfo": null,
            "Expenses": null,
            "LineExtensionAmount": 0,
            "GeneralKDV1Total": 0,
            "GeneralKDV8Total": 0,
            "GeneralKDV18Total": 0,
            "GeneralKDV10Total": 0,
            "GeneralKDV20Total": 0,
            "GeneralAllowanceTotal": 0,
            "PayableAmount": 0,
            "KdvTotal": 0
        },
        "CompanyInfo": {
            "TaxNumber": "6310540565",
            "Name": "Nilvera Yazılım ve Bilişim Hiz. Tic. Ltd. Şti.",
            "TaxOffice": "Erciyes",
            "PartyIdentifications": null,
            "AgentPartyIdentifications": null,
            "Address": "Adres",
            "District": "Melikgazi",
            "City": "Kayseri",
            "Country": "Türkiye",
            "PostalCode": "38038",
            "Phone": "08502514010",
            "Fax": null,
            "Mail": "info@nilvera.com",
            "WebSite": "htts://nilvera.com"
        },
        "CustomerInfo": {
            "TaxNumber": "1234567801",
            "Name": "AAA Anonim Şirketi",
            "TaxOffice": null,
            "PartyIdentifications": null,
            "AgentPartyIdentifications": null,
            "Address": "Papatya Caddesi Yasemin Sokak No21",
            "District": "Melikgazi",
            "City": "Kayseri",
            "Country": "Türkiye",
            "PostalCode": "38038",
            "Phone": null,
            "Fax": null,
            "Mail": null,
            "WebSite": null
        },
        "BuyerCustomerInfo": null,
        "ExportCustomerInfo": null,
        "TaxFreeInfo": null,
        "InvoiceLines": [
            {
                "Index": null,
                "SellerCode": null,
                "BuyerCode": null,
                "Name": "Laptop",
                "Description": null,
                "Quantity": 1,
                "UnitType": "C62",
                "Price": 100,
                "AllowanceTotal": 0,
                "KDVPercent": 18,
                "KDVTotal": 0,
                "Taxes": null,
                "DeliveryInfo": null,
                "ManufacturerCode": null,
                "BrandName": null,
                "ModelName": null,
                "Note": null,
                "SerialID": null,
                "OzelMatrahReason": null,
                "OzelMatrahTotal": null,
                "VatAmountWithoutTevkifat": null,
                "AdditionalItemIdentification": null
            }
        ],
        "Notes": [
            "Note 1",
            "Note 2"
        ]
    },
    "CustomerAlias": null
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api1.nilvera.com/einvoice/Send/Model' \
--header 'Content-Type: application/json' \
--data-raw '{
    "EInvoice": {
        "InvoiceInfo": {
            "UUID": "b04a62e1-c90d-4b81-88f7-28eb6b8b4576",
            "TemplateUUID": "783f59a3-66b3-46b3-b402-d7fb1765474f",
            "TemplateBase64String": null,
            "InvoiceType": "SATIS",
            "InvoiceSerieOrNumber": "EFT",
            "IssueDate": "2024-10-11T11:39:39.3716578+03:00",
            "CurrencyCode": "TRY",
            "ExchangeRate": null,
            "InvoiceProfile": "TICARIFATURA",
            "DespatchDocumentReference": null,
            "OrderReference": null,
            "OrderReferenceDocument": null,
            "AdditionalDocumentReferences": null,
            "TaxExemptionReasonInfo": null,
            "PaymentTermsInfo": null,
            "PaymentMeansInfo": null,
            "OKCInfo": null,
            "ESUReportInfo": null,
            "ReturnInvoiceInfo": null,
            "AccountingCost": null,
            "InvoicePeriod": null,
            "SGKInfo": null,
            "Expenses": null,
            "LineExtensionAmount": 0,
            "GeneralKDV1Total": 0,
            "GeneralKDV8Total": 0,
            "GeneralKDV18Total": 0,
            "GeneralKDV10Total": 0,
            "GeneralKDV20Total": 0,
            "GeneralAllowanceTotal": 0,
            "PayableAmount": 0,
            "KdvTotal": 0
        },
        "CompanyInfo": {
            "TaxNumber": "6310540565",
            "Name": "Nilvera Yazılım ve Bilişim Hiz. Tic. Ltd. Şti.",
            "TaxOffice": "Erciyes",
            "PartyIdentifications": null,
            "AgentPartyIdentifications": null,
            "Address": "Adres",
            "District": "Melikgazi",
            "City": "Kayseri",
            "Country": "Türkiye",
            "PostalCode": "38038",
            "Phone": "08502514010",
            "Fax": null,
            "Mail": "info@nilvera.com",
            "WebSite": "htts://nilvera.com"
        },
        "CustomerInfo": {
            "TaxNumber": "1234567801",
            "Name": "AAA Anonim Şirketi",
            "TaxOffice": null,
            "PartyIdentifications": null,
            "AgentPartyIdentifications": null,
            "Address": "Papatya Caddesi Yasemin Sokak No21",
            "District": "Melikgazi",
            "City": "Kayseri",
            "Country": "Türkiye",
            "PostalCode": "38038",
            "Phone": null,
            "Fax": null,
            "Mail": null,
            "WebSite": null
        },
        "BuyerCustomerInfo": null,
        "ExportCustomerInfo": null,
        "TaxFreeInfo": null,
        "InvoiceLines": [
            {
                "Index": null,
                "SellerCode": null,
                "BuyerCode": null,
                "Name": "Laptop",
                "Description": null,
                "Quantity": 1,
                "UnitType": "C62",
                "Price": 100,
                "AllowanceTotal": 0,
                "KDVPercent": 18,
                "KDVTotal": 0,
                "Taxes": null,
                "DeliveryInfo": null,
                "ManufacturerCode": null,
                "BrandName": null,
                "ModelName": null,
                "Note": null,
                "SerialID": null,
                "OzelMatrahReason": null,
                "OzelMatrahTotal": null,
                "VatAmountWithoutTevkifat": null,
                "AdditionalItemIdentification": null
            }
        ],
        "Notes": [
            "Note 1",
            "Note 2"
        ]
    },
    "CustomerAlias": null
}'

Responses

🟢200OK
text/plain
Faturayı model olarak gönderir
Body
UUID
string <uuid>
optional
InvoiceNumber
string  | null 
optional
Example
{
    "UUID": "0543d253-b016-4ad0-bd57-c082e62a0e6e",
    "InvoiceNumber": "EFT2024000000001"
}
🟠400Bad Request
🟠403Forbidden
🟠404Record Not Found
🟠409409
🟠422Parameter Error
Previous
Faturaya özel kod ataması yapılır.
Next
Faturayı model olarak gönderir.