新商盟多渠道订货REST服务接口文档-V1.2

版权申诉
0 下载量 94 浏览量 更新于2024-06-25 收藏 193KB DOCX 举报
"多渠道订货REST服务列表-V1.2-20160217.docx 提供了一组用于多渠道订货管理的RESTful API,涵盖了从客户信息获取、商品浏览到订单操作等多个关键环节。文档中详细列出了各个API的功能、返回的数据格式以及调用方法。" 在多渠道订货系统中,REST服务扮演着核心角色,它通过HTTP协议对外提供了一系列接口,允许外部应用与系统进行交互。以下是这些服务的主要知识点: 1. **获取客户信息 (getCust)**: 这个接口用于获取客户的详细信息,可能包括姓名、联系方式、地址等。调用URL为`http://新商盟省站地址/apiJS/custJS/getCust`,服务提供者为新商盟,适用于外网订货终端。 2. **获取公司商品**: 此接口返回公司的商品列表,包含商品的各种属性,如名称、价格、库存等。如果系统采用导入xsm的本地限量模式,还会返回特定的限量值。 3. **购物车管理**: 包括购物车查询、增加和删除操作,支持用户在购物车中添加、移除商品。 4. **客户限量查询与客户单品限量查询**: 这些接口用于查询客户的总体购买限制和单个商品的购买限制,帮助用户了解自己能否购买特定数量的商品。 5. **当前周期订单查询 (CHECK)**: 允许用户查看当前订货周期内的订单状态,了解订单是否已经提交或处理中。 6. **订单操作**: 包含订单头查询、订单明细查询、订单提交、订单修改和订单删除。订单提交和修改不返回订单明细,除非机构参数设置允许。如果提交失败,系统会在MSG中提示具体原因,比如限量不足。 7. **查询余额**: 用户可以查询自己的账户余额,确保有足够的资金进行支付。 8. **收藏夹管理**: 收藏夹查询、增加和删除功能,帮助用户管理他们的喜好商品。收藏夹增加时会检查是否有公司级收藏并进行相应处理。 9. **检查订货时间**: 用户可以查询何时可以进行下一次订货,以便规划购买。 10. **订单跟踪**: 提供订单的物流跟踪信息,让用户了解订单的配送进度。 11. **上报库存**: 可能用于商家向系统报告商品库存变化,以保持库存信息的准确。 12. **获取商品基础属性**: 获取商品的基本信息,如规格、颜色、尺寸等。 13. **系统参数和数据格式**: 文档还定义了一些数据格式,如C字符型、C12固定长度字符串、可变长度的C..12和C4..12字符串,以及数值型的N3、N..3和N7,2。 这些REST服务构成了一个多渠道订货系统的基础架构,允许用户通过不同的渠道方便地进行商品选购、订单管理,并与后台系统进行无缝通信。通过规范化的API设计,系统实现了标准化的数据交换,提高了系统的可扩展性和互操作性。