订单api说明

<h2>1. 使用指定的过滤器获取订单</h2> <p><em>有时候你需要根据特定的条件来查找订单，比如查找某个时间段内的订单、某个顾客的订单或者某个状态的订单。使用Fruugo订单API，你可以通过设置过滤器来实现这些查询。</em></p> <ul> <li><strong>指定过滤器</strong>：过滤器就像一个筛选条件，你可以根据需要设置不同的过滤器。比如，你可以设置一个过滤器来查找“已付款”状态的订单，或者设置一个过滤器来查找某个顾客的所有订单。</li> <li><strong>查询订单信息</strong>：当你设置了过滤器后，API会根据你的条件返回符合条件的订单信息。这样你就可以快速找到你想要的订单了。</li> <li><strong>Webhook回调</strong>：当你查询订单时，API会把查询结果通过Webhook发送给你。Webhook就像一个自动通知系统，它会把订单信息发送到你指定的网址（端点），这样你就可以在你的系统中接收到这些信息，并进行后续处理，比如更新订单状态、生成报告等。</li> </ul> <table> <thead> <tr> <th>字段</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>dateFrom和dateTo</td> <td>这两个字段用来指定你想查询的订单的时间范围。比如，你想查询2019年8月24日到2019年8月25日之间的订单。</td> </tr> <tr> <td>orderId</td> <td>这是Fruugo给每个订单分配的一个唯一标识符。如果你知道某个订单的ID，可以直接用它来查询这个订单。</td> </tr> <tr> <td>productId和skuId</td> <td>这两个字段用来指定你想查询的产品或SKU。比如，你想查询某个特定产品的订单，或者某个特定SKU的订单。</td> </tr> <tr> <td>statuses</td> <td>这个字段用来指定你想查询的订单的履行状态。比如，你想查询所有“待处理”（PENDING）的订单。</td> </tr> <tr> <td>customerCountries</td> <td>这个字段用来指定你想查询的订单的顾客所在的国家。比如，你想查询所有来自美国（US）的订单。</td> </tr> <tr> <td>paymentAmountMin和paymentAmountMax</td> <td>这两个字段用来指定你想查询的订单的最小和最大订单总额，包括增值税和运费。比如，你想查询订单总额在100元到500元之间的订单</td> </tr> </tbody> </table> <h2>2. 将指定的订单标记为已确认</h2> <p><em>当顾客下单后，你需要确认订单并安排发货。使用Fruugo的订单API，你可以将特定的订单标记为已确认，并设置预计的发货日期。</em></p> <ul> <li><strong>标记为已确认</strong>：当你确认订单后，订单的状态会从“待处理”或“待确认”变为“已确认”。这意味着你已经准备好发货，并且顾客可以期待在预计的时间收到商品。</li> <li><strong>预计发货日期</strong>：这是你预计会发货的日期，顾客可以看到这个日期，以便知道他们大概什么时候能收到商品。</li> <li><strong>Webhook回调</strong>：当你标记订单为已确认后，Fruugo会通过Webhook发送一个确认响应。这个响应会包含确认的订单信息和预计发货日期，发送到你指定的网址（端点），这样你就可以在你的系统中接收到这些信息，并进行后续处理，比如更新库存、生成发货单等。</li> </ul> <h2>3. 将指定的订单标记为已取消</h2> <h2>4. 将指定的订单标记为已退货</h2> <p><em>使用Fruugo的订单API，你可以将特定的订单标记为已退货，并提供一个退货原因。</em></p> <ul> <li><strong>标记为已退货</strong>：当你标记订单为已退货后，订单的状态会从“已发货”或“已确认”变为“已退货”。这意味着顾客已经将商品退回，订单将不再继续执行。</li> <li><strong>指定退货原因</strong>：你可以为每个退货的订单提供一个具体的退货原因，比如“商品损坏”、“尺寸不合适”或“顾客改变主意”等。这有助于你了解退货的具体原因，并采取相应的措施。</li> </ul> <h2>5. 将指定的订单标记为已发货</h2> <p><em>当商品准备好并已经寄出时，你需要更新订单的状态</em></p> <h2>6. 查询订单的装箱单</h2> <p><em>订单发货的装箱单将作为A4 PDF文档生成</em></p> <p><em>当商品准备好并即将发货时，你需要为每个订单准备装箱单</em> <em>装箱单是一种重要的文件，记录了订单中的商品信息，包括商品名称、数量、SKU等，通常用于物流和库存管理</em> 装箱单和面单是两种不同的物流文件，它们在内容和用途上有所区别：</p> <pre><code class="language-html">### 装箱单 * **内容**：装箱单主要记录了订单中商品的详细信息，包括商品名称、SKU、数量、尺寸、重量等。它还可能包含一些其他信息，如包装方式、特殊说明等。 * **用途**：装箱单主要用于内部管理和库存核对。在商品打包和发货前，工作人员会根据装箱单来核对商品的种类和数量，确保打包的商品与订单一致。此外，装箱单也可以作为商品的内部记录，用于后续的库存管理和销售分析。 ### 面单 * **内容**：面单是贴在包裹外面的标签，主要包含收件人和寄件人的信息，如姓名、地址、电话等。它还可能包括一些物流信息，如运单号、目的地、运输方式等。 * **用途**：面单主要用于物流运输和配送。快递员或物流公司会根据面单上的信息来识别包裹的目的地和收件人，确保包裹能够准确无误地送达。面单上的运单号还可以用于追踪包裹的运输状态。 ### 区别 * **信息侧重点**：装箱单侧重于商品的详细信息，而面单侧重于收件人和物流信息。 * **使用场景**：装箱单主要用于内部管理和商品核对，面单则用于物流运输和配送。 * **形式**：装箱单通常是一份打印的文件或PDF文档，面单则是一张贴在包裹上的标签。</code></pre> <h2>7. 更新指定订单的跟踪信息</h2> <table> <thead> <tr> <th></th> <th></th> </tr> </thead> <tbody> <tr> <td>orders数组</td> <td>这是一个包含多个订单跟踪信息的对象数组。每个对象代表一个订单的跟踪信息。</td> </tr> <tr> <td>orderId（订单ID）</td> <td>这是Fruugo给每个订单分配的一个唯一标识符。你需要提供这个ID来指定你想更新哪个订单的跟踪信息。</td> </tr> <tr> <td>shipmentId（发货ID）</td> <td>这是订单的唯一发货标识符，用于区分订单中的不同发货批次。比如，一个订单可能包含多个包裹，每个包裹都有一个不同的发货ID。</td> </tr> <tr> <td>trackingUrl（跟踪URL）</td> <td>这是一个网址，顾客和物流公司可以通过这个网址来查看包裹的运输状态和位置。比如，你可以提供一个快递公司的跟踪网址。</td> </tr> <tr> <td>trackingCode（跟踪代码）</td> <td>这是用于跟踪包裹的代码，通常是运单号或其他跟踪标识符。顾客和物流公司可以用这个代码在跟踪URL上查询包裹的信息。</td> </tr> </tbody> </table>