美客多巴西站旧批量接口 10 月 25 日到期：多查询端点停用改用 bulk，2026 准入门槛同步收紧

10 月 25 日这一天，美客多（Mercado Libre）平台上被大量 ERP 调用了多年的两个多查询接口，将走完弃用流程。改动本身只有一行：把 /items?ids= 换成 /items/bulk?ids=。但对一家把巴西、墨西哥、智利三站跑在同一个 ERP 里的团队来说，这一行的代价可能不是同步慢几个小时。2026 年 10 月 22 日的行业早报给的说法更直接——没升级的卖家不是慢一点，而是订单与库存同步直接中断。问题在于，官方公告里并没有「中断」这两个字。

美客多面向集成方的公告写得很短，大意是：多查询端点 /items?ids= 与 /users?ids= 进入弃用流程，执行同类查询请改用 /items/bulk?ids= 与 /users/bulk?ids=，新端点已经可用，请在 2026 年 10 月 25 日前完成迁移，过渡期内现有端点与替代端点并存。同一时间窗口里，美客多 2026 年的准入规则也在系统性收紧：多数站点要求有限责任或股份公司主体，佣金由相对固定改为阶梯，税号成为硬门槛，品牌商品须前置授权书，自发货订单有效追踪率门槛抬到 95%，新店保护期由三个月压缩到一个月。

巴西小包方向则给了甜头——50 美元以下联邦进口税归零——但只对走合规渠道的包裹生效，且严禁拆单。一件管你还能不能在系统里跑，一件管你还能不能在平台上卖。两件事落在同一个季度。

一、被停用的到底是什么接口

先把范围说清楚：这次进入弃用的是「多查询」端点，也就是在一次请求里用逗号拼一长串 id、批量拉取商品或卖家信息的那类调用。ERP 批量拉取刊登状态、库存、价格、批量核对卖家信息，走的通常就是这条路。它不是刊登接口，也不是下单接口。

公告里的三个信息点值得拆开看。

第一，替代关系是等价替换，不是新功能。/items/bulk?ids= 与 /items?ids= 做的事相同，但返回结构有差异。已有开发者在迁移记录中提到，新端点的响应格式与旧端点不同，读取字段时需要在字段名前加 body. 前缀，解析层要跟着改。这意味着 ERP 侧不是把 URL 替换掉就完事。

第二，「过渡期内新旧并存」这句话在公告里是有时点的。官方原文用了「convivirán」（将并存）的表述，但没有写明这段过渡期有多长，也没有写明 10 月 25 日之后旧端点以什么方式失效——是返回错误码、返回空值，还是继续可用一段时间。公告未作说明。

第三，10 月 25 日不是今年唯一的截止日。美客多全球销售开发者文档显示，另一项更底层的迁移已经先走了一轮：User Products 刊登模型的采用截止日为 2026 年 7 月 31 日，集成方须在此日期前完成迁移以避免影响卖家体验，自该日起旧刊登模型会被逐步停用。文档同时提示，带有 user_product_seller 标签的卖家必须使用 User Products 模型刊登，而 2026 年 2 月之后创建的卖家大概率已带此标签。对还没做过这轮迁移的团队来说，10 月 25 日这条是叠加在旧账上的新账。

二、「中断」这个说法从哪来，官方怎么写的

「不是变慢，而是中断」这个表述，出自 2026 年 10 月 22 日的行业早报，不是美客多的官方原话。

两者口径的差异不在严重程度，而在可验证性。官方公告给的是一个迁移截止日加一句「过渡期并存」，没有承诺过渡期长度，也没有承诺截止日后旧端点的失效方式。早报给的是一个结果判断：ERP 未升级，订单与库存同步直接断掉。这两种说法之间，隔着一层中间件。

ERP 不是直接把数据推给美客多，而是按周期调用接口拉取。假设一次批量查询在迁移日后返回错误，ERP 侧的表现取决于它自己的容错设计：有的会重试几次后抛错并停止同步，有的会静默失败——后台库存停在旧值，或直接归零。前者是显性中断，当天就能发现；后者更难察觉，表现为前台页面显示缺货、仓库实际有货，等发现时已经错过销售窗口。

这里还有一个容易被忽略的变量：调用方不止 ERP 一个。海外仓 WMS、客服工单系统、BI 看板抓取、以及卖家自己写的脚本，都可能各自持有一份对旧端点的调用。只改 ERP 一处，其余链路仍会在 10 月 25 日之后继续报错。

三、准入端同期收紧的六条线

与接口弃用同期披露的，是美客多 2026 年入驻与考核规则的一组调整。按公开招商资料整理，六个方向出现了变化。

主体类型被抬高。旧政策下一个体工商户、个人独资企业在部分站点可以入驻，2026 年多数站点要求有限责任或股份公司；个体工商户只能进入少数特定站点。另有招商资料给出更具体的口径：中国卖家通道仅接受中国大陆或中国香港注册的有限责任公司，个体户、个人与分公司不在受理范围，营业执照剩余有效期需不少于 30 天。

佣金结构改为阶梯。旧政策下平台佣金相对固定，2026 年引入阶梯佣金，公开口径是销售额越高费率越低。具体区间各家招商资料并不一致：ESG 跨境电商给出的主流区间是 11% 至 17%，墨西哥站为 17.5% 至 19%；另有资料列出电子类 5% 至 8%、时尚类 15% 至 20%。平台未逐档披露费率表。

税号成为硬门槛。墨西哥 RFC、巴西 CNPJ、智利 RUT 被明确写入要求。墨西哥站的口径是年销售额超过 5000 美元须注册 RFC；无合规 RFC 的情况下，平台按每单预扣 36% 销售额（16% 增值税加 20% 所得税）作为预缴税金。巴西站需本地 CNPJ，且巴西站发货前还有 NF-e 电子发票流程需验证。

