Stock In

以下接口适用于数据集成 API，对接前请了解 API 接入流程

发送数据到Lenovo

Description:3PL发送stock in的数据

Method:POST PUT DELETE

ContentType:application/json

Path:/3pl/stock_in

• API

Env	URL
test	https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/open_platform/data/sync/3pl/stock_in
prd	https://api-cn.lenovo.com/v1.0/supply_chain/scc/open_platform/data/sync/3pl/stock_in

业务数据说明

参数名称	KEY	必填	参数类型	长度	参数格式	描述
uid	Y	Y	String	32	数据行唯一标识
warehouse_name		Y	string	40	---	e.g.：HE XN HUB, MTY CEVA, etc. length is around 30. this is provided by 3PL, SCC does not control it.
stock_type		Y	string	10	SOI or LOI
lenovo_plant_code		Y	string	30		Lenovo SAP Plant Code
lenovo_storage_location		Y	string	50		Lenovo SAP Storage Location
lenovo_pn		Y	string	50
vendor_code		Y	string	50
posa		Y	string	50
posa_line		Y	string	50
stock_receiving_date		Y	string(datetime)		yyyy-MM-dd HH24:mm:ss
tpl_receiving_id		Y	string	50
receipt_id		Y	string	50
line_id		Y	string	50
supplier_invoice_no		Y	string	100		commercial invoice number
supplier_delivery_note		Y	string	100
stock_receiving_type		Y	string	50		1.通过PO/SA GR的 (SOI, LOI), rebalance in 2.SOI转LOI的LOI进 3.没有PO/SA的收货，但有3PL Pull No.的场景 4.除1,2,3之外，其他归为others （传数字代码)
order_type_in			string	50		1.Normal Procurement a.for LOI, PO's GR b.for SOI, SA's GR as consigned stock c.for financing supplier, Po's GR asn consigned stock 2.Normal Buy Ahead a.75 PO approved by leadership b.GSM inform 3PL that buy ahead SOI convert to LOI 3.Special Buy Ahead a.GSM inform 3PL that this is special buy ahead, 3PL mark it here 4.Rebalance In 5.ODM Return
received_qty		Y	string(decimal)	10,3		goods arrive and haven't been checked quality yet.
good_quantity		Y	string(decimal)	10,3		good quantity after IQC
ng_qty		Y	string(decimal)	10,3		unqualified quantity after IQC
coo		Y	string	50
supplier_pn			string	50
tpl_remark			string	200		any thing 3PL would like to remark
tpl_issuing_no			string	50		XN Pull No. 当收货时，填写XN其他hub的出库单号
syn_date		Y	string(datetime)		yyyy-MM-dd HH24:mm:ss	when the record is uploaded
sender		Y	string	50
comment1			string	100
comment2			string	100

请求示例

json

{
  "batch_id": "11297",
  "batch_size": 1,
  "seq_id": "1",
  "seq_size": 1,
  "data": [
    {
      "warehouse_name":"test_name",
      "stock_type":"SOI",
      "lenovo_plant_code":"code-1",
      "lenovo_storage_location":"location_1",
      "lenovo_pn":"pn01",
      "vendor_code":"vendor001",
      "posa":"tst",
      "posa_line":"tst",
      "stock_receiving_date":"2023-09-20 12:23:31",
      "tpl_receiving_id":"0232823233343",
      "receipt_id":"102343",
      "line_id":"30233",
      "supplier_invoice_no":"",
      "supplier_delivery_note":"",
      "stock_receiving_type":"",
      "order_type_in":"",
      "received_qty":"233.23",
      "good_quantity":"2344.42",
      "ng_qty":"1.23",
      "coo":"xx",
      "supplier_pn":"pn01",
      "tpl_remark":"any thing to remark",
      "syn_date": "2023-10-24 23:32:12"
    }
  ]
}

xml

<?xml version="1.0" encoding="UTF-8"?>
<Req>
  <batch_id>11300</batch_id>
  <batch_size>1</batch_size>
  <seq_id>1</seq_id>
  <seq_size>1</seq_size>
  <data>
    <warehouse_name>test_name</warehouse_name>
    <stock_type>SOI</stock_type>
    <lenovo_plant_code>code-1</lenovo_plant_code>
    <lenovo_storage_location>location_1</lenovo_storage_location>
    <lenovo_pn>pn01</lenovo_pn>
    <vendor_code>vendor001</vendor_code>
    <posa>tst</posa>
    <posa_line>tst</posa_line>
    <stock_receiving_date>2023-09-20 12:23:31</stock_receiving_date>
    <tpl_receiving_id>0232823233343</tpl_receiving_id>
    <receipt_id>102343</receipt_id>
    <line_id>30233</line_id>
    <supplier_invoice_no>3</supplier_invoice_no>
    <supplier_delivery_note>2</supplier_delivery_note>
    <stock_receiving_type>1</stock_receiving_type>
    <order_type_in></order_type_in>
    <received_qty>233.23</received_qty>
    <good_quantity>2344.42</good_quantity>
    <ng_qty>1.23</ng_qty>
    <coo>xx</coo>
    <supplier_pn>pn01</supplier_pn>
    <tpl_remark>any thing to remark</tpl_remark>
    <syn_date>2023-10-24 23:32:12</syn_date>
  </data>
  <data>
    ...
  </data>
</Req>

返回成功示例

json

{
  "code": "0",
  "msg": "request success"
}

xml

<Resp>
  <code>0</code>
  <msg>request success!</msg>
  <result>request success!</result>
</Resp>

返回包含错误数据示例

json

{
  "code": "E00V00",
  "msg": "data verification failed!",
  "result": {
    "verify": {
      "type": "value missing",
      "fields": "tpl_receiving_id"
    },
    "row": {
      "uid": "1233"
    }
  }
}

xml

<Resp>
  <code>E00V00</code>
  <msg>data verification failed!</msg>
  <result>
    <verify>
      <type>value missing</type>
      <fields>tpl_receiving_id</fields>
    </verify>
    <row>
      <uid>1233</uid>
    </row>
  </result>
</Resp>