¶ 美客多（Mercado Libre）店铺对接：授权、抓单、平台面单与物流回传
将美客多店铺连接到易抵达后，可以定时抓取已付款订单、保存平台物流单号及符合条件的面单，并为适用的自发物流订单回传物流信息。
本指引使用 Global Selling 墨西哥站（MLM）说明操作。图片来自测试界面，仅保留配置区域，名称和日期为演示内容，不包含真实店铺账号、客户资料或授权凭据。截图中的“未授权”是新增配置的状态，不是授权成功示例。
返回：其他电商平台对接。
¶ 一、先确认订单使用哪种物流
¶ 平台合作承运商发货
对应美客多的 me2 / drop_off、cross_docking 场景。
- 抓取订单和平台已生成的物流单号。
- 符合面单下载条件时，保存平台面单。
- 不向美客多回传易抵达的物流单号或面单。
¶ 平台仓履约
对应美客多的 me2 / fulfillment 场景。
- 抓取订单、物流状态及平台已有的物流单号。
- 此对接不下载平台仓面单，也不回传易抵达的物流单号或面单。
¶ 卖家自有物流
对应美客多的 me1 / default 场景。
- 抓取订单，按已配置的渠道和排货规则安排取号。
- 取得转单号后，回传物流单号、承运商，以及已有的追踪链接。
- 不上传卖家面单。
其他物流模式不会仅因为“没有平台单号”就自动改为自发物流。若不清楚订单属于哪一类，请先向客服核对。
当前使用边界：
- 抓取范围为已付款订单。未付款、取消等状态的订单不在本流程的抓取范围内。
- 一张美客多订单对应一票易抵达运单；同一订单有多个商品时，生成多条申报明细。
- 首先用于独立物流包裹的订单。多个订单共用同一个平台物流单号的共包场景，暂不支持完整的多票建单，请先交客服核对，不要通过放开重复转单号或编造单号绕过。
- 其他站点需要另行核实店铺权限和物流能力；参数栏出现其他站点的示例，不代表所有站点都已验证可用。
¶ 二、使用前准备
- 请管理员确认机构已开通电商对接，并已完成美客多平台应用的对接配置。
- 准备具有店铺授权权限的美客多卖家账号。
- 确认当前易抵达账号有查看、新增和修改抓单接口的权限。
- 确认接收订单使用的收货渠道；若为自发物流，还需由业务人员配置适用的排货取号规则、发货渠道及承运商。
每个店铺使用独立的接口配置，并用名称区分。无需把店铺密码或授权凭据填入下面的普通配置字段。
¶ 三、新增美客多抓单接口
¶ 1. 打开抓单对接设置
在客户端点击“运单”，进入旧版运单界面。
打开右上角“设置”，选择“抓单接口”。
在“抓单对接设置”窗口点击图中①“添加”。图中②③所示的最近抓取时间、状态和错误列，用于配置完成后的核对。
本文后续使用的是带“基本、参数、默认”三个页签的窗口。如果你进入的窗口没有这些页签，请先回到上述旧版运单入口，不要在其他平台的参数栏中代填。
¶ 2. 填写基本信息
在“基本”页签，按图中编号设置：
- “类型”选择 Mercado，即美客多。
- “名称”填写便于识别店铺的名称，例如“美客多墨西哥示例店铺”。
- “间隔时间(分钟)”按业务需要填写；留空使用系统默认安排。
¶ 3. 填写美客多参数
打开“参数”页签，按图中编号设置：
- “站点”填写本店铺对应的站点；墨西哥站示例为 MLM。
- 需要保存平台物流面单时，将“抓取平台面单”选择为“是”。
- “抓单起始时间”填写希望开始抓取订单的时间，格式为“年-月-日 时:分:秒”，例如
2026-10-01 00:00:00。这是订单创建时间的起点；留空不限制起始时间。 - 新增时显示“请先保存接口后再授权”，属于正常提示。
“抓取平台面单＝是”不等于所有订单都有面单：只有平台合作承运商发货的适用订单，且平台物流状态已达到可发货（ready_to_ship）时，才尝试下载。
¶ 4. 设置订单默认信息
打开“默认”页签。
在图中①“收货渠道”选择承接该店铺订单的渠道。
有海外仓业务时，再按实际业务选择图中②“仓库(海外仓)”；不要为普通订单随意指定仓库。
客户账号新增的接口会归属当前客户。内部员工代为配置时，还需核对接口归属客户及相关默认信息。
信息核对无误后，点击窗口底部“保存”。
¶ 四、完成店铺授权
重新进入接口的“参数”页签，检查授权状态。下图①为页签入口、②为授权状态、③为首次保存前的提示。若仍显示“请先保存接口后再授权”，需先保存，再重新打开接口，才能进行下面的授权操作。
说明：本图是测试界面的未授权状态，不是美客多登录页或授权成功示例。完成下面的真实店铺授权后，②应显示“已授权”。
- 在抓单列表双击刚保存的接口。
- 打开“参数”页签。
- 点击“授权”。已有授权的接口会显示“重新授权”。
- 在美客多打开的授权页面，使用正确的卖家账号完成登录和确认。
- 看到“授权成功”后，返回抓单列表。
- 重新打开该接口，确认“授权状态”为“已授权”，并核对显示的店铺昵称。
若店铺或账号不对，请重新授权正确账号，不要继续抓取。授权页面停留过久或提示授权状态失效时，应从接口重新发起授权，不要重复使用旧的授权链接。
¶ 五、检查抓单结果和平台面单
¶ 抓单是否真正完成
保存并授权后，在抓单列表确认接口处于“运行中”。需要恢复已暂停接口时，选中该接口并执行“启用”。
系统按抓取安排处理订单。内部员工可在核对配置后使用“立即抓单”进行一次验证；客户账号不一定显示此按钮。
核对最近抓取时间、最近抓取状态和最近抓取错误。仅显示“已授权”，不能代替抓单成功。
按图中①②③逐项核对；本图只展示核对位置，测试列表为空，不表示已有订单抓取成功。
使用美客多订单号，按“客户单号”查询生成的易抵达运单。
打开运单，检查收件资料、申报明细、重量和转单号。平台提供的重量会换算为公斤；若平台缺少真实重量，系统不会自动补一个虚构重量，请按错误提示核实资料。
¶ 平台物流订单的面单在哪里
满足下载条件且抓取成功后，平台物流单号会保存为运单的“转单号”。平台面单保存在运单档案中，文件类型为“转单Label”，文件名以“MercadoLibre转单面单”开头。
双击运单打开详情，再进入“文件”页签（窗口较窄时可先展开详情区域）。在列表中检查文件名和类型，再打开或下载对应文件，核对面单上的物流单号与运单转单号一致后再打印。
图中①进入“文件”，②核对文件名，③核对类型，④为可用的打开、打印或下载操作。图片使用普通测试运单展示入口，其中“系统Label”不是美客多平台面单；美客多平台面单应按上文核对为“转单Label”，文件名以“MercadoLibre转单面单”开头。
平台物流暂未生成单号或面单时，不要另用其他承运商接口重复取号；本对接不会把这类订单自动转成自发物流。
¶ 六、自发物流订单怎样回传
仅适用于已被识别为卖家自有物流（me1 / default）的抓单订单。
- 确认订单已保存到易抵达，并正确关联原美客多订单。
- 按已配置的排货和打单流程取得真实转单号。
- 核对渠道已配置正确承运商。
- 核对取号后的自动回传结果；需要人工处理时，由有权限的操作人员在运单“更多”中执行“转单回传”。
- 在回传日志及美客多订单中，分别核对是否成功、物流单号及承运商是否一致。
这条回传通道自动使用该运单关联的店铺授权，不需要再新建一套美客多回传账号。自动回传需要取号事件及回传任务正常执行，请以回传日志和平台结果为准。
没有适用排货规则时，可能出现“运单已保存，但取号未成功”的警告；这不代表物流信息已经回传。应先完成渠道、排货、取号，再核对回传结果。
此流程回传的是物流信息，不把易抵达生成的卖家面单上传给美客多。平台物流订单也不适用此流程。
¶ 七、常见问题
¶ 已授权，为什么没有订单？
按顺序检查：接口是否运行中、店铺是否正确、订单是否已付款、订单创建时间是否在抓单起始时间之后，以及最近抓取错误。新店铺没有符合条件的订单时，不会凭空生成运单。
¶ 为什么有订单和单号，却没有平台面单？
先检查“抓取平台面单”是否为“是”。再核对是否属于平台合作承运商物流、物流状态是否为可发货，以及平台是否允许当前账号下载面单。平台仓履约和自发物流不通过本流程下载平台仓面单。
¶ 出现授权或平台请求错误怎么办？
授权无法续期时，重新打开原接口完成授权。平台接口报错时保留最近抓取错误、店铺名称、订单号和发生时间，交客服核对；不要通过重复新增接口或更换虚构单号处理。
¶ 收到平台物流通知后会立即生成订单吗？
不能这样判断。日常订单以定时抓单或手动抓单为主。平台物流通知补抓是需另行启用的增强能力，默认不启用，收到通知不等于已经补抓成功。