退出
热词搜索：
API接口目录

政企业务

政企商品API
政企价格API
政企库存API
政企订单API
政企物流API
政企发票API
政企售后API
政企其他API
政企易企购API
政企抽检API
异常码自查工具
suning.govbus.invoicesupplement.confirm 补开发票接口(新)
￥免费

政企API客户下单选择暂不开票后，调用此接口补开发票。若开普票则需传入发票抬头。传入统一增票时，若客户已认证了增票资质，无需传入增票信息，若客户未认证或未录入认证增票信息，需换入增票的必填信息。

开票时商品标题最大支持70字符

公共参数
请求参数
名称 类型 是否必须 示例值 描述
applyForInvoiceReqDTOStringN
addressStringN江苏省南京市秦淮区法院发票收件人详细地址,除电子发票外必填
companyNameStringN江苏舜天有限公司公司名称 (传入增票信息时必传)
consigneeMobileNumStringN17856789012发票收件人手机号,必填(电子发票也必填)
consigneeNameStringN张三发票收件人姓名,除电子发票外必填
invoiceContentStringN1发票内容 1:明细
invoiceTypeStringY6发票类型 2：普票 ，4：电子发票，6：增票
regAccountStringN23235254664336银行账户（传入增票信息时必传）
regAddStringN江苏省南京市雨花区软件大道舜天集团注册地址（传入增票信息时必传）
regBankStringNXXX银行开户银行（传入增票信息时必传）
regTelStringN025-84797157注册电话（传入增票信息时必传）
taxNoStringN32534346637纳税人识别号（传入增票信息时必传）
titleStringY南京苏宁软件有限公司发票抬头
markIdStringYxxx1000000客户自定义,申请单号（结算单号）,同一客户不允许重复,后续根据此字段查询消息及撤回开票申请等
remarkStringNXXXXXXX发票备注信息（限制70字符以内）
orderInfoDTOStringN
gcOrderNoStringN23423524334苏宁政企订单号 (gcOrderNo、gcOrderItemNo 单次调用仅允许入参其中一种) 按单开票需要此订单内所有行满足开票条件
gcItemNoStringN2342352433401苏宁政企订单行号 (gcOrderNo、gcOrderItemNo 单次调用仅允许入参其中一种) 按行开票需要入参所有行满足开票条件即可
响应参数
名称 类型 示例值 描述
campSuccessStringYY 成功，N失败
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <confirmInvoicesupplement>
      <orderInfoDTO>
        <gcOrderNo>23423524334</gcOrderNo>
        <gcItemNo>2342352433401</gcItemNo>
      </orderInfoDTO>
      <applyForInvoiceReqDTO>
        <regAccount>23235254664336</regAccount>
        <regTel>025-84797157</regTel>
        <invoiceContent>1</invoiceContent>
        <address>江苏省南京市秦淮区法院</address>
        <markId>xxx1000000</markId>
        <companyName>江苏舜天有限公司</companyName>
        <regAdd>江苏省南京市雨花区软件大道舜天集团</regAdd>
        <remark>XXXXXXX</remark>
        <title>南京苏宁软件有限公司</title>
        <consigneeName>张三</consigneeName>
        <consigneeMobileNum>17856789012</consigneeMobileNum>
        <invoiceType>6</invoiceType>
        <regBank>XXX银行</regBank>
        <taxNo>32534346637</taxNo>
      </applyForInvoiceReqDTO>
    </confirmInvoicesupplement>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "confirmInvoicesupplement": {
        "orderInfoDTO": [
          {
            "gcOrderNo": "23423524334",
            "gcItemNo": "2342352433401"
          }
        ],
        "applyForInvoiceReqDTO": {
          "regAccount": "23235254664336",
          "regTel": "025-84797157",
          "invoiceContent": "1",
          "address": "江苏省南京市秦淮区法院",
          "markId": "xxx1000000",
          "companyName": "江苏舜天有限公司",
          "regAdd": "江苏省南京市雨花区软件大道舜天集团",
          "remark": "XXXXXXX",
          "title": "南京苏宁软件有限公司",
          "consigneeName": "张三",
          "consigneeMobileNum": "17856789012",
          "invoiceType": "6",
          "regBank": "XXX银行",
          "taxNo": "32534346637"
        }
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <confirmInvoicesupplement>
      <campSuccess>Y</campSuccess>
    </confirmInvoicesupplement>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "confirmInvoicesupplement": {
        "campSuccess": "Y"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.govbus.confirminvoicesupplement.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.govbus.confirminvoicesupplement.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.govbus.confirminvoicesupplement.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.gcapi 服务不可用 请联系苏宁技术人员
biz.govbus.confirminvoicesupplement.invalid-biz:100 输入报文格式错误 输入报文格式错误
biz.govbus.confirminvoicesupplement.invalid-biz:101 输入报文格式错误 输入报文格式错误
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