直营快递通常规定必须填写月结卡号，且不得传输值，顺丰快递除外；加盟快递则通常要求填写网点编码，同样不得传输值；至于顺丰快递，品牌编码和月结卡号都是必填项。

小红书的发送者邮箱地址属于四级结构，众多开发者常常忽略了其中的第四级town部分，一旦查询或订购时接口显示town信息，就务必确保将town信息一同传递。

目前电子面单分为新旧两个版本，若订购信息采用旧版取号，则需使用旧版面单；若采用新版取号，则必须使用新版面单。若出现版本错误，可能是操作失误所致。

在查询订购信息为空的情况下，原因可能还包括店铺出现了错误。部分商家拥有多家分店，众多开发者曾坚定地表示他们并未选错店铺。然而，经过一番调查，最终发现错误正是因为选错了店铺，所提供的店铺截图与实际调用的查询接口所指向的店铺并不一致。

3.用户信息处理失败

原因之一，小红书的接收者信息采用与APP绑定的加密密钥，只有当应用A在调用取号接口时，才能成功解密所收到的密文。然而，应用B即便获得了应用A所获取的密文，也无法进行解密。为了在应用B中成功取号，必须额外提供（该字段由订单详情接口返回）的参数，这一参数需由应用A获取后传递给应用B。然而，目前已有发现，一些上游传来的oaid存在错误，与订单信息不匹配的情况。

原因之二在于，小红书所采用的密文格式规范为#xxx#xxx#x##，然而众多开发者提交的密文格式普遍存在偏差。

原因三：由于用户对地址进行了修改，从而引发了订单信息的变动，因此上游系统必须重新提取订单数据，以获取最新的信息。

请注意，用户信息的处理顺序是优先明文，其次密文，若接收到的用户信息格式错误，即不符合密文标准，将被视为明文处理，进而可能导致取号操作失败。在进行模式取号时，必须确保传递正确的值。

4.是否支持店铺之间共享电子面单

小红书尚未对现有订单进行商家归属的核实，若ISV端能实现将不同店铺的订单合并至一个店铺进行打印，那么在调用电子面单取号接口时，只需保证订单来源（小红书）、订单编号、收件人信息等关键参数的一致性即可。

通过各自店铺的订单提取，再利用打印店铺的打印接口，即可实现号码共享。其中，ak1标识店铺1，ak2标识店铺2，ak3标识店铺3。

5.代打单业务如何支持

小红书尚未对现有订单进行商家归属的核实。一旦供应商在小红书上开设店铺并完成电子面单的开通与设置，ISV端便能协助将商家订单同步至供应商进行打印与发货。在调用电子面单取号接口时，ISV需确保订单渠道（即小红书）、订单编号、收件人信息等关键参数保持一致。小红书官方的代打单服务正在筹备阶段，一旦该服务正式推出，预计将加强订单的审核流程。

6.ISV获取订单后推送给WMS打单的场景

为了实现WMS与ERP系统的数据对接，必须对ERP系统进行相应的改造，以便将所需参数传递至WMS。在WMS调用电子面单取号接口时，需确保小红书订单渠道、订单号以及收件人信息等关键参数保持一致。

向WMS测试团队提供一份测试订单的相关数据，以便他们进行取号操作，在测试过程中，除了用户信息需要填写完整外，其他信息字段可以留空。

：

：

请注意：鉴于上述参数将被众多开发者所共用，您需自行设定一个不同于现有值的标识，否则可能会引发取号上的问题。

由于WMS系统无法识别加密的号码，因此建议在传输收件人信息时，地址和手机号码字段应填写空字符，以此防止因ERP系统推送的加密信息格式错误而引起的取号失败问题。

7.增值服务取号失败

一些快递企业的附加服务需经商家提出申请方可启用，商家需登录小红书平台上的千帆系统，完成申请开通的程序。

