当前位置: API文档
stockin_order_push.php(创建其他入库单)
1.1 接口描述:旺店通ERP需要增加库存且入库单据没有对应的业务类型,调用本接口在旺店通ERP创建其他入库单,增加库存。 |
1.2 适用版本:网页版 |
1.3 注意事项:该接口不支持创建委外类型仓库的其他入库单 |
2.1 线下ERP、SAP等系统对接 |
环境 | HTTP地址 |
---|---|
测试环境 | https://openapitest.huice.com/openapi/stockin_order_push.php |
正式环境 | https://openapi.huice.com/openapi/stockin_order_push.php |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
卖家账号 | sid | String | 是 | 购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。 | |
接口账号 | appkey | String | 是 | 本开放平台“自助对接”功能模块内自助申请,申请流程单击这里 | |
时间戳 | timestamp | int | 是 | 北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通业版API服务端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。 | |
签名 | sign | String | 是 | API输入参数签名结果,签名算法介绍单击这里 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
外部单号 | outer_no | varchar | 40 | 是 | 外部系统的唯一单据编号,避免重复推送数据 |
仓库编号 | warehouse_id | varchar | 40 | 是 | 代表仓库所有属性的唯一编码,用于仓库区分, ERP内支持自定义(ERP仓库界面设置) |
物流编号 | logistics_code | varchar | 20 | 否 | 代表物流所有属性的唯一编码,用于物流区分, ERP内支持自定义(ERP物流界面设置) |
物流单号 | logistics_no | varchar | 40 | 否 | 物流公司的运单号,用于追踪物流、 快递流转信息(路由)的数字编码 |
是否审核 | is_save | tinyint | false | 否 | 传false自动审核 传true为不审核 默认为false |
邮资 | post_amount | decimal | (19,4) | 否 | 物流或者快递运输货物产生的费用 |
备注 | remark | varchar | 255 | 否 | 其他入库单备注 |
入库原因 | stockin_reason | varchar | 255 | 否 | 入库原因(需要在客户端维护好该原因, 如客户端无该原因或者原因停用,则推送失败) |
货品明细节点 | stock_in_order_detail_list | data[] | 是 | 入库单货品列表节点 | |
源单类型 | src_order_type | int | 11 | 是 | 源单类型-目前仅允许其他入库(type=6)和采购入库(type=1) |
源单号 | src_order_no | varchar | 40 | 是 | 上层单据编号,如果是采购入库就是采购单号, 调拨入库就是调拨号,以此类推 |
stock_in_order_detail_list
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
商家编码 | sku_no | varchar | 40 | 是 | ERP内单品唯一编码(SKU),代表单品(SKU)所有属性,
并且为库存量出入计算最小单元。 注:推送的sku_no值在ERP货品档案必须存在,否则单据会创建失败。 |
源单明细id | src_order_detail_id | int | 11 | 否 | 源单明细id |
入库数量 | realNum | decimal | (19,4) | 是 | 入库数量 |
货位编号 | position_no | varchar | 20 | 否 | 商品在仓库内的位置编号,不传此参数,读ERP配置【入库开单货位优先级配置】, 来决定取默认货位、上一次入库货位、ZANCUN货位其中一个货位。 |
批次 | batch_no | varchar | 20 | 否 | 货品批次编号 |
生产日期 | production_date | datetime | 否 | 货品生产日期,格式:yyyy-MM-dd HH:mm:ss | |
有效期天数 | validity_days | int | 11 | 否 | 商品有效期,单位:天 |
有效期 | expire_date | datetime | 否 | 有效期日期,格式:yyyy-MM-dd HH:mm:ss | |
入库价 | stockin_price | decimal | (19,4) | 是 | 入库价格,如不传该字段入库价默认取0 |
入库金额 | stockin_amount | decimal | (19,4) | 否 | 入库金额,默认:数量*单价 |
明细备注 | remark | varchar | 255 | 否 | 明细备注 |
4.1公共响应参数
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
错误码 | code | int | 11 | 是 | 状态码:0表示成功,其他表示失败 |
错误原因 | message | varchar | 255 | 是 | 错误原因 |
入库单号 | stockin_no | varchar | 40 | 是 | ERP系统生成入库单据分配的单号 |