在智利做电商，很多订单并不来自自己的网站，而是来自 MercadoLibre（美客多）。网站和平台各一套后台，库存、订单、发货分开看。。KingCMS X1 内置了 MercadoLibre 模块，把平台订单接进同一个后台，按销售渠道单独统计。
适合什么场景
常见的有：一是在 MercadoLibre 有店铺、同时用 KingCMS 做独立站，希望订单在一个列表里看；二是同一个商品在两边卖，需要把平台 SKU 和网站 SKU 对上，避免超卖；三是发货量上来后，希望面单和库存状态不用两边手工抄。
只在平台卖、没有独立站时，这个模块不是必需的。
第一步：启用模块并准备应用凭证
模块默认是关闭的，未启用时后台不出现入口，路由和定时任务也不生效。到「模块管理」启用 MercadoLibre 后，侧栏「商城」下会出现入口。
连接前要先在 MercadoLibre 开发者后台创建一个应用，拿到 Client ID 和 Client Secret，并把回调地址填成与站点一致的地址。后台设置页会显示本站实际使用的回调地址，复制过去即可；两边不一致时授权会失败。
设置页里还有几个关键项：站点选智利（MLC）；同步最近天数 1–30 天，默认 7 天；自动同步间隔不小于 5 分钟，默认 30 分钟；定时自动同步默认关闭，需要手动打开。建议先用较短的天数试跑，确认订单和金额都对，再放大范围。
第二步：授权连接
点「连接 MercadoLibre」会跳到平台的授权页，确认后回到本站。令牌加密保存，页面只显示「已连接」、卖家账号和过期时间，不会回显明文；离过期不足 5 分钟时会先刷新再调接口，遇到 401 会刷新一次重试。
安全上有一条硬限制：授权、回调、同步、推送和面单都只接受 https 的公网域名，localhost、内网地址和裸 IP 一律拒绝。本地调试请使用正式域名加反向代理。
第三步：同步订单，按渠道看账
「同步订单」可以留空拉取最近一段时间的订单，也可以填订单号只同步指定几单。平台订单进来后渠道记为 MercadoLibre，和网站订单分开：后台订单列表可以按渠道筛选，销售统计和导出也按渠道分列。
订单号固定为 ML- 加平台订单号，重复同步会跳过，不会生成第二张单，也不会覆盖后台人工改过的金额和商品。金额按智利比索整数乘 100 存成分，订单总额、行合计、运费和折扣保持对得上。状态按平台状态映射：待付款、已付款、部分退款、退款、取消；已付款的订单还会看物流，已发货变「已发货」，已送达变「已完成」，只向前推进，不回退。
第四步：SKU 映射、面单与库存推送
要让库存和价格同步，先在 SKU 映射页把平台商品和网站 SKU 对上，可以逐条加，也可以用 CSV 批量导入导出。没映射的平台商品会进未映射报告，映射后自动消失。
面单在订单里直接下载，链接用短期签名，默认 1 小时有效。库存和价格推送默认关闭，开启后手工按钮和定时任务都会按映射推送，不会推没有映射的商品。
注意事项
第一，平台订单属于导入单，不能走站内的付款流程，付款和退款仍在 MercadoLibre 侧完成。第二，自动同步默认关闭，别忘了按自己的单量设置间隔并打开。第三，平台商品没做映射时，库存推送不会生效，先补映射再开推送。第四，两边同时卖同一商品时，库存以哪边为准要提前定好，避免超卖。
小结
MercadoLibre 模块解决的不是「多一个销售渠道」，而是「渠道多了以后账还能对得上」：订单进同一个后台、按渠道统计、SKU 对上、面单和库存状态不用手工搬。对同时经营独立站和拉美平台店铺的团队，这能省下每天最枯燥的那部分工作。