This document consolidates the original CRMAPI.md and BomAPI.md. Use this file as the source of truth.

Table of Contents

• Table of Contents
• Summary
• Entry Functions
  • Fx.crm.getProduct
  • Fx.crm.getLeads
  • Fx.crm.getAccount
  • Fx.crm.getBom
  • Fx.crm.getEnterpriseByName
  • Fx.crm.getEnterpriseDetailById
  • Fx.crm.automatch
  • Fx.crm.bankStatement.identifyAccount
  • Fx.crm.periodicAccountsReceivable
• ProductAPI
  • shelf
  • createProductCategory
  • deleteProductCategory
  • updateProductCategory
  • searchCategory
  • associateAttribute
  • disAssociateAttribute
• LeadsAPI
  • move
  • giveBack
  • allocate
  • takeBack
  • transfer
• AccountAPI
  • move
  • remove
  • giveBack
  • takeOut
  • allocate
  • takeBack
• BomAPI
  • bomDeploy
  • add
  • edit
  • queryBomTree
• Changelog
• Background
• Applicable Scenarios
• Prerequisites
• Steps
• Notes

Summary

The overview of this document is as follows: This document consolidates the original CRMAPI.md and BomAPI.md. Use this file as the source of truth.

Entry Functions

Fx.crm.getProduct

Product-related entry.

Fx.crm.getProduct()

Reference interface:

• com.fxiaoke.functions.api.ProductAPI

Owner: Sun Deyu

Fx.crm.getLeads

Leads-related entry.

Fx.crm.getLeads()

Reference interface:

• com.fxiaoke.functions.api.LeadsAPI

Owner: Gong Chunru

Fx.crm.getAccount

Account-related entry.

Fx.crm.getAccount()

Reference interface:

• com.fxiaoke.functions.api.AccountAPI

Owner: Li Kun (bruce)

Fx.crm.getBom

BOM-related entry.

Fx.crm.getBom()

Reference interface:

• com.fxiaoke.functions.api.BomAPI

Fx.crm.getEnterpriseByName

Fuzzy query business registration information by company name.

Fx.crm.getEnterpriseByName(<String companyName>)

Parameters

Input format

Parameter	Type	Description	Required
companyName	String	Company name, unified social credit code, or registration number	Yes

Output format

Parameter	APIResult	Description
isError	boolean	Whether an error occurred
data	List	Returned data
message	string	Message

Groovy example

def(Boolean error, List data, String errorMessage) = Fx.crm.getEnterpriseByName("Baidu")

Fx.crm.getEnterpriseDetailById

Query business registration information by companyId.

Fx.crm.getEnterpriseDetailById(<String companyId>)

Parameters

Input format

Parameter	Type	Description	Required
companyId	String	Company ID	Yes

Groovy example

def(Boolean error, Map data, String errorMessage) = Fx.crm.getEnterpriseDetailById("1644990310")

Fx.crm.automatch

Automatic write-off API.

Fx.crm.automatch(<String objectDescribeApiName>, <String objectDataId>)

Parameters

Input format

Parameter	Type	Description	Required
objectDescribeApiName	String	Object API Name	Yes
objectDataId	String	Object ID	Yes

Output format

Parameter	APIResult	Description
isError	boolean	Whether an error occurred
data	Map	Returned data
message	string	Message

Output example

{
  "isError": false,
  "data": {},
  "message": "success"
}

Groovy example

String objectDescribeApiName = "PaymentObj"
String objectDataId = "1111"

def(boolean error, Map data, String message) = Fx.crm.automatch(objectDescribeApiName, objectDataId)
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

Notes

• This API currently supports only scenarios where automatic write-off is enabled.

Fx.crm.bankStatement.identifyAccount

Identify account from bank statements.

Fx.crm.bankStatement.identifyAccount(<List objectIds>)

Parameters

Input format

Parameter	Type	Description	Required
objectIds	List	Bank statement ID list	Yes

Output format

Parameter	APIResult	Description
isError	boolean	Whether an error occurred
data	Map	Returned data
message	string	Message

Output example

{
  "isError": false,
  "data": {},
  "message": "success"
}

Groovy example

List<String> objectIds = ["1111"]

def(boolean error, Map data, String message) = Fx.crm.bankStatement.identifyAccount(objectIds)
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

Notes

• This API currently supports only scenarios where payment matching is enabled.

Fx.crm.periodicAccountsReceivable

Periodic receivable generation.

