open-api
首页
open-api
  • 快速开始
  • 授权登录
  • 客户
  • 销售订单
  • 采购订单
  • 产品
  • 回款登记
  • 回款单
  • 付款单
  • 费用单
  • 报价单
  • 供应商
  • 商机
  • 用户
  • 销售出库单
  • 库存
  • 线索
  • 资金
  • 采购入库单
    • 采购入库单
    • 采购入库单-列表GET
    • 采购入库单-详情GET
    • 采购入库单字段GET
    • 采购入库单-删除POST
    • 采购入库单-新建/编辑POST
  • 采购退货单
  • 统计分析
  • 示例接口(勿用)
  • 阿里账号信息GET
  • 阿里资金账户信息GET
亮色模式
  1. 采购入库单

采购入库单-新建/编辑

POST/v1/invoices/purchaseInbound/push
异常码 异常消息 异常解决方案
404 ‘xxx’ cannot be empty 查看字段说明为“如果传入不能为空”,是否有字段传入了并且是空值

请求参数

Body 参数application/x-msgpack
inbound_id
integer 
采购入库单ID
可选

编辑时需要传入 值来自于/v1/invoices/purchaseInbound/list

supplier_id
integer 
供应商id
必需

值来自于/v1/supplier/list

currency
string 
币种
必需

如果传入不能为空

exchange_rate
number 
兑人民币汇率
可选

如果传入不能为空

exchange_rate_usd
number 
兑美元汇率
可选

如果传入不能为空

serial_id
string 
采购入库单编号
可选

值来自于/v1/invoices/purchaseInbound/list

warehouse_invoice_time
string 
入库日期
可选

如果传入不能为空

remark
string 
入库备注
可选
invoice_warehouse_id
integer 
仓库id
必需

值来自于/v1/warehouse/list

discount_rate
integer 
整单折扣率
可选
discount
number 
整单折扣额
可选
handler
array[integer]
处理人ID
必需

传入处理人对应的user_id 值来自于/v1/user/list

record_list
array [object {9}] 
入库明细
必需
purchase_price
integer 
采购单价
必需
inbound_count
integer 
入库数量
必需
purchase_order_id
integer 
关联采购单id
可选

purchase_order_product_id和purchase_order_id两个要么都不传,要么都得传

product_id
integer 
产品id
必需

值来自于/v1/product/list

sku_id
integer 
产品sku_id
必需

值来自于/v1/product/list

purchase_order_product_id
integer 
采购订单明细id
可选

值来自于/v1/purchaseOrder/list

transfer_invoice_id
string 
产品流转ID
可选
transfer_invoice_record_id
string 
产品流转明细ID
可选
combine_product_id
integer 
组合产品id
可选
示例
{
  "supplier_id": 5195647154,
  "currency": "USD",
  "attachment": [],
  "exchange_rate": 725,
  "exchange_rate_usd": 100,
  "serial_id": "",
  "supplier_no": "",
  "warehouse_invoice_time": "2025-03-14",
  "remark": "",
  "invoice_warehouse_id": 1131355530,
  "discount": "",
  "discount_rate": "",
  "product_total_amount": 64,
  "handler": [
    11858713
  ],
  "record_list": [
    {
      "purchase_order_id": 5200481935,
      "product_id": 3515757805,
      "sku_id": 3515757806,
      "purchase_order_product_id": 5200481936,
      "warehouse_id": 1131355530,
      "sku_code": "2024050925313",
      "product_name": "a4123esky",
      "product_cn_name": "猜猜猜",
      "sku_attributes": [],
      "product_unit": "",
      "purchase_order_no": "大乔20250303CGDD0217",
      "transfer_invoice_serial_id": "",
      "transfer_invoice_id": "",
      "transfer_invoice_record_id": "",
      "purchase_price": 10,
      "wait_inbound_count": 0,
      "purchase_count": 100099,
      "inbound_count": 1,
      "product_amount": 10,
      "product_model": "aeop11",
      "product_disable_flag": 0
    }
  ]
}

示例代码

返回响应

成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
code
integer 
必需
message
string 
必需
now
string 
必需
data
object 
必需
inbound_invoice_id
integer 
采购入库单ID
必需
serial_id
string 
采购入库单编号
必需
示例
{
  "code": 200,
  "message": "success",
  "now": "2025-03-14 15:03:22",
  "data": {
    "inbound_invoice_id": 5210028347,
    "serial_id": "CGRK2503140088"
  }
}
最后修改时间: 2 个月前