Shopee把软件放回链条：一张接口清单

软件在链条里的坐标

链条上有五段，从选品判断开始，经过资料整理、软件执行、人工核查，最后到反馈回收。软件只有中间那一段，也就是说五段里它占一段。这个比例本身就是一张很有用的图，它直接回答了这类软件在店铺里能承担多少。

软件那一段的特点是动作可复制、规则明确、执行量大。一条链接和一千条链接，做法是一样的，只是耗时不同。前一段的资料整理和后一段的人工核查都属于需要判断的活，动作不好复制，规模上去之后人力也跟不上。

把坐标定清楚之后，很多争论会自动消失。比如有人问软件能不能替代选品，答案落在坐标上就很清楚：选品是它前面那一段，它读不到那一段的输入，也就接不上。这类问题问的是位置，不是能力强弱。

坐标还有一个用处是排优先级。链条上五段，哪一段最弱，整条链条的产出就被哪一段限住。软件那一段通常不是最弱的，因为它动作稳定。真正卡住产出的往往在两头，尤其在第一段，因为选品判断的质量决定了后面全部工作的价值。

软件在链条里的位置还会随阶段变化。刚开始铺货的时候，它在中间起到的作用比较突出，因为量在涨。等到量稳定下来，维护和核查的比重会上去，软件那一段占比反而下降。同一套软件，在不同阶段的分量不一样。

坐标也是给别人解释的好工具。新人问为什么要做资料整理这一步，画一下坐标就明白，软件只认整理好的字段，整理没做，软件那一段就没有输入。把位置画出来，比讲一堆道理有效。

最后，坐标提醒一件事：给软件加功能，和把链条前一段做好，是两件事。前者是在中间那一段上使劲，后者是在回报更高的地方使劲。看到坐标之后，多数店铺会更愿意回头把选品和整理这一段补一补。

把坐标画出来之后，还有一个更实际的用法，就是判断该往哪一段投入。如果软件那一段已经跑得顺，往里加投入的边际回报就低；如果资料整理那一段总是拖到最后一刻，往那里加一点安排，整条链条的速度都会变。

坐标也解释了为什么同一种软件在不同店铺里效果差别很大。链条前一段准备得好的店铺，软件接上去就能跑；前一段本来就凌乱的店铺，软件接上去只能把混乱加速。差别不在软件上，在它前后那两段的状态上。

坐标画出来之后，还有一个隐含的结论：链条的产出由最弱的一段决定。软件那一段跑得再快，如果前面的资料整理总是慢半拍，整条链条的速度还是被那半拍拖着。想提速的时候，先看哪一段最慢，而不是先看哪一段的工具最新。

坐标还有一个时间维度。刚开始做的时候，链条上各段投入的精力差不多；做了半年之后，判断和整理这两段会越来越省力，因为经验在积累。软件那一段的耗时基本不变，它不因为做过很多次而变快。这个差别在长期里会越来越明显。

软件是链条中间的一段，前后各有一段由人负责

上游要给软件什么

上游要给软件的第一样东西是结论，而不是素材。结论指的是做这个款、按这个价位、拆成这么多条。素材是图片、描述、属性这些原始材料。结论没有定，素材再多也没法组织成一条合格的链接。

第二样是结构。同一批商品拆成几条链接、彼此的规格怎么分，这个结构要在进软件之前定下来。软件按你给的结构铺，你自己没定结构，它就会按默认的方式铺，铺出来的结果往往不是你要的。

第三样是值域。同一个结论用不同说法写出来，软件会当成不同内容处理。所以在交给它之前，要把关键的几个值统一成一套说法，比如价位档怎么写、状态怎么写。这套说法一旦定下来，后面每一批都沿用。

第四样是数量。这一批交多少个款下去，要有一个明确的数字。上游以为交的是候选，下游以为拿到的是最终，两边对工作量的理解会差出很大一截。把一批几个约定清楚，是排计划和安排人手的前提。