Fx.crm.periodicAccountsReceivable(<String masterDescribeApiName>, <String detailDescribeApiName>, <String detailDataId>)

Parameters

Input format

Parameter	Type	Description	Required
masterDescribeApiName	String	Parent object API Name	Yes
detailDescribeApiName	String	Child object API Name	Yes
detailDataId	String	Child object ID	Yes

Output format

Parameter	APIResult	Description
isError	boolean	Whether an error occurred
data	Map	Returned data
message	string	Message

Output example

{
  "isError": false,
  "data": {},
  "message": "success"
}

Groovy example

String masterDescribeApiName = "SalesOrderObj"
String detailDescribeApiName = "SalesOrderProductObj"
String detailDataId = "1111"

def(boolean error, Map data, String message) = Fx.crm.periodicAccountsReceivable(
  masterDescribeApiName,
  detailDescribeApiName,
  detailDataId
)
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

Notes

• This API currently supports only scenarios where periodic receivable generation is enabled.

ProductAPI

shelf

Put product on shelf / off shelf.

Fx.crm.product.shelf(<String productId>, <Integer status>)

Parameters

Input format

Parameter	Type	Description	Required
productId	String	Product ID	Yes
status	Integer	1 on shelf, 2 off shelf	Yes

Groovy example

def (Boolean err, Map data, String errorMessage) = Fx.crm.product.shelf("e1e145095f8142c891802fa36fcbd4c6", 1)
def (Boolean err2, Map data2, String errorMessage2) = Fx.crm.product.shelf("e1e145095f8142c891802fa36fcbd4c6", 2)

createProductCategory

Create product category.

Fx.crm.product.createProductCategory(<String name>, <String categoryCode>, <String pid>)

Parameters

Input format

Parameter	Type	Description	Required
name	String	Product category name	Yes
categoryCode	String	Product category code	Yes
pid	String	Parent category ID	No

Code examples

def (Boolean err, Map data, String errorMessage) = Fx.crm.product.createProductCategory("产品分类名", "产品分类编码", null)
def (Boolean err2, Map data2, String errorMessage2) = Fx.crm.product.createProductCategory("产品分类名", "产品分类编码", "123")

deleteProductCategory

Delete product category.

Fx.crm.product.deleteProductCategory(<String id>)

Parameters

Parameter	Type	Description	Required
id	String	Product category ID	Yes

Code examples

def res = (((Fx.object.find("ProductCategoryObj", [["category_code": "111"]], 10, 0)[1]) as QueryResult).dataList[0] as Map)
def id = (res._id) as String
def (Boolean error, Map data, String errorMessage) = Fx.crm.product.deleteProductCategory(id)
log.info(data)

updateProductCategory

Update product category.

Fx.crm.product.updateProductCategory(<String id>, <Map arg>)

Parameters

Parameter	Type	Description	Required
id	String	Product category ID	Yes
arg	Map	Updated category content	Yes

Code examples

def res = (((Fx.object.find("ProductCategoryObj", [["category_code": "111"]], 10, 0)[1]) as QueryResult).dataList[0] as Map)
def id = (res._id) as String
Map map = ["name": "111", "categoryCode": "222"]
def (boolean err, Map dataList, String errorMessage) = Fx.crm.product.updateProductCategory(id, map)

searchCategory

Search category records by field value.

Fx.crm.product.searchCategory(<String fieldApiName>, <List values>)

Parameters

Parameter	Type	Description	Required
fieldApiName	String	Category field API Name, supports category_code	Yes
values	List	Field value list, up to 20 values	Yes

Code examples

def fieldApiName = "category_code"
def values = ["pNxTqSPS"]
def(boolean error, List data, String message) = Fx.crm.product.searchCategory(fieldApiName, values)
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

associateAttribute

Associate product attributes.

Fx.crm.product.associateAttribute(<List productIds>, <List attributeIds>)

Parameters

Parameter	Type	Description	Required
productIds	List	Product ID array	Yes
attributeIds	List	Attribute ID array	Yes

Code examples

def productIds = ["xxxxx"]
def attributeIds = ["xxxxx"]
def(boolean error, List data, String message) = Fx.crm.product.associateAttribute(productIds, attributeIds)
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

disAssociateAttribute

Disassociate product attributes.

Fx.crm.product.disAssociateAttribute(<List productIds>, <List attributeIds>)

Parameters

