Ürün/Hizmet Oluşturma

Yeni ürün/hizmet kaydı oluşturma.

Endpoint

POST /kolaybi/v1/products

Parametreler

Parametre	Tip	Zorunlu	Açıklama
name	string	Evet	Ürün adı
code	string	Hayır	Ürün kodu
barcode	string	Hayır	Barkod numarası
description	string	Hayır	Ürün açıklaması
product_type	ProductType	Hayır	Varsayılan good
vat_rate	VATRate	Hayır	Varsayılan 20
price	number	Hayır	Satış fiyatı
price_currency	Currency	Hayır	Fiyat para birimi
quantity	number	Hayır	İlk stok miktarı (varsayılan: 0)
discount_type	string	Hayır	percentage (varsayılan) veya numeric
discount_value	number	Hayır	İndirim yüzdesi ya da tutarı
tags	array	Hayır	Ürün etiket ID'leri (tags[0], tags[1])

Örnekler

cURL

# Temel ürün oluşturma
curl -X POST "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/products" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Channel: YOUR_CHANNEL" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "name=Test Ürün"

# Detaylı ürün oluşturma
curl -X POST "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/products" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Channel: YOUR_CHANNEL" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "name=Test Ürün&code=URN001&barcode=1234567890&product_type=good&vat_rate=20&price=100.00&price_currency=try&quantity=50"

JavaScript

async function createProduct(data) {
  const formData = new URLSearchParams(data);

  const response = await fetch(
    "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/products",
    {
      method: "POST",
      headers: {
        Authorization: `Bearer ${accessToken}`,
        Channel: channel,
        "Content-Type": "application/x-www-form-urlencoded",
      },
      body: formData,
    }
  );

  return await response.json();
}

// Temel kullanım
const product = await createProduct({
  name: "Test Ürün",
});

// Detaylı kullanım
const detailedProduct = await createProduct({
  name: "Test Ürün",
  code: "URN001",
  barcode: "1234567890",
  product_type: "good",
  vat_rate: 20,
  price: 100.0,
  price_currency: "try",
  quantity: 50,
  discount_type: "percentage",
  discount_value: 5,
  "tags[0]": 12,
  "tags[1]": 18,
});

PHP

function createProduct($data) {
    $url = 'https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/products';

    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => http_build_query($data),
        CURLOPT_HTTPHEADER => [
            'Authorization: Bearer ' . $accessToken,
            'Channel: ' . $channel,
            'Content-Type: application/x-www-form-urlencoded'
        ],
        CURLOPT_RETURNTRANSFER => true
    ]);

    $response = curl_exec($ch);
    curl_close($ch);

    return json_decode($response, true);
}

// Temel kullanım
$product = createProduct([
    'name' => 'Test Ürün'
]);

// Detaylı kullanım
$detailedProduct = createProduct([
    'name' => 'Test Ürün',
    'code' => 'URN001',
    'barcode' => '1234567890',
    'product_type' => 'good',
    'vat_rate' => 20,
    'price' => 100.00,
    'price_currency' => 'try',
    'quantity' => 50,
    'discount_type' => 'percentage',
    'discount_value' => 5,
    'tags[0]' => 12,
    'tags[1]' => 18
]);

Python

import requests

def create_product(data):
    url = "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/products"
    headers = {
        "Authorization": f"Bearer {access_token}",
        "Channel": channel,
        "Content-Type": "application/x-www-form-urlencoded"
    }

    response = requests.post(url, headers=headers, data=data)
    return response.json()

# Temel kullanım
product = create_product({
    "name": "Test Ürün"
})

# Detaylı kullanım
detailed_product = create_product({
    "name": "Test Ürün",
    "code": "URN001",
    "barcode": "1234567890",
    "product_type": "good",
    "vat_rate": 20,
    "price": 100.00,
    "price_currency": "try",
    "quantity": 50,
    "discount_type": "percentage",
    "discount_value": 5,
    "tags[0]": 12,
    "tags[1]": 18
})

C#

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;
using Newtonsoft.Json;

async Task<dynamic> CreateProductAsync(Dictionary<string, string> data)
{
    using var client = new HttpClient();

    var request = new HttpRequestMessage(HttpMethod.Post,
        "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/products")
    {
        Content = new FormUrlEncodedContent(data)
    };

    request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", accessToken);
    request.Headers.Add("Channel", channel);

    var response = await client.SendAsync(request);
    var content = await response.Content.ReadAsStringAsync();
    return JsonConvert.DeserializeObject<dynamic>(content);
}

// Temel kullanım
var product = await CreateProductAsync(new Dictionary<string, string>
{
    { "name", "Test Ürün" }
});

// Detaylı kullanım
var detailedProduct = await CreateProductAsync(new Dictionary<string, string>
{
    { "name", "Test Ürün" },
    { "code", "URN001" },
    { "barcode", "1234567890" },
    { "product_type", "good" },
    { "vat_rate", "20" },
    { "price", "100.00" },
    { "price_currency", "try" },
    { "quantity", "50" },
    { "discount_type", "percentage" },
    { "discount_value", "5" },
    { "tags[0]", "12" }
});

Yanıt

Başarılı Yanıt

{
  "data": {
    "id": 1,
    "product_type": "good",
    "name": "Test Ürün",
    "code": "URN001",
    "vat_type": "PERCENTAGE",
    "vat_value": 20,
    "barcode": "1234567890",
    "description": "Test ürün açıklaması",
    "discount_type": "PERCENTAGE",
    "discount_value": 5,
    "stock_unit": 1,
    "stock_multiplier": 1,
    "purchase_unit": 1,
    "purchase_stock_multiplier": 1,
    "purchase_unit_description": "koli",
    "purchase_price": 80,
    "purchase_currency": "try",
    "sale_unit": 1,
    "sale_stock_multiplier": 1,
    "sale_unit_description": "adet",
    "sale_price": 100,
    "sale_currency": "try",
    "total_stock_quantity": 50,
    "tags": [
      {
        "id": 12,
        "name": "e-ticaret"
      }
    ]
  }
}

Yanıt Alanları

Alan	Tip	Açıklama
id	integer	Oluşturulan ürün ID
product_type	string	GOOD / SERVICE
name	string	Ürün adı
code	string	Ürün kodu
vat_type	string	KDV birimi (PERCENTAGE vb.)
vat_value	number	KDV oranı
barcode	string	Barkod
description	string	Açıklama
discount_type	string	PERCENTAGE veya NUMERIC
discount_value	number	İndirim değeri
stock_unit	number	Stok birimi
stock_multiplier	number	Stok birim çarpanı
purchase_unit	number	Alış birimi
purchase_stock_multiplier	number	Alış birim çarpanı
purchase_unit_description	number	Alış birim açıklaması
purchase_price	number	Alış fiyatı
purchase_currency	number	Alış para birimi
sale_unit	number	Satış birimi
sale_stock_multiplier	number	Satış birim çarpanı
sale_unit_description	number	Satış birim açıklaması
sale_price	number	Satış fiyatı
sale_currency	number	Satış para birimi
total_stock_quantity	number	Toplam stok miktarı
tags	array	Ürüne bağlı etiket listesi

Etiket Alanları (tags)

Alan	Tip	Açıklama
id	integer	Etiket ID değeri
name	string	Etiket adı
description	string	Etiket açıklaması (varsa)