# 开票信息接口

# 新增开票信息

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/invoice/v1/addInvoice/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
 "cm_id": "CM0001",
 "cm_waiqin365_id": "1236513267651",
 "invoice_id": "IN13214",
 "name": "通用开票单",
 "taxpayer_code": "523658222295",
 "address": "江苏省南京市南京路XXXX号",
 "tel": "12665453429",
 "account_name": "工行",
 "account_code": "TX32134f"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
cm_id VARCHAR(32) 来源于第三方的客户唯一标识
cm_waiqin365_id VARCHAR(32) 勤策(原外勤365)的客户唯一标识,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": "CM0001",
 "cm_waiqin365_id": "1236513267651",
 "invoice_id": "IN13214",
 "invoice_waiqin365_id": "23476456747",
 "name": "通用开票单",
 "taxpayer_code": "523658222295",
 "address": "江苏省南京市南京路XXXX号",
 "tel": "12665453429",
 "account_name": "工行",
 "account_code": "TX32134f"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
cm_id VARCHAR(32) 来源于第三方的客户唯一标识
cm_waiqin365_id VARCHAR(32) 勤策(原外勤365)的客户唯一标识,cm_id和cm_waiqin365_id不能同时为空,如果同时存在优先取cm_waiqin365_id
invoice_id VARCHAR(32) 开票信息唯一标识,来源于第三方系统的唯一开票信息标识
invoice_waiqin365_id VARCHAR(32) 勤策(原外勤365)开票信息唯一标识, 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": "082901",
 "cm_waiqin365_id": "8913445946038614084",
 "invoice_id": "test001",
 "invoice_waiqin365_id": "8297111851472788530"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
cm_id VARCHAR(32) 来源于第三方的客户唯一标识
cm_waiqin365_id VARCHAR(32) 勤策(原外勤365)的客户唯一标识,cm_id和cm_waiqin365_id不能同时为空,如果同时存在优先取cm_waiqin365_id
invoice_id VARCHAR(32) 开票信息唯一标识,来源于第三方系统的唯一开票信息标识
invoice_waiqin365_id VARCHAR(32) 勤策(原外勤365)开票信息唯一标识, 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 响应说明