商品接口最佳实践

一、概述

LinkedMall API为分销商提供了一系列商品相关接口和消息，分销商可通过合理调用各接口和商品消息消费，实现商品的同步、查询等功能。

本文档旨在规范接口调用的流程并提示相关注意事项，以协助分销商避免不合理调用接口导致的问题，从而提升系统的稳定性和可靠性。文档通过四个典型场景阐明如何正确使用接口。

二、典型场景说明

场景1：商品同步并回流

说明

商品同步是指将商品信息从一个系统同步到另一个系统，并将同步结果回流。通常用于系统间的数据初始化或不定期更新。

典型业务场景

注意事项

• 确保调用接口时的参数完整性和准确性，避免因参数错误导致数据缺失。

• 应及时消费商品各类消息，以正确获得增量商品及商品状态等更新。

场景2：搜索接口同步商品并回流

说明

通过搜索接口同步商品信息并回流，适用于根据特定条件动态获取商品数据的场景。

典型业务场景

注意事项

• 搜索条件的准确性对结果至关重要，确保搜索参数的合理性和完整性。

• 目前，商品出入库功能及消息等，仅适用于已加白出入库功能的分销商，请参考下表。

  功能	加白分销伙伴	未加白分销伙伴

  功能	加白分销伙伴	未加白分销伙伴
  优化后的商品消息发送策略	遵循新策略（参考下一张表格）	全量发送和消费
  商品出库、入库接口	需对接或在控制台操作出入库	出入库操作不生效
  商品出库、入库消息	需及时消费	需忽略
  商品出入库状态inGroup字段	需关注或处理	需忽略

• LinkedMall系统针对已入库和未入库（已出库）的商品采用不同的商品消息发送和策略。详情请参考下表。

  重要

  商品出库、入库功能，目前仅开放给部分已加白分销商。未加白的分销商的全类商品消息均会发送（可忽略下表）。详情请咨询LinkedMall技术支持小二。

  消息	未入库商品是否发送	已入库商品是否发送

  消息	未入库商品是否发送	已入库商品是否发送
  商品创建消息	是	是
  商品删除消息	是	是
  商品编辑消息	否	是
  商品状态变更消息	是	是
  商品入库消息	是	是
  商品出库消息	是	是
  商品建议零售价变更消息	否	是
  Sku创建消息	是	是
  Sku删除消息	是	是
  Sku价格变更消息	是	是
  Sku编辑消息	否	是
  Sku状态变更消息	是	是

场景3：购物车商品列表展示场景

说明

电商业务通常需要配置购物车模块。当买家加购商品后，商品进入购物车商品列表。

典型业务场景

注意事项

• 确保购物车中的SKUID准确无误，避免查询到错误的商品信息。

• 如需按买家收货地址查询对应区域是否可售，需在调用接口时传入divisionCode字段。

场景4：商详展示和导购展示场景

说明

商详与导购场景是指业务根据用户的需求推荐商品，通常需要查询商品详情和售卖信息。

典型业务场景

注意事项

• 导购场景中，商品推荐的准确性依赖于商品详情和售卖信息的完整性，确保接口调用时参数正确。

• 如需查询商品在指定区域是否可售，调用接口时需传入divisionCode参数。

三、商品接口及消息介绍

请参考商品接口说明及商品消息说明。