淘宝开放平台

登录
文档中心 > API类目 > 电子发票

电子发票

qimen.alibaba.einvoice.tax.user.register (自然人注册成虚拟/实体个体工商户)

将自然人信息传给isv，isv会将自然人注册成实体/虚拟个体工商户，从而让自然人享有税优的政策

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
company_code String 必须 TAOHUA 业务平台编码, 由税优中台分配
identification_number String 必须 123123123 用户身份证号码，和注册模式来做接口幂等
platform_user_identification String 必须 123456 用户在税优化平台ID
user_name String 必须 张三 用户姓名
ext_json String 可选 {} 请求扩展信息，用与业务系统透传业务要素
identity_back_pic String 可选 Q+Uzb1PJrEk4QknrU8sOqWJEhBHxiH 用户身份证照片背面base64后的字符串，长度2800000(根据业务场景必要性评估是否提供)
contract_url String 可选 https://xxxxx 用户三方合约url
identity_front_pic String 可选 Q+Uzb1PJrEk4QknrU8sOqWJEhBHxiH 用户身份证照片正面base64后的字符串，长度2800000(根据业务场景必要性评估是否提供)
register_mode String 必须 VIRTUAL_SELF_EMPLOYEE 注册模式
mobile_phone String 可选 13111111111 用户手机号
face_pic String 可选 Q+Uzb1PJrEk4QknrU8sOqWJEhBHxiH 用户人脸认证时的图片
contractor_code String 可选 ContractCompany 税筹服务商的编码

响应参数

名称 类型 示例值 描述
result String false 注册结果
result_msg String 系统繁忙 错误描述
ext_json String {} 响应扩展信息，用与ISV系统透传业务要素
result_code String isp.system-error 错误码
temporary_register_no String 123456789012345 临时税务登记证号

请求示例

{"identification_number":"123123123","user_name":"张三","mobile_phone":"13111111111","ext_json":"{}","contractor_code":"ContractCompany","face_pic":"Q+Uzb1PJrEk4QknrU8sOqWJEhBHxiH","company_code":"TAOHUA","register_mode":"VIRTUAL_SELF_EMPLOYEE","contract_url":"https://xxxxx","platform_user_identification":"123456","identity_back_pic":"Q+Uzb1PJrEk4QknrU8sOqWJEhBHxiH","identity_front_pic":"Q+Uzb1PJrEk4QknrU8sOqWJEhBHxiH"}

响应示例

{
    "result":"false",
    "result_msg":"系统繁忙",
    "ext_json":"{}",
    "result_code":"isp.system-error",
    "temporary_register_no":"123456789012345"
}

验签示例

{"result":"false","result_msg":"Illegal request","result_code":"sign-check-failure"}

错误码解释

错误码 错误描述 解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问
返回
顶部