铱云开放API 2.0
易订货2.0
易订货2.0
  1. 采购
  • 开发指南
    • 开发须知
    • 更新历史
  • 登录授权
    • 获取 access_token
      GET
  • 基础数据
    • 区域列表
      GET
    • 仓库列表
      GET
    • 员工列表
      POST
    • 客户分类列表
      GET
    • 商品单位列表
      GET
    • 商品分类列表
      GET
    • 商品品牌列表
      GET
    • 商品展示分类列表
      GET
    • 商品授权方案列表
      GET
    • 查询价格等级
      GET
    • 查询组织(店铺)信息
      GET
  • 公共
    • 省市区域
      • 获取国家城市列表
      • 获得国家列表
      • 获取市区列表
      • 获取省份列表
    • 物流公司
      • 获取物流公司列表
  • 客户
    • 客户列表
      POST
    • 创建客户
      POST
    • 修改客户
      PUT
  • 商品
    • 商品列表
    • 增量更新的skuId列表
    • 新增商品
    • 新增商品-新增规格
    • 更新商品
    • 新增等级调价单并审核
    • 新增客户调价单并审核
  • 订单
    • 订单列表
    • 订单出库
    • 关闭一个B2B订单
    • 创建订单
    • 订单审核
    • 商家订单列表
    • 商家订单发货记录
  • 退单
    • 退单列表
    • 商家退单列表
    • 退单审核
    • 退单收货审核
    • 退单入库
  • 采购
    • 直发采购单和销售单关系
    • 采购订单列表
      POST
    • 采购退单列表
      POST
    • 创建采购单
      POST
    • 采购单入库
      POST
    • 采购退单审核
      PUT
    • 采购退单出库
      POST
  • 库存
    • 库存列表
    • 同步库存(同步失败看接口返回)
    • 签收单列表
    • 出库签收
    • 创建其它入库单
    • 审核其它入库单
    • 创建其它出库单
    • 新增盘点单
    • 审核其它出库单
    • 采购入库单列表
    • 销售退货入库单列表
    • 采购退货出库单列表
    • 销售出库单列表
    • 查询供应商列表
    • 查询供应商商品
  • 资金-收付款
    • 收付款单列表
    • 收款记录列表
    • 往来对象核销触发
    • 新增收款单(强鉴权)
    • 查询核销单列表
    • 添加其他应付单
    • 查询其他应付单列表
    • 添加其他应收单
    • 查询其他应收单列表
    • 查询其他应收/应付收费用类型列表
  • 常见问题与解答
    • 常见问题与解答
  • 开放接口-商家端-商家订单管理
  1. 采购

创建采购单

POST
/order-aggregation/organizations/purchase-orders
开放接口-采购订单
创建采购单

请求参数

Header 参数
access_token
string 
必需
oauth2接口获取的access_token
x-client-id
string 
必需
申请对接时的clientId
Body 参数application/json
sellerId
integer 
必需
卖方组织机构Id,即供应商id,,供应商信息可通过库存模块查询供应商列表信息接口获取
orderStatus
string 
必需
ORDER_AUDIT_PENDING:待审核,AUDITED:已审核
productTotalAmount
number 
必需
商品小计之和(就是页面上看到每行小计金额的合计),精度保留两位小数
otherAmount
number 
必需
其他费用,没有则传0,精度保留两位小数
orderTotalAmount
number 
必需
订单总额(productTotalAmount + otherAmount),精度保留两位小数
remark
string 
订单备注
可选
deliveryDate
integer 
交货日期,时间戳
可选
warehouseId
integer 
下单仓库
可选
contactName
string 
收货联系人
可选
<= 30 字符
contactPhone
string 
收货联系人电话
可选
<= 30 字符
provinceId
integer 
可选
收货地址-省区域id,需从公共省市区域接口获取,示例:广东省(440000)
cityId
integer 
可选
收货地址-市区域id,需从公共省市区域接口获取,示例:深圳市(440300)
districtId
integer 
可选
收货地址-街道区域id,需从公共省市区域接口获取,示例:南山区(440305)
addressDetail
string 
可选
收货地址详细地址,示例:清华信息港铱云云计算有限公司
<= 100 字符
createId
integer 
可选
制单人ID,员工id,从员工接口获取
orderDetails
array [object {10}] 
下单采购商品
可选
productSku
integer 
商品skuId
必需
productCode
string 
商品编码
可选
productName
string 
商品名称
可选
<= 100 字符
unitId
integer 
下单使用单位id
必需
purchaseNumbers
integer 
必需
下单数量(针对unitId的购买数量)
auxUnitId
integer  | null 
辅助计量单位的id
可选
auxUnitNumbers
integer 
辅助单位购买数量
可选
originalPrice
number 
商品采购价
必需
>= 0
subtotal
number 
必需
小计(purchaseNumbers * originalPrice),精度保留两位小数
>= 0
type
string 
必需
订单商品类型,NORMAL:普通商品,MANUAL_GIFT:手工赠品,默认:NORMAL,普通商品
示例
{
  "orderDetails": [
    {
      "originalPrice": 4285.7143,
      "productCode": "99000003",
      "productShortCode": "",
      "productName": "直发商品A",
      "productSku": 1730848620968417,
      "purchaseNumbers": 2,
      "subtotal": 8571.43,
      "unitId": 1730848620968418,
      "auxUnitId": null,
      "auxUnitNumbers": 0
    },
    {
      "originalPrice": 500,
      "productCode": "99003201",
      "productShortCode": "",
      "productName": "直发商品D-辅助单位",
      "productSku": 1776869453446817,
      "purchaseNumbers": 24,
      "subtotal": 12000,
      "unitId": 1776869453446818,
      "auxUnitId": 1776869455005344,
      "auxUnitNumbers": 2
    }
  ],
  "orderStatus": "ORDER_AUDIT_PENDING",
  "productTotalAmount": 20571.43,
  "otherAmount": 1000,
  "orderTotalAmount": 21571.43,
  "remark": "采购单备注内容信息采购单备注内容信息采购单备注内容信息采购单备注内容信息采购单备注内容信息采购单备注内容信息",
  "sellerId": 1500145770000864,
  "deliveryDate": 1722355200000,
  "warehouseId": 1443709585219040,
  "contactName": "仓库联系人",
  "contactPhone": "18888888888",
  "provinceId": 440000,
  "cityId": 440300,
  "districtId": 440305,
  "addressDetail": "清华信息港铱云云计算有限公司"
}

返回响应

🟢200成功
application/json
Body
id
integer 
采购单id
必需
orderCode
string 
采购单号
必需
示例
{
  "id": 0,
  "orderCode": "string"
}
修改于 2024-11-12 02:26:23
上一页
采购退单列表
下一页
采购单入库
Built with