卡易速自动发卡货源的可售状态怎么确认

接入自动发卡渠道时，最容易出现的判断误差是：看到货源分类匹配、报价合适，就直接认定为可用货源。实际上，供货接口中商品是否处于可采购状态、订阅有效期是否覆盖经营周期、库存与规格是否一一对应，才是决定能否正常发卡的硬条件，只看表层信息很容易在首笔订单出现发卡失败。下面只解决一个问题：怎样在不依赖口头承诺的前提下，确认卡易速自动发卡货源处于真实可售状态。

先确认货源查询入口与账户可见范围

可售状态的核对要从官方开放的查询能力开始，而不是让供应方截图代查，截图无法体现当前订阅状态或实时库存。依据接口文档，调用 GET /categories 可获取当前账户可见的商品分类；拿到分类后，再调用 GET /goods/catalog 并传入 catalogRef 参数分页查询可采购商品，该列表会直接返回商品的当前订阅状态与到期时间。

这一步的关键是确认当前账号具备基础接入权限，且查询结果覆盖你要经营的商品范围。若接口返回的可见分类少于预期，或在商品目录中找不到对应货源，说明当前账户的可见范围尚未覆盖该货源，不能直接判断为货源不可用，应先核对权限与账号主体配置。

核对订阅状态与到期时间是否覆盖经营周期

商品目录返回的订阅状态是判断可售性的核心依据。订阅处于有效状态，商品才具备持续下单与自动发卡的基础；订阅到期或未订阅，即便展示在商品目录中，也不代表可以稳定采购。如果计划长期经营，需将到期时间与自身经营周期对齐，避免经营中途出现供货中断。

如果业务需要在第一笔订单之前就接收货源变化，可调用 POST /goods/subscriptions 订阅商品；不订阅也可以继续查询模板和创建订单，但订阅后可通过查询接口筛选已订阅商品，并接收对应的商品变化通知，便于同步货源动态。

核对库存格式与有效可售数量

货源类型不同，库存的计算方式也存在差异，卡密、卡号加卡密、固定卡密与充值货源不能按同一逻辑理解。自动发卡场景下，只有具备明确可售数量且格式符合自动发放要求的卡密类货源，才能直接绑定自动发货规则。

操作时不要只看总库存，要先确认有效可售数量，再核对货源类型、启用状态，以及是否绑定到正确的商品或规格。例如，卡密类货源需要与卡密仓库和发货规则对应，直充类货源需要关联对应充值商品，仅增加总库存并不等于完成可售绑定。

用商品详情与下单模板验证发卡匹配度

对商品目录中确认可采购的商品，调用 GET /goods/{productRef} 获取商品详情与规格，确认商品类型、可用规格与自身经营需求一致。随后调用 GET /goods/tpl 获取下单模板，保存模板并生成本地下单表单，单规格商品只传 productRef，多规格商品同时传 variantRef。

这一步用于验证货源规格与本地商品规格能否对应。若模板字段与本地表单无法匹配，说明该货源不能直接用于当前自动发卡商品，需要调整规格映射，不能靠手动导入或猜测字段强行对应。

明确结果不确定状态的处理边界

核对过程中如果出现状态不明、库存数异常或规格无法对应的情况，应先停下来核查，而不是直接创建订单。依据后台常见问题的处理要求，结果不确定时要先人工核查，避免卡密重复发放或充值重复到账。

多货源场景下，系统按既定策略分配订单，存在低价优先、自营优先与顺序轮询等不同规则，不能仅凭货源列表排序推断每一笔订单必然走某一渠道。遇到发卡失败，先查看原订单日志与渠道返回结果，确认明确失败且未交付后再走补单流程，避免把可售判断问题误判为发货规则问题。

这个判断不适用时如何调整

上述方法适用于开放接口且具备基础接入权限的卡易速货源场景，如果你尚未开通接口权限，或当前货源不在当前账户可见范围内，则不能通过接口直接判断可售状态，需要先完成权限开通、账号归属或店铺接入配置，再回到接口查询。对于仅支持后台页面核对的货源，可对照商品与规格关联、实际发布状态、货源类型及发货规则逐项核对，但这类核对无法替代接口返回的订阅与库存状态。

参考资料：接入指南（2026-09-20）；库存与发货异常（2026-10-18）；电商店铺与选品（2026-10-18）。具体操作与适用范围以对应文档为准。