企业注册电子发票

机构商户号和外部商户号不能同时为空,当在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次