Parameter	Type	Description	Required
productIds	List	Product ID array	Yes
attributeIds	List	Attribute ID array	Yes

Code examples

def productIds = ["xxxxx"]
def attributeIds = ["xxxxx"]
def(boolean error, List data, String message) = Fx.crm.product.disAssociateAttribute(productIds, attributeIds)
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

LeadsAPI

move

Move lead.

Fx.crm.leads.move(<String leadsId>, <String leadsPoolId>)

Parameter	Type	Description	Required
leadsId	String	Lead ID	Yes
leadsPoolId	String	Lead pool ID	Yes

Code examples

def (Boolean err, String data, String errorMessage) = Fx.crm.leads.move(
  "05f3f656feb9496abaa4cf50f1fa22ce",
  "85f454b044894f83a57e1bacfd2f1beb"
)

giveBack

Return lead.

Fx.crm.leads.giveBack(<String leadsIds>, <String leadsPoolId>, <String backReason>, <String otherReason>)

Parameter	Type	Description	Required
leadsIds	String	Lead ID	Yes
leadsPoolId	String	Lead pool ID	Yes
backReason	String	Return reason option value, default return by function	No
otherReason	String	Extra note when backReason is other	No

Code examples

Fx.crm.leads.giveBack("05f3f656feb9496abaa4cf50f1fa22ce", "85f454b044894f83a57e1bacfd2f1beb")

allocate

Allocate leads.

Fx.crm.leads.allocate(<List leadsIds>, <String leadsPoolId>, <String ownerld>)

Parameter	Type	Description	Required
leadsIds	List[String]	Lead ID list	Yes
leadsPoolId	String	Lead pool ID	Yes
ownerld	String	User ID	Yes

Code examples

Fx.crm.leads.allocate(["3ed01dcafbe4402d99d7a521aaa4e9c3"], "85f454b044894f83a57e1bacfd2f1beb", "1025")

takeBack

Take back leads.

Fx.crm.leads.takeBack(<List leadsIds>, <String leadsPoolId>)

Parameter	Type	Description	Required
leadsIds	List[String]	Lead ID list	Yes
leadsPoolId	String	Lead pool ID	Yes

Code examples

def(Boolean err, String rs, String errorMessage) = Fx.crm.leads.takeBack(
  ["3ed01dcafbe4402d99d7a521aaa4e9c3"],
  "85f454b044894f83a57e1bacfd2f1beb"
)
if (err) {
  log.debug("收回失败：" + errorMessage)
} else {
  log.debug("收回成功")
}

transfer

Lead conversion (one lead to three business entities).

Fx.crm.leads.transfer(<Boolean combineCRMFeed>, <Boolean putTeamMembersIntoCustomer>, <String leadsId>, <Map account>, <Map contact>, <Map newObjectData>, <Map opportunity>)

Parameter	Lead conversion argument	Description	Required
combineCRMFeed	Boolean	Bring lead CRM feed into account automatically	Yes
putTeamMembersIntoCustomer	Boolean	Bring lead related team into account automatically	Yes
leadsId	String	Lead ID	Yes
account	Map	Account map. If _id exists, associate existing account; otherwise create a new one	Yes
contact	Map	Contact map	Yes
newObjectData	Map	Wrapper containing new Opportunity 2.0 data	Yes
opportunity	Map	Opportunity map	Yes

newObjectData	Type	Description	Required
object_data	object	Opportunity 2.0 payload	No

Code examples

String leadsId = "05f3f656feb9496abaa4cf50f1fa22ce"
Map account = [
  "object_describe_api_name": "AccountObj",
  "record_type": "default__c",
  "created_by": ["1109"],
  "name": "hello"
]
Map contact = [:]
Map newOpportunity = [:]
Map newObjectData = ["object_data": newOpportunity]
Map opportunity = [:]
def(boolean error, Object data, String msg) = Fx.crm.leads.transfer(
  true,
  true,
  leadsId,
  account,
  contact,
  newObjectData,
  opportunity
)
if (error) {
  log.info(data)
} else {
  log.info(msg)
}

AccountAPI

move

Move account to high seas.

Fx.crm.account.move(<String accountId>, <String highSeaId>)

Parameter	Type	Description	Required
accountId	String	Account ID	Yes
highSeaId	String	High-seas ID	Yes

Output format

Parameter	APIResult	Description
error	Boolean	Whether an error occurred
data	String	Returned data
message	String	Message

Code examples

