API文档

采购单信息

批量获取采购单行列表(根据下单时间)

说明：

​ 根据采购单下单时间段，批量查询采购单行信息

请求描述：

	HTTP请求方式：GET
	HTTP请求头类型：Content-Type=application/json
	API: /v1/sp/procurement/orders

请求参数：

1、公共参数

​ 详情可查看在【开发规范】中的系统级参数中查看

2、业务参数

参数名称 类型 是否必填 缺省值 参数描述
page int 否 1 第几页，商品过多时请分页查询
pageSize int 否 10 单页获取个数，最大100
state int 否 1 数据类型,可选项【1：预处理，2:延期，3:待发货，4:异常清单，5:在途退，99：ALL】
executionDate string 否 下单日期，格式MM/dd/yyyy-MM/dd/yyyy
updateTimeStart string 否 更新时间，格式2020-11-28T00:00:00
updateTimeEnd string 否 更新时间，格式2020-12-01T00:00:00

​ 注：如果要使用更新时间进行查询，必须包含更新开始时间

业务示例

{host}/v1/sp/procurement/orders?
token=你的token
&businessId=你的业务id
&timestamp=发起请求的时间戳
&page=1
&pageSize=10
&executionDate=10/15/2023-10/15/2023
&state=99
&updateTimeStart=2023-10-15T00:00:00
&updateTimeEnd=2023-10-15T23:59:59

响应参数

名称 类型 描述
success boolean 结果状态，true请求成功，false请求失败
detail string 错误信息
status int 错误码
data array 采购单行信息
page int 页数
pageSize int 单页最大size
pageSize int 总数

data

名称 类型 描述
executionDate long 下单时间
orderId int 采购单号
deliveryDate long 预计发货时间
storage string 送货地址
orderLineId int 采购单行号
shippingType string 采购单收货类型
productName string 商品名称
productNameEn string 商品英文名称
barCode string 产品条形码
merchantLsinCode string 产品商家LSIN编码
merchantSkuCode string 产品商家SKU编码
skuAttribute string SKU属性
skuAttributeEn string SKU英文属性
price bigdecimal 采购单价
currency string 报价币种
quantity int 采购数量
sku string SKU
lsin string LSIN
imageUrl string 图片
memo string 备注
shippingOrderId int 关联的发货单id
shippingState int 发货状态(0-没有加入发货单,1-草稿,2-已发出)
shippingTime long 发货时间
expressCode string 关联的发货单上的物流单号
fsmStateDate long 状态变更时间
fsmState int 单行状态
fsmStateName string 状态名称
updateTime long 最后更新时间
locationInfos array 库存占用信息
reprocurementTimes int 重采次数
ancestorProcurementOrderId int 祖先采购单
arriveTime long 签收时间
receiveTime long 收货时间
orderItemAbortState int 单行异常状态
delegateType int 结算模式(0-非以销定结 1-以销定结)

采购单行状态说明:

name value
执行中 4
已收货 5
质检不合格 6
退货 7
未退货 8
质检合格 9
在途退货 10
已取消 11
完成 12

单行异常状态说明:

name value 说明
缺货确认中 1 采购单行状态=执行中，单行异常状态=缺货确认中的采购单行不能加入发货单，发货时请勿传入相关单行
在途退确认中 2 采购单行状态=执行中，单行异常状态=缺货确认中的采购单行不能加入发货单，发货时请勿传入相关单行，请先调用接口： 批量回复在途退确认(根据采购单行号)，进行回复再操作：若可退，则系统会进行在途退，无需发货；若不可退，则则继续加入发货单

响应示例（JSON）

{
    "success": true,
    "detail": "",
    "data": [
        {
            "executionDate": 1606715602000,
            "orderId": 16728645,
            "deliveryDate": 1607011200000,
            "storage": "东莞松山湖仓",
            "orderLineId": 98516339,
            "shippingType": "按采购单收货",
            "productName": "爆款额头纹贴抬头纹法令纹睡眠冷敷额头贴护肤品厂家抬头纹贴面膜",
            "productNameEn": "Slim Solid Colored Spandex Asian Size Classic Collar Work Women's",
            "barCode": "2000514135654",
            "merchantLsinCode": "594659728173",
            "merchantSkuCode": null,
            "skuAttribute": "颜色=黑色",
            "skuAttributeEn": "Color=Black",
            "price": 16,
            "currency": "CNY",
            "quantity": 110,
            "sku": "S766915200002",
            "memo": "",
            "shippingOrderId": null,
            "shippingState": 1,
            "shippingTime": 1655287496000,
            "expressCode": "KY4000090305364,73179324131788",
            "expressName": "跨越速运,中通",
            "fsmStateDate": 1606715603000,
            "fsmState": 4,
            "fsmStateName": "执行中",
            "updateTime": 1606736773000,
            "delegateType":0
        }
    ],
    "status": 0,
    "page": 1,
    "pageSize": 1,
    "totalCount": 28
}
















