Noyax’ı kendi yazılımınıza bağlayın

Noyax API ile e-ticaret siteniz, depo ya da saha yazılımınız Noyax’la doğrudan konuşur: carileri ve ürünleri okur; fatura, sipariş ve irsaliye keser; stok durumunu ve cari bakiyeleri alır.

Noyax API teknik dokümantasyonunda Cari listesi sayfası: GET /api/v1/customers uç noktası, curl isteği ve 200 yanıtının JSON gövdesi

Bir istek, bir yanıt

Bir çağrı seçin: isteği curl komutu, yanıtı Noyax’ın döndüğü JSON olarak görün. Alan adları API’dekiyle aynı, değerler örnektir.

GET /api/v1/customers

Cariler sayfa sayfa gelir, bir sayfada en çok 50 kayıt. search cari adında arar; cari kodu, vergi numarası ya da e-posta adresi tam eşleşen cariyi bulur.

İstek

curl "https://api.noyax.com/api/v1/customers?search=paketleme&pageSize=10" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "X-UserID: 12" \
  -H "X-CompanyID: 3"

Yanıt 200 OK

{
  "Success": true,
  "ResultCode": "0000",
  "Message": null,
  "Data": {
    "Page": 1,
    "PageSize": 10,
    "TotalCount": 2,
    "Items": [
      {
        "Id": "8d2f4a61-3c7e-4b19-a5d0-6e1f9b2c7a43",
        "CustomerCode": "C0042",
        "Name": "Kuzey Paketleme A.Ş.",
        "TaxNumber": "6120458731",
        "TaxOffice": "Nilüfer",
        "DueDays": 30,
        "RiskLimit": 250000
      },
      {
        "Id": "e17a0c35-92b4-4d6f-8a1e-3b5c9d0f2a68",
        "CustomerCode": "C0057",
        "Name": "Marmara Paketleme Ltd. Şti.",
        "TaxNumber": "6094127358",
        "TaxOffice": "Gebze",
        "DueDays": 45,
        "RiskLimit": 150000
      }
    ]
  }
}

GET /api/v1/stock/products/status

Ürünün eldeki miktarı, lot ve seri no dökümüyle. warehouseName verilirse yalnız o depo sayılır; ürün ID’si, kodu ya da e-ticaret koduyla sorulur.

İstek

curl "https://api.noyax.com/api/v1/stock/products/status?productCode=RLM-6205&warehouseName=Merkez%20Depo" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "X-UserID: 12" \
  -H "X-CompanyID: 3"

Yanıt 200 OK

{
  "Success": true,
  "ResultCode": "0000",
  "Message": null,
  "Data": {
    "UnitCode": "C62",
    "Quantity": 1620,
    "Lots": [
      {
        "LotNo": "LOT002917",
        "Quantity": 1180
      },
      {
        "LotNo": "LOT002921",
        "Quantity": 440
      }
    ],
    "SerialNumbers": null
  }
}

POST /api/v1/sales-invoices

Fatura, satırları ve stok hareketi tek seferde yazılır. Numara yerine “Next” gönderilince numara şirketin serisinden verilir; cari hareketi kendiliğinden oluşur.

İstek

curl -X POST "https://api.noyax.com/api/v1/sales-invoices" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "X-UserID: 12" \
  -H "X-CompanyID: 3" \
  -H "Content-Type: application/json" \
  --data '{
  "InvoiceNumber": "Next",
  "Date": "2026-11-22T10:30:00",
  "CustomerCode": "C0042",
  "Lines": [
    {
      "ProductCode": "CVT-M1040",
      "UnitCode": "C62",
      "Quantity": 200,
      "UnitPrice": 4.5,
      "CurrencyCode": "TRY",
      "ExchangeRate": 1,
      "VatRate": 20,
      "AmountExcludingTax": 900,
      "VatBase": 900,
      "VatAmount": 180,
      "AmountIncludingTax": 1080,
      "WarehouseName": "Merkez Depo"
    }
  ]
}'

Yanıt 201 Created

{
  "Success": true,
  "ResultCode": "0000",
  "Message": null,
  "Data": {
    "Id": "c41e7b20-9a5d-4f83-b6c2-0d8e3a51f794",
    "InvoiceNumber": "NYX2026000000318",
    "Date": "2026-11-22T10:30:00",
    "CustomerCode": "C0042",
    "CustomerName": "Kuzey Paketleme A.Ş.",
    "CurrencyCode": "TRY",
    "SubTotal": 900,
    "VatTotal": 180,
    "GrandTotal": 1080
  }
}