Fx.crm.account.move("ad14bbbcede240a48dc2f65787a8763d", "6c1a6a54617245fe90aae5a162eb191d").result()

Code examples

Fx.crm.account.move("ad14bbbcede240a48dc2f65787a8763d", "6c1a6a54617245fe90aae5a162eb191d").result()

remove

Remove account from high seas.

Fx.crm.account.remove(<String accountId>, <String highSeaId>, <String owner>)

Parameter	Type	Description	Required
accountId	String	Account ID	Yes
highSeaId	String	High-seas ID	Yes
owner	String	Owner ID	Yes

Code examples

Fx.crm.account.remove("ad14bbbcede240a48dc2f65787a8763d", "6c1a6a54617245fe90aae5a162eb191d", "1000").result()

Code examples

Fx.crm.account.remove("ad14bbbcede240a48dc2f65787a8763d", "6c1a6a54617245fe90aae5a162eb191d", "1000").result()

Return Parameters

Parameter	APIResult	Description
error	Boolean	是否错误
data	String	返回数据
message	String	信息

giveBack

Give back account to high seas.

Fx.crm.account.giveBack(<String accountId>, <String highSeaId>, <String backReason>, <String otherReason>)

Parameter	Type	Description	Required
accountId	String	Account ID	Yes
highSeaId	String	High-seas ID	Yes
backReason	String	Return reason option value, default return by function	No
otherReason	String	Extra note when backReason is other	No

Code examples

Fx.crm.account.giveBack("ad14bbbcede240a48dc2f65787a8763d", "6c1a6a54617245fe90aae5a162eb191d", "other", "不符合").result()

Code examples

Fx.crm.account.giveBack("ad14bbbcede240a48dc2f65787a8763d", "6c1a6a54617245fe90aae5a162eb191d", "other", "不符合").result()

Return Parameters

Parameter	APIResult	Description
error	Boolean	是否错误
data	String	返回数据
message	String	信息

takeOut

Take out account.

Fx.crm.account.takeOut(<List accountIds>)

Parameter	Type	Description	Required
accountIds	List	Account ID list	Yes

Code examples

Fx.crm.account.takeOut(["ad14bbbcede240a48dc2f65787a8763d", "6c1a6a54617245fe90aae5a162eb191d"]).result()

Code examples

Fx.crm.account.takeOut(["ad14bbbcede240a48dc2f65787a8763d", "6c1a6a54617245fe90aae5a162eb191d"]).result()

Return Parameters

Parameter	APIResult	Description
error	Boolean	是否错误
data	String	返回数据
message	String	信息

allocate

Allocate account.

Fx.crm.account.allocate(<List accountIds>, <String highSeaId>, <String ownerId>)

Parameter	Type	Description	Required
accountIds	List	Account ID list	Yes
highSeaId	String	High-seas ID	Yes
ownerId	String	User ID	Yes

Code examples

Fx.crm.account.allocate(["cd097b120f584533b627c40239ece7d0"], "0ebc054e55254b8b89f09d7ac7602972", "1025").result()

Code examples

Fx.crm.account.allocate(["cd097b120f584533b627c40239ece7d0"], "0ebc054e55254b8b89f09d7ac7602972", "1025").result()

Return Parameters

Parameter	APIResult	Description
error	Boolean	是否错误
data	String	返回数据
message	String	信息

takeBack

Take back account.

Fx.crm.account.takeBack(<List accountIds>, <String highSeaId>)

Parameter	Type	Description	Required
accountIds	List	Account ID list	Yes
highSeaId	String	High-seas ID	Yes

Code examples

Fx.crm.account.takeBack(["cd097b120f584533b627c40239ece7d0"], "0ebc054e55254b8b89f09d7ac7602972").result()

Code examples

Fx.crm.account.takeBack(["cd097b120f584533b627c40239ece7d0"], "0ebc054e55254b8b89f09d7ac7602972").result()

Return Parameters

Parameter	APIResult	Description
error	Boolean	是否错误
data	String	返回数据
message	String	信息

BomAPI

bomDeploy

Save product configuration details.

Fx.crm.bom.bomDeploy(<String rootProductId>, <List nodeList>, <List deletedBomAndGroupList>)

Parameter	Type	Description	Required
rootProductId	String	Root product ID	Yes
nodeList	List	Array of created/updated nodes	No
deletedBomAndGroupList	List	Array of deleted nodes	No

Output format