批量获取采购单行列表(根据采购单号)

说明：

​ 查询指定采购单号下所有采购单行信息

请求描述：

	HTTP请求方式：GET
	HTTP请求头类型：Content-Type=application/json
	API: /v1/sp/procurement/orderDetails

请求参数：

1、公共参数

​ 详情可查看在【开发规范】中的系统级参数中查看

2、业务参数

参数名 类型 是否必填 缺省值 参数描述
orderId array 是 采购单号（多个采购单，使用逗号[,]拼接）
skus array 否 SKU（多个sku，使用逗号[,]拼接）

业务示例

{host}/v1/sp/procurement/orderDetails?
token=你的token
&timestamp=发起请求时间戳
&businessId=你的业务id
&orderId=98516339,98516339
&skus=S766915200002,S766915200002

响应参数

名称 类型 描述
success boolean 结果状态，true请求成功，false请求失败
detail string 错误信息
status int 错误码
data array 采购单行信息

data

名称 类型 描述
executionDate long 下单时间
orderId int 采购单号
deliveryDate long 预计发货时间
storage string 送货地址
orderLineId int 采购单行号
shippingType string 采购单收货类型
productName string 商品名称
productNameEn string 商品英文名称
barCode string 产品条形码
merchantLsinCode string 产品商家LSIN编码
merchantSkuCode string 产品商家SKU编码
skuAttribute string SKU属性
skuAttributeEn string SKU英文属性
price bigdecimal 采购单价
currency string 报价币种
quantity int 采购数量
sku string SKU
memo string 备注
shippingOrderId int 关联的发货单id
shippingState int 发货状态(0-没有加入发货单,1-草稿,2-已发出)
shippingTime long 发货时间
expressCode string 关联的发货单上的物流单号,多个情况下以","分隔
expressName string 关联的发货单上的物流商名称,多个情况下以","分隔
fsmStateDate long 状态变更时间
fsmState int 单行状态
fsmStateName string 状态名称
updateTime long 最后更新时
delegateType int 结算模式(0-非以销定结 1-以销定结)

采购单行状态说明：

name value
执行中 4
已收货 5
质检不合格 6
退货 7
未退货 8
质检合格 9
在途退货 10
已取消 11
完成 12

响应示例（JSON）

{
    "success": true,
    "detail": "",
    "data": [
        {
            "executionDate": 1606715602000,
            "orderId": 16728645,
            "deliveryDate": 1607011200000,
            "storage": "东莞松山湖仓",
            "orderLineId": 98516339,
            "shippingType": "按采购单收货",
            "productName": "爆款额头纹贴抬头纹法令纹睡眠冷敷额头贴护肤品厂家抬头纹贴面膜",
            "productNameEn": "Slim Solid Colored Spandex Asian Size Classic Collar Work Women's",
            "barCode": "2000514135654",
            "merchantLsinCode": "594659728173",
            "merchantSkuCode": null,
            "skuAttribute": "颜色=黑色",
            "skuAttributeEn": "Color=Black",
            "price": 16,
            "currency": "CNY",
            "quantity": 110,
            "sku": "S766915200002",
            "memo": "",
            "shippingOrderId": null,
            "shippingState": 1,
            "shippingTime": 1655287496000,
            "expressCode": "KY4000090305364,73179324131788",
            "expressName": "跨越速运,中通",
            "fsmStateDate": 1606715603000,
            "fsmState": 4,
            "fsmStateName": "执行中",
            "updateTime": 1606736773000,
            "delegateType":0
        }
    ],
    "status": 0
}

批量回复在途退确认(根据采购单行号)

说明： ​ 确认传入的采购单行是否可退，若可退，将传入的标记的采购单行在途退货，否则标记为已回复，可供货。

请求描述：

	HTTP请求方式：POST
	HTTP请求头类型：Content-Type=application/json
	API: /v1/sp/procurement/replyReturnInTransConfirm

请求参数：

1、公共参数

​ 详情可查看在【开发规范】中的系统级参数中查看

2、业务参数

参数名 类型 是否必填 参数描述
enableReturn boolean 是 是否可退
procurementOrderLineIds array 是 采购单行ID

业务示例（JSON）

{
  "enableReturn": true,
  "procurementOrderLineIds":[98657056,98657057]
}

响应参数

名称 类型 描述
success boolean 结果状态，true请求成功，false请求失败
detail string 错误信息
status int 错误码

响应示例（JSON）

{
    "success": true,
    "detail": "",
    "status": 0
}
授权申请
发货