Entegrasyon Dokümantasyonu

POST /create

Ürün Oluşturma

Toplu ürün oluşturur. Her item için barkod, isim, marka ve kategori zorunludur. Marka/kategori isimle gönderilir; sistemde yoksa firma altında oluşturulur.

Endpoint URL

POST https://pes.talazan.com.tr/api/integration/product/create

Notlar

• Aynı barkod ile aktif veya pasif ürün varsa item başarısız olur (diğer itemlar işlenmeye devam eder).
• stockCode gönderilirse firmada aynı stok koduna sahip başka ürün (aktif/pasif) varsa kayıt yapılmaz.
• images alanı resim URL listesidir.
• attributes alanı { name, value, variant } nesnelerinden oluşur. variant: true ise o özellik varyant bilgisidir (Renk, Beden); false veya gönderilmezse tekil özellik (Materyal vb.).
• groupCode: Varyantlı ürünlerde tüm varyant satırlarına aynı grup kodu gönderilir.
• variant (ürün): true veya false. Gönderilmezse false kabul edilir. true ise groupCode zorunludur.
• currency: TRY, USD veya EURO.

Örnek Request

{
  "companyCode": "FIRMA001",
  "items": [
    {
      "barcode": "8690123456789",
      "name": "Örnek Ürün",
      "description": "Ürün açıklaması",
      "brand": "Marka Adı",
      "category": "Kategori Adı",
      "desi": "2",
      "productCode": "URN-001",
      "stockCode": "STK-001",
      "groupCode": "GRUP-RENK-BEDEN-001",
      "currency": "TRY",
      "vatRate": 20,
      "variant": true,
      "images": [
        "https://cdn.example.com/img1.jpg",
        "https://cdn.example.com/img2.jpg"
      ],
      "attributes": [
        { "name": "Renk", "value": "Siyah", "variant": true },
        { "name": "Beden", "value": "M", "variant": true },
        { "name": "Materyal", "value": "Pamuk", "variant": false }
      ],
      "stockQuantity": 100,
      "salePrice": 299.99,
      "listPrice": 349.99
    }
  ]
}

Örnek Response

{
  "status": 200,
  "data": {
    "total": 1,
    "success": 1,
    "failed": 0,
    "results": [
      { "barcode": "8690123456789", "success": true, "errorCode": null, "errorMessage": null }
    ]
  },
  "errorMessage": null,
  "infoMessage": null
}