API开放平台

TIP

# 开票信息接口

# 新增开票信息

请求方式： 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) 否 勤策的客户唯一标识，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) 否 勤策的客户唯一标识，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": "082901",
 "cm_waiqin365_id": "8913445946038614084",
 "invoice_id": "test001",
 "invoice_waiqin365_id": "8297111851472788530"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
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": "082901",
 "cm_waiqin365_id": "8913445946038614084",
 "cm_code": "test001"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
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

← 客户合同接口 →