GET /api/v1/finance/customers/balances

Bakiyesi olan carilerin borcu, alacağı ve bakiyesi, döviz döviz. asOfDate ile geçmiş bir tarihteki bakiyeyi alırsınız.

İstek

curl "https://api.noyax.com/api/v1/finance/customers/balances?excludeZeroBalance=true&pageSize=2" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "X-UserID: 12" \
  -H "X-CompanyID: 3"

Yanıt 200 OK

{
  "Success": true,
  "ResultCode": "0000",
  "Message": null,
  "Data": {
    "Page": 1,
    "PageSize": 2,
    "TotalCount": 84,
    "Items": [
      {
        "CustomerId": "8d2f4a61-3c7e-4b19-a5d0-6e1f9b2c7a43",
        "CustomerCode": "C0042",
        "CustomerName": "Kuzey Paketleme A.Ş.",
        "Balances": [
          {
            "CurrencyCode": "TRY",
            "IsDefault": true,
            "Debit": 184250,
            "Credit": 151900,
            "Balance": 32350
          }
        ]
      },
      {
        "CustomerId": "e17a0c35-92b4-4d6f-8a1e-3b5c9d0f2a68",
        "CustomerCode": "C0057",
        "CustomerName": "Marmara Paketleme Ltd. Şti.",
        "Balances": [
          {
            "CurrencyCode": "TRY",
            "IsDefault": true,
            "Debit": 96400,
            "Credit": 96400,
            "Balance": 0
          },
          {
            "CurrencyCode": "EUR",
            "IsDefault": false,
            "Debit": 12400,
            "Credit": 9800,
            "Balance": 2600
          }
        ]
      }
    ]
  }
}

PATCH /api/v1/products/{productId}

Yalnız değiştirdiğiniz alanları gönderirsiniz: gönderilmeyen alan olduğu gibi kalır, null gönderilen alan temizlenir.

İstek

curl -X PATCH "https://api.noyax.com/api/v1/products/5b7e2c90-1f4d-4a86-9c3b-e2d0a7f61b58" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "X-UserID: 12" \
  -H "X-CompanyID: 3" \
  -H "Content-Type: application/json" \
  --data '{
  "ShelfNumber": "B-14",
  "Description": null
}'

Yanıt 200 OK

{
  "Success": true,
  "ResultCode": "0000",
  "Message": null,
  "Data": {
    "Id": "5b7e2c90-1f4d-4a86-9c3b-e2d0a7f61b58",
    "Code": "RLM-6205",
    "Name": "Rulman 6205-2RS",
    "UnitCode": "C62",
    "StockType": 4,
    "VatRate": 20,
    "ShelfNumber": "B-14",
    "Description": null
  }
}

Bütün uç noktalar, alanlar ve hata kodları teknik dokümantasyonda: https://apidocs.noyax.com

Her anahtar yalnız izin verdiğiniz modüllere erişir

API anahtarının her modülde ayrı okuma ve yazma yetkisi vardır: okuma GET isteklerine, yazma POST, PUT, PATCH ve DELETE isteklerine izin verir. Yetkisi olmayan modüle gelen istek reddedilir.

  • Okuma yetkisi yazmayı, yazma yetkisi okumayı kapsamaz; bir anahtar yalnız okuyabilir.
  • İstek, X-UserID ile gönderilen kullanıcı adına yapılır; kaydı kimin oluşturduğu ya da değiştirdiği uygulamada görünür.
  • Paylaşım koduyla gizlenen kayıtlar, kullanıcı onları göremiyorsa listeye gelmez.
API’deki modüller
Modül Neler yapılır
Cari Cari kartları; adresleri, telefonları, yetkilileri ve banka hesapları
Ürün Ürün kartları ve kritik stok tanımları
Fatura Alış, satış, alış iade ve satış iade faturaları
Teklif Alış ve satış teklifleri
Sipariş Alış ve satış siparişleri
İrsaliye Giriş ve çıkış irsaliyeleri
Stok Ürünün stok durumu, lot ve seri no dökümüyle (yalnız okuma)
Finans Cari hareketleri ve bakiyeleri; banka hesapları, havale, virman, açılış ve kredi kartı tahsilat fişleri
Tanım Cari ve ürün grupları, parametre tanımları, depolar ve bölümler

API’den kesilen fatura uygulamadaki kurallardan geçer

