erp库存同步 - 元数标准接口

请求参数

Query 参数

_platform_num

string

可选

示例值:

153658

Body 参数application/json

stocks

array [object {5}]

库存数组

必需

outWarehouseCode

string

客户仓库编码

可选

使用该参数，商品参数也要用外部商品编码，成对使用

warehouseCode

string

仓库编码

可选

和客户仓库编码二选一

outSkuCode

string

客户商品编码

可选

skuCode

string

商品编码

可选

和客户商品编码二选一

realNum

string

库存数量

必需

operateUser

string

操作人

必需

用于记录日志

syncFlag

number

是否同步执行

可选

是否同步执行，0 同步执行， 1异步执行默认同步，同步每次请求限制50条数据，异步200

srcFlag

number

来源标志

可选

系统接入时候分配，默认 5

incFlag

number

增量标志

可选

0覆盖更新 1增量更新默认0

billNo

string

单据号

可选

增量更新场景必传，用来幂等操作

syncTime

number

同步时间戳

可选

毫秒（1717049630984），异步&覆盖场景使用，不传默认请求时间

示例

{
  "stock": [
    {
      "warehouseCode": "",
      "skuCode": "",
      "realNum": 20
    }
  ],
  "opterateUser": ""
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/retail-data-exchange/stock/sync?_platform_num=153658' \
--header 'Content-Type: application/json' \
--data-raw '{
    "stock":[
    {
        "warehouseCode":"",
        "skuCode":"",
        "realNum":20
    }
],
"opterateUser":""
}'

返回响应

🟢200成功

application/json

Body

traceId

string

必需

code

string

必需

msg

string

必需

success

boolean

必需

data

object

必需

errorList

array [object {6}]

失败列表

可选

同步执行才返回

示例

{
  "traceId": "laboris eiusmod reprehenderit irure occaecat",
  "code": "aliquip adipisicing voluptate exercitation",
  "msg": "enim deserunt",
  "success": true,
  "data": {}
}