English navigation · Main article content follows the Chinese edition. View Simplified Chinese version.
💰 Spend a small amount of money to do big things, 20% of the budget will be used in the system
Certified channel partner · Save 15%–30%, up to 55%
Answer in 30 seconds · Kingdee Cosmic
ERP native + Xinchuang privatization: 500 people+, integrated with Xinghan/Cangqiong.Developer documentation ≠ purchasing decisions.
7 Platform Hengping → · Channel Quotation → · Cost Calculator →
First distinguish the product line (sky/starry sky/stars) and extension methods (plug-ins, secondary developers, integrations), and then enter the corresponding API and permission model.The ERP in-depth integration cycle is long, and the POC first locks in the 1–2 main business documents; business discounts and channel prices will be discussed after the boundaries of the technical solutions are clear.
API documentation · Common error reports · Code examples · Certification exams · Community mutual assistance - everything developers need is here.
MiCount actual combat arrangement · Non-Kingdee official website · See the link on the page for full official documents
What are you doing?choose a path
Compiled high-frequency error reports from the official community + actual projects, and directly provided solutions
bos.IllegalOperationException: Execution of document conversion rules failed
Scenario: In the document conversion plug-in, the source document fields do not match the target document field types.
Solution: Check the field mapping in the conversion rule to ensure that the source field type is consistent with the target; the numeric type must be converted to text type explicitly ConvertService.convert()。
HTTP 401 Unauthorized (OpenAPI call)
Scenario: The third-party system calls Cangqiong OpenAPI and returns 401
Solution: ① Check whether the AppKey / AppSecret has expired; ② The Token cache has timed out and needs to be obtained again; ③ Confirm that the interface permissions have been authorized in "Open Platform → Application Management".
KScript compilation error: Cannot resolve symbol 'xxx'
Scenario: KingScript fails to compile when referencing a custom object
Solution: ① Confirm that the referenced BO/Entity has been published to the current environment; ② Check whether the import path is correct (package name is case-sensitive); ③ Clear the IDE compilation cache and rebuild.
WorkflowException: The workflow node cannot find the approver
Scenario: document submission workflow reports "Cannot find the approver"
Solution: ① Check whether the workflow role configuration is associated with organizational personnel; ② Confirm whether the branch condition expression can match the person; ③ The test environment needs to initialize organizational data.
deploy failed: Application deployment failed due to metadata conflict
Scenario: Metadata conflicts when development environment application is released to production environment
Solution: ① Use "application packaging" instead of direct publishing; ② Check whether the target environment already has metadata with the same name (needs to be backed up first and then overwritten); ③ Use version management to compare differences.
SSO single sign-on callback failed: redirect_uri mismatch
Scenario: OAuth2.0 callback error after single sign-on configuration
Solution: ① Confirm that the callback address in Cangqiong's "Open Platform → Application Settings" is exactly the same as the actual request (including protocol, domain name, port, path); ② Pay attention to URL encoding issues.
Can't find the solution in the document? 401 /Plug-ins/SSO are often stuck in the environment or permissions - it has been delivered to 200+ Cangqiong integration, which can be remotely diagnosed or formally implemented in 30 minutes.
Copy and use Cangqiong OpenAPI call example
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();Need a complete interface dictionary?developer.kingdee.com official API list →
For the complete dictionary of OpenAPI, see developer.kingdee.com · Selection and Xinchuangjian Kangqiong Decision Guide
MES work report → Cangqiong production order/warehousing order OpenAPI → cost writeback.Key points: Work order number idempotence + organization coding mapping.
Click to expand implementation points
Enterprise portal OAuth2 → Cangqiong authorize/token → Single click to enter BOS.Key points: redirect_uri whitelist and multi-environment client.
Click to expand implementation points
KingScript plug-in packaging → Xinchuang middleware / localized DB verification → grayscale release.Key points: dependency list and rollback package.
Click to expand implementation points
Master Data Platform → Cangqiong Material/Customer/Supplier API → Organization Dimension Distribution.Key points: Coding rules and conflict merging strategies.
Click to expand implementation points
Implementation entrustment arithmetic integration service · In-depth reading of Manufacturing ERP integration strategy · Acceptance project list
Master the core development capabilities of Kingdee Cloud, including low-code development, full-code development, API calling, etc.
Official document solves "how to use API" - Project establishment and delivery Please read Sky Selection · Arithmetic Integration Implementation · Integration Recipe
Introduction to dynamic domain model (KDDM), visual designer and low-code development platform, covering the entire life cycle of application development
Visit linkOfficial developer portal, including OpenAPI documentation, SDK downloads, Restful specifications and no-code API configuration guide
Visit linkSummary of official tutorials and practical documents on KingScript development environment, project creation, syntax highlighting configuration, etc.
Visit linkCangqiong OpenAPI calling, parameter encapsulation, request debugging discussion forum, adapted to ERP/CRM system integration scenarios
Visit linkOfficial code specifications, naming rules and best practices, suitable for enterprise-level application development
Visit linkKingdee official integration platform documents: interface docking steps, data synchronization rules and system interconnection scheme
Visit linkOfficial AI capability open platform, including service interface documents for agents, visual recognition, NLP, etc.
Visit linkMaster Kingdee cloud system integration capabilities, including single sign-on, multi-system data synchronization, etc.
Based on the OAuth2.0 protocol, including heterogeneous system/Cangqiong cross-system single sign-on configuration, with link construction examples
Visit linkExplain master data management, cross-system process configuration, and adapt to business and financial integration scenarios
Visit linkRealize agent message push and approval reminder, including interface configuration steps and open API docking
Visit linkOfficially maintained open source case code repository, including examples of integration scenarios such as identity authentication and process triggering.
Visit linkPassed Kingdee Cloud·Cangqiong development certification to improve personal abilities and project undertaking qualifications
Covers beginner-intermediate systematic content, including page modeling, application development, advanced skills, and supporting exercises
Visit linkThe primary exam is held every Tuesday and Friday. The 60 questions are limited to 45 minutes and the 60 score is passing.
Visit linkSupports early/intermediate certificate progress query, the certificate is valid for 2 years
Visit linkGold medal lecturers answer questions, students communicate and interact, and provide study notes and technical document sharing
How to join: Log in to Cloud Home and search for "Cangqiong Development Certification Tutoring Group" (official community, real-time response)
4000 + Developer communication platform, official technical team responds within 24 hours
Visit linkProvide targeted learning suggestions based on the learning path of the developer role
Give priority to completing the path of "core development system learning→certification examination→integration practice", and use the community to answer questions and solve practical problems. The certification certificate can enhance your project undertaking qualifications.
PaaS architecture/applicable scenarios/selection suggestions
0-1 Learning Path / Introduction to Business Modeling
Environment deployment/permission system/operation and maintenance tuning
SDK / OpenAPI / Community Resource Summary
Cangqiong application template: low-code form / OpenAPI / Agent intelligence
Try Demo nowFree 30min architecture design/integration solution consultation
Make an appointment for consultationKingScript / OpenAPI / Agent High Frequency Questions and Answers
Join the communityShanghai Siyang Information Technology · Kingdee ecological service provider · Cumulative delivery of 200+ integration projects
Is the Cangqiong API adjusted? official authorized channel · Procurement Province 15%–30%, up to 55% · Integrated implementation · Canadian enterprise micro-college official price list
High-frequency requirements outside of OpenAPI/Agent
Compare the Hengping matrix, cost calculations and official channel quotations to reduce repeated searches.
KingScript / OpenAPI
practical Q&A
Scan the QR code to join the technical community
for real-time response · Free