v1.0

CNT - AuthenticSeconds API Kılavuzu

Endpoint'leri Keşfet Kimlik Doğrulama

Kimlik Doğrulama

Basic Authentication

Tüm API istekleri Basic Authentication gerektirir. Kullanıcı adı ve şifrenizi base64 ile encode ederek Authorization header'ında göndermeniz gerekmektedir.

Request Header 
Authorization: Basic base64(username:password)
cURL Örneği 
curl -X GET "https://api.example.com/api/products" \
  -H "Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=" \
  -H "Content-Type: application/json"

API Endpoint'leri

📦 Ürün ve Envanter

GET /api/products

Tüm ürün master bilgilerini listeler (pagination destekli)

Query Parameters

Parametre Tip Zorunlu Açıklama
page integer Hayır Sayfa numarası (default: 1)
per_page integer Hayır Sayfa başına kayıt (default: 50, max: 100)
item_type_code string Hayır Ürün tipi filtresi

Response Örneği (200 OK)

JSON Response 
{
  "success": true,
  "data": [
    {
      "ItemTypeCode": 1,
      "ItemDimTypeCode": 2,
      "ItemCode": "SHIRT-001",
      "ItemDescription": "Polo Yaka Erkek Tişört",
      "ProductAtt01": "Pamuk",
      "ProductAtt02": "Yuvarlak Yaka",
      "ProductAtt03": "Kısa Kollu",
      "ProductAtt04": "Erkek",
      "ProductAtt05": "Casual",
      "ProductAtt06": "Türkiye",
      "ProductAtt07": "Yaz",
      "ProductAtt08": null,
      "ProductAtt09": "Premium",
      "ProductAtt10": "2024",
      "PurchasePrice": 45.50,
      "SalePrice": 89.90,
      "TaxRate": 20,
      "IsBlocked": false,
      "CreatedDate": "2024-01-15T10:30:00Z",
      "UpdatedDate": "2024-02-10T14:22:00Z",
      "Variants": [
        {
          "ColorCode": "RED",
          "ColorDescription": "Kırmızı",
          "ItemDim1Code": "M",
          "Barcode": "8690123456789"
        },
        {
          "ColorCode": "RED",
          "ColorDescription": "Kırmızı",
          "ItemDim1Code": "L",
          "Barcode": "8690123456796"
        },
        {
          "ColorCode": "BLUE",
          "ColorDescription": "Lacivert",
          "ItemDim1Code": "M",
          "Barcode": "8690123456803"
        }
      ]
    },
    {
      "ItemTypeCode": 1,
      "ItemDimTypeCode": 1,
      "ItemCode": "SCARF-001",
      "ItemDescription": "Pamuklu Eşarp",
      "ProductAtt01": "Pamuk",
      "ProductAtt02": "Dikdörtgen",
      "ProductAtt03": null,
      "ProductAtt04": "Kadın",
      "ProductAtt05": "Casual",
      "ProductAtt06": "Türkiye",
      "ProductAtt07": "Tüm Sezon",
      "ProductAtt08": null,
      "ProductAtt09": "Standard",
      "ProductAtt10": "2024",
      "PurchasePrice": 15.00,
      "SalePrice": 29.90,
      "TaxRate": 20,
      "IsBlocked": false,
      "CreatedDate": "2024-02-01T11:00:00Z",
      "UpdatedDate": "2024-02-01T11:00:00Z",
      "Variants": [
        {
          "ColorCode": "RED",
          "ColorDescription": "Kırmızı",
          "ItemDim1Code": null,
          "Barcode": "8690123456810"
        },
        {
          "ColorCode": "BLUE",
          "ColorDescription": "Mavi",
          "ItemDim1Code": null,
          "Barcode": "8690123456827"
        }
      ]
    },
    {
      "ItemTypeCode": 2,
      "ItemDimTypeCode": 0,
      "ItemCode": "FABRIC-100",
      "ItemDescription": "Pamuklu Kumaş - Beyaz - 150cm En",
      "ProductAtt01": "Pamuk",
      "ProductAtt02": "%100",
      "ProductAtt03": "150cm",
      "ProductAtt04": "Beyaz",
      "ProductAtt05": "Dokuma",
      "ProductAtt06": null,
      "ProductAtt07": null,
      "ProductAtt08": null,
      "ProductAtt09": null,
      "ProductAtt10": null,
      "PurchasePrice": 12.50,
      "SalePrice": 25.00,
      "TaxRate": 20,
      "IsBlocked": false,
      "CreatedDate": "2024-01-10T08:00:00Z",
      "UpdatedDate": "2024-01-10T08:00:00Z",
      "Variants": []
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total": 1523,
    "total_pages": 31
  }
}

Alan Açıklamaları

ItemTypeCode Değerleri
Kod Açıklama
1 Ürün
2 Malzeme
4 Masraf
5 Servis
6 Sabit Kıymet
ItemDimTypeCode Değerleri
Kod Açıklama
0 Varyantsız
1 Renk
2 Renk-Beden
GET /api/products/{id}

Belirli bir ürünün detay bilgilerini getirir

Path Parameters

Parametre Tip Zorunlu Açıklama
id string Evet Ürün kodu (ItemCode)

Response Örneği (200 OK)

JSON Response 
{
  "success": true,
  "data": {
    "ItemTypeCode": 1,
    "ItemDimTypeCode": 2,
    "ItemCode": "SHIRT-001",
    "ItemDescription": "Polo Yaka Erkek Tişört",
    "ProductAtt01": "Pamuk",
    "ProductAtt02": "Yuvarlak Yaka",
    "ProductAtt03": "Kısa Kollu",
    "ProductAtt04": "Erkek",
    "ProductAtt05": "Casual",
    "ProductAtt06": "Türkiye",
    "ProductAtt07": "Yaz",
    "ProductAtt08": null,
    "ProductAtt09": "Premium",
    "ProductAtt10": "2024",
    "PurchasePrice": 45.50,
    "SalePrice": 89.90,
    "TaxRate": 20,
    "IsBlocked": false,
    "CreatedDate": "2024-01-15T10:30:00Z",
    "UpdatedDate": "2024-02-10T14:22:00Z",
    "Variants": [
      {
        "ColorCode": "RED",
        "ColorDescription": "Kırmızı",
        "ItemDim1Code": "M",
        "Barcode": "8690123456789"
      },
      {
        "ColorCode": "RED",
        "ColorDescription": "Kırmızı",
        "ItemDim1Code": "L",
        "Barcode": "8690123456796"
      },
      {
        "ColorCode": "BLUE",
        "ColorDescription": "Lacivert",
        "ItemDim1Code": "M",
        "Barcode": "8690123456803"
      }
    ]
  }
}

Alan Açıklamaları

ItemTypeCode Değerleri
Kod Açıklama
1 Ürün
2 Malzeme
4 Masraf
5 Servis
6 Sabit Kıymet
ItemDimTypeCode Değerleri
Kod Açıklama
0 Varyantsız
1 Renk
2 Renk-Beden

🏭 Tedarik & Müşteri Yönetimi

GET /api/suppliers

Tüm tedarikçileri listeler (pagination destekli)

Query Parameters

Parametre Tip Zorunlu Açıklama
page integer Hayır Sayfa numarası (default: 1)
per_page integer Hayır Sayfa başına kayıt (default: 50, max: 100)

Response Örneği (200 OK)

JSON Response 
{
  "success": true,
  "data": [
    {
      "CurrAccTypeCode": 1,
      "CurrAccCode": "1-1-117",
      "CurrAccDescription": "ABC Tekstil San. ve Tic. A.Ş.",
      "OfficeCode": "IST-01",
      "IsIndividualAcc": false,
      "IdentityNum": null,
      "TaxNumber": "1234567890",
      "Communications": [
        {
          "CommunicationTypeCode": 3,
          "CommAddress": "info@abctekstil.com.tr"
        },
        {
          "CommunicationTypeCode": 7,
          "CommAddress": "+905321234567"
        }
      ]
    },
    {
      "CurrAccTypeCode": 1,
      "CurrAccCode": "1-1-245",
      "CurrAccDescription": "XYZ Kimya Ltd. Şti.",
      "OfficeCode": "IST-01",
      "IsIndividualAcc": false,
      "IdentityNum": null,
      "TaxNumber": "9876543210",
      "Communications": [
        {
          "CommunicationTypeCode": 3,
          "CommAddress": "satis@xyzkimya.com"
        },
        {
          "CommunicationTypeCode": 7,
          "CommAddress": "+905439876543"
        }
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total": 287,
    "total_pages": 6
  }
}

Alan Açıklamaları

CurrAccTypeCode Değeri
Kod Açıklama
1 Tedarikçi
CommunicationTypeCode Değerleri
Kod Açıklama
3 E-posta
7 GSM
GET /api/customers/wholesale

Toptan müşterileri listeler (pagination destekli)

Query Parameters

Parametre Tip Zorunlu Açıklama
page integer Hayır Sayfa numarası (default: 1)
per_page integer Hayır Sayfa başına kayıt (default: 50, max: 100)

Response Örneği (200 OK)

JSON Response 
{
  "success": true,
  "data": [
    {
      "CurrAccTypeCode": 3,
      "CurrAccCode": "1-3-46",
      "CurrAccDescription": "Moda Dünyası Giyim Tic. Ltd. Şti.",
      "OfficeCode": "ANK-01",
      "IsIndividualAcc": false,
      "IdentityNum": null,
      "TaxNumber": "5551234567",
      "Communications": [
        {
          "CommunicationTypeCode": 3,
          "CommAddress": "siparis@modadunyasi.com.tr"
        },
        {
          "CommunicationTypeCode": 7,
          "CommAddress": "+905551234567"
        }
      ]
    },
    {
      "CurrAccTypeCode": 3,
      "CurrAccCode": "1-3-89",
      "CurrAccDescription": "Trend Mağazacılık A.Ş.",
      "OfficeCode": "IZM-01",
      "IsIndividualAcc": false,
      "IdentityNum": null,
      "TaxNumber": "7778889990",
      "Communications": [
        {
          "CommunicationTypeCode": 3,
          "CommAddress": "alisveris@trendmag.com"
        },
        {
          "CommunicationTypeCode": 7,
          "CommAddress": "+905447778889"
        }
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total": 142,
    "total_pages": 3
  }
}

Alan Açıklamaları

CurrAccTypeCode Değeri
Kod Açıklama
3 Toptan Müşteri
CommunicationTypeCode Değerleri
Kod Açıklama
3 E-posta
7 GSM
GET /api/customers/retail

Perakende müşterileri listeler (pagination destekli)

Query Parameters

Parametre Tip Zorunlu Açıklama
page integer Hayır Sayfa numarası (default: 1)
per_page integer Hayır Sayfa başına kayıt (default: 50, max: 100)

Response Örneği (200 OK)

JSON Response 
{
  "success": true,
  "data": [
    {
      "CurrAccTypeCode": 4,
      "CurrAccCode": "1-4-159",
      "CurrAccDescription": "Ahmet Yılmaz",
      "OfficeCode": "IST-02",
      "IsIndividualAcc": true,
      "IdentityNum": "12345678901",
      "TaxNumber": null,
      "Communications": [
        {
          "CommunicationTypeCode": 3,
          "CommAddress": "ahmet.yilmaz@gmail.com"
        },
        {
          "CommunicationTypeCode": 7,
          "CommAddress": "+905321112233"
        }
      ]
    },
    {
      "CurrAccTypeCode": 4,
      "CurrAccCode": "1-4-267",
      "CurrAccDescription": "Ayşe Demir",
      "OfficeCode": "IST-02",
      "IsIndividualAcc": true,
      "IdentityNum": "98765432109",
      "TaxNumber": null,
      "Communications": [
        {
          "CommunicationTypeCode": 3,
          "CommAddress": "ayse.demir@hotmail.com"
        },
        {
          "CommunicationTypeCode": 7,
          "CommAddress": "+905439998877"
        }
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total": 3456,
    "total_pages": 70
  }
}

Alan Açıklamaları

CurrAccTypeCode Değeri
Kod Açıklama
4 Perakende Müşteri
CommunicationTypeCode Değerleri
Kod Açıklama
3 E-posta
7 GSM
Önemli Notlar

IsIndividualAcc: Bireysel müşteriler için true, kurumsal müşteriler için false

IdentityNum: Bireysel müşteriler için TC Kimlik No

TaxNumber: Kurumsal müşteriler için Vergi Numarası

GET /api/customers/{id}

Belirli bir müşteri/tedarikçinin detay bilgilerini getirir

Path Parameters

Parametre Tip Zorunlu Açıklama
id string Evet Cari hesap kodu (CurrAccCode)

Response Örneği (200 OK)

JSON Response 
{
  "success": true,
  "data": {
    "CurrAccTypeCode": 3,
    "CurrAccCode": "1-3-46",
    "CurrAccDescription": "Moda Dünyası Giyim Tic. Ltd. Şti.",
    "OfficeCode": "ANK-01",
    "IsIndividualAcc": false,
    "IdentityNum": null,
    "TaxNumber": "5551234567",
    "Communications": [
      {
        "CommunicationTypeCode": 3,
        "CommAddress": "siparis@modadunyasi.com.tr"
      },
      {
        "CommunicationTypeCode": 7,
        "CommAddress": "+905551234567"
      }
    ]
  }
}

Alan Açıklamaları

CurrAccTypeCode Değerleri
Kod Açıklama
1 Tedarikçi
3 Toptan Müşteri
4 Perakende Müşteri
CommunicationTypeCode Değerleri
Kod Açıklama
3 E-posta
7 GSM

🛒 Satın Alma

GET /api/purchase-orders

Satın alma siparişlerini listeler (pagination destekli)

Query Parameters

Parametre Tip Zorunlu Açıklama
page integer Hayır Sayfa numarası (default: 1)
per_page integer Hayır Sayfa başına kayıt (default: 50, max: 100)
order_date_start date Hayır Başlangıç tarihi filtresi (YYYY-MM-DD)
order_date_end date Hayır Bitiş tarihi filtresi (YYYY-MM-DD)

Response Örneği (200 OK)

JSON Response 
{
  "success": true,
  "data": [
    {
      "OrderNumber": "1-BP-2-123",
      "OrderDate": "2024-02-15",
      "DocumentNumber": "SAT-2024-156",
      "SupplierCode": "1-1-117",
      "ProcessCode": "BP",
      "Description": "Ilkbahar Koleksiyonu Kumaş Alışı",
      "InternalDescription": "Acil sipariş - üretim için gerekli",
      "TaxTypeCode": 0,
      "OfficeCode": "IST-01",
      "WarehouseCode": "WH-MAIN",
      "DocCurrencyCode": "TRY",
      "Lines": [
        {
          "ItemTypeCode": 1,
          "ItemCode": "FABRIC-100",
          "ColorCode": null,
          "ItemDim1Code": null,
          "Qty1": 500.00,
          "NetAmount": 6250.00
        },
        {
          "ItemTypeCode": 1,
          "ItemCode": "FABRIC-205",
          "ColorCode": "BLUE",
          "ItemDim1Code": null,
          "Qty1": 350.00,
          "NetAmount": 5250.00
        }
      ]
    },
    {
      "OrderNumber": "1-IP-2-458",
      "OrderDate": "2024-02-16",
      "DocumentNumber": "SAT-2024-157",
      "SupplierCode": "1-1-245",
      "ProcessCode": "IP",
      "Description": "İthalat - Özel Boya Malzemeleri",
      "InternalDescription": "Gümrük işlemleri devam ediyor",
      "TaxTypeCode": 0,
      "OfficeCode": "IST-01",
      "WarehouseCode": "WH-IMPORT",
      "DocCurrencyCode": "USD",
      "Lines": [
        {
          "ItemTypeCode": 1,
          "ItemCode": "DYE-450",
          "ColorCode": "RED",
          "ItemDim1Code": null,
          "Qty1": 100.00,
          "NetAmount": 1500.00
        },
        {
          "ItemTypeCode": 1,
          "ItemCode": "DYE-451",
          "ColorCode": "BLUE",
          "ItemDim1Code": null,
          "Qty1": 150.00,
          "NetAmount": 2250.00
        },
        {
          "ItemTypeCode": 1,
          "ItemCode": "DYE-452",
          "ColorCode": "GREEN",
          "ItemDim1Code": null,
          "Qty1": 80.00,
          "NetAmount": 1200.00
        }
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total": 458,
    "total_pages": 10
  }
}

Alan Açıklamaları

ProcessCode Değerleri
Kod Açıklama
BP Toptan Alış
CP Konsinye Alış
CS Konsinye Satış
DS Bayi Satış
EP Masraf Alış
ES İhracat
EXS Masraf Satış
FAP Sabit Kıymet Alış
FAS Sabit Kıymet Satışı
IP İthalat
R Peşin Satış
RFS Mağazadan Ürün Talep
RI Taksitli Satış
RSD Perakende Sonra Teslim
S Mağazaya Transfer
SS Servis Satış
WS Toptan Satış
TaxTypeCode Değerleri
Kod Açıklama
0 Standart
1 Tevkifatlı
2 Tax Free (Tax Refund)
3 Diplomatik
4 Vergisiz
5 Alınan Serbest Meslek Makbuzu
6 Vat Off
Lines Dizisi

Lines: Sipariş kalemlerini içeren array. Her kalem için ürün bilgileri, miktar ve tutar bilgileri yer alır.

ColorCode & ItemDim1Code: Ürün varyantı yoksa (ItemDimTypeCode=0) bu alanlar null gelir.

GET /api/purchase-invoices

Satın alma faturalarını listeler (pagination ve tarih filtreleme destekli)

Query Parameters

Parametre Tip Zorunlu Açıklama
page integer Hayır Sayfa numarası (default: 1)
per_page integer Hayır Sayfa başına kayıt (default: 50, max: 100)
invoice_date_start date Hayır Fatura başlangıç tarihi (YYYY-MM-DD)
invoice_date_end date Hayır Fatura bitiş tarihi (YYYY-MM-DD)

Response Örneği (200 OK)

JSON Response 
{
  "success": true,
  "data": [
    {
      "InvoiceNumber": "1-BP-7-345",
      "InvoiceDate": "2024-02-18",
      "DocumentNumber": "SAT-FAT-2024-345",
      "SupplierCode": "1-1-117",
      "ProcessCode": "BP",
      "Description": "İlkbahar Koleksiyonu Kumaş Alışı - Fatura",
      "InternalDescription": "Sipariş 1-BP-2-123'e ait fatura",
      "TaxTypeCode": 0,
      "OfficeCode": "IST-01",
      "WarehouseCode": "WH-MAIN",
      "DocCurrencyCode": "TRY",
      "Lines": [
        {
          "ItemTypeCode": 1,
          "ItemCode": "FABRIC-100",
          "ColorCode": null,
          "ItemDim1Code": null,
          "Qty1": 500.00,
          "NetAmount": 6250.00
        },
        {
          "ItemTypeCode": 1,
          "ItemCode": "FABRIC-205",
          "ColorCode": "BLUE",
          "ItemDim1Code": null,
          "Qty1": 350.00,
          "NetAmount": 5250.00
        }
      ]
    },
    {
      "InvoiceNumber": "1-IP-7-892",
      "InvoiceDate": "2024-02-20",
      "DocumentNumber": "SAT-FAT-2024-892",
      "SupplierCode": "1-1-245",
      "ProcessCode": "IP",
      "Description": "İthalat - Özel Boya Malzemeleri - Fatura",
      "InternalDescription": "Gümrük işlemleri tamamlandı",
      "TaxTypeCode": 0,
      "OfficeCode": "IST-01",
      "WarehouseCode": "WH-IMPORT",
      "DocCurrencyCode": "USD",
      "Lines": [
        {
          "ItemTypeCode": 1,
          "ItemCode": "DYE-450",
          "ColorCode": "RED",
          "ItemDim1Code": null,
          "Qty1": 100.00,
          "NetAmount": 1500.00
        },
        {
          "ItemTypeCode": 1,
          "ItemCode": "DYE-451",
          "ColorCode": "BLUE",
          "ItemDim1Code": null,
          "Qty1": 150.00,
          "NetAmount": 2250.00
        },
        {
          "ItemTypeCode": 1,
          "ItemCode": "DYE-452",
          "ColorCode": "GREEN",
          "ItemDim1Code": null,
          "Qty1": 80.00,
          "NetAmount": 1200.00
        }
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total": 1247,
    "total_pages": 25
  }
}

Alan Açıklamaları

ProcessCode Değerleri
Kod Açıklama
BP Toptan Alış (Buy Purchase)
CP Konsinye Alış (Consignment Purchase)
IP İthalat (Import)
CR Konsinye İade
D Dağıtım
EP İhracat (Export)
FS Mağazadan Ürün İadesi
I Dahili Transfer
MP Üretim
P Üretim (Production)
PRP Promosyon Ürünleri
R Peşin Satış
RFS Mağazadan Ürün Talep
RI Taksitli Satış
RSD Perakende Sonra Teslim
S Mağazaya Transfer
SS Servis Satış
WS Toptan Satış
TaxTypeCode Değerleri
Kod Açıklama
0 Standart
1 Tevkifatlı
2 Tax Free
3 İhraç Kayıtlı
4 Diplomatik
5 Geçici İthalat

📦 Depo & Envanter

GET /api/warehouses

Tüm depoları listeler (ofis, mağaza ve depo hiyerarşisi ile)

Query Parameters

Parametre Tip Zorunlu Açıklama
page integer Hayır Sayfa numarası (default: 1)
per_page integer Hayır Sayfa başına kayıt (default: 50, max: 100)

Response Örneği (200 OK)

JSON Response 
{
  "success": true,
  "data": [
    {
      "OfficeCode": "IST-01",
      "OfficeDescription": "İstanbul Merkez Ofis",
      "StoreCode": "IST-M-01",
      "StoreDescription": "Bağdat Caddesi Mağazası",
      "WarehouseCode": "WH-IST-M01-MAIN",
      "WarehouseDescription": "Ana Depo"
    },
    {
      "OfficeCode": "IST-01",
      "OfficeDescription": "İstanbul Merkez Ofis",
      "StoreCode": "IST-M-01",
      "StoreDescription": "Bağdat Caddesi Mağazası",
      "WarehouseCode": "WH-IST-M01-BACK",
      "WarehouseDescription": "Arka Depo"
    },
    {
      "OfficeCode": "IST-01",
      "OfficeDescription": "İstanbul Merkez Ofis",
      "StoreCode": "IST-W-01",
      "StoreDescription": "Toptan Satış Deposu",
      "WarehouseCode": "WH-IST-W01-MAIN",
      "WarehouseDescription": "Toptan Ana Depo"
    },
    {
      "OfficeCode": "ANK-01",
      "OfficeDescription": "Ankara Bölge Ofisi",
      "StoreCode": "ANK-M-01",
      "StoreDescription": "Tunalı Hilmi Mağazası",
      "WarehouseCode": "WH-ANK-M01-MAIN",
      "WarehouseDescription": "Ana Depo"
    },
    {
      "OfficeCode": "IZM-01",
      "OfficeDescription": "İzmir Bölge Ofisi",
      "StoreCode": "",
      "StoreDescription": "",
      "WarehouseCode": "WH-IZM-CENTRAL",
      "WarehouseDescription": "Merkezi Depo"
    },
    {
      "OfficeCode": "IST-01",
      "OfficeDescription": "İstanbul Merkez Ofis",
      "StoreCode": "IST-F-01",
      "StoreDescription": "Merkez Fabrika",
      "WarehouseCode": "WH-IST-F01-RAW",
      "WarehouseDescription": "Hammadde Deposu"
    },
    {
      "OfficeCode": "BRS-01",
      "OfficeDescription": "Bursa Bölge Ofisi",
      "StoreCode": "",
      "StoreDescription": "",
      "WarehouseCode": "WH-BRS-MAIN",
      "WarehouseDescription": "Ana Depo"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total": 47,
    "total_pages": 1
  }
}
GET /api/inventory

Tüm envanter kayıtlarını listeler (pagination destekli)

Query Parameters

Parametre Tip Zorunlu Açıklama
page integer Hayır Sayfa numarası (default: 1)
per_page integer Hayır Sayfa başına kayıt (default: 50, max: 100)
warehouse_code string Hayır Belirli bir depoya göre filtrele

Response Örneği (200 OK)

JSON Response 
{
  "success": true,
  "data": [
    {
      "OfficeCode": "IST-01",
      "StoreCode": "IST-M-01",
      "WarehouseCode": "WH-IST-M01-MAIN",
      "ItemTypeCode": 1,
      "ItemCode": "SHIRT-001",
      "ColorCode": "RED",
      "ItemDim1Code": "M",
      "InventoryQty1": 45
    },
    {
      "OfficeCode": "IST-01",
      "StoreCode": "IST-M-01",
      "WarehouseCode": "WH-IST-M01-MAIN",
      "ItemTypeCode": 1,
      "ItemCode": "SHIRT-001",
      "ColorCode": "RED",
      "ItemDim1Code": "L",
      "InventoryQty1": 32
    },
    {
      "OfficeCode": "IST-01",
      "StoreCode": "IST-M-01",
      "WarehouseCode": "WH-IST-M01-MAIN",
      "ItemTypeCode": 1,
      "ItemCode": "SHIRT-001",
      "ColorCode": "BLUE",
      "ItemDim1Code": "M",
      "InventoryQty1": 28
    },
    {
      "OfficeCode": "ANK-01",
      "StoreCode": "ANK-M-01",
      "WarehouseCode": "WH-ANK-M01-MAIN",
      "ItemTypeCode": 1,
      "ItemCode": "SCARF-001",
      "ColorCode": "PINK",
      "ItemDim1Code": null,
      "InventoryQty1": 67
    },
    {
      "OfficeCode": "IZM-01",
      "StoreCode": "",
      "WarehouseCode": "WH-IZM-CENTRAL",
      "ItemTypeCode": 1,
      "ItemCode": "FABRIC-100",
      "ColorCode": null,
      "ItemDim1Code": null,
      "InventoryQty1": 1250
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total": 8742,
    "total_pages": 175
  }
}
GET /api/inventory/{ItemCode}

Belirli bir ürüne ait tüm depolardaki envanter bilgilerini getirir

Path Parameters

Parametre Tip Zorunlu Açıklama
ItemCode string Evet Ürün kodu

Response Örneği (200 OK)

JSON Response 
{
  "success": true,
  "data": [
    {
      "OfficeCode": "IST-01",
      "StoreCode": "IST-M-01",
      "WarehouseCode": "WH-IST-M01-MAIN",
      "ItemTypeCode": 1,
      "ItemCode": "SHIRT-001",
      "ColorCode": "RED",
      "ItemDim1Code": "M",
      "InventoryQty1": 45
    },
    {
      "OfficeCode": "IST-01",
      "StoreCode": "IST-M-01",
      "WarehouseCode": "WH-IST-M01-MAIN",
      "ItemTypeCode": 1,
      "ItemCode": "SHIRT-001",
      "ColorCode": "RED",
      "ItemDim1Code": "L",
      "InventoryQty1": 32
    },
    {
      "OfficeCode": "IST-01",
      "StoreCode": "IST-M-01",
      "WarehouseCode": "WH-IST-M01-MAIN",
      "ItemTypeCode": 1,
      "ItemCode": "SHIRT-001",
      "ColorCode": "BLUE",
      "ItemDim1Code": "M",
      "InventoryQty1": 28
    },
    {
      "OfficeCode": "IST-01",
      "StoreCode": "IST-M-01",
      "WarehouseCode": "WH-IST-M01-BACK",
      "ItemTypeCode": 1,
      "ItemCode": "SHIRT-001",
      "ColorCode": "RED",
      "ItemDim1Code": "M",
      "InventoryQty1": 12
    },
    {
      "OfficeCode": "ANK-01",
      "StoreCode": "ANK-M-01",
      "WarehouseCode": "WH-ANK-M01-MAIN",
      "ItemTypeCode": 1,
      "ItemCode": "SHIRT-001",
      "ColorCode": "RED",
      "ItemDim1Code": "M",
      "InventoryQty1": 18
    },
    {
      "OfficeCode": "ANK-01",
      "StoreCode": "ANK-M-01",
      "WarehouseCode": "WH-ANK-M01-MAIN",
      "ItemTypeCode": 1,
      "ItemCode": "SHIRT-001",
      "ColorCode": "RED",
      "ItemDim1Code": "L",
      "InventoryQty1": 15
    }
  ]
}

💰 Satış

GET /api/sales-orders

Satış siparişlerini listeler (perakende ve toptan)

Query Parameters

Parametre Tip Zorunlu Açıklama
page integer Hayır Sayfa numarası (default: 1)
per_page integer Hayır Sayfa başına kayıt (default: 50, max: 100)
order_date_start date Hayır Sipariş başlangıç tarihi (YYYY-MM-DD)
order_date_end date Hayır Sipariş bitiş tarihi (YYYY-MM-DD)
process_code string Hayır Süreç koduna göre filtrele (WS, R, RI, RSD, EP, SS)

Response Örneği (200 OK)

JSON Response 
{
  "success": true,
  "data": [
    {
      "OrderNumber": "1-WS-2-567",
      "OrderDate": "2024-02-15",
      "DocumentNumber": "SAT-SIP-2024-567",
      "CustomerCode": "1-3-892",
      "ProcessCode": "WS",
      "Description": "Bahar Koleksiyonu Toptan Sipariş",
      "InternalDescription": "Bayilik anlaşması kapsamında",
      "TaxTypeCode": 0,
      "OfficeCode": "IST-01",
      "WarehouseCode": "WH-IST-W01-MAIN",
      "DocCurrencyCode": "TRY",
      "Lines": [
        {
          "ItemTypeCode": 1,
          "ItemCode": "SHIRT-001",
          "ColorCode": "RED",
          "ItemDim1Code": "M",
          "Qty1": 50,
          "NetAmount": 12500.00
        },
        {
          "ItemTypeCode": 1,
          "ItemCode": "SHIRT-001",
          "ColorCode": "RED",
          "ItemDim1Code": "L",
          "Qty1": 75,
          "NetAmount": 18750.00
        },
        {
          "ItemTypeCode": 1,
          "ItemCode": "SHIRT-001",
          "ColorCode": "BLUE",
          "ItemDim1Code": "M",
          "Qty1": 60,
          "NetAmount": 15000.00
        }
      ]
    },
    {
      "OrderNumber": "1-R-2-1243",
      "OrderDate": "2024-02-16",
      "DocumentNumber": "MAG-SIP-2024-1243",
      "CustomerCode": "1-4-45621",
      "ProcessCode": "R",
      "Description": "Perakende Satış - Bağdat Caddesi Mağazası",
      "InternalDescription": "Nakit ödeme",
      "TaxTypeCode": 0,
      "OfficeCode": "IST-01",
      "WarehouseCode": "WH-IST-M01-MAIN",
      "DocCurrencyCode": "TRY",
      "Lines": [
        {
          "ItemTypeCode": 1,
          "ItemCode": "SHIRT-001",
          "ColorCode": "RED",
          "ItemDim1Code": "M",
          "Qty1": 1,
          "NetAmount": 299.00
        },
        {
          "ItemTypeCode": 1,
          "ItemCode": "SCARF-001",
          "ColorCode": "PINK",
          "ItemDim1Code": null,
          "Qty1": 2,
          "NetAmount": 398.00
        }
      ]
    },
    {
      "OrderNumber": "1-RI-2-3421",
      "OrderDate": "2024-02-16",
      "DocumentNumber": "MAG-TAK-2024-3421",
      "CustomerCode": "1-4-78934",
      "ProcessCode": "RI",
      "Description": "Taksitli Satış - 6 Ay Vade",
      "InternalDescription": "Kredi kartı ile 6 taksit",
      "TaxTypeCode": 0,
      "OfficeCode": "ANK-01",
      "WarehouseCode": "WH-ANK-M01-MAIN",
      "DocCurrencyCode": "TRY",
      "Lines": [
        {
          "ItemTypeCode": 1,
          "ItemCode": "JACKET-005",
          "ColorCode": "BLACK",
          "ItemDim1Code": "L",
          "Qty1": 1,
          "NetAmount": 1299.00
        }
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total": 3847,
    "total_pages": 77
  }
}

Alan Açıklamaları

ProcessCode Değerleri (Satış)
Kod Açıklama
WS Toptan Satış (Wholesale)
R Peşin Satış (Retail - Perakende)
RI Taksitli Satış (Retail Installment)
RSD Perakende Sonra Teslim
EP İhracat (Export)
SS Servis Satış
TaxTypeCode Değerleri
Kod Açıklama
0 Standart
1 Tevkifatlı
2 Tax Free
3 İhraç Kayıtlı
4 Diplomatik
5 Geçici İthalat
GET /api/sales-invoices

Satış faturalarını listeler (perakende ve toptan)

Query Parameters

Parametre Tip Zorunlu Açıklama
page integer Hayır Sayfa numarası (default: 1)
per_page integer Hayır Sayfa başına kayıt (default: 50, max: 100)
invoice_date_start date Hayır Fatura başlangıç tarihi (YYYY-MM-DD)
invoice_date_end date Hayır Fatura bitiş tarihi (YYYY-MM-DD)
process_code string Hayır Süreç koduna göre filtrele (WS, R, RI, RSD, EP, SS)

Response Örneği (200 OK)

JSON Response 
{
  "success": true,
  "data": [
    {
      "InvoiceNumber": "1-WS-7-892",
      "InvoiceDate": "2024-02-18",
      "DocumentNumber": "SAT-FAT-2024-892",
      "CustomerCode": "1-3-892",
      "ProcessCode": "WS",
      "Description": "Bahar Koleksiyonu Toptan Fatura",
      "InternalDescription": "Sipariş 1-WS-2-567'ye ait fatura",
      "TaxTypeCode": 0,
      "OfficeCode": "IST-01",
      "WarehouseCode": "WH-IST-W01-MAIN",
      "DocCurrencyCode": "TRY",
      "Lines": [
        {
          "ItemTypeCode": 1,
          "ItemCode": "SHIRT-001",
          "ColorCode": "RED",
          "ItemDim1Code": "M",
          "Qty1": 50,
          "NetAmount": 12500.00
        },
        {
          "ItemTypeCode": 1,
          "ItemCode": "SHIRT-001",
          "ColorCode": "RED",
          "ItemDim1Code": "L",
          "Qty1": 75,
          "NetAmount": 18750.00
        },
        {
          "ItemTypeCode": 1,
          "ItemCode": "SHIRT-001",
          "ColorCode": "BLUE",
          "ItemDim1Code": "M",
          "Qty1": 60,
          "NetAmount": 15000.00
        }
      ]
    },
    {
      "InvoiceNumber": "1-R-7-4521",
      "InvoiceDate": "2024-02-16",
      "DocumentNumber": "MAG-FAT-2024-4521",
      "CustomerCode": "1-4-45621",
      "ProcessCode": "R",
      "Description": "Perakende Satış Faturası",
      "InternalDescription": "Nakit ödeme tamamlandı",
      "TaxTypeCode": 0,
      "OfficeCode": "IST-01",
      "WarehouseCode": "WH-IST-M01-MAIN",
      "DocCurrencyCode": "TRY",
      "Lines": [
        {
          "ItemTypeCode": 1,
          "ItemCode": "SHIRT-001",
          "ColorCode": "RED",
          "ItemDim1Code": "M",
          "Qty1": 1,
          "NetAmount": 299.00
        },
        {
          "ItemTypeCode": 1,
          "ItemCode": "SCARF-001",
          "ColorCode": "PINK",
          "ItemDim1Code": null,
          "Qty1": 2,
          "NetAmount": 398.00
        }
      ]
    },
    {
      "InvoiceNumber": "1-RI-7-8934",
      "InvoiceDate": "2024-02-16",
      "DocumentNumber": "MAG-FAT-TAK-2024-8934",
      "CustomerCode": "1-4-78934",
      "ProcessCode": "RI",
      "Description": "Taksitli Satış Faturası - 6 Ay",
      "InternalDescription": "6 taksit - Kredi kartı",
      "TaxTypeCode": 0,
      "OfficeCode": "ANK-01",
      "WarehouseCode": "WH-ANK-M01-MAIN",
      "DocCurrencyCode": "TRY",
      "Lines": [
        {
          "ItemTypeCode": 1,
          "ItemCode": "JACKET-005",
          "ColorCode": "BLACK",
          "ItemDim1Code": "L",
          "Qty1": 1,
          "NetAmount": 1299.00
        }
      ]
    },
    {
      "InvoiceNumber": "1-EP-7-234",
      "InvoiceDate": "2024-02-20",
      "DocumentNumber": "EXP-FAT-2024-234",
      "CustomerCode": "1-3-1456",
      "ProcessCode": "EP",
      "Description": "İhracat Faturası - Almanya",
      "InternalDescription": "Export - Germany shipment",
      "TaxTypeCode": 3,
      "OfficeCode": "IST-01",
      "WarehouseCode": "WH-IST-W01-MAIN",
      "DocCurrencyCode": "EUR",
      "Lines": [
        {
          "ItemTypeCode": 1,
          "ItemCode": "SHIRT-001",
          "ColorCode": "RED",
          "ItemDim1Code": "M",
          "Qty1": 200,
          "NetAmount": 4000.00
        },
        {
          "ItemTypeCode": 1,
          "ItemCode": "SHIRT-001",
          "ColorCode": "BLUE",
          "ItemDim1Code": "M",
          "Qty1": 150,
          "NetAmount": 3000.00
        }
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total": 4521,
    "total_pages": 91
  }
}

Alan Açıklamaları

ProcessCode Değerleri (Satış)
Kod Açıklama
WS Toptan Satış (Wholesale)
R Peşin Satış (Retail - Perakende)
RI Taksitli Satış (Retail Installment)
RSD Perakende Sonra Teslim
EP İhracat (Export)
SS Servis Satış
TaxTypeCode Değerleri
Kod Açıklama
0 Standart
1 Tevkifatlı
2 Tax Free
3 İhraç Kayıtlı
4 Diplomatik
5 Geçici İthalat