Finans ve ERP

Müşteri PO numarası

Siparişin müşteri satınalma sipariş numarasını (customer_po) yazar ya da boş göndererek siler; boşluklar sadeleşir, en çok 60 karakter. ERP'ye gönderilmiş (sent, open, shipped, invoiced, closed) siparişte 409 — numara ERP'de değiştirilir. Yanıt güncel sipariş satırı (order) ve değişip değişmediği (changed). Sipariş satırları (firma / fırsat kartındaki orders) customer_po, product_id (anlık stok için), status, due_date, amount ve ERP gönderim durumunu (erp: status, label, tone, ext_no, error; gönderilmediyse null) taşır.

POST/api/v1/orders/{id}/po

Yetkilendirme

Authorizationheaderzorunlu

Bearer belirteci: API anahtarı (sk_…), OAuth erişim belirteci (mcp_…) ya da mobil oturum (xk_…).

Kapsam: crm.write

Yol parametreleri

idintegerzorunlu

Sipariş kimliği.

Gövde application/json

customer_postringisteğe bağlı

Müşterinin PO numarası; boş = sil.

Hatalar

HTTP	error	Anlamı
`409`	`erp`	ERP işlemi yapılamadı (`message`: sipariş bağlantısı yok, cari eşleşmedi, ürünün ERP kodu yok…).
`403`	`forbidden`	Kaydı görme / düzenleme yetkiniz yok.
`404`	`not_found`	Kayıt bulunamadı.

İstek

curl -X POST https://ornek.solk.app/api/v1/orders/16/po \
  -H "Authorization: Bearer $SOLK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "customer_po": "PO-7790"
}'

const res = await fetch("https://ornek.solk.app/api/v1/orders/16/po", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "customer_po": "PO-7790"
  }),
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://ornek.solk.app/api/v1/orders/16/po",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    json={
        "customer_po": "PO-7790"
    },
)
print(r.json())

Yanıt

{
  "changed": true,
  "ok": true,
  "order": {
    "amount": 24720.0,
    "currency": "EUR",
    "customer_id": 9,
    "customer_po": "PO-7790",
    "date": "2026-09-23",
    "due_date": null,
    "erp": null,
    "id": 16,
    "kg": 4000.0,
    "kind": "Yeni Sipariş",
    "note": "",
    "opp_id": 52,
    "payment_days": 90,
    "price": 6.18,
    "product": "HS 30 Isıl Yapışma Laki",
    "product_id": 5,
    "pu": "€/kg",
    "status": "Kapandı",
    "unit": "kg"
  }
}

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