API Servisleri

Satış Siparişleri - Sales Orders

Bu API servisi Satış Siparişler bilgilerine erişmenizi sağlar. Sipariş başlık bilgileri ile sipariş kalemlerini içerir. Gelişmiş filtreleme ve dil desteği sunar.

Temel URL

Sunucu ortamına göre değişkendir: 

https://{host}/pls/{app}/products

Not: {host} ve {app} alanlarını kendi sisteminize göre güncelleyin.

İstek Metodu

GET

Sorgu Parametreleri

ParametreTipKullanımAçıklamaÖrnek
apikey string Gerekli Sisteme ait API anahtarınız xxxxxxxxxxxxxxxxxxxxxxxxxxxx
lang string İsteğe bağlı Dil kodu. Seçenekler: TR, EN, DE. Varsayılan: TR EN
productcode string İsteğe bağlı Ürün kodu veya filtreleme ifadesi A1000, A1000~GT, A1000~RNG~A3000
datebeg tarih İsteğe bağlı Sipariş kayıt tarihi başlangıç tarihi (YYYY-MM-DD) 2024-01-01
dateend tarih İsteğe bağlı Sipariş kayıt tarihi bitiş tarihi 2025-01-01
maxrec integer İsteğe bağlı Getirilecek maksimum kayıt sayısı. Varsayılan: 1000 100

productcode için Filtreleme Notasyonu

NotasyonAnlamıÖrnek
ABC123Tam eşleşmeproductcode=ABC123
ABC~LKABC ile başlayanlarproductcode=ABC~LK
ABC~NLKABC ile başlamayanlarproductcode=ABC~NLK
ABC~GTABC ile başlayanlardan büyük olanlarproductcode=ABC~GT
ABC~GTEABC ile başlayanlardan büyük veya eşit olanlarproductcode=ABC~GTE
ABC~LTABC ile başlayanlardan küçük olanlarproductcode=ABC~LT
ABC~LTEABC ile başlayanlardan küçük veya eşit olanlarproductcode=ABC~LTE
ABC~RNG~XYZABC ile XYZ başlayanların arasındakilerproductcode=ABC~RNG~XYZ
A1000,B2000,C3000Liste içindekilerproductcode=A1000,B2000

Örnek İstek

GET https://sys.nixla.com/pls/web/products?apikey=xxxxxxxxxxxxxxxxxxxxxxxxxx&lang=TR&productcode=A1000~LK

Örnek Yanıt

[
  {
    "orderID": "BH11725",
    "orderNo": " ",
    "orderDate": "2015-12-12",
    "objTypeCode": "SSL",
    "objTypeName": "Sales",
    "customerCode": "XYZ",
    "customerName": "XYZ A.Ş.",
    "items": [
      {
        "itemCode": "3100000002",
        "itemName": "Sempre İkili Kanepe",
        "uomCode": "PIECE",
        "uomName": "Adet",
        "quantity": 1,
        "currency": "TRY",
        "price": 8000,
        "amount": 8000,
        "discount": 0,
        "tax": 1440,
        "amountNet": 9440
      },
      {
        "itemCode": "3100000399",
        "itemName": "Sigma 85mm 1.4 DG HSM Art",
        "uomCode": "PIECE",
        "uomName": "Adet",
        "quantity": 3,
        "currency": "TRY",
        "price": 50,
        "amount": 150,
        "discount": 0,
        "tax": 27,
        "amountNet": 177
      }
    ]
  }]

Notlar

  • Tüm karşılaştırmalar büyük/küçük harf duyarsızdır (Oracle NLS).
  • Hiçbir parametre verilmezse, ilk 1000 kayıt döner.
  • Yanıt JSON dizisi şeklindedir, her bir nesne bir ürünü temsil eder.

Hata Kodları

  • 401 Yetkisiz - Geçersiz veya eksik API anahtarı
  • 400 Hatalı İstek - Geçersiz tarih veya filtre formatı
  • 500 Sunucu Hatası - Dahili hata

İletişim

API erişimi veya teknik destek için: support@nixla.com
Bilgi Talebi