品牌授权前置。旧政策下无授权书的品牌商品有时也能上架、被投诉后再下架；2026 年的口径是品牌商品必须提前提交授权书，否则直接限制上架，平台与品牌方的数据对接可自动识别未授权商品。

自发货追踪率设线。选择自发货的卖家，须保证 95% 以上的订单能提供有效追踪号，否则会被限制流量；使用官方仓的卖家在搜索排名上仍有优势。

新店保护期缩短。旧政策新店有三个月保护期、期间考核较松；2026 年压缩到一个月，且第一个月就考核取消率与发货时效。

需要标出来的风险是：以上条目的生效时点与适用站点，在公开招商资料里并不统一。「95% 有效追踪率」适用于哪些站点、从哪一天开始执行，公开资料未见明确时间表；新店保护期缩短到一个月从哪一天起执行，同样未见官方统一公告日期。这两项应以账户经理书面确认与卖家后台通知为准，不宜按二手资料自行推算。

四、巴西小包：50 美元归零的三个附加条件

巴西这条线是少见的减负，但减负有前提。

时间线上，2026 年 5 月 12 日，巴西政府发布第 1357 号临时措施（MP 1.357/2026），授权财政部把国际邮政包裹简化税制下不超过 50 美元的进口税税率降至零，措施自 5 月 13 日生效，同日财政部颁布法令明确零税率。9 月 10 日，总统卢拉签署由该临时措施转化而来的 2026 年第 13 号法案，免税安排转为正式法律。

归零的是联邦进口税（II），不是全部税负。三点附加条件必须同时满足：一是渠道限制，商品须通过巴西联邦税务局「合规汇款计划」（Remessa Conforme）认证的平台购买；二是计价口径，判断标准是海关计税价格而非商品标价，计税价格包含商品价格、运费和保险费用；三是州税照旧，各州征收的商品和服务流通税 ICMS 税率目前为 17% 至 20%，无豁免。

50.01 至 3000 美元区间维持 60% 税率，固定减免 30 美元。新法同时授权财政部长调整简化进口税制税率，包括把 3000 美元以下国际包裹税率降至 30%，并可按运输方式、电商平台是否加入合规计划实行差别化税率。

拆单被写进了法条。法律授权主管部门对免税商品的购买数量和频率作出限制，并采取措施防止消费者通过人为拆分包裹规避监管，或利用简化税制从事商业销售与转售活动。也就是说，把一笔 80 美元的订单拆成两个 40 美元包裹发出，属于被明确防范的行为。

财政侧的代价也有数字：该项税收 2025 年全年规模约 50 亿雷亚尔，2026 年前四个月征收 17.8 亿雷亚尔，同比增长 25%。巴西工业和零售业团体对免税持反对意见，认为会扩大进口商品与本国产品的税负差异；按新法，财政部将定期评估免税政策的经济影响，国会每年审议差别化税收制度。

五、ERP 侧与合规侧的待办清单

技术侧的动作有先后。第一步是在全部代码库与第三方插件中检索 /items?ids= 与 /users?ids= 的调用位置，不要只在主 ERP 里搜；第二步是确认新端点的返回格式差异并完成解析层改造，已有迁移记录显示字段读取方式需要调整；第三步是灰度对照——用同一批 id 同时请求新旧端点，比较返回值是否一致，再全量切换。

合规侧的六项自查可以并行：主体类型与营业执照剩余有效期、三站税号（RFC、CNPJ、RUT）状态、品牌授权书归档情况、自发货订单追踪号回传率是否达到 95% 以上、新店首月取消率与发货时效看板是否已建、巴西小包渠道是否在 Remessa Conforme 认证名单内。

报价口径也要跟着改。巴西小包应按海关计税价格（商品价加运费加保险）判断是否落在 50 美元以下，而不是按商品标价；同时确认渠道合规，且不通过拆单规避。

成本测算上有一处需要谨慎：阶梯佣金的具体区间未逐档公开，各招商资料口径不一。测算时应按未打折的类目佣金区间做压力测试，不要按最优档推算利润。平台对新卖家的首月免佣、第 2 至 3 个月减半等扶持，同样属于阶段性安排，未在公告中承诺长期有效。

接口截止日是确定的，准入口径是不确定的。真正被这条消息筛掉的，往往不是没看到公告的人，而是把 ERP 当成一次性采购项目、没人维护接口的团队。10 月 25 日之后，旧端点会不会真的同时关掉？答案也许要等到第一批没升级的卖家在后台看到空库存那天，才会真正浮出水面。

六、参考资料

• Mercado Libre API 弃用公告：《Los endpoints de consultas múltiples /items?ids= y /users?ids= entran en proceso de deprecación》
• Mercado Libre 全球销售开发者文档：《User Products 刊登模型迁移说明（2026 年 7 月 31 日截止）》
• 新华财经：《巴西正式取消 50 美元以下跨境网购进口税》
• Gazeta Brasilis：《Taxa das blusinhas: Governo publica MP que zera o imposto para compras internacionais de até US$ 50》
• CoGoLinks 结行国际：《美客多新旧入驻政策对比，2026 开店变化》
• ESG 跨境电商：《美客多入驻 2026：拉美第一电商的四种卖法，中国卖家怎么选》
• 妙手 ERP 跨境学院：《美客多和 Noon 哪个好做？2026 年拉美与中东市场入驻门槛、成本与运营难度对比》
• 跨境电商行业早报（2026 年 10 月 22 日）：《欧盟从收钱转向查数据，非洲线附加费明起连涨五天》