增值服务的参数表现为一种字符串形式，具体为json格式的字符串。在处理过程中，需特别注意双引号的转义。其格式如下：{"增值服务1的code":{增值服务1的值},"增值服务2的code":{增值服务2的值}}。举例来说，若采用中通保价和特快服务，其代码表示为："":"{\"SVC-\":{\"\":\"100\"},\"SVC--HIGH\":{}}"。

8.打印组件相关问题

小红书自主研发了打印组件，若在使用过程中遇到难题，您可轻点屏幕右上方的【一键反馈】功能，随后上传打印操作的相关日志。

9.打印模板问题10.关于子母单

当前能够处理子母单业务的物流公司包括：顺丰快递、京东以及德邦，不过仅有顺丰和德邦能够提供追加面单的服务。一旦获取了常规包裹的订单编号，该订单便无法再进行子母单的处理（将普通包裹与子母单包裹一同取件可能会产生多种结果，因此强烈不建议这样做）。在完成揽件操作后，便无法再追加子单。

子母单号获取规则如下：必须传入的参数值不得小于1，每个包裹只能对应一个单号，若需获取新的子单号，需重新启动取号接口，或在单次调用中包含多个项目。子单号的获取除了.id这一参数外，其他参数需保持一致。子母单号的匹配依据在于判断它们是否属于同一母单。

顺丰快递与德邦快递的母子单中，首张单据的母单号是空的，而首张单据的编号则被用作后续子单的母单号。在京东快递中，所有单据均为子单号，并且每个子单号都对应一个母单号。

请注意，在京东取号环节中，必须采用子母件模式进行操作，若未输入具体值，系统将默认设置为1，且该平台不支持子单的追加。此外，单次取件的最大数量上限为10个。当顺丰取件数量达到10个后，您依然可以继续添加更多的取件号。

子母单的更新事宜如下：目前，顺丰和德邦的主单可以进行更新操作，但子单则无法进行更新；而在京东，只有以“-1-1-”结尾的单个包裹的子单才能支持更新。

确保电子面单余额充足，商家已线下与物流公司联系完成充值操作。值得注意的是，面单一旦取消，余额不会立刻返还，需待面单被回收后，才能对商家余额进行补充。某些增值服务需额外号码段，对此需单独进行充值（例如中通和申通生鲜件）。此外，还有批量取号的相关事宜。至于总对总模式，也需进一步探讨。

电子面单需适配门店商家执行总对总发货流程，商家仅需以某一门店的地址作为订购总网点的依据，在取号并下单过程中，各门店应分别使用自己的地址进行操作。

支持的快递：直营型所有快递、加盟型目前支持中通快递。

加盟行快递对总模式接入流程：

1. 商家、小红书业务、快递三方沟通确认需要走总对总模式；

商家需在ark系统后台挑选总网点进行订单操作，随后与快递公司取得联系，确保审核流程顺利完成，并指导快递公司准确设置相关总业务信息。

3.商家告知小红书对总网点编码；

4.商家在isv操作取号打单，新增字段：

4.1 对总网点编码 -必填（接口原有字段）；

4.2 扩展字段新增key：

14.为什么有些传入的产品和接口返回的产品不一致

有些流向不支持某些产品，顺丰会自动转成该流向支持的产品。

15.参数超过最大长度64

该组合由三个部分构成，整体长度需控制在64字符以内。具体来说，它包括商家的电子面单账号标识，目前该标识的长度为15位，且无需通过参数接口进行输入。

16.关于面单更新

更新操作未能成功，显示面单信息不存在：这种情况通常是因为快递已经将包裹取走，我们将会对错误提示进行改进和优化。

17.电子面单回收规则

新版电子面单回收规则：

快递公司

[]

未走件回收天数

备注

中通

1天

30天

圆通

15天

30天

申通

30天

30天

韵达

40天

40天

极兔

15天

15天

