TIP

• 费用核算记录查询接口
• 费用核算凭证回写接口
• 支付方式新增
• 支付方式查询
• 成本中心新增
• 成本中心查询
• 会计科目新增
• 会计科目查询
• 科目映射查询

预算费控

费用核算记录查询接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/cuxiao/cost/v1/queryAccounting/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "create_start": "2020-08-01 00:00:00",
    "create_end": "2020-08-20 23:59:59",
    "modify_start": "2020-08-01 00:00:00",
    "modify_end": "2020-08-20 23:59:59",
    "certificate_sync_status": "0",
    "accounting_type": "1,2",
    "page": "1",
    "rows": "100"
   
}

说明： 本示例仅供参考，具体以参数说明为准。

请求说明

参数	类型	必填	说明
create_start	varchar(100)	否	记录生成开始时间。格式：YYYY-MM-DD hh:mi:ss
create_end	varchar(100)	否	记录生成结束时间。格式：YYYY-MM-DD hh:mi:ss
modify_start	varchar(100)	否	修改开始时间。格式：YYYY-MM-DD hh:mi:ss
modify_end	varchar(4000)	否	修改结束时间。格式：YYYY-MM-DD hh:mi:ss
certificate_sync_status	varchar(100)	否	凭证同步状态。1：同步成功，2：同步失败，0：未同步
accounting_type	varchar(32)	否	核算类型，多个使用英文逗号拼接，1：费用预提；2：冲销预提；3：费用核销；4：关联发票；5：进项税
page	varchar(100)	否	当前页
rows	varchar(100)	否	每页条数

响应示例：

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "dept_code": "",
        "lend_type_name": "营销",
        "activity_name": "703-DM-项目-常规",
        "certificate_code": "",
        "borrow_code": "KM2022011201",
        "sync_message": "",
        "certificate_sync_status": "0",
        "accounting_type": "关联发票",
        "lend_code": "KM2022011201",
        "project_name": "703-DM-项目",
        "table_name": "budget_2202070052",
        "tax_rate": "12.00",
        "dim_dept_name": "",
        "biz_row_code": " 00001",
        "pd_code": "",
        "subject_code": "KM2022011201",
        "biz_code": "HX202205110006",
        "create_time": "2022-05-11 16:40",
        "pay_mode_name": "发票",
        "dealer_dept_name": "诺克萨斯",
        "dates": "2022-05-01~2022-05-31",
        "project_code": "XM2022056702",
        "activity_code": "SQ202205110006",
        "accounting_amount": 0.01000000,
        "generate_type": "2",
        "dealer_dept_code": "BM21111601",
        "customer_dept_id": "",
        "subject_name": "子科目一",
        "borrow_type_name": "营销",
        "pd_name": "",
        "org_code": "OG20220211001",
        "apply_type": "3",
        "cost_center_code": "",
        "code": "HS202205110106",
        "modify_time": "",
        "dim_dept_id": "",
        "dealer_code": "CUS000005",
        "profit_name": "",
        "biz_batch_code": "HXB202205110002",
        "verify_remark": "",
        "cost_center_name": "",
        "org_name": "江苏区",
        "bcc_code": "CUS000009",
        "dealer_id": 4847308782274217093,
        "creator_code": "dm",
        "borrow_name": "会计科目",
        "dealer_dept_id": 4732833996161900894,
        "dim_dept_code": "",
        "dept_name": "",
        "func_id": "5591453064364783551",
        "biz_create_time": "2022-05-11 16:40",
        "lend_name": "会计科目",
        "bcc_name": "EZ",
        "profit_code": "",
        "dealer_name": "薇恩",
        "creator_name": "刀妹",
        "customer_id": 9004133115208910583,
        "biz_id": "7866263410310551469",
        "verification_row_id": "8993133115208809472",
        "form_name": "常规-维值权限",
        "activity_row_no": "1",
        "biz_creator_id": "5945873929671013359",
        "biz_creator_code": "cs",
        "biz_creator_name": "测试",
        "biz_creator_source_code": "",
        "bcc_source_code": "",
        "dept_source_code": "",
        "dealer_source_code": "",
        "dealer_dept_source_code": "",
        "pd_id": "6274880251796745455",
        "pd_source_code": "",
        "creator_id": "5945873929671013359",
        "creator_source_code": "",
        "project_id": "",
        "plan_id": "4615187161384500775", 
        "plan_code": "CX20220310305",
        "plan_name": "701-市场-加签-0310",
        "certificate_date": "2022-05-11"
    }
]

