**简要描述:**
* 第三方系统在处理维修单、或在CTC系统进行配件采购时,可通过该接口查询到仓库的出入库信息、及明细。
**接口地址:**
* `http://IP/doscall/oa/api/receipt_parts/`
**参数示例**
```
{
"key": "……", //CTC系统指定
"data": {
"type": "in",
"inputtime_s": "2020-05-20 20:40:23",
"inputtime_e": "2020-05-27 20:49:12",
}
}
```
**参数:**
| 名称 | 是否必须 | 允许为空 | 描述 | 附加说明 |
| --- | --- | --- | --- | --- |
| type | Y | N | 查询类型 <br>有效值:in,out | 有效值:<br>in 入库信息,<br>out 出库信息 |
| inputtime\_s | Y | N | 起始创建时间 | 与结束时间范围不能超过7天 |
| inputtime\_e | Y | N | 结束创建时间 | 与起始时间范围不能超过7天 |
**返回示例**
```
// 入库返回示例(type=in)
{
"res":0,
"msg":"",
"data":[
{
"in_number":"CK1590583223368861321",
# 入库单号
"intype":"采购入库",
# 入库类型
"amount":10,
# 入库总数
"amount_of_money":"1310.00", # 入库总金额
"status":"已入库",
# 单据状态
"number":"CK1590583223910",
# 关联工单
"inputuser":"admin",
# 建单人
"inputtime":"2020-05-27 20:40:23", # 建单时间
"parts_details":[
# 配件入库明细
{
"yunmi_code":"20.02.09.03.0063",
# 云米配件编号
"amount":10
# 入库数量
},
{
"yunmi_code":"20.02.09.03.0063",
"amount":0
}
]
},
{
"in_number":"RK1590583752235274571",
"intype":"维修入库",
"amount":3,
"amount_of_money":"393.00",
"status":"已结单",
"number":"WX2005055057034",
"inputuser":"余喜田",
"inputtime":"2020-05-27 20:49:12",
"parts_details":[
{
"yunmi_code":"20.02.09.03.0063",
"amount":3
}
]
}
]
}
// 出库返回示例(type=out)
{
"res":0,
"msg":"",
"data":[
{
"out_number":"CK1590583223368861321",
# 出库单号
"outtype":"核销出库",
# 出库类型
"amount":10,
# 出库总数
"amount_of_money":"1310.00", # 出库总金额
"status":"已出库",
# 单据状态
"number":"CK1590583223910",
# 关联工单
"inputuser":"admin",
# 建单人
"inputtime":"2020-05-27 20:40:23", # 建单时间
"parts_details":[
# 配件入库明细
{
"yunmi_code":"20.02.09.03.0063",
# 云米配件编号
"amount":10
# 出库数量
},
{
"yunmi_code":"20.02.09.03.0063",
"amount":0
}
]
},
{
"out_number":"RK1590583752235274571",
"outtype":"维修入库",
"amount":3,
"amount_of_money":"393.00",
"status":"已结单",
"number":"WX2005055057034",
"inputuser":"余喜田",
"inputtime":"2020-05-27 20:49:12",
"parts_details":[
{
"yunmi_code":"20.02.09.03.0063",
"amount":3
}
]
}
]
}
```
**返回参数说明**
| 名称 | 描述 | 附加说明 |
| --- | --- | --- |
| res | 0成功,其他值为失败 | 有效值:0 成功 其他为失败 |
| msg | 消息说明 | 1:签名无效;2:无数据 |
| data | 返回结果 | key值 |
| 其他字段 | 见上面的参数描述 | |
\*\* 出入库类型有效值:\*\*
* 入库类型:采购入库、维修入库、发放入库、返厂入库、盘点入库、生产入库、借调入库、红冲入库、其他入库、配件申请、配件损耗入库。
* 入库单状态:已入库、已撤销
* 出库类型:发放出库、返厂出库、盘点出库、残损出库、销售出库、借调出库、网点配件申请、配件维修出库、配件损耗出库、维修耗用出库、核销出库;
* 出库单状态:已出库、已撤销
- 1.修订记录
- 2.接口概述
- 3.通讯协议
- 4.CTC接口说明
- 4.1.接口类型
- 4.2.通用接口
- 4.2.1.工单创建(被动模式)
- 4.2.2.工单派发(主动模式)
- 4.2.3.工单办理(被动模式)
- 4.2.4.工单撤销(主动模式)
- 4.2.5.工单催办(主动模式)
- 4.2.6.获取故障类别(被动模式)
- 4.2.7.产品SN码维护(被动模式)
- 4.2.8.获取工单列表(被动模式)
- 4.2.9.获取工单详细(被动模式)
- 4.2.10.工单评价(被动模式)
- 4.2.11.短信接口(被动模式)
- 4.2.12.短信链接评价接口(主动模式)
- 4.2.13.工单备注(主动模式)
- 4.2.14.工单备注(被动模式)
- 4.2.15 等级品SN码(被动模式)
- 4.2.16 产品配件(被动模式)
- 4.2.17.出入库信息及明细(被动模式)
- 4.2.18.师傅邀请码(被动模式)
- 4.3.安装流程
- 4.3.1.流程说明
- 4.3.2.工单派发(主动模式)
- 4.3.3.派送师傅(被动模式)
- 4.3.4.预约上门(被动模式)
- 4.3.5.上门打卡(被动模式)
- 4.3.6.处理完成(被动模式)
- 4.3.7.申请完单(被动模式)
- 4.3.8.工单回访(暂停使用)
- 4.3.9.工单撤销(被动模式)
- 4.3.10.工单转派(被动模式)
- 4.3.11.技术鉴定(主动模式)
- 4.3.12.回访审核(主动模式)
- 4.4.维修流程
- 4.4.1.流程说明
- 4.4.2.工单派发(主动模式)
- 4.4.3.派送师傅(被动模式)
- 4.4.4.预约上门(被动模式)
- 4.4.5.上门打卡(被动模式)
- 4.4.6.处理完成(被动模式)
- 4.4.7.技术鉴定(主动模式)
- 4.4.8.申请完单(被动模式)
- 4.4.9.工单回访(暂停使用)
- 4.4.10.工单撤销(被动模式)
- 4.4.11.工单转派(被动模式)
- 4.4.12.回访审核(主动模式)
- 4.5.鉴定流程(暂停使用)
- 4.5.1.流程说明(暂停使用此流程)
- 4.5.2.工单派发(主动模式)
- 4.5.3.派送师傅(被动模式)
- 4.5.4.预约上门(被动模式)
- 4.5.5.上门打卡(被动模式)
- 4.5.6.处理完成(被动模式)
- 4.5.7.申请完单(被动模式)
- 4.5.8.工单撤销(被动模式)
- 4.5.9.工单转派(被动模式)
- 4.6.投诉流程
- 4.6.1.流程说明
- 4.6.2.工单派发(主动模式)
- 4.6.3.处理完成(被动模式)
- 4.7.换货流程
- 4.7.1. 流程说明
- 4.7.2. 工单派发(主动模式)
- 4.7.3. 网点确认收新品(被动模式)
- 4.7.4. 网点处理送装(被动模式)
- 4.7.5. 师傅预约上门(被动模式)
- 4.7.6. 师傅送拆装(被动模式)
- 4.7.7. 网点自寄(暂时停用-被动模式)
- 4.7.8. 客服审核(主动模式)
- 4.7.9. 逆向处置审核(主动模式)
- 4.8.退货流程
- 4.8.1. 流程说明
- 4.8.2. 工单派发(主动模式)
- 4.8.3. 网点预约上门(被动模式)
- 4.8.4. 师傅预约上门(被动模式)
- 4.8.5. 师傅上门拆件(被动模式)
- 4.8.6. 网点自寄(暂时停用-被动模式)
- 4.8.7. 逆向处置审核(主动模式)
- 4.9.拆机流程
- 4.9.1.流程说明
- 4.9.2.工单派发(主动模式)
- 4.9.3.派送师傅(被动模式)
- 4.9.4.预约上门(被动模式)
- 4.9.5.上门打卡(被动模式)
- 4.9.6.处理完成(被动模式)
- 4.9.7.回访审核(主动模式)
- 4.10.测量流程
- 4.10.1. 流程说明
- 4.10.2.工单派发(主动模式)
- 4.10.3.派送师傅(被动模式)
- 4.10.4.预约上门(被动模式)
- 4.10.5.上门打卡(被动模式)
- 4.10.6.处理完成(被动模式)
- 4.10.7.回访审核(主动模式)
- 4.11.配件申请流程
- 4.11.1. 流程说明
- 4.11.2. 创建工单(被动模式)
- 4.11.3. 配件审核(主动模式)
- 4.11.4. 处理退回(被动模式)
- 4.11.5. 仓库发货(主动模式)
- 4.11.6. 网点收货(被动模式)
- 4.12.配件退款流程
- 4.12.1. 退款成功通知(主动模式)
- 4.13. 维修换修流程
- 4.13.1. 流程说明
- 4.13.2. 工单派发(主动模式)
- 4.13.3. 派送师傅(被动模式)
- 4.13.4. 预约上门(被动模式)
- 4.13.5. 上门打卡(被动模式)
- 4.13.6. 处理完成(被动模式)
- 4.13.7. 寄修收货(被动模式)
- 4.13.8. 工单撤销(被动模式)
- 4.14.清洗流程
- 4.14.1.流程说明
- 4.14.2.工单派发(主动模式)
- 4.14.3.派送师傅(被动模式)
- 4.14.4.预约上门(被动模式)
- 4.14.5.上门打卡(被动模式)
- 4.14.6.处理完成(被动模式)
- 4.14.7.回访审核(主动模式)