第五样是时间。什么时候交、什么时候开始铺、什么时候要铺完，三个时点要说清。时间不说清，下游只能随时待命，注意力被牵着走。定下时点之后，两边都可以围绕它安排其他事情。

第六样是例外。这一批里有没有需要特别处理的款，比如某个款这一批先不铺、某个款要单独调一次价。这类例外如果不提前说，软件会把它当成常规商品一起铺出去，事后还要单独把它从一堆链接里捞出来改一遍。

这六样东西加起来，其实是一份资料包。给软件的不是几十张图，而是一份带了结论、结构、值域、数量、时间、例外的包。前面几篇文章讲素材包怎么建，讲的就是这件事，放到这里它就是软件那一段的输入。

输入准备得越靠前，返工越少。资料整理放在判断之后、铺货之前，中间不留太久，因为隔得越久，当初的判断依据越模糊。有的店铺把整理和判断连在一起做，判断完顺手就把字段填上，这一步衔接得紧，后面几乎不用回头。

输入还需要一个版本标识。同一批资料可能有多次修改，交出去的时候要能说清是第几版。没有版本标识，下游拿到的可能是旧的一版，铺出去之后才发现标题用的是上一稿。标一个日期或序号，成本极低。

输入的准备还有一个先后问题。同样是准备，先定结论再找素材，和先堆素材再想结论，效率差很多。先定结论的话，找素材的时候就带着目标，知道要几张什么样的图、要写哪几个卖点。反过来先把素材堆起来，最后大概率用不上。

输入的完整度可以用一个清单来管。这套资料包含哪几样，画一张固定的单子，每次交出去之前对一遍。对单子的动作只需要几十秒，但能避免很常见的漏项，比如漏了属性值或者漏了备注的情况。这种漏项在下游往往要到铺出去之后才被发现。

能直接接着用的，都是被写成了固定格式的那几段

软件要交给下游什么

软件交给下游的第一样是商品页本身。铺出去之后生成的链接，包括标题、图片、属性、价格，这些都在买家端可见。下游要核对的是这些页面上写的东西是否符合预期，而不是软件有没有跑完。

第二样是清单。铺出去多少条、每条对应哪个款、铺在哪个店，这份清单是核查的依据。没有清单就没办法核对，因为链接铺出去之后，面对的是一个个商品页，看不出原本是哪一批的哪一条。

第三样是异常标记。这一批里哪些条铺失败了、哪些缺了字段，软件通常能给出一份提示。这份提示要接得住。下游拿到之后要逐条看，而不是当成一份可以忽略的日志。忽略它的后果是这些条在店铺里以不完整的状态存在。

第四样是时间戳。每条链接是什么时候铺的，这个信息在后期排查时很有用。同一批铺出去的条，出问题往往也是同一类的，有时间戳就能按批归拢，一批一批查，比逐条翻快得多。

第五样是关联编号。链接和原始款式之间要有对应关系，这个编号最好从上游一路带下来，不要在中间重新编一次。重新编编号的后果是后期查问题时要经过两次对照，多一道就容易出错。

第六样是留痕。这一批做了什么动作、用的是什么规则，副产物是一份执行记录。这份记录平时没有人去看，出问题的时候作用很大，它能让排查的人知道当时用的规则是什么样，而不是只能靠猜。

下游拿到这几样之后才能开始核查。缺了清单只能盲查，缺了编号查不回去，缺了异常标记会漏掉那些根本没铺成功的条目。所以这几样不是附加品，是核查那一段能不能开工的前提。

输出能不能被下游接住，有一个简单的验证办法。让下游只拿输出、不看其他任何材料，看能不能直接开始核查。能开始，说明输出这一头是完整的；不能，说明它还缺东西，缺的那一样要补进清单的输出内容栏。

输出里的异常提示容易被当成可忽略的附加信息。实际上它是最该先看的一份东西，因为它标出的是那些没有正常完成的条目。这批条目在店铺里通常以不完整的状态存在，比铺错的条目更麻烦，因为铺错的至少是个完整的页面。