参数说明：

参数	类型	必填	说明
code	VARCHAR	是	记录编号
biz_code	VARCHAR	是	业务单据编号
biz_creator_id	VARCHAR	否	业务单据申请人id
biz_creator_code	VARCHAR	否	业务单据申请人账号
biz_creator_name	VARCHAR	否	业务单据申请人名称
biz_creator_source_code	VARCHAR	否	业务单据申请人外部id
biz_id	VARCHAR	是	结案明细id
func_id	VARCHAR	是	申请明细id (按方案申请时：是申请单中付费项目ID 固定金额促销申请时：如果是按连锁品牌申请的，是连锁品牌申请行ID。按客户申请的，是客户申请行ID 进货折让：客户申请行ID)
verification_row_id	VARCHAR	否	核销明细ID
apply_type	VARCHAR	是	申请类型。0：付费陈列、1：固定进货促销、2：进货折让、3：万能促销活动、4：其他（直接创建核销）
accounting_type	VARCHAR	是	核算类型(费用预提、冲销预提、费用核销、关联发票、进项税)
form_name	VARCHAR	是	活动场景
activity_code	VARCHAR	是	活动申请单号
activity_name	VARCHAR	是	申请单名称
dates	VARCHAR	是	活动周期范围：格式：yyyy-MM-dd~yyyy-MM-dd
customer_id	VARCHAR	是	客户ID
bcc_code	VARCHAR	是	客户编码
bcc_name	VARCHAR	是	客户名称
bcc_source_code	VARCHAR	是	客户外部ID
customer_dept_id	VARCHAR	是	客户部门ID
dept_code	VARCHAR	是	客户部门编码
dept_name	VARCHAR	是	客户部门名称
dept_source_code	VARCHAR	是	客户部门外部ID
dealer_id	VARCHAR	是	费用代垫经销商ID
dealer_code	VARCHAR	是	费用代垫经销商编码
dealer_name	VARCHAR	是	费用代垫经销商名称
dealer_source_code	VARCHAR	是	费用代垫经销商外部ID
dealer_dept_id	VARCHAR	是	经销商部门ID
dealer_dept_code	VARCHAR	是	经销商部门编码
dealer_dept_name	VARCHAR	是	经销商部门名称
dealer_dept_source_code	VARCHAR	是	经销商部门外部ID
dim_dept_id	VARCHAR	是	费用承担部门ID
dim_dept_code	VARCHAR	是	费用承担部门编码
dim_dept_name	VARCHAR	是	费用承担部门名称
pay_mode_name	VARCHAR	是	支付方式
borrow_code	VARCHAR	是	借项科目编码
borrow_name	VARCHAR	是	借项科目名称
lend_code	VARCHAR	是	贷项科目编码
lend_name	VARCHAR	是	贷项科目名称
subject_code	VARCHAR	是	预算科目编码
subject_name	VARCHAR	是	预算科目名称
pd_code	VARCHAR	是	商品编码
pd_id	VARCHAR	是	商品id
pd_source_code	VARCHAR	是	商品外部id
verify_remark	VARCHAR	是	核销备注
accounting_amount	VARCHAR	是	金额
certificate_code	VARCHAR	是	凭证编号
certificate_sync_status	VARCHAR	是	凭证同步状态
sync_message	VARCHAR	是	同步消息
creator_id	VARCHAR	是	记录创建人id
creator_name	VARCHAR	是	记录创建人账号
creator_code	VARCHAR	是	记录创建人姓名
creator_source_code	VARCHAR	是	记录创建人外部id
generate_type	VARCHAR	是	记录生成方式:1->结案生成;2->核销生成;3->手工生成;4->申请生成;5->关闭申请;6->发货冲销;7->删除申请行
create_time	VARCHAR(32)	是	记录生成时间。格式：yyyy-MM-dd HH24:mi
modify_time	VARCHAR(32)	是	修改时间。格式：yyyy-MM-dd HH24:mi
borrow_type_name	VARCHAR(32)	是	借项科目类型
lend_type_name	VARCHAR(32)	是	贷项科目类型
biz_batch_code	VARCHAR(32)	否	单据批次号
tax_rate	VARCHAR(32)	否	税率
biz_create_time	VARCHAR(32)	是	单据提交时间。格式：yyyy-MM-dd HH24:mi
project_id	VARCHAR(32)	是	项目id
project_code	VARCHAR(32)	否	项目编码
project_name	VARCHAR(32)	否	项目名称
plan_id	VARCHAR(32)	否	方案id
plan_code	VARCHAR(32)	否	方案编码
plan_name	VARCHAR(32)	否	方案名称
cost_center_code	VARCHAR(32)	否	成本中心编码
cost_center_name	VARCHAR(32)	否	成本中心名称
profit_code	VARCHAR(32)	否	利润中心编码
profit_name	VARCHAR(32)	否	利润中心名称
org_code	VARCHAR(32)	否	预算组织编码
org_name	VARCHAR(32)	否	预算组织名称
biz_row_code	VARCHAR(32)	否	业务行号
certificate_date	VARCHAR	是	过账日期。格式：yyyy-MM-dd
activity_row_no	VARCHAR(32)	否	申请行号

