开放平台开发文档

Appearance

发票类接口 ​

发票查询下载 ​

场景：订单开票成功后，即可查询下载发票版式文件。

调用方法B2CInvoice.info
SDK 示例（Java）
java
import com.gc365.sznr.sdk.api.b2c.B2CInvoice;
import com.gc365.sznr.sdk.model.b2c.InvoiceInfoParam;

InvoiceInfoParam param = InvoiceInfoParam.builder()
    // purchaseOrderNo 与 businessNo 二选一
    .purchaseOrderNo("采购订单编号")
    .build();

InvoiceInfo info = B2CInvoice.info(param);
POST/open-api/ncp-invoice/info
请求参数 Body
purchaseOrderNostring可选
采购订单编号，与 businessNo 二选一
businessNostring可选
外部业务流水号，与 purchaseOrderNo 二选一
响应参数
msgstring可选
错误消息
codeinteger必需
响应码，200 表示正常

批量发票查询下载 ​

场景：需要根据多个采购订单编号，批量查询并下载对应的发票版式文件。

调用方法B2CInvoice.batchInfo
SDK 示例（Java）
java
import com.gc365.sznr.sdk.api.b2c.B2CInvoice;
import com.gc365.sznr.sdk.model.b2c.InvoiceInfoBatchParam;
import java.util.Arrays;

InvoiceInfoBatchParam param = InvoiceInfoBatchParam.builder()
    .purchaseOrderNos(Arrays.asList("PO20240126001", "PO20240126002"))
    .build();

List<InvoiceInfo> list = B2CInvoice.batchInfo(param);
POST/open-api/ncp-invoice/batch-info
请求参数 Body
purchaseOrderNosarray可选
采购订单编号列表，最多 500 条，与 businessNos 二选一
businessNosarray可选
外部业务流水号列表，最多 500 条，与 purchaseOrderNos 二选一
响应参数
msgstring可选
错误消息
codeinteger必需
响应码，200 表示正常

发票冲红 ​

场景：针对订单开具成功的蓝字发票，在交易发生取消或者商品退回的时候，支持整张蓝票冲红。

调用方法B2CInvoice.orderRedPunch
SDK 示例（Java）
java
import com.gc365.sznr.sdk.api.b2c.B2CInvoice;
import com.gc365.sznr.sdk.model.b2c.OrderRedPunchParam;

OrderRedPunchParam param = OrderRedPunchParam.builder()
    // purchaseOrderNo 与 businessNo 二选一
    .purchaseOrderNo("PO20240126001")
    .build();

B2CInvoice.orderRedPunch(param);
POST/open-api/ncp-invoice/order-red-punch
请求参数 Body
purchaseOrderNostring可选
订单编号，与 businessNo 二选一
businessNostring可选
外部业务流水号，与 purchaseOrderNo 二选一
reasonstring可选
冲红原因，与 reasonEnum 二者必须填一个
reasonEnumenum<string>可选
开票错误原因枚举，与 reason 二者必须填一个
枚举值:
INVOICE_ERROR开票有误
SALES_RETURN销货退回
SERVICE_SUSPENSION服务中止
SALES_DISCOUNT销售折让
响应参数
msgstring可选
显示消息内容
codeinteger必需
响应码，200 表示接口请求正常
dataobject可选
请求数据结构体

发票冲红结果查询 ​

场景：针对订单已经发起冲红的，可以调用此接口查询冲红结果。

调用方法B2CInvoice.redInvoiceResult
SDK 示例（Java）
java
import com.gc365.sznr.sdk.api.b2c.B2CInvoice;
import com.gc365.sznr.sdk.model.b2c.RedInvoiceResultParam;

RedInvoiceResultParam param = RedInvoiceResultParam.builder()
    // purchaseOrderNo 与 businessNo 二选一
    .purchaseOrderNo("PO20240126001")
    .build();

RedInvoiceResult result = B2CInvoice.redInvoiceResult(param);
POST/open-api/ncp-invoice/red-invoice-result
请求参数 Body
purchaseOrderNostring可选
采购订单编号，与 businessNo 二选一
最大长度 64
businessNostring可选
外部业务流水号，与 purchaseOrderNo 二选一
最大长度 64
响应参数
msgstring可选
错误消息
codeinteger必需
响应码，200 表示正常

重试开票 ​

场景：针对订单开具失败的情况，支持调用此接口重试开票，主要针对企业没有发票额度、未报税、局端升级导致的开票失败订单重试开票。

调用方法B2CInvoice.manualRetry
SDK 示例（Java）
java
import com.gc365.sznr.sdk.api.b2c.B2CInvoice;
import com.gc365.sznr.sdk.model.b2c.ManualRetryParam;

ManualRetryParam param = ManualRetryParam.builder()
    // purchaseOrderNo 与 businessNo 二选一
    .purchaseOrderNo("PO20240126001")
    .build();

B2CInvoice.manualRetry(param);
POST/open-api/ncp-invoice/manual-retry
请求参数 Body
purchaseOrderNostring可选
采购订单编号，与 businessNo 二选一
最大长度 64
businessNostring可选
外部业务流水号，与 purchaseOrderNo 二选一
最大长度 64
响应参数
msgstring必需
显示消息内容
codeinteger必需
响应码，200 表示接口请求正常
dataenum<integer>必需
开票状态
枚举值:
0待开票
1开票中
2已开票
3开票失败
4红冲中
5已红冲
6红冲失败
okboolean必需
响应状态，true 表示成功，false 表示失败
requestIdstring必需
响应单号