开放平台开发文档

Appearance

订单类接口 ​

创建采购订单 ​

场景：创建农产品采购订单，支持商品列表和附加信息。

调用方法B2SOrders.create
SDK 示例（Java）
java
import com.gc365.sznr.sdk.api.b2s.B2SOrders;
import com.gc365.sznr.sdk.model.b2s.PurchaseOrderCreateParam;
import com.gc365.sznr.sdk.model.b2s.OrderProduct;
import java.math.BigDecimal;
import java.util.Arrays;

// 构建商品
OrderProduct product = OrderProduct.builder()
    // 设置商品信息
    .build();

PurchaseOrderCreateParam param = PurchaseOrderCreateParam.builder()
    .totalPrice(new BigDecimal("1000.00"))
    .taxAmount(new BigDecimal("90.00"))
    .netTotalPrice(new BigDecimal("910.00"))
    .products(Arrays.asList(product))
    .customerName("XX农业公司")
    .customerUscc("91110000XXXXXXXXXX")
    .businessNo("B2S20240126001")
    .build();

PurchaseOrderCreateResult result = B2SOrders.create(param);
System.out.println("订单号: " + result.getPurchaseOrderNo());
POST/open-api/geo-agri-center/ncp-purchase-order/create
请求参数 Body
businessNostring必需
业务流水号，唯一识别
最大长度 50
customerNamestring必需
采购商名称
最大长度 100
customerUsccstring必需
采购商统一社会信用代码
长度 18
totalPricenumber必需
商品总金额（含税）
decimal(12, 2)
netTotalPricenumber必需
不含税总金额
decimal(12, 2)
taxAmountnumber必需
税额
decimal(12, 2)
响应参数
codeinteger必需
响应码，200 表示正常
msgstring可选
错误消息

查询采购订单 ​

场景：通过订单编号或业务流水号查询采购订单详情，包括支付状态、发票状态及商品信息。

调用方法B2SOrders.queryOne
SDK 示例（Java）
java
import com.gc365.sznr.sdk.api.b2s.B2SOrders;
import com.gc365.sznr.sdk.model.b2s.PurchaseOrderQueryParam;

PurchaseOrderQueryParam param = PurchaseOrderQueryParam.builder()
    .purchaseOrderNo("PO20240126001")
    .build();

PurchaseOrderQueryResult result = B2SOrders.queryOne(param);
POST/open-api/geo-agri-center/ncp-purchase-order/one
请求参数 Body
purchaseOrderNostring可选
采购订单编号（与 businessNo 二选一）
businessNostring可选
业务流水号（与 purchaseOrderNo 二选一）
响应参数
codeinteger必需
响应码，200 表示正常
msgstring可选
错误消息

订单支付+开票 ​

场景：对已创建的采购订单进行支付并同时开具发票。通过订单编号或业务流水号指定订单。

调用方法B2SOrders.payAndInvoice
SDK 示例（Java）
java
import com.gc365.sznr.sdk.api.b2s.B2SOrders;
import com.gc365.sznr.sdk.model.b2s.PurchaseOrderPayParam;

PurchaseOrderPayParam param = PurchaseOrderPayParam.builder()
    .purchaseOrderNo("PO20240126001")
    .build();

B2SOrders.payAndInvoice(param);
POST/open-api/geo-agri-center/ncp-purchase-order/pay-and-invoice
请求参数 Body
purchaseOrderNostring可选
订单编号（与 businessNo 二选一）
businessNostring可选
业务流水号（与 purchaseOrderNo 二选一）
响应参数
codeinteger必需
响应码，200 表示正常
msgstring可选
错误消息
dataobject必需
响应数据

订单退款+红冲 ​

场景：对已支付的采购订单进行退款，同时对已开具的发票进行红冲处理。

调用方法B2SOrders.refundAndRedInvoice
SDK 示例（Java）
java
import com.gc365.sznr.sdk.api.b2s.B2SOrders;
import com.gc365.sznr.sdk.model.b2s.PurchaseOrderRefundParam;

PurchaseOrderRefundParam param = PurchaseOrderRefundParam.builder()
    .purchaseOrderNo("PO20240126001")
    .build();

B2SOrders.refundAndRedInvoice(param);
POST/open-api/geo-agri-center/ncp-purchase-order/refund-and-red-invoice
请求参数 Body
purchaseOrderNostring可选
订单编号（与 businessNo 二选一）
businessNostring可选
业务流水号（与 purchaseOrderNo 二选一）
reasonenum<string>必需
退款原因
枚举值:
INVOICE_ERROR开票有误
SALES_RETURN销货退回
响应参数
codeinteger必需
响应码，200 表示正常
msgstring可选
错误消息
dataobject必需
响应数据