若物品在15天内无物流信息记录，则可进行回收并充值；若在15天的物流轨迹中，包含快件揽收、入库扫描、退货登记或拦截件登记等环节，且其中任意一个或多个环节的轨迹带有完结标识，同样可进行回收。

旧版电子面单回收规则

商家自愿提交取消订单的凭证，自该订单被取消之始，满15日之期，系统将自动对相应的单号进行回收处理。若商家未主动提出取消订单，且订单凭证缺乏物流信息，则需等待至30日之后，系统将自动回收相关单号。关于面单打印出现异常的情况。

小红书使用的面单打印功能系与菜鸟公司合作开发，该技术支持由菜鸟公司提供。在使用过程中，若遇到打印问题，请您先访问菜鸟云打印的答疑知识库自行查找解决方案。通常，诸如重启电脑、卸载并重新安装软件、以管理员权限运行程序等方法，便能解决大多数常见的打印难题。

遇到常见问题一：面单打印出现空白，首先应核实纸张是否选用得当，若非正确纸张，则需调整打印设置，将打印模式更改为相应模式。

常见问题二：启动失败或者无法连接打印组件

#查看端口号所在的进程 netstat -aon|findstr 10818 #杀死进程taskkill -f -pid 进程id

常见问题三：找不到对应的打印机

问题四：打印列表为空：若打印机列表完全为空，这可能是由于电脑的打印服务尚未开启，您可以尝试在百度上搜索“如何开启电脑打印服务”的相关信息。

19.是否支持其他渠道的订单进行面单打印

支持，但是取号时用户和收货信息需要传明文。

20.测试店铺不能测试电子面单

在开放平台的应用发布前，所创建的测试店铺不具备测试电子面单的功能，必须等到应用正式上线后，才能进行电子面单接口的测试。

小红书平台上的千帆系统，其开发者在小红书平台上开设了自己的个人店铺以进行测试。在搜索“如何开店”的相关信息时，应略过关于缴纳保证金的环节。

小红书电子面单系统，适合那些不打算在小红书上开设店铺的用户使用。需留意的是，小红书电子面单系统与小红书千帆系统的数据并未实现互通，因此，请勿使用同一邮箱同时注册店铺和小红书千帆系统，以免发生授权信息被覆盖的情况。

注意事项：

a. 小红书测试店铺获取的面单号禁止用来真实走件

在京东取号时存在一定的规定，需确保寄件人的联系电话及邮寄地址与以下所列的地址和电话号码相匹配。

[[]]

限定手机号为：、、、

21.部分内网需要配置打印组件访问的资源域名白名单

如何关闭防火墙或者配置域名白名单？

22.开放平台相关问题

授权问题，具体的授权规则请查看授权流程：

根据和获取失败： ，说明已经失效了

应用在尝试获取相关数据时遭遇了障碍，这表明该应用并未获得访问电子面单接口的授权。目前，只有诸如打单工具、企业ERP系统、仓储管理系统以及自研应用等特定类别的应用，才被赋予了使用电子面单的权限。

目前在处理授权失败的情况时，我们推荐依据错误信息字段中的关键词进行判断，而不要仅仅依赖错误码401来判定授权失败。

23.接口返回的是code和msg而不是和

电子面单接口基于开放平台的新框架设计，遇到参数类型不符、关键参数缺失、缺乏接口使用权限或信息过期等情况时，系统将输出错误信息msg和错误代码code。为此，我们建议开发者在程序设计中予以充分考虑并妥善处理。

物流电子面单的code码解释如下，建议您优先采用“true”这一标识来确认操作是否顺利；一旦遇到错误码显示不统一的情况，请及时与小红书客服取得联系进行更正。

错误码

错误信息

0、200

请求成功

301

请求参数错误

302

请求重复

401

业务处理异常

402

重复提交

501

未知异常

504

网络异常

24.找不到服务描述

查阅电子面单对接指南中附录部分所列出的商品类别（）以及附加服务的参数列举值。

