# 预算费控

# 费用核算记录查询接口

请求方式: 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",
        "actual_cm_id": "1234",
        "actual_cm_code": "cus1231",
        "actual_cm_name": "客户",
        "actual_cm_source_code": "111",
        "actual_dealer_id": "1234",
        "actual_dealer_code": "cus1231",
        "actual_dealer_name": "客户",
        "actual_dealer_source_code": "111",
        "cm_id": "1234",
        "cm_code": "cus1231",
        "cm_name": "客户",
        "cm_source_code": "111",
        "upper_dealer_id": "1234",
        "upper_dealer_code": "cus1231",
        "upper_dealer_name": "客户",
        "upper_dealer_source_code": "111"
    }
]

参数说明:

参数 类型 必填 说明
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
actual_cm_id VARCHAR 实际核销客户ID
actual_cm_code VARCHAR 实际核销客户编码
actual_cm_name VARCHAR 实际核销客户名称
actual_cm_source_code VARCHAR 实际核销客户外部ID
actual_dealer_id VARCHAR 实际代垫经销商ID
actual_dealer_code VARCHAR 实际代垫经销商编码
actual_dealer_name VARCHAR 实际代垫经销商名称
actual_dealer_source_code VARCHAR 实际代垫经销商外部ID
cm_id VARCHAR 申请客户ID
cm_code VARCHAR 申请客户编码
cm_name VARCHAR 申请客户名称
cm_source_code VARCHAR 申请客户外部ID
upper_dealer_id VARCHAR 申请代垫经销商ID
upper_dealer_code VARCHAR 申请代垫经销商编码
upper_dealer_name VARCHAR 申请代垫经销商名称
upper_dealer_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