Parameter	APIResult	Description
isError	boolean	Whether an error occurred
data	Map	Returned data
message	string	Message

Code examples

def deletedBomAndGroupList = []
def nodeList = [
  [
    "object_describe_api_name": "ProductGroupObj",
    "name": "分组一",
    "group_options_control": false,
    "min_prod_count": null,
    "max_prod_count": null,
    "children": [
      [
        "record_type": "default__c",
        "object_describe_api_name": "BOMObj",
        "price_editable": true,
        "price_mode": "1",
        "amount": "3",
        "min_amount": "2",
        "selected_by_default": true,
        "increment": "1",
        "is_required": false,
        "life_status": "normal",
        "enabled_status": true,
        "amount_editable": true,
        "max_amount": "5",
        "product_id": "640716930f8b230001378dea",
        "action_type": "create",
        "adjust_price": "3.00"
      ]
    ],
    "action_type": "create",
    "record_type": "default__c"
  ]
]
def rootProductId = "6406f80060c1980001a23560"
def(boolean error, Map data, String message) = Fx.crm.bom.bomDeploy(rootProductId, nodeList, deletedBomAndGroupList)
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

Code examples

def deletedBomAndGroupList = []
def nodeList = [
  [
    "object_describe_api_name": "ProductGroupObj",
    "name": "分组一",
    "group_options_control": false,
    "min_prod_count": null,
    "max_prod_count": null,
    "children": [
      [
        "record_type": "default__c",
        "object_describe_api_name": "BOMObj",
        "price_editable": true,
        "price_mode": "1",
        "amount": "3",
        "min_amount": "2",
        "selected_by_default": true,
        "increment": "1",
        "is_required": false,
        "life_status": "normal",
        "enabled_status": true,
        "amount_editable": true,
        "max_amount": "5",
        "product_id": "640716930f8b230001378dea",
        "action_type": "create",
        "adjust_price": "3.00"
      ]
    ],
    "action_type": "create",
    "record_type": "default__c"
  ]
]
def rootProductId = "6406f80060c1980001a23560"
def(boolean error, Map data, String message) = Fx.crm.bom.bomDeploy(rootProductId, nodeList, deletedBomAndGroupList)
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

add

Create product combination.

Fx.crm.bom.add(<Map objectData>, <Map details>)

Parameter	Type	Description	Required
objectData	Map	Parent object field values	Y
details	Map	Child object data	Y

Output format

Parameter	APIResult	Description
isError	boolean	Whether an error occurred
data	Map	Returned data
message	string	Message

Notes

• children represents child nodes of the current node.

Code examples

Map masterData = [
  "product_id": "6600e02fab2ffd00073faad2",
  "category": "configure",
  "purpose": "sale",
  "object_describe_api_name": "BomCoreObj",
  "owner": ["-10000"],
  "record_type": "default__c"
]

List details = []
Map product1 = [
  "record_type": "default__c",
  "object_describe_api_name": "BOMObj",
  "product_id": "65fd50dd9f9a2d000128c294",
  "amount": "1",
  "price_mode": "1",
  "adjust_price": 200,
  "is_required": true,
  "selected_by_default": true,
  "price_editable": false,
  "amount_editable": false,
  "increment": 1,
  "enabled_status": true,
  "order_field": "1",
  "action_type": "create",
  "children": []
]
details.add(product1)

List children = [
  [
    "action_type": "create",
    "record_type": "default__c",
    "object_describe_api_name": "BOMObj",
    "product_id": "65fd50dd9f9a2d000128c294",
    "amount": "1",
    "price_mode": "1",
    "adjust_price": 300,
    "is_required": true,
    "selected_by_default": true,
    "price_editable": false,
    "amount_editable": false,
    "increment": 1,
    "enabled_status": true,
    "order_field": "1"
  ],
  [
    "action_type": "create",
    "record_type": "default__c",
    "object_describe_api_name": "BOMObj",
    "product_id": "6603c02d491f7e00079431ca",
    "amount": "1",
    "price_mode": "1",
    "adjust_price": 300,
    "is_required": true,
    "selected_by_default": true,
    "price_editable": false,
    "amount_editable": false,
    "increment": 1,
    "enabled_status": true,
    "order_field": "1"
  ]
]

Map group = [
  "record_type": "default__c",
  "object_describe_api_name": "ProductGroupObj",
  "name": "测试分组信息",
  "order_field": "1",
  "group_options_control": true,
  "action_type": "create",
  "children": children
]
details.add(group)
Map detailData = ["BOMObj": details]

