API开放平台

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": "",
        "certificate_date": "2022-05-11",
        "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": "常规-维值权限"
    }
]

参数说明：

参数 类型 必填 说明
code VARCHAR 是 记录编号
biz_code VARCHAR 是 业务单据编号
biz_id VARCHAR 是 结案明细id
func_id VARCHAR 是 申请明细id (按方案申请时：是申请单中付费项目ID 固定金额促销申请时：如果是按连锁品牌申请的，是连锁品牌申请行ID。按客户申请的，是客户申请行ID 进货折让：客户申请行ID)
verification_row_id VARCHAR 否 核销明细ID
apply_type VARCHAR 是 申请类型。0：付费陈列、1：固定进货促销、2：进货折让
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 是 客户名称
customer_dept_id VARCHAR 是 客户部门ID
dept_code VARCHAR 是 客户部门编码
dept_name VARCHAR 是 客户部门名称
dealer_id VARCHAR 是 费用代垫经销商ID
dealer_code VARCHAR 是 费用代垫经销商编码
dealer_name VARCHAR 是 费用代垫经销商名称
dealer_dept_id VARCHAR 是 经销商部门ID
dealer_dept_code VARCHAR 是 经销商部门编码
dealer_dept_name VARCHAR 是 经销商部门名称
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 是 商品编码
verify_remark VARCHAR 是 核销备注
accounting_amount VARCHAR 是 金额
certificate_code VARCHAR 是 凭证编号
certificate_date VARCHAR 是 过账日期。格式：yyyy-MM-dd
certificate_sync_status VARCHAR 是 凭证同步状态
sync_message VARCHAR 是 同步消息
creator_name VARCHAR 是 记录创建人账号
creator_code VARCHAR 是 记录创建人姓名
generate_type VARCHAR 是 记录生成方式:1->结案生成;2->核销生成;3->手工生成;4->申请生成;5->关闭申请
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_code VARCHAR(32) 否 项目编码
project_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) 否 业务行号

​ ​ ​ ​ ​

# 费用核算凭证回写接口

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

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

{
    "code": "HS202008100001",
	"certificate_sync_status": "1",
	"certificate_code": "",
	"sync_message": "同步成功"
	
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
code VARCHAR(100) 是 TPM系统的核算记录编号
certificate_code VARCHAR(100) 是 凭证编号。状态为“同步成功”，必须回写凭证编号
certificate_sync_status VARCHAR(100) 是 凭证同步状态。1：同步成功，2：同步失败
sync_message VARCHAR(100) 是 同步失败消息。状态为“同步失败”，必须回写失败消息

参数说明：

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 响应信息
msg_id 消息ID

← 费用预算接口 →