# 开票信息接口
# 新增开票信息
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/invoice/v1/addInvoice/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
cm_id | VARCHAR(32) | 否 | 来源于第三方的客户唯一标识 |
cm_waiqin365_id | VARCHAR(32) | 否 | 勤策的客户唯一标识,cm_id和cm_waiqin365_id不能同时为空,如果同时存在优先取cm_waiqin365_id |
invoice_id | VARCHAR(32) | 是 | 开票信息唯一标识,来源于第三方系统的唯一开票信息标识 |
name | VARCHAR(32) | 是 | 开票名称 |
taxpayer_code | VARCHAR(32) | 否 | 纳税人识别号 |
address | VARCHAR(32) | 否 | 单位地址 |
tel | VARCHAR(32) | 否 | 电话号码 |
account_name | VARCHAR(32) | 否 | 开户银行名称 |
account_code | VARCHAR(32) | 否 | 银行账户号码 |
响应示例:
{
"msg_id": "X000001",
"return_code": 0,
"return_msg": ""
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
msg_id | String | 请求消息ID |
return_code | int | 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window) |
return_msg | String | 响应说明 |
# 修改开票信息
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/invoice/v1/modifyInvoice/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
cm_id | VARCHAR(32) | 否 | 来源于第三方的客户唯一标识 |
cm_waiqin365_id | VARCHAR(32) | 否 | 勤策的客户唯一标识,cm_id和cm_waiqin365_id不能同时为空,如果同时存在优先取cm_waiqin365_id |
invoice_id | VARCHAR(32) | 否 | 开票信息唯一标识,来源于第三方系统的唯一开票信息标识 |
invoice_waiqin365_id | VARCHAR(32) | 否 | 勤策开票信息唯一标识, invoice_id和invoice_waiqin365_id不能同时为空,如果同时存在优先取invoice_waiqin365_id |
name | VARCHAR(32) | 是 | 开票名称 |
taxpayer_code | VARCHAR(32) | 否 | 纳税人识别号 |
address | VARCHAR(32) | 否 | 单位地址 |
tel | VARCHAR(32) | 否 | 电话号码 |
account_name | VARCHAR(32) | 否 | 开户银行名称 |
account_code | VARCHAR(32) | 否 | 银行账户号码 |
响应示例:
{
"msg_id": "X000001",
"return_code": 0,
"return_msg": ""
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
msg_id | String | 请求消息ID |
return_code | int | 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window) |
return_msg | String | 响应说明 |
# 删除开票信息
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/invoice/v1/removeInvoice/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
cm_id | VARCHAR(32) | 否 | 来源于第三方的客户唯一标识 |
cm_waiqin365_id | VARCHAR(32) | 否 | 勤策的客户唯一标识,cm_id和cm_waiqin365_id不能同时为空,如果同时存在优先取cm_waiqin365_id |
invoice_id | VARCHAR(32) | 否 | 开票信息唯一标识,来源于第三方系统的唯一开票信息标识 |
invoice_waiqin365_id | VARCHAR(32) | 否 | 勤策开票信息唯一标识, invoice_id和invoice_waiqin365_id不能同时为空,如果同时存在优先取invoice_waiqin365_id |
响应示例:
{
"msg_id": "X000001",
"return_code": 0,
"return_msg": ""
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
msg_id | String | 请求消息ID |
return_code | int | 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window) |
return_msg | String | 响应说明 |
# 开票信息查询
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/invoice/v1/queryInvoice/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
cm_id | VARCHAR(32) | 否 | 来源于第三方的客户唯一标识,和勤策的客户唯一标识、客户编码不能同时为空 |
cm_waiqin365_id | VARCHAR(32) | 否 | 勤策的客户唯一标识,和第三方的客户唯一标识、客户编码不能同时为空 |
cm_code | VARCHAR(100) | 否 | 客户编码,和勤策的客户唯一标识、第三方的客户唯一标识不能同时为空,(勤策客户唯一标识、第三方客户唯一标识、客户编码 同时出现时,取值优先级依次降低) |
响应示例:
{
"msg_id": "X000001",
"return_code": 0,
"return_msg": "",
"return_data": "<<DATA>>"
}
数据DATA示例:
[
{
"account_code": "123",
"account_name": "南京银行",
"address": "南京建业",
"cm_code": "cs0001",
"cm_id": "123456",
"cm_waiqin365_id": 4819457034069704750,
"invoice_waiqin365_id": 5952195990957977246,
"name": "测试开票1",
"status": "1",
"taxpayer_code": "123456",
"tel": "12322225555",
"invoice_id": "cs1111",
"exts":[
{
"ext_column":"ext_11072",
"ext_key":"数值001",
"ext_value":"10"
}
]
}
]
参数说明:
参数 | 类型 | 说明 |
---|---|---|
account_code | String | 开户银行号码 |
account_name | int | 开户银行名称 |
address | String | 单位地址 |
cm_code | String | 客户编码 |
cm_id | String | 来源于第三方的客户唯一标识 |
cm_waiqin365_id | String | 勤策的客户唯一标识 |
invoice_waiqin365_id | String | 开票信息勤策唯一标识 |
invoice_id | String | 开票信息第三方系统唯一标识 |
name | String | 开票名称 |
status | String | 删除标识。0:代表删除,1:代表未删除 |
taxpayer_code | String | 纳税人识别号 |
tel | String | 电话号码 |
exts | List | 自定义字段列表 |
exts.ext_key | String | 自定义字段key |
exts.ext_value | String | 自定义字段value |
exts.ext_column | String | 自定义字段column |
← 客户付款方关系维护接口 客户合同接口 →