def (boolean error, Map data, String message) = Fx.crm.bom.add(masterData, detailData)
if (error) {
  log.info("错误信息：" + message)
} else {
  log.info("返回结果：" + data)
}

Code examples

Map masterData = [
  "product_id": "6600e02fab2ffd00073faad2",
  "category": "configure",
  "purpose": "sale",
  "object_describe_api_name": "BomCoreObj",
  "owner": ["-10000"],
  "record_type": "default__c"
]

List details = []
Map product1 = [
  "record_type": "default__c",
  "object_describe_api_name": "BOMObj",
  "product_id": "65fd50dd9f9a2d000128c294",
  "amount": "1",
  "price_mode": "1",
  "adjust_price": 200,
  "is_required": true,
  "selected_by_default": true,
  "price_editable": false,
  "amount_editable": false,
  "increment": 1,
  "enabled_status": true,
  "order_field": "1",
  "action_type": "create",
  "children": []
]
details.add(product1)

List children = [
  [
    "action_type": "create",
    "record_type": "default__c",
    "object_describe_api_name": "BOMObj",
    "product_id": "65fd50dd9f9a2d000128c294",
    "amount": "1",
    "price_mode": "1",
    "adjust_price": 300,
    "is_required": true,
    "selected_by_default": true,
    "price_editable": false,
    "amount_editable": false,
    "increment": 1,
    "enabled_status": true,
    "order_field": "1"
  ],
  [
    "action_type": "create",
    "record_type": "default__c",
    "object_describe_api_name": "BOMObj",
    "product_id": "6603c02d491f7e00079431ca",
    "amount": "1",
    "price_mode": "1",
    "adjust_price": 300,
    "is_required": true,
    "selected_by_default": true,
    "price_editable": false,
    "amount_editable": false,
    "increment": 1,
    "enabled_status": true,
    "order_field": "1"
  ]
]

Map group = [
  "record_type": "default__c",
  "object_describe_api_name": "ProductGroupObj",
  "name": "测试分组信息",
  "order_field": "1",
  "group_options_control": true,
  "action_type": "create",
  "children": children
]
details.add(group)
Map detailData = ["BOMObj": details]

def (boolean error, Map data, String message) = Fx.crm.bom.add(masterData, detailData)
if (error) {
  log.info("错误信息：" + message)
} else {
  log.info("返回结果：" + data)
}

edit

Edit product combination.

Fx.crm.bom.edit(<Map objectData>, <Map details>)

Parameter	Type	Description	Required
objectData	Map	Parent object field values	Yes
details	Map	Child object data	Yes

Output format

Parameter	APIResult	Description
isError	boolean	Whether an error occurred
data	Map	Returned data
message	string	Message

Notes

• children represents child nodes of the current node.
• action_type represents operation type: create, update, or delete.

Code examples

Map masterData = [
  "product_id": "6600e02fab2ffd00073faad2",
  "category": "configure",
  "purpose": "sale",
  "object_describe_api_name": "BomCoreObj",
  "owner": ["-10000"],
  "record_type": "default__c"
]

List details = []
Map product1 = [
  "record_type": "default__c",
  "object_describe_api_name": "BOMObj",
  "product_id": "65fd50dd9f9a2d000128c294",
  "amount": "1",
  "price_mode": "1",
  "adjust_price": 200,
  "is_required": true,
  "selected_by_default": true,
  "price_editable": false,
  "amount_editable": false,
  "increment": 1,
  "enabled_status": true,
  "order_field": "1",
  "action_type": "create",
  "children": []
]
details.add(product1)

List children = [
  [
    "action_type": "create",
    "record_type": "default__c",
    "object_describe_api_name": "BOMObj",
    "product_id": "65fd50dd9f9a2d000128c294",
    "amount": "1",
    "price_mode": "1",
    "adjust_price": 300,
    "is_required": true,
    "selected_by_default": true,
    "price_editable": false,
    "amount_editable": false,
    "increment": 1,
    "enabled_status": true,
    "order_field": "1"
  ],
  [
    "action_type": "create",
    "record_type": "default__c",
    "object_describe_api_name": "BOMObj",
    "product_id": "6603c02d491f7e00079431ca",
    "amount": "1",
    "price_mode": "1",
    "adjust_price": 300,
    "is_required": true,
    "selected_by_default": true,
    "price_editable": false,
    "amount_editable": false,
    "increment": 1,
    "enabled_status": true,
    "order_field": "1"
  ]
]

