金蝶雲・蒼穹 開發者指南

import requests

url = "https://{your-domain}/kapi/oauth2/token"
payload = {
    "grant_type": "client_credentials",
    "client_id": "YOUR_APP_KEY",
    "client_secret": "YOUR_APP_SECRET"
}
resp = requests.post(url, json=payload)
token = resp.json()["access_token"]
print(f"Token: {token[:20]}...")

// 蒼穹 OpenAPI 查詢單據示例
HttpResponse resp = HttpRequest.post(
    "https://{domain}/kapi/bos/v1/bill/query")
  .header("Authorization", "Bearer " + token)
  .body(JSONUtil.toJsonStr(Map.of(
    "formId", "k_billapp",
    "fieldKeys", "FBillNo,FDate,FAmount",
    "filterString", "FDate>='2025-01-01'"
  ))).execute();
List<Map> bills = JSONUtil.parseArray(
    resp.body()).toList(Map.class);

// 單據稽核前外掛：自動校驗金額
public class AmountValidator extends AbstractPlugin {
  @Override
  public void beforeAudit(BeforeAuditEvent e) {
    BigDecimal amt = (BigDecimal) 
      e.getBill().get("FAmount");
    if (amt.compareTo(BigDecimal.ZERO) <= 0) {
      throw new KDBizException("金額必須大於0");
    }
  }
}

// 構造蒼穹 SSO 授權跳轉 URL
const authUrl = new URL(
  'https://{domain}/kapi/oauth2/authorize');
authUrl.searchParams.set('response_type','code');
authUrl.searchParams.set('client_id', APP_KEY);
authUrl.searchParams.set('redirect_uri', 
  'https://yourapp.com/callback');
authUrl.searchParams.set('scope', 'all');
window.location.href = authUrl.toString();