​ ​ ​ ​ ​

费用核算凭证回写接口

接口说明：回写凭证编码或者失败消息

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/cuxiaoCost/v1/syncAccounting/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "code": "HS202008100001",
	"certificate_sync_status": "1",
	"certificate_code": "",
    "certificate_date": "2099-08-09",
	"sync_message": "同步成功"
	
}

说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
code	VARCHAR(100)	是	TPM系统的核算记录编号
certificate_code	VARCHAR(100)	是	凭证编号。状态为“同步成功”，必须回写凭证编号
certificate_sync_status	VARCHAR(100)	是	凭证同步状态。1：同步成功，2：同步失败
certificate_date	VARCHAR(100)	是	过账日期。日期格式，同步成功的时候需回传，不必填。同步失败的时候不能回传具体值
sync_message	VARCHAR(100)	是	同步消息。如果同步失败，必须传同步消息如果同步成功，可以传可以不传，如果同步成功回传了消息，那将该字段更新为回传的，如果同步成功没有回传消息，那将该字段更新为空

参数说明：

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}

参数	说明
return_code	响应编码
return_msg	响应信息
msg_id	消息ID

支付方式新增

接口说明：新增支付方式基础数据，状态为“启用”。 请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/budget/v1/addPayMode/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "name":"openapi方式",
  "source_code":"20230619001",
  "sequence":"1",
  "accounting_subject_code":"KM2022011201",
  "invoice_subject_code":"KM2022011201",
  "use_rebate_account":"0",
  "use_invoice":"0"
}

说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
name	VARCHAR(100)	是	支付方式
source_code	VARCHAR(100)	否	支付方式外部id
sequence	VARCHAR(100)	是	排序号
accounting_subject_code	VARCHAR(100)	否	费用核销贷项科目编码(在系统中存在)
invoice_subject_code	VARCHAR(100)	否	关联发票贷项科目编码(在系统中存在)
use_rebate_account	VARCHAR(100)	否	返利方式(0:不关联; 1:费用池; 2:赠品池（仅分销版）; )
use_invoice	VARCHAR(100)	否	关联发票(0:否; 1:是;)

参数说明：

{
  "return_code": "0",
  "return_msg": "支付方式新增成功。",
  "msg_id": "{ msg_id }",
  "response_data": null
}

参数	说明
return_code	响应编码
return_msg	响应信息
msg_id	消息ID
response_data	响应返回值

支付方式查询

接口说明：查询支付方式基础数据。 请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/budget/v1/queryPayMode/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "id":"8062610321850485429",
  "name":"发票",
  "source_code":"",
  "page_number":"1",
  "page_size":"1000"
}

说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
id	VARCHAR(100)	否	支付方式id
name	VARCHAR(100)	否	支付方式
source_code	VARCHAR(100)	否	支付方式外部id
page_number	VARCHAR(100)	否	页码 不填默认第一页
page_size	VARCHAR(100)	否	页长 不填默认1000

响应示例：

