金蝶云・苍穹 开发者指南

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();