对于批量解密接口，涉及到的加密数据列表，数量上限为100条，那么在一次性传输时，究竟传输多少条数据是较为适宜的呢？

接收到的数据长度与解密权限之间并无显著联系，因此难以确定一个恰当的长度。以100个待解密字符为例，这些字符分别来源于100个订单。当解密额度达到50时，前50个订单的字符能够成功解密，但超出此额度的后50个字符将受到解密限制，系统将显示“解密额度接口调用异常，无法解密，请与平台联系”的提示信息。

26.顺丰返回下单方式不符合

下单过程中出现【下单方式不符合】的错误，主要原因是产品种类不支持上门取件，比如填舱标快（238）和电商标快均不支持上门取件服务。部分商家使用的月结卡号与顺丰签订了电商标快协议，当使用S2下单时，系统会自动切换至电商标快，而这种方式同样不支持上门取件服务。

27.接口调用超时

该平台要求接口在5秒内提供结果，然而众多独立软件供应商(ISV)设定的超时限制仅为3秒，因此建议将其调整为5秒。另外，进行批量号码获取会延长处理时间，因此建议在获取号码时每次仅获取一个。特别地，顺丰的取号接口性能相对较差，其处理时间很容易超过3秒。

28.用户信息前面多了或者少了一些字符

开放平台的加密及解密机制针对订单信息进行操作，若加密后的订单信息与解密后的信息存在差异，则可能引发此类问题。为确保信息准确，ISV需保证传输的订单编号与获取订单详情时使用的订单编号相匹配。此外，某些异常情况可能涉及手机号码的字符过多或过少。

29.关于隐私面单

小红书目前展示在订单页面的用户资料均已进行隐私保护处理，暂未提供隐私保护账号功能，并且短期内并无更新此功能的计划。

30.订单已生成路由不能申请子单

订单有轨迹以后不允许再申请子单，也不允许取消

31.子单号序号2超过总件数1

目前京东仅支持使用子母单模板，且这些模板均采用子母单取件方式。在同一个订单号下，是不允许进行第二次取件的。若需进行二次取件，必须提供小红书的订单号，并在其后附加一个特定的尾缀。

32.顺丰体积传值不生效

在进行顺丰子母单的取件操作时，必须确保在相关字段中正确输入，具体格式应为："":"{\"键名\": 1000}"。

建议顺丰取号的时候同时传和.

33.暂无有效订购关系，请确认快递信息配置

商家若通过小红书官方直送渠道订购电子面单，在京东平台，他们只能选择特惠送（ed-m-0001）或特惠小件（ed-m-0019）这两种产品类型中的一种。目前，平台尚未对外开放查询官方直送订购产品类型的接口。而判断是否为官方直送的方法，则是查看订购关系接口返回的详细地址是否以“【-官方直送】”作为结尾。

34. 重复下单

官方直送服务是基于.id实现的幂等操作，规定每个订单的包裹编号必须唯一，且同一包裹编号不得重复使用。建议采用.id的值规则为订单编号加上包裹序号。判断是否为官方直送的方法是查看订购关系接口返回的详细地址是否以“-官方直送”作为结尾。

35.订单中存在商品已进行电子面单打单，请至电子面单发货

调用发货接口时出现错误，原因在于商家在千帆系统内执行了打印订单的操作，而根据规定，发货操作仅限于千帆系统中的【订单】【打单发货】【已打单待发货】这一特定页面进行。

36.送货上门常见问题解答

Q：送货上门支持的快递公司有哪些？

A：目前有顺丰、京东，后续会逐渐接入其他快递公司。

若送货上门的订单未采用规定的快递企业进行配送，电子面单在获取号码时是否会出现错误提示？

不能正常操作，但取号和发货是可行的。然而，若未提供相应服务，一旦消费者提出投诉，商家将承担相应责任，并需向消费者赔偿10元消费券。

Q：非送货上门的订单合单，还需要传字段吗？