{
  "return_code": "0",
  "return_msg": "响应信息。",
  "msg_id": "{ msg_id }",
  "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "invoice_subject_name": "会计科目",
        "accounting_subject_id": "7037620463253663216",
        "accounting_subject_name": "会计科目",
        "sequence": "1",
        "invoice_subject_source_code": "",
        "use_rebate_account": "0",
        "name": "openapi方式",
        "invoice_subject_id": "7037620463253663216",
        "invoice_subject_code": "KM2022011201",
        "id": "8448092065936246439",
        "accounting_subject_source_code": "",
        "use_invoice": "0",
        "source_code": "20230619001",
        "accounting_subject_code": "KM2022011201"
    }
]

参数说明：

参数	类型	说明
id	VARCHAR	支付方式id
name	VARCHAR	支付方式
source_code	VARCHAR	支付方式外部id
sequence	VARCHAR	排序号
invoice_subject_id	VARCHAR	关联发票贷项科目id
invoice_subject_code	VARCHAR	关联发票贷项科目编码
invoice_subject_name	VARCHAR	关联发票贷项科目名称
invoice_subject_source_code	VARCHAR	关联发票贷项科目外部id
accounting_subject_id	VARCHAR	费用核销贷项科目id
accounting_subject_code	VARCHAR	费用核销贷项科目编码
accounting_subject_name	VARCHAR	费用核销贷项科目名称
accounting_subject_source_code	VARCHAR	费用核销贷项科目外部id
use_rebate_account	VARCHAR	返利方式(0:不关联; 1:费用池; 2:赠品池（仅分销版）; )
use_invoice	VARCHAR	关联发票(0:否; 1:是;)

成本中心新增

接口说明：新增成本中心基础数据，新增后，状态默认为启用。 请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/budget/v1/addCostCenter/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "code":"20230619002",
  "name":"openapi方式",
  "source_code":"20230619001",
  "dept_codes":"BM21111601,IONY",
  "profit_code":"1652001",
  "profit_name":"利润中心",
  "cm_type":"第三级类型"
}

说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
code	VARCHAR(100)	是	成本中心编码，不可重复
name	VARCHAR(100)	是	成本中心名称，不可重复
source_code	VARCHAR(100)	否	成本中心外部id
dept_codes	VARCHAR(100)	否	关联部门编码（在系统中存在，多个是用,隔开）
profit_code	VARCHAR(100)	否	关联利润中心编码
profit_name	VARCHAR(100)	否	关联利润中心名称
cm_type	VARCHAR(100)	否	关联客户类型（在系统中存在）

参数说明：

{
  "return_code": "0",
  "return_msg": "成本中心新增成功。",
  "msg_id": "{ msg_id }",
  "response_data": null
}

参数	说明
return_code	响应编码
return_msg	响应信息
msg_id	消息ID
response_data	响应返回值

成本中心查询

接口说明：查询成本中心基础数据。 请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/budget/v1/queryCostCenter/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "id":"8911084487849930525",
  "code":"20230628001",
  "name":"",
  "source_code":"",
  "page_number":"1",
  "page_size":"1000"
}

说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
id	VARCHAR(100)	否	成本中心id
code	VARCHAR(100)	否	成本中心编码
name	VARCHAR(100)	否	成本中心名称
source_code	VARCHAR(100)	否	成本中心外部id
page_number	VARCHAR(100)	否	页码 不填默认第一页
page_size	VARCHAR(100)	否	页长 不填默认1000

响应示例：

{
  "return_code": "0",
  "return_msg": "响应信息",
  "msg_id": "{ msg_id }",
  "response_data": "<<DATA>>"
}

数据DATA示例:

[
  {
    "code": "20230628001",
    "profit_name": "利润中心",
    "dept_codes": "IONY,BM21111601",
    "name": "openapi方式0628-001",
    "profit_code": "1652001",
    "id": "8911084487849930525",
    "source_code": "20230627001",
    "cm_type_name": "类型1"
  }
]

参数说明：

参数	类型	说明
id	VARCHAR	成本中心id
code	VARCHAR	成本中心编码
name	VARCHAR	成本中心名称
source_code	VARCHAR	成本中心外部id
dept_codes	VARCHAR	关联部门编码
profit_name	VARCHAR	关联利润中心
cm_type_name	VARCHAR	关联客户类型

会计科目新增

接口说明：新增会计科目基础数据。 请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/budget/v1/addAccountingSubject/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "code":"20230619003",
  "name":"openapi方式",
  "source_code":"20230619003",
  "type":"营销"
}