输出这一头还有一个容易被忽略的内容，就是失败原因的说明。铺失败的条目，软件通常会给一句原因提示。这句话往往很短，看不出真实原因。核查的人需要把它翻成自己看得懂的说法，再决定是补资料还是改设置。

输出交得越整齐，核查越省力。同一个批次铺出去的东西，如果清单里的排列顺序和铺出去的顺序一致，核查的时候就可以顺序过一遍。顺序打乱的话，核查要在两份列表之间来回找，时间大部分花在找上面，而不是看上面。

接口清单怎么写

写清单的起点是画一遍链条。把从选品到上架再到回收的全部步骤按顺序写成一个竖列，不要合并，也不要跳。画完通常会看到十来个步骤，比原来预期得多，这一步做对了，后面填空才有依据。

第二步是给每一步标出是人在做还是软件在做。这一步会暴露不少事，比如有些步骤两边都不做，属于谁也没管的空白；有些步骤两边都在做，属于重复劳动。空白和重复都是接口没定清楚的表现。

第三步是把软件那一段的前一步和后一步单独圈出来。这两处是接口最吃紧的地方，前面是它的输入从哪来，后面是它的输出交给谁。清单的重点就落在这两处，其余步骤写简一点即可。

第四步是给每一步写上六栏。六栏分别是环节名、上游输入、输入格式、软件动作、输出内容、接收人。软件那一段的六栏要写详细，人做的段也要写，因为人做的段同样需要交接，只是交接对象是另一个人。

第五步是检查栏位之间能不能对上。这一步不用写字，只需要看：上一行的输出内容和下一行的上游输入是不是同一件东西。对不上的地方就是断点，逐条标出来。一份十来个步骤的清单，标出来的断点通常在两到四处。

第六步是先补断点最多的一处，不要一次全补。同时补多处的问题是出问题时分不清是哪里引起的。先补一处，跑一批，看效果，再动下一处。补的顺序建议从链条末尾往前，前面留人的检查能兜住后面的错。

清单不要写成大表。一页 A4 横向排版通常够用，超过一页就会开始有人不愿意看。步骤多的时候可以拆成两张，按前半段和后半段分，两张表之间用同一个步骤名衔接，不要出现两个名字。

写清单的时候，最好让做事的人自己填自己那一段。由一个人统一填写整张表的问题是，写的人不承担那一段的工作，很多细节写不到点上。各段自己填，最后只做一次对照，得出的清单更接近实际做法。

六步走完之后，清单要跑一批验证。用一批真实的商品按清单走一遍，看中间在哪里卡住、哪里需要额外解释。卡住的地方就是清单写得不够清楚的地方，当场改掉。跑过一批的清单，比在纸上推敲十遍的清单可靠。

清单写完之后的第一次试用，建议挑一批量小的商品。量小的时候出问题影响面小，改起来也不心疼。用一批真实商品走完整个清单，会发现一些纸上想不到的细节，比如某一步其实拿不到上一段承诺的东西。

清单的修改要留痕。每次改动记下日期和改动原因，一个季度之后回头看，会发现改动集中在某一两栏上。集中改动的那一栏，说明当初对它的定义就有问题，值得重新想一次，而不是继续小修小补。

每一栏怎么填

环节名要写动作，不要写部门或者岗位。写做属性填写比写运营组更清楚，因为部门名看不出这一段到底干什么。环节名写清楚之后，看清单的人不用问就知道这一步在做什么，找问题也好定位。

上游输入要写到具体的形态。写商品资料太笼统，写到某几张图、某个标题、哪几个属性值才算具体。写到这个程度之后，上游知道该准备什么，下游也知道拿到什么才算齐，双方不用再猜。

输入格式要写载体和必带字段。载体是表格还是文档，必带字段是哪几列，字段的顺序有没有要求。这几项写清楚，第一次交接通常就能对上；不写，第一次交接往往要来回两三次。

软件动作要写它执行哪几步，不写界面怎么点。写批量生成标题、按模板套属性、按清单顺序铺出，这三句就够用。写界面操作的清单维护成本高，界面一变就要改，而信息量并没有增加。