Map group = [
  "record_type": "default__c",
  "object_describe_api_name": "ProductGroupObj",
  "name": "测试分组信息",
  "order_field": "1",
  "group_options_control": true,
  "action_type": "create",
  "children": children
]
details.add(group)
Map detailData = ["BOMObj": details]

def (boolean error, Map data, String message) = Fx.crm.bom.edit(masterData, detailData)
if (error) {
  log.info("错误信息：" + message)
} else {
  log.info("返回结果：" + data)
}

Code examples

Map masterData = [
  "product_id": "6600e02fab2ffd00073faad2",
  "category": "configure",
  "purpose": "sale",
  "object_describe_api_name": "BomCoreObj",
  "owner": ["-10000"],
  "record_type": "default__c"
]

List details = []
Map product1 = [
  "record_type": "default__c",
  "object_describe_api_name": "BOMObj",
  "product_id": "65fd50dd9f9a2d000128c294",
  "amount": "1",
  "price_mode": "1",
  "adjust_price": 200,
  "is_required": true,
  "selected_by_default": true,
  "price_editable": false,
  "amount_editable": false,
  "increment": 1,
  "enabled_status": true,
  "order_field": "1",
  "action_type": "create",
  "children": []
]
details.add(product1)

List children = [
  [
    "action_type": "create",
    "record_type": "default__c",
    "object_describe_api_name": "BOMObj",
    "product_id": "65fd50dd9f9a2d000128c294",
    "amount": "1",
    "price_mode": "1",
    "adjust_price": 300,
    "is_required": true,
    "selected_by_default": true,
    "price_editable": false,
    "amount_editable": false,
    "increment": 1,
    "enabled_status": true,
    "order_field": "1"
  ],
  [
    "action_type": "create",
    "record_type": "default__c",
    "object_describe_api_name": "BOMObj",
    "product_id": "6603c02d491f7e00079431ca",
    "amount": "1",
    "price_mode": "1",
    "adjust_price": 300,
    "is_required": true,
    "selected_by_default": true,
    "price_editable": false,
    "amount_editable": false,
    "increment": 1,
    "enabled_status": true,
    "order_field": "1"
  ]
]

Map group = [
  "record_type": "default__c",
  "object_describe_api_name": "ProductGroupObj",
  "name": "测试分组信息",
  "order_field": "1",
  "group_options_control": true,
  "action_type": "create",
  "children": children
]
details.add(group)
Map detailData = ["BOMObj": details]

def (boolean error, Map data, String message) = Fx.crm.bom.edit(masterData, detailData)
if (error) {
  log.info("错误信息：" + message)
} else {
  log.info("返回结果：" + data)
}

queryBomTree

Get complete product combination structure.

Fx.crm.bom.queryBomTree(<bom_core_id>, <need_sub_bom>, <bom_amount>, <include_all>)

Parameters

Parameter	Type	Description	Required
bom_core_id	String	Product combination ID	Yes
need_sub_bom	Boolean	Whether to return sub-BOM data	No
bom_amount	Integer	Amount of BOM package, default is 1	No
include_all	Boolean	If group is deleted, whether to include children under that group, default is false	No

Output format

Parameter	APIResult	Description
isError	boolean	Whether an error occurred
data	List	Returned child data
message	String	Message

Output example

{
  "isError": false,
  "data": {},
  "message": "success"
}

Groovy example

Integer amount = 1
def(boolean error, Object data, String message) = Fx.crm.bom.queryBomTree(
  "67ee3216cf9d1b00014a4af5",
  true,
  amount,
  false
)
Map map = Fx.json.parseObject(data as String, Map)
List result = map["dataMapList"] as List

Changelog

Version	Date	Changes	Author
v1.0	2026-05-20	Initial version

Background

This document provides detailed information about the Fx.crm API functionality and usage, helping developers integrate relevant capabilities.

Applicable Scenarios

• Business scenario integration
• Data processing and synchronization
• System integration and extension

Prerequisites

• Access to Fxiaoke Open Platform
• Application authorization and configuration completed
• Basic knowledge of relevant business domain

Steps

Please refer to the detailed instructions for each API.

Notes

• Ensure prerequisites are met before calling APIs
• Pay attention to API call frequency limits
• Refer to error code documentation for exception handling

Compatibility note: This version currently has no deprecated or compatibility notes.