Lingxing
切换旧版

创建待到货的采购单

POST/erp/sc/routing/purchase/purchase/createPurchaseOrder

支持创建采购单，状态为“待到货”

接口信息

API Path请求协议请求方式令牌桶容量
/erp/sc/routing/purchase/purchase/createPurchaseOrderHTTPSPOST1

请求参数

widinteger
客户仓库id
sys_widinteger
系统仓库id【与客户仓库id 二选一必填】
supplier_idinteger
客户供应商id
sys_supplier_idinteger
系统供应商id【与客户供应商id 二选一必填】
custom_order_snstring
自定义采购单号【不传此字段则系统自动生成采购单号】
contact_personstring
联系人
contact_numberstring
联系电话
settlement_methodinteger
结算方式：7 现结，8 月结
prepay_percentnumber
预付比例（%）
period_config_keystring
账期配置key
settlement_descriptionstring
结算描述
payment_methodinteger
支付方式：1 网银转账，2 网上支付
purchase_currencystring
采购币种
ratenumber
汇率
shipping_currencystring
运费币种
shipping_pricenumber
运费
other_currencystring
其它费用币种
other_feenumber
其它费用
fee_part_typeinteger
费用分摊方式：0 不分摊，1 按金额，2 按数量
is_taxinteger
是否含税：0 否，1 是【当含税为1时，tax_rate为必传字段】
remarkstring
备注
qc_typeinteger
质检类型：【默认0】 0 仓库质检，1 预检，2 免检
opt_uidinteger必填
采购员uid
purchaser_idinteger必填
采购方id，查询采购方列表 接口对应字段【purchaser_id】
product_listarray<object>必填
隐藏子属性
sidinteger
店铺id ，对应查询亚马逊店铺列表接口对应字段【sid】
seller_idstring
亚马逊店铺id【建议使用sid替换】
marketplace_idstring
marketplace_id【建议使用sid替换】
skustring必填
sku
fnskustring
fnsku
pricestring必填
单价
tax_ratestring
税率，范围为[0,100)【当含税为1时，tax_rate为必传字段】
cases_numinteger
箱数
quantity_per_caseinteger
单箱数量
quantity_realstring必填
实际采购量
expect_arrive_timestring
预计到货时间，格式：Y-m-d
remarkstring
备注
plan_snstring
采购计划编号
optionsobject
创建选项
隐藏子属性
is_auto_fill_storeinteger
是否自动填充店铺：【默认0】 0 否，1 是
is_auto_fill_fnskuinteger
是否自动填充fnsku：【默认0】0 否，1 是

请求示例

{
    "sys_wid": 1,
    "sys_supplier_id": 2,
    "settlement_method": 8,
    "purchase_currency": "CNY",
    "fee_part_type": 0,
    "remark": "测试123",
    "opt_uid": 1,
    "purchaser_id": 1,
    "is_tax": 0,
    "product_list": [
        {
            "sku": "SKU-1",
            "price": "1.00",
            "quantity_real": 50,
            "plan_sn": "PP231211001",
            "expect_arrive_time": "2023-12-21",
            "tax_rate":"10"
        }
    ]
}

返回结果

Json Object

codeinteger必填
状态码，0 成功
示例 0
messagestring必填
响应消息
示例 操作成功
error_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 8DFEE1CA-EC9B-F401-5D41-9F95251D5D50
response_timestring必填
响应时间
示例 2020-09-21 15:48:58
dataobject必填
响应数据
隐藏子属性
order_snstring必填
采购单号
示例 PO211112002
custom_order_snstring必填
自定义采购单号
示例 PO211112002

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "D41373ED-AF54-CDF1-1658-B8F86286F209",
    "response_time": "2021-11-12 12:37:55",
    "data": {
        "order_sn": "PO211112002",
        "custom_order_sn":"PO211112002"
    },
    "total": 0
}

返回失败示例

{
    "code": 500,
    "message": "内部错误",
    "error_details": "仓库参数错误 [请求码:3CF77C]",
    "request_id": "31667FCC-24E5-0CBE-2FC8-23E6908D9473",
    "response_time": "2021-11-12 12:34:26",
    "data": [],
    "total": 0
}

附加说明

  1. 客户供应商id，指客户通过领星开放接口创建的供应商，在传值时向领星传入的供应商id。如果供应商是在领星ERP操作创建的，该供应商没有客户供应商id；
  2. 系统供应商id，指领星ERP自动生成的供应商id，唯一标识，每个供应商均有自己的系统id；
  3. 客户仓库id，指客户通过领星开放接口创建的仓库，在传值时向领星传入的仓库id。如果仓库是在领星ERP操作创建的，该仓库没有客户仓库id；
  4. 系统仓库id，指领星ERP自动生成的仓库id，唯一标识，每个仓库均有自己的系统id；