推送事件
最后更新时间：2023-01-19
请求
基本信息
| 基本 | ||
| 正式 DOMAIN | https://open.bianxingjimu.com | |
| 测试 DOMAIN | https://open.tb.tokoyi.com | |
| PATH | api/v1/OMS/push/event | |
| HTTP Method | POST | |
| 调用方式 | 第三方调用TB | |
请求头
| 名称 | 类型 | 必填 | 描述 |
| Content-Type | string | 是 | 固定值："application/json" |
| Date | string | 是 | 请求时间，仅支持GMT格式 |
请求体
| 名称 | 类型 | 必填 | 说明 |
| EventType | string | 是 | 事件类型，枚举： sales_order_confirm 提料单确认 sales_order_reject 提料单驳回 sales_order_publish 发货计划单发布 delivery_order_status_change 发货计划单变更 logistic_order_status_change 物流计划单变更 logistic_order_delivery 发货 logistic_order_sign_for 签收 logistic_order_delivery_sign 上传回执照片 skin_model_approved 膜纸审核通过 skin_model_reject 膜纸审核驳回 lading_approved 物料审核通过 lading_reject 物料审核驳回 |
| FBillNo | string | 否 | 销售订单编号 |
| BasicNumber | string | 否 | 提料单编号 |
| DeliverPlanOrderNumber | string | 否 | 发货计划单编号 |
| LogisticPlanOrderNumber | string | 否 | 物流计划单编号 |
| SkinModelId | int | 否 | 膜纸ID |
| SkinModelCode | int | 否 | 膜纸颜色编码 |
| SkinModelName | int | 否 | 膜纸颜色名称 |
| LadingId | int | 否 | 物料ID |
| LadingCode | int | 否 | 物料编码 |
| AuditUserName | 否 | 审核人 |
请求体示例 1(提料单确认)
json
{
"EventType": "sales_order_confirm",
"BasicNumber": "MRF220321220719578257111", // 提料单编号
}
请求体示例 2(提料单驳回)
json
{
"EventType": "sales_order_confirm",
"BasicNumber": "MRF220321220719578257111", // 提料单编号
}
请求体示例 3(发货计划单发布)
json
{
"EventType": "sales_order_publish",
"BasicNumber": "MRF220321220719578257111", // 销售订单号
}
请求体示例 4(发货计划单进度变更)
json
{
"EventType": "delivery_order_status_change",
"BasicNumber": "MRF220321220719578257111", // 提料单编号
"DeliverPlanOrderNumber": "FHJH20230116000003" // 发货计划单号
}
请求体示例 5(物流计划单变更)
json
{
"EventType": "logistic_order_status_change",
"BasicNumber": "MRF220321220719578257111", // 提料单编号
"DeliverPlanOrderNumber": "FHJH20230116000003", // 发货计划单号
"LogisticPlanOrderNumber": "WLJH20230116000003", // 物流计划单号
}
请求体示例 6(发货)
json
{
"EventType": "logistic_order_delivery",
"BasicNumber": "MRF220321220719578257111", // 提料单编号
"DeliverPlanOrderNumber": "FHJH20230116000003", // 发货计划单号
"LogisticPlanOrderNumber": "WLJH20230116000003", // 物流计划单号
}
请求体示例 7(签收)
json
{
"EventType": "logistic_order_sign_for",
"BasicNumber": "MRF220321220719578257111", // 提料单编号
"DeliverPlanOrderNumber": "FHJH20230116000003", // 发货计划单号
"LogisticPlanOrderNumber": "WLJH20230116000003", // 物流计划单号
}
请求体示例 8(上传回执照片)
json
{
"EventType": "logistic_order_delivery_sign",
"BasicNumber": "MRF220321220719578257111", // 提料单编号
"DeliverPlanOrderNumber": "FHJH20230116000003", // 发货计划单号
"LogisticPlanOrderNumber": "WLJH20230116000003", // 物流计划单号
}
请求体示例 9(膜纸审核通过)
json
{
"EventType": "skin_model_approved", // 事件类型(膜纸审核通过)
"SkinModelId": 1, // 膜纸ID
"SkinModelCode": "08739", // 膜纸颜色编码,
"SkinModelName": "膜纸名称", // 膜纸颜色名称
"AuditUserName": "张三", // 审核人姓名
}
请求体示例 10(膜纸审核驳回)
json
{
"EventType": "skin_model_reject", // 事件类型(膜纸审核驳回)
"SkinModelId": 1, // 膜纸ID
"RejectReason": "不通过", // 驳回原因
"AuditUserName": "张三", // 审核人姓名
}
请求体示例 11(物料审核通过)
json
{
"EventType": "lading_approved", // 事件类型(物料审核通过)
"LadingId": 1, // 物料ID
"LadingCode": "FP.000209", // 物料编码
"AuditUserName": "张三", // 审核人姓名
}
请求体示例 12(物料审核驳回)
json
{
"EventType": "lading_reject", // 事件类型(物料审核驳回)
"LadingId": 1, // 物料ID
"RejectReason": "不通过", // 驳回原因
"AuditUserName": "张三", // 审核人姓名
}
响应
响应头
| 名称 | 类型 | 必须 | 描述 |
| Content-Type | string | 是 | 固定值："application/json" |
| X-Tb-LogId | string | 是 | 日志ID 示例值："2021092309572286544XFCO1143" |
响应体
| 参数 | 类型 | 说明 |
| code | int | 错误码，非200表示失败 |
| msg | string | 返回码的描述 |
| data | map | 返回业务信息 |
响应体示例
json
{
"code": 200,
"msg": "SUCCESS",
"data": []
}
错误码
| HTTP状态码 | 业务状态码 | 解释 | 对应msg信息 |
| 200 | 200 | 成功 | SUCCESS |
| 200 | 400 | 参数错误 | 事件类型不能为空 事件类型值错误 提料单编号不能为空 |