搜索
1、XMDJ、XMJE长度最大为12位，开具十万以上百万以下发票时，小数位数做相应的减位。2、FPQQLSH必须唯一，企业内部可有1笔订单对应多个FPQQLSH流水号，但一个FPQQLSH必须对应唯一一张发票（此类情况一般发生在有退换发票的情况，需要红冲一次，再另外开具一张蓝票给到顾客，此时1笔订单对应3个流水号，但每个流水号对应的发票只有1张，如果企业允许多次提交更换发票的情况，那1笔订单则对应多个FPQQLSH，企业需要对这个FPQQLSH制定规则，例如：蓝票：BWDZLP201700001；红冲：BWDZHC201700001），如果遇到请求失败的，以原先的流水号内容不变再次发起请求，不可变更流水号，相同流水号重复请求的间隔建议设置时间600秒以上，防止重复开票。3、XMSL和XMDJ中如果填写了其中1项就必须填写另一项内容，或者都不填写，建议填写数量及单价，规范格式4、FPQQLSH长度要求20位以内只可以是字母+数字（全局唯一）5、开折扣的情况折扣行与被折扣行的XMMC必须相同，折扣行的FPHXZ为1，被折扣行的FPHXZ为2.6、对于微信扫码开票的情况或企业ERP开票模式的需要对企业的单张开票最大限额做了解，对于1笔订单的金额超过单张发票允许开具最大限额的，需对订单金额进行拆分开具发票。7、开具红字发票时数量、合计金额、税额都为负数，单价为正数8、手机号的正则表达式为：^[1][3,4,5,6,7,8][0-9]{9}$邮箱号的正则表达式为：\\w+([-+.]\\w+)*@\\w+([-.]\\w+)*\\.\\w+([-.]\\w+)*9、GMF_NSRSBH的字段必须为0、15—20位，只能包含数字和字母，且不能全部值都是010、开票提示“异常情况”销售方税号、名称要与发行的核心板上的税号、名称一致。注意大小写、中英文括弧、半角、全角字符、空格11、需要对开具红字发票做一定的控制，由于票种切换、供应商切换等原因，百望对红字发票权限进行了放宽，对于不存在数据库的发票需要红冲不再校验原蓝字发票的代码号码等信息，所以再开具红字发票前需要对原订单开具的发票进行对应，以防出现开具的红字没法对应到原蓝字发票信息。如果频繁发送相同的红冲请求就会导致该问题。建议业务端红冲发票失败情况下，再次请求时间间隔在600秒以上开具蓝票调用接口如果未收到有效返回信息，需要重新用原数据调用，开票请求流水号不做变更，重复请求间隔设置600秒以上。12、对于公司名称有括号的情况，一定要注意核心板发行的是英文状态括号还是中文状态括号13、开票抬头、地址电话等内容中，xml的特殊字符都不能填写14、单价*数量=项目金额，项目金额*税率=税额，各项目金额总和=合计金额；各项目税额总和=合计税额；金额+税额=价税合计（不允许有误差）不含税金额=价税合计/（1+税率），税额=不含税金额*税率，价税合计=不含税金额（允许1分钱误差）+税额（允许6分钱误差）15、商品明细单价不能为0，发票最终开具的价税合计不能为0，最少为0.01元16、为解决尾差，单价*数量=金额，可以有1分钱误差，金额*税率=税额，可以有6分钱误差。金额+税额=价税合计（不允许有误差）17、为空的节点不要穿null，直接传空18、建议企业一套自动重新调用接口的机制，在出现网络或其他情况错误导致第一次调用接口不成功的情况下，间隔性重复调用。19、0税率的spbm需要配置YHZCBS、LSLBS、2ZZSTSGL这几个个字段，如SPBM6010000000000000000/SPBMYHZCBS1/YHZCBSLSLBS2/LSLBSZZSTSGL不征税/ZZSTSGL具体参考接口文档46-47-48项。错误代码：0000成功0000此发票已经开具过10002：销方信息不合法10003：购方信息不合法10004：发票请求流水号超长或电子发票流水号为空10005：收款人，复核人，开票人或备注信息不合法10006：合计金额税额等信息不合法10007：第X行商品信息不合法10008：明细累加与合计金额不正确10141：税率传入的值不合法10030：根据开票终端或纳税人识别号获取税控服务器的信息失败10034：红票原发票代码号码格式有误10035：第1行发票行性质有误10140：增值税特殊管理传入的值不合法10143：零税率标识不为空时，传入的税率应该为010144：根据商品编码未查到相关商品信息10087:开具的发票金额已大于原票累计金额或税额，不能开1988：通信失败：建立连接失败9996传入的请求数据格式不正确，请仔细检查核对！9997不存在该纳税人税号为【XXXXXXXXXXXXXXX】的appid信息！9997开票方纳税人识别号不能为空！00F134:不支持该类型税率092400命令中的参数有错09D110:发票类型不存在09D121超过离线开票限定金额09D122超过离线开票上传限定截止日期09D125开负数发票时原发票累计负数金额超限09D11F超过离线开票限定时长09D013发票领用信息已用完09D109已到开票截止日期，禁止开票09D101已超过单张发票开票金额限额09E1A1通讯失败00F103Socket连接有误00F114获取监控管理数据