企业注册电子发票

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