输出内容要写到下游拿到就能用。判断标准可以拿给下游看，问一句拿着这个能不能开工。他说能，这一栏就填对了；他说还要再问一下，说明这一栏还差一层，要拆到更具体的物件上。

接收人要写具体的人和具体的时点。写交给下一段是没用的，写交给谁、什么时候交才有约束。一个人同时负责几段的时候，接收人这一栏同样要写，因为它提醒的是交接这个动作本身要发生。

六栏填完之后，留一栏备注是值得的。备注写这条规则适用什么范围、什么情况不适用。比如适用于标准款、带定制的款回到第一段。没有备注的清单容易被当成万能规则，遇到特殊情况照做反而会出错。

上游输入这一栏写的时候容易受到身份影响。自己这一段的人往往把上游需要给的东西写得过多，因为多要一点总比少要好。写得过多的后果是上游准备时间被拉长，有一些其实是可选项的也被当成必带项。判断可选还是必带，看少了它能不能开工。

输出内容这一栏要避免写成结果指标。写本月销量多少没有用，因为那不是这一段交出的东西，那是整条链条的结果。这一段交出的应该是一份可以被下一段直接使用的物件，比如填好的资料表、铺出去的链接清单。

备注栏里最值得写的是退回条件。什么情况下下游可以把东西退回来，什么情况下要自己想办法处理。这条写清楚之后，上下游之间的来回会减少很多，因为边界明确了，不需要每次都商量一次。

环节名这一栏看起来最简单，其实最容易写错。常见的问题是写得太大，比如写成上架这一段，一个名字里包含了好几个动作。大名字的问题在于交接点定位不了，出问题只能说上架那一段有问题，范围太宽，查起来慢。

软件动作这一栏，写到后来会发现有一些动作其实是半自动的，也就是软件给出结果、人来确认。这类动作不要写成完全自动，写清楚有一步人工确认，能避免后面的核查把这一部分漏掉。

六栏在不同段上的轻重不同，缺栏的地方就是接口没写全的位置

清单怎么用起来

清单最直接的用法是排查。铺出去之后发现问题，先看你手上有没有一条能顺着往回查的路径。清单就是这条路径：这一条属于哪一批、那一批的输入是什么、当时的格式是怎样。顺着走一遍，多数问题能定位到具体是哪一栏没接上。

第二种用法是接人。新人接手某一段，不需要把整条链条都讲一遍，只看这一段的上游输入和输出内容，知道手上要拿到什么、要交出什么，就可以开工。上手时间会短很多，因为他只需要理解一段而不是全部。

第三种用法是对账。上游以为交了，下游以为没收到，这类争议在链条稍长的时候经常出现。有清单之后，对着接收人那一栏看，写的是谁、什么时间，事情就清楚了。争议从态度问题变成有没有达到约定的问题。

第四种用法是提需求。要往上加功能或者换做法时，先看清单上哪一栏最常出问题。如果问题集中在上游输入这一栏，那要解决的是资料准备，不是软件功能。看清这一点能避免花钱去补一个不缺的地方。

第五种用法是复盘。一个周期结束，把这段时间出现的问题按栏位归类，看集中在哪一栏。集中在输入格式说明格式约定不清楚，集中在输出去向说明交接对象不明确。归类之后要改的那一栏自己就跳出来了。

清单的用法里唯一不该有的是逐项打勾。每天把六栏都核对一遍，很快会变成走形式，填完就算完成。清单是出问题时拿出来查的，不是每天照着填的。把它当检查表用，它就会在一个月内变成一张空表。

这份清单还有一个隐性作用，就是把沉默的默契变成文字。很多店铺的分工其实存在，只是藏在一个人的记忆里。写成六栏之后，这份默契变成了可以被讨论、被修改、被交接的东西，这是它最有价值的地方。

清单用起来之后会遇到一个问题，就是有人觉得写清单耽误事。这种感受在赶批次的时候特别强。可以先把清单只用在软件那一段的前后两处，把范围缩小，跑顺了再往外扩。全链条一次铺开，阻力往往太大。

