机构商户号和外部商户号不能同时为空,当在boss平台存在机构商户号时,请使用机构商户号;当在boss平台不存在机构商户号时,将会使用外部商户号创建一个新的机构商户。
当使用外部商户号调用接口时,如果发生网络异常等情况导致无法得知请求是否到达服务器,也无法获取机构商户号,请使用外部商户号调用 /invoice/getEnterpriseInfo 查询信息:
返回 code = -12,表示还未创建机构商户号,再次使用外部商户号进行企业注册。
返回 code = -1,表示已创建机构商户号,使用机构商户号进行企业注册。
返回 code = 0,表示已创建机构商户号,且已注册电子发票,继续判断审核状态status,非成功或失败的状态下,每10分钟查询一次。
审核不通过时,修改相关字段后,使用机构商户号再次注册。
| 接口名称:/open/invoice/registerEInvoice |
|---|
请求参数:
| 字段 | 类型 | 必填项 | 描述 |
| agencyId | number | 是 | 机构号 |
| merchantCode | text | 是 | 机构商户号 |
| outMerchantCode | text | 是 | 外部商户号 |
| taxpayerNum | text | 是 | 纳税识别号 |
| enterpriseName | text | 是 | 企业名称 |
| legalPersonName | text | 是 | 法人名称 |
| contactsName | text | 是 | 企业联系人姓名 |
| contactsEmail | text | 是 | 企业联系人邮箱 |
| contactsPhone | text | 是 | 企业联系人手机 |
| casherName | text | 是 | 开票时的收款人 |
| reviewerName | text | 是 | 开票时的复核人 |
| drawerName | text | 是 | 开票时的开票人 |
| invitationCode | text | 否 | 邀请码 可空 |
| regionCode | text | 是 | 省份编码 |
| cityName | text | 是 | 市(地区)名称 |
| enterpriseAddress | text | 是 | 不包含省市名称的详细地址 |
| taxRegistrationCertificate | text | 是 | 税务登记证图片内容(base64) |
| notifyUrl | text | 否 | 注册结果后台通知地址 |
响应:
| merchantCode | text | 机构商户号 |
后台通知:
通知类型 event: RegisterNotify
| code | text | 注册状态:0000 审核通过,9991 审核不通过 |
| msg | text | 注册状态描述 |
| taxpayerNum | text | 纳税识别号 |
| enterpriseCode | text | 企业平台编码 |
| registrationCode | text | 注册码 |
| authorizationCode | text | 授权码 |
接入商接收到异步通知后,响应“SUCCESS”这7个大写字母即表示通知成功,不成功的将会在下次尝试通知,通知频率为5s/10s/15s ······,最多通知20次