建议传递，今后若遇到涉及合并订单的需求，便无需进行改造。对于非合并订单，无需传递该字段信息。至于送货上门的标识，无需ISV提供，我们会在查询（若未传递值则进行查询）订单的送货上门标识后，在取号环节将其发送给快递公司。

Q：与是什么关系？

A：该功能主要用于提取编号，且在业务处理中不参与，允许传递至外部平台的单号。然而，在业务逻辑的判断过程中，则只能使用小红书的订单编号。

Q：传了以后还需要传吗？

目前需要提交的是，需提供所有小红书的订单编号，您可以选择任意一个订单编号进行上传。

Q：商家为什么还看不到送货上门服务？

送货上门服务作为新推出的功能，目前正处于小范围测试阶段，预计在5月1日假期结束之后，将逐步扩大投放规模。敬请各位商家保持关注，等待平台发布的最新公告。

37.电子面单取号幂等逻辑是什么

取号幂等机制是通过结合“+ .id”这一组合来实现的，而对于子母单而言，其幂等性则是基于它们关联于同一母单号。

38.如何区分新版和旧版电子面单

在小红书：

在新版页面中，页眉处设有“切换旧版”按钮，并标注为“新版电子面单”，同时亦配备“一键切换”按钮。新版的店铺ID由18位数字组成，且以13为开头。转至旧版页面，页眉将显示“新版电子面单”链接，标题可能为“旧版电子面单”或“电子面单”。旧版店铺ID长度为15位，并以10为开头。

在快递公司：

渠道的来源存在差异，以往可能源自菜鸟或小红书，而新版本则必然是小红书。特别针对中通快递，旧版小红书渠道标识为“小红书线上”，而新版则直接称为“小红书”。新版的店铺身份标识码由18位组成，以13为开头；旧版则由15位组成，以10为开头。电子面单的账号信息可在小红书千帆系统的电子面单页面查得。需要注意的是，面单的路由信息目前为空。

某些快递企业，比如圆通，在查询路径超时后不会提供路径信息，然而其打印的面单仍能正常进行派送；此外，还有时候因为地址信息不完整，使得无法生成精确的三段码，但派送流程依然可以继续。

40.旧版电子面单余额如何处理

方案一：旧版余额较少，全部使用完再切换新版

若旧版余额充足或旧版已无法进行取号操作，需联络快递服务点，首先对旧版账户余额进行退还，随后再将资金重新注入至新设立的新版电子面单账户中。

41.电子面单一键切换问题

电子面单的快速切换操作不会对先前版本造成任何不良后果，即便在切换之后，用户依然能够继续使用旧版面单。

新版与旧版账号彼此独立，一旦进行切换操作，便需耐心等待快递服务提供商的审核确认。

模板ID与当前面单版本存在不一致，建议您利用面单模板查询接口，查找相应的面单版本模板ID。

在使用批量取号接口时，请注意模板ID字段的区分。进行新版取号操作时，应使用新版模板ID；而进行旧版取号操作时，则需使用旧版模板ID。

众多开发者习惯于在取号时直接将旧版模板的ID设定为固定值，这样的做法常导致取号操作无法成功完成。因此，在取号过程中，我们建议采用模板查询接口来获取相应的模板ID。

43.加密数据解密失败，

旧版数据提取需采用旧版打印设备，而新版本则需借助新版的打印工具，两者运作互不干扰，且彼此之间并不具备兼容性。

将旧版取号密文数据导入至新版打印系统时，系统将显示错误提示【加密数据解密失败】。

将新版获取的编号加密信息传输至旧款打印设备时，系统将出现错误提示【:pad 】。

44.因为网络问题下载模板失败或者网络超时导致打单失败

若需推荐，请选用以下几种流行的公共DNS服务器；若遇ERP系统模板加载超时，请及时联系ERP技术支持团队，针对模板接口进行性能的改进与优化。