Fatura, satırları ve stok hareketi olan satırların lot ve seri no girdileri tek seferde yazılır. Herhangi biri geçersizse hiçbir şey kaydedilmez; bütün hatalar tek yanıtta, satır numarasıyla döner.

  • Numara yerine “Next” gönderirseniz numara şirketin serisinden, e-Fatura kullanıyorsanız e-Fatura ya da e-Arşiv numaralandırmasından verilir.
  • Cari koduyla ya da yalnız vergi numarası elinizdeyse onunla bulunur; adres, unvan ve vergi dairesi cariden gelir.
  • API satır tutarlarını hesaplamaz ama birbirini tuttuğunu denetler; fatura toplamları satırlardan doldurulur.
Teknik dokümantasyonda Satış faturası oluştur sayfası: POST /api/v1/sales-invoices, curl isteği ve 201 yanıtı Görseli büyütün

Hata mesajı ne olduğunu söyler

Her yanıt aynı zarfla gelir: Success, ResultCode ve Message. Başarılı istekte kod 0000’dır; hatada HTTP durumu, dört haneli kod ve açıklama birlikte döner, birden çok hata Errors listesinde tek tek yazılır.

  • Token’ın süresi dolduysa · 401

    Token has expired. Obtain a new token using the refresh token.

  • Anahtarın modülde yetkisi yoksa · 403

    You do not have permission for this operation.

  • Zorunlu header eksikse · 400

    X-UserID header is required.

  • Günlük istek hakkı bittiyse · 429

    Daily request limit (10000) exceeded.

Kalan istek hakkınız her yanıtta yazar

Her anahtarın saniyelik ve günlük bir istek hakkı vardır; aynı anahtarı kullanan bütün sunucularınız bu hakkı paylaşır. Kalan hak her yanıtın header’larında döner, günlük sayaç her gece yarısı (Türkiye saati) sıfırlanır.

  • Saniye limitine takılan istek günlük hakkınızdan düşmez.
  • Günlük hakkınız, API modülünün aldığınız kademesine göredir.
Örnek bir yanıtın header’ları
Header Anlamı Değer
X-RateLimit-Limit Saniyedeki istek limiti 50
X-RateLimit-Remaining Bu saniyede kalan 37
X-Daily-Limit Günlük istek limiti 10000
X-Daily-Remaining Bugün kalan 9874

API’nin diğer özellikleri

Sayfalama ve arama
Listeler sayfa sayfa gelir, sayfada en çok 50 kayıt. search ile cari adında arar; cari kodu, vergi numarası ya da e-posta adresi tam eşleşen cariyi bulursunuz.
Tam ve kısmi güncelleme
PUT kaydın bütün alanlarını değiştirir; PATCH ile yalnız değiştirdiğiniz alanları gönderirsiniz (JSON Merge Patch).
Şirket ve dönem
Her istek X-CompanyID ile verilen şirkette çalışır; X-PeriodID gönderirseniz yeni kayıtlar o muhasebe dönemine yazılır.
Var olan kayıt
Kodu kullanılan bir cariyi ya da ürünü yeniden eklemeye çalışırsanız yanıt, var olan kaydın ID’sini döner.
Sürümleme
Sürüm adreste yazar (/api/v1). Eskimiş sayılan bir sürüm en az 6 ay daha çalışır.
Postman koleksiyonu
Kimlik doğrulama dahil bütün uç noktalar, hazır değişkenleriyle bir Postman koleksiyonunda; içe aktarıp hemen denersiniz.

İlk isteğinizi dakikalar içinde gönderin.

Noyax API sunucudan sunucuya çalışan bir REST API’dir; istekler ve yanıtlar JSON’dur. Teknik dokümantasyon her uç noktayı alanları, örnekleri ve hata kodlarıyla anlatır; Postman koleksiyonuyla bütün uç noktaları kendi anahtarınızla denersiniz.

  1. Anahtar

    Noyax size kuruluş adınızı ve API anahtarınızı verir; anahtarın hangi modüllerde okuyup yazacağı tanımlanır.

  2. Token

    Anahtarınızla token alırsınız. Token 20 dakika geçerlidir; süresi dolunca yenileme token’ıyla yenisini alırsınız.

  3. İlk istek

    Token’ı Authorization header’ına, kullanıcıyı ve şirketi X-UserID ve X-CompanyID header’larına koyup isteği gönderirsiniz.

Yazılımınızı Noyax’a bağlayın.

14 gün ücretsiz deneyin. Kredi kartı gerekmez.