TIP

• 直营发货单扫码结果同步接口
• 分销发货单扫码结果同步接口
• 扫码记录新增接口

直营发货单扫码结果同步接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmscodes/v1/add/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "sent_id": "20201110000001",
    "sent_no": "FH20201110000001",
    "type": "10",
    "operate_time":"2023-11-02 13:11:11",
    "operator_id":"111",
    "operator_code":"111",
    "products": [
        {
            "product_id": "7755038711664976249",
            "product_code": "PD001",
            "code": "",
            "code_unit": "",
            "base_unit_num": "100",
            "code_type_id": "100",
            "code_type_name": "箱码"
        }
    ]
}

说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
sent_id	VARCHAR(100)	否	发货单id，单号或者id传递其中的一个即可
sent_no	VARCHAR(100)	否	发货单号，单号或者id传递其中的一个即可
type	VARCHAR(32)	是	操作类型。10：扫码入库；20：扫码出库
operate_time	VARCHAR(32)	是	扫码时间，格式为yyyy-MM-dd HH:mm:ss
operator_id	VARCHAR(100)	否	扫码人id，id优先级大于名称
operator_code	VARCHAR(100)	否	扫码人编码，id优先级大于名称
products	List		扫码信息列表
products.product_id	VARCHAR(32)	否	商品id。product_id，product_source_code，product_code不能同时为空，如果同时存在，优先级依次降低
products.product_code	VARCHAR(100)	否	商品编码。product_id，product_source_code，product_code不能同时为空，如果同时存在，优先级依次降低
products.product_source_code	VARCHAR(100)	否	商品第三方系统的唯一标识。product_id，product_source_code，product_code不能同时为空，如果同时存在，优先级依次降低
products.code	VARCHAR(100)	是	码
products.code_unit	VARCHAR(100)	是	码单位
products.code_type_id	VARCHAR(100)	否	码类型id，id优先级大于名称,码类型id和码类型名称必须选一个
products.code_type_name	VARCHAR(100)	否	码类型名称，id优先级大于名称,码类型id和码类型名称必须选一个
products.base_unit_num	NUMERIC(9,8)	是	基本单位扫码数量

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

分销发货单扫码结果同步接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmscodes/v1/fx/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "sent_id": "20201110000001",
    "sent_no": "FH20201110000001",
    "type": "10",
    "operate_time":"2023-11-02 13:11:11",
    "operator_id":"111",
    "operator_code":"111",
    "products": [
        {
            "product_id": "7755038711664976249",
            "product_code": "PD001",
            "code": "",
            "code_unit": "",
            "base_unit_num": "100",
            "code_type_id": "100",
            "code_type_name": "箱码"

        }
    ]
}

说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
sent_id	VARCHAR(100)	否	发货单id，单号或者id传递其中的一个即可
sent_no	VARCHAR(100)	否	发货单号，单号或者id传递其中的一个即可
type	VARCHAR(32)	是	操作类型。10：扫码入库；20：扫码出库
operate_time	VARCHAR(32)	是	扫码时间，格式为yyyy-MM-dd HH:mm:ss
operator_id	VARCHAR(100)	否	扫码人id，id优先级大于名称
operator_code	VARCHAR(100)	否	扫码人编码，id优先级大于名称
products	List		扫码信息列表
products.product_id	VARCHAR(32)	否	商品id。product_id，product_source_code，product_code不能同时为空，如果同时存在，优先级依次降低
products.product_code	VARCHAR(100)	否	商品编码。product_id，product_source_code，product_code不能同时为空，如果同时存在，优先级依次降低
products.product_source_code	VARCHAR(100)	否	商品第三方系统的唯一标识。product_id，product_source_code，product_code不能同时为空，如果同时存在，优先级依次降低
products.code	VARCHAR(100)	是	码
products.code_unit	VARCHAR(100)	是	码单位
products.code_type_id	VARCHAR(100)	否	码类型id，id优先级大于名称,码类型id和码类型名称必须选一个
products.code_type_name	VARCHAR(100)	否	码类型名称，id优先级大于名称,码类型id和码类型名称必须选一个
products.base_unit_num	NUMERIC(9,8)	是	基本单位扫码数量

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

扫码记录新增接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/goodscode/v1/addCodes/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "type": "10",
    "operate_time":"2023-11-02 13:11:11",
    "operator_id":"111",
    "operator_code":"111",
    "products": [
        {
            "product_id": "7755038711664976249",
            "product_code": "PD001",
            "code": "",
            "code_unit": "",
            "base_unit_num": "100",
            "code_type_id": "100",
            "code_type_name": "箱码"

        }
    ]
}

说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
type	VARCHAR(32)	是	操作类型。10：扫码入库；20：扫码出库；40：消费者扫码
operate_time	VARCHAR(32)	是	扫码时间，格式为yyyy-MM-dd HH:mm:ss
operator_id	VARCHAR(100)	否	扫码人id，id优先级大于名称
operator_code	VARCHAR(100)	否	扫码人编码，id优先级大于名称
belong_cm_id	VARCHAR(32)	否	归属客户id，客户id、客户编码、客户第三方唯一标识必须传一个，如果同时存在，优先级依次递减
belong_cm_code	VARCHAR(32)	否	归属客户编码，客户id、客户编码、客户第三方唯一标识必须传一个，如果同时存在，优先级依次递减
belong_cm_name	VARCHAR(32)	否	归属客户名称，客户id、客户编码、客户第三方唯一标识必须传一个，如果同时存在，优先级依次递减
products	List		扫码信息列表
products.product_id	VARCHAR(32)	否	商品id。product_id，product_source_code，product_code不能同时为空，如果同时存在，优先级依次降低
products.product_code	VARCHAR(100)	否	商品编码。product_id，product_source_code，product_code不能同时为空，如果同时存在，优先级依次降低
products.product_source_code	VARCHAR(100)	否	商品第三方系统的唯一标识。product_id，product_source_code，product_code不能同时为空，如果同时存在，优先级依次降低
products.code	VARCHAR(100)	是	码
products.code_unit	VARCHAR(100)	是	码单位
products.code_type_id	VARCHAR(100)	否	码类型id，id优先级大于名称,码类型id和码类型名称必须选一个
products.code_type_name	VARCHAR(100)	否	码类型名称，id优先级大于名称,码类型id和码类型名称必须选一个
products.base_unit_num	NUMERIC(9,8)	否	基本单位扫码数量。扫码数量和基本单位扫码数量不能同时为空，基本单位扫码数量和扫码数量必须选一个
products.code_unit_num	NUMERIC(9,8)	否	扫码数量。扫码数量和基本单位扫码数量不能同时为空，基本单位扫码数量和扫码数量必须选一个

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}