Prestashop Webservice API获取所有退货订单问题求助

核心资源定位 #

你在官方资源列表里找不到对应条目的核心原因是命名认知错位+列表排序漏看：PrestaShop 全稳定版本（1.6/1.7/8.x）的Webservice体系中，对应客户实物退货流程记录的资源标识符为 order_return。
一方面这个资源名带了order_前缀，和大家日常认知里“return”单独作为退货资源的预期不匹配；另一方面官方资源列表是按首字母排序的，order_return排在order_status条目之后，很多人翻到order相关资源区时漏看了靠后的这个条目，才会以为没有对应退货的API。

注意和两个易混淆资源做区分，避免找错接口：

• order_return：目标资源，存储全链路退货记录，包含客户提交的退货申请、关联原订单ID、退货原因、当前审核状态、退货收件凭证等完整信息，就是你要查询的退货订单数据来源
• order_slip：仅存储财务维度的退款凭证，记录退款金额、退款路径，不包含实物退货的申请、物流相关信息，不要和实物退货资源混淆

调用注意事项 #

• 首次调用前，必须在PrestaShop后台的Webservice配置页，给当前使用的API密钥勾选order_return资源的访问权限，直接调用会触发403未授权错误
• 拉取全量退货记录的基础调用路径为Webservice根路径下的/api/order_return端点，返回结果为所有退货记录的索引列表；如果需要做条件筛选，可以搭配官方支持的filter参数（比如按关联原订单号、退货状态过滤）、display参数控制返回字段，精简返回体量
• 如果需要补充退货记录关联的明细信息，可以通过返回结果中携带的原订单ID，关联调用order资源获取原订单详情，调用order_return_history资源获取对应退货的全状态变更日志

版本兼容说明 #

• 所有PrestaShop 1.7正式版的order_return资源接口逻辑完全统一，没有版本破坏性变更，直接按上述逻辑调用即可
• 如果你使用的是PrestaShop 8.x大版本，该资源的命名、权限规则、返回字段没有做不兼容调整，可以直接复用1.7的调用代码逻辑

内容的提问来源于stack exchange，提问作者Sachin