Solk ERP API

Ürünleri gönder

ERP stok kartlarını gönderir; CRM ürünleriyle koddan (yoksa addan) eşleşir. Bağlantıda liste fiyatını güncelle açıksa price ürünün liste fiyatına yazılır. qty varsa stok olarak saklanır.

POST/api/erp/v1/products

Yetkilendirme

Authorizationheaderzorunlu

Solk ERP API anahtarı (erp_…): Ayarlar → Muhasebe ve ERP → Solk ERP API bağlantısı açılınca bir kez gösterilir. X-Solk-Erp-Key başlığıyla da gönderilebilir.

Gövde application/json

itemsarrayzorunlu

Ürünler: ext_id, code, name, unit, price, currency, qty.

Hatalar

HTTP	error	Anlamı
`401`	`unauthorized`	Belirteç yok, geçersiz, süresi dolmuş ya da iptal edilmiş.
`400`	`invalid`	Eksik ya da geçersiz alan (`message` ayrıntıyı verir).
`413`	`too_many`	Tek istekte en çok 2.000 kayıt.
`429`	`rate_limited`	Dakikalık istek sınırı aşıldı (`Retry-After`).

İstek

curl -X POST https://ornek.solk.app/api/erp/v1/products \
  -H "Authorization: Bearer $SOLK_ERP_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "items": [
    {
      "ext_id": "153.PU500",
      "code": "HS30",
      "name": "HS 30 Isıl Yapışma Laki",
      "unit": "kg",
      "price": 3.2,
      "currency": "EUR",
      "qty": 5200
    }
  ]
}'

const res = await fetch("https://ornek.solk.app/api/erp/v1/products", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_ERP_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "items": [
      {
        "ext_id": "153.PU500",
        "code": "HS30",
        "name": "HS 30 Isıl Yapışma Laki",
        "unit": "kg",
        "price": 3.2,
        "currency": "EUR",
        "qty": 5200
      }
    ]
  }),
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://ornek.solk.app/api/erp/v1/products",
    headers={"Authorization": f"Bearer {os.environ['SOLK_ERP_KEY']}"},
    json={
        "items": [
            {
                "ext_id": "153.PU500",
                "code": "HS30",
                "name": "HS 30 Isıl Yapışma Laki",
                "unit": "kg",
                "price": 3.2,
                "currency": "EUR",
                "qty": 5200
            }
        ]
    },
)
print(r.json())

Yanıt

{
  "matched": 1,
  "new": 1,
  "ok": true,
  "received": 1
}

Örnek yanıt örnek veriyle çalışan bir v54 kurulumundan alındı; listeler en çok iki öğeyle kısaltıldı.