清单和表格模板是两件事，不要混在一张表里。清单讲的是交接关系，表格模板讲的是字段填法。混在一起的结果是，看的人不知道该按哪一层去理解，改的时候也容易改错地方。分成两份，各管一段。

清单还有一个用法是给上游看。把下游那一段的输入栏位拿给上游看一遍，告诉他这就是下游需要的东西。上游看到具体字段之后，准备的时候会更有针对性，比只在嘴上说一句准备齐全一点效果明显。

清单用了一段时间之后，可以统计每个栏位出过几次问题。出问题次数最多的一栏，就是当前最该改的那一栏。这个统计不需要工具，在清单旁边画正字就行，一个季度看一次，结论足够清楚。

清单写下来之后，同一类问题第二次出现时不必从头查一遍

从清单到日常动作

动作化的第一步是给清单上的每一段配一个固定的时间点。比如判断集中在周一上午，资料整理放在周一下午，铺出去安排在周二上午，核查放在周三。时间点定下来之后，各段之间的等待变得有限，链条开始按周循环。

第二步是给几个关键栏位配一个检查动作。上游输入这一栏，配的检查是开工前看一眼东西齐不齐。输出内容这一栏，配的检查是交出去之前看一眼下游能不能直接用。两个检查都是几秒钟的事，但能挡住大部分断点。

第三步是把异常处理写成固定动作。铺出去之后发现有问题的条目，先归到某一栏，再按这一栏对应的处理方式做。归栏这一步很重要，它避免每次都从头分析一遍，也避免同类问题每次用不同办法处理。

第四步是定期回看清单里有没有已经没用的行。有些步骤因为做法变化已经不需要了，但还留在清单上，还占着人去做。定期删掉这些行，比在清单上不断加行更重要，因为清单越长越没人看。

第五步是给清单留一个变化记录。每次改动记一个日期和一句原因。半年之后翻这张记录，能看出店铺的流程是怎么演变的，也能看出哪些改动后来被证明是必要的、哪些是来回折腾。这份记录对调整节奏很有帮助。

日常动作不需要复杂。真正落地之后，多数店铺的日常就是三件事：按时间点交接、开工前看一眼输入、交出去之前看一眼输出。这三件事加起来占用的时间不多，但它们决定了链条是顺的还是断的。

最后一步是把这套东西固定下来，变成不需要提醒就会做的事。判断的方式是自己出差一周回来，链条还在正常运转，没有出现因为某个人不在就完全停住的情况。做到这一点，说明清单已经从一张纸变成了店里的实际做法。

日常动作里最容易被跳过的是交出去之前那一眼。人做完一段活，本能地想赶紧交出去，看一眼要花的时间不多，但会被当成多余的步骤。可以在最初几周强制做这件事，形成习惯之后再凭自觉，跳过率会明显下降。

还有一个动作是每批结束之后写一句结论。写这批顺不顺、卡在哪一段、下一批要改什么。一句话的成本很低，积累起来却是最真实的流程记录。翻这些句子，比翻任何一份正式文档都更容易看出问题在哪。

整套东西固定下来之后，它的价值会体现在一些不常见但很关键的时刻。比如骨干成员休假、比如旺季量突然翻倍、比如一个人要同时管两个店。这些时刻靠临时记忆撑不住，靠清单就能撑住，这也是写这份清单最实际的回报。

日常动作要能承受人有状态起伏。人忙的时候会省略步骤，所以这几件事要设计得足够轻，轻到忙的时候也能做完。开工前看一眼输入、交出去之前看一眼输出，这两个动作如果超过一分钟，忙起来就会被跳过。

这套动作还有一个好处是让交接不依赖面对面。两个人不在同一个时间在线的时候，只要清单和记录在，交接照样能完成。这对一人多店、或者跨时区安排的情况特别有用，它把交接从必须同时在线改成了可以错开。

常见问题（FAQ）