说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
code	VARCHAR(100)	是	会计科目编码，不能重复
name	VARCHAR(100)	是	会计科目名称，不能重复
source_code	VARCHAR(100)	否	会计科目外部id
type	VARCHAR(100)	否	会计科目类型，在系统中存在

参数说明：

{
  "return_code": "0",
  "return_msg": "会计科目新增成功。",
  "msg_id": "{ msg_id }",
  "response_data": null
}

参数	说明
return_code	响应编码
return_msg	响应信息
msg_id	消息ID
response_data	响应返回值

会计科目查询

接口说明：查询会计科目基础数据，状态为“启用”。 请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/budget/v1/queryAccountingSubject/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "id":"8448092065936246439",
  "code":"",
  "name":"",
  "source_code":"",
  "type":"营销",
  "page_number":"1",
  "page_size":"1000"
}

说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
id	VARCHAR(100)	否	会计科目id
code	VARCHAR(100)	否	会计科目编码
name	VARCHAR(100)	否	会计科目名称
source_code	VARCHAR(100)	否	会计科目外部id
type	VARCHAR(100)	否	会计科目类型
page_number	VARCHAR(100)	否	页码 不填默认第一页
page_size	VARCHAR(100)	否	页长 不填默认1000

响应示例：

{
  "return_code": "0",
  "return_msg": "响应信息",
  "msg_id": "{ msg_id }",
  "response_data": "<<DATA>>"
}

数据DATA示例:

[
  {
    "type_name": "营销",
    "code": "20230619003",
    "type_id": "4689251748697975644",
    "name": "openapi方式",
    "id": "6110466910833819219",
    "source_code": "20230619003"
  }
]

参数说明：

参数	类型	说明
id	VARCHAR	会计科目id
code	VARCHAR	会计科目编码
name	VARCHAR	会计科目名称
source_code	VARCHAR	会计科目外部id
type_name	VARCHAR	会计科目类型

科目映射查询

接口说明：查询科目映射基础数据。 请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/budget/v1/querySubjectMapping/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "budget_subject_id":"",
  "budget_subject_code":"",
  "budget_subject_name":"",
  "budget_subject_source_code":"",
  "budget_subject_type":"营销",
  "page_number":"1",
  "page_size":"1000"
}

说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
budget_subject_id	VARCHAR(100)	否	预算科目id
budget_subject_code	VARCHAR(100)	否	预算科目编码
budget_subject_name	VARCHAR(100)	否	预算科目名称
budget_subject_source_code	VARCHAR(100)	否	预算科目外部id
budget_subject_type	VARCHAR(100)	否	预算科目类型
page_number	VARCHAR(100)	否	页码 不填默认第一页
page_size	VARCHAR(100)	否	页长 不填默认1000

响应示例：

{
  "return_code": "0",
  "return_msg": "响应信息",
  "msg_id": "{ msg_id }",
  "response_data": "<<DATA>>"
}

数据DATA示例:

[
  {
    "budget_subject_source_code": "",
    "budget_subject_id": "6792686035488363152",
    "cost_subject_id": "7037620463253663216",
    "cost_subject_source_code": "",
    "cost_subject_code": "KM2022011201",
    "proviston_subject_source_code": "",
    "cost_subject_name": "会计科目",
    "id": "5010061876177140962",
    "budget_subject_code": "KM0000001",
    "proviston_subject_name": "会计科目",
    "proviston_subject_id": "7037620463253663216",
    "budget_subject_name": "2022年进场费科目",
    "proviston_subject_code": "KM2022011201"
  }
]

参数说明：

参数	类型	说明
budget_subject_id	VARCHAR	预算科目id
budget_subject_code	VARCHAR	预算科目编码
budget_subject_name	VARCHAR	预算科目名称
budget_subject_source_code	VARCHAR	预算科目外部id
cost_subject_id	VARCHAR	费用科目id
cost_subject_code	VARCHAR	费用科目编码
cost_subject_name	VARCHAR	费用科目名称
cost_subject_source_code	VARCHAR	费用科目外部id
proviston_subject_id	VARCHAR	预提科目id
proviston_subject_code	VARCHAR	预提科目编码
proviston_subject_name	VARCHAR	预提科目名称
proviston_subject_source_code	VARCHAR	预提科目外部id