采购订单新增/编辑

POST/v1/purchaseOrder/push

请求参数

Header 参数

Authorization

string

必需

从/v1/oauth2/access_token获取到的access_token

示例值:

access_token

3137211747

string

可选

采购订单自定义字段。字段名称为/v1/purchaseOrder/fields 获取到的自定义字段ID

purchase_order_id

integer

可选

采购订单ID，编辑时必填

purchase_order_no

string

采购订单编号

可选

supplier_id

integer

可选

供应商ID，新建时必填，来自供应商模块的.supplier_id

supplier_contact

integer

可选

供应商联系人ID，选填，来自供应商模块contact_list.supplier_contact_id

currency

string

可选

币种，新建是必填，传入值可以参考订单的/v1/invoices/order/orderEnums字段里面的currency_list.code

exchange_rate

number <float>

可选

汇率(兑CNY人民币)

exchange_rate_usd

number <float>

可选

汇率(兑USD美元)

purchase_date

string <date>

可选

采购日期，非必填，缺省值为当前日期，例如2024-04-29

delivery_date

string <date>

交货日期，非必填

可选

remark

string

可选

备注，非必填，例如2024-04-29

refer_order_id

integer

可选

关联的销售订单ID，来自销售订单模块的order_id

creator

integer

可选

采购订单创建人，默认为请求接口的当前用户，传入值来自/v1/user/list中的user_id

handler

array[integer]

采购订单处理人

可选

status

integer

可选

采购订单状态ID，值为/v1/purchaseOrder/fields/selector接口的状态ID

amount

number

可选

采购订单金额，新建时必填

product_total_amount

number

采购订单产品总金额

可选

cost_list

array [object {4}]

费用列表

可选

cost_name

string

费用名称

必需

percent_type

integer

必需

计算规则0（加（+）绝对值、1加（+）占产品总金额百分比、2减（-）绝对值、3减（-）占产品总金额百分比）

percent_amount

number

必需

计算金额值，比如1%，那就是产品金额*1%

cost

number

必需

金额，根据计算金额计算出来后的费用

product_list

array [object {14}]

可选

采购订单产品明细列表

134355323

string

产品自定义字段

可选

purchase_order_product_id

integer

可选

采购订单产品唯一ID，新增产品时可不传；编辑时必填

order_id

integer

关联的销售订单ID

可选

invoice_product_id

integer

可选

关联的销售订单产品unique_id

product_no

string

产品编号

可选

product_id

integer

产品ID，必填。

必需

sku_id

integer

必需

产品SKU ID，必填。多规格产品可传 0

unit_price

number <float>

采购单价

必需

count

number

采购数量

必需

product_remark

string

产品备注

可选

cost_amount

number <float>

金额小计

可选

product_name

string

产品名称

可选

product_cn_name

string

中文产品名称

可选

sku_info

object

可选

产品信息，非必要请忽略

attachments

array[string]

可选

附件，可访问的文件url

{
  "purchase_order_no": "PO202300001",
  "handler": [
    55281444
  ],
  "purchase_date": "2023-06-11",
  "delivery_date": "2023-06-13 15:53:30",
  "product_total_count": 2,
  "supplier_id": 6108435309018,
  "supplier_contact": 3159969917,
  "currency": "USD",
  "exchange_rate": 680,
  "exchange_rate_usd": 100,
  "amount": 1,
  "remark": "remark",
  "refer_order_id": 8532894576203,
  "product_list": [
    {
      "purchase_order_product_id": "",
      "product_id": "3107787846051",
      "sku_id": "3107787846057",
      "unit": "Box",
      "order_id": 8532894576203,
      "count": 1,
      "unit_price": 1,
      "cost_amount": 1
    }
  ]
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

integer

错误码

可选

message

string

错误信息

可选

now

string

当前时间

可选

data

object

响应数据

可选

purchase_order_id

integer

采购订单ID

可选

{
  "code": 0,
  "message": "string",
  "now": "string",
  "data": {
    "purchase_order_id": 0
  }
}

最后修改时间： 3 个月前