Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

注意, 使用批量添加, 订单状态默认是到"已完成", 自己出单就不用管了, 如果包裹发到鸟仓再出单, 则需要给每个consignment添加"status":"PENDING"的参数

获取预置信息

创建订单的时候, 需要邮递服务和包裹尺寸, 可以预存到你们系统里, 不经常改变, 不需要每次都请求.

获取邮递服务

...

获取可用的海关属性

往代理专线订单添加产品的时候, 需要产品海关属性, 可以预存到你们系统里, 不经常改变, 不需要每次都请求.

Include Page

...

创建订单

地址: POST http://test.birdsystem.com/client/consignment/Post-Pending-Consignment-With-Products-Json

参数 说明

product_customs_property: 海关属性可以用名称,也可以用ID。 [必填]

product_name_cn:产品中文名称 ,不填写会影响清关文件 [必填]

sales_price: 订单在销售平台的价格,(不填的话会自动调用产品申报价格)。   [选填]

sales_reference:需要填写销售跟踪号请自行添加参数 sales_reference,  例如 "sales_reference":"12345"

...

price_customs_export:海关出口报关价,单位为美元。(用product_name或name、product_name_cn,或name_cn、price_customs_export或 price都可以上传对应的值)

client_ref:对应客户sku,有传则可配置面单显示此字段,便于拣货。  [必填]

custom_identity_reference:自定义唯一跟踪号,属于排重字段,防止重复订单,填写后会检查同一订单类型下6个月内是否有重复订单,重复则报错提示。

brand:品牌 (非必填)

attachment-url:产品图片URL,传送图片链接供飞鸟质检审核产品。新产品图片URL为必填,已存在的产品不用传图片URL(只能传网上的图片,不能传本地的)

Code Block
[
  {
    "delivery_service_id": "5198",
       "type":"AGENT_DIRECT",
    "business_name": "",
    "contact": "Rochelle Kerr",
    "address_line1": "23 Portelet Court",
    "city": "London",
    "county": "London",
    "post_code": "N1 5TL",
    "country_iso": "GB",
    "telephone": "07983-467763-467763",
    "custom_identity_reference":"224SF242321",
    "line": "1",
    "products": [
      {
        "product_name": "3apple29",
        "product_name_cn":"3苹果29",
        "brand":"asd品牌",
        "client_ref":"a4624",
        "price_customs_export": "3",
        "sales_price":"10",
        "weight": "300",
        "quantity": "1",
        "product_customs_property":["其它"],
        "attachment-url":"http://www.qqma.com/imgpic2/cpimagenew/2018/4/5/6e1de60ce43d4bf4b9671d7661024e7a.jpg"
      },
       {
        "product_name": "4apple29",
        "product_name_cn":"4苹果29",
        "brand":"asd品牌",
        "client_ref":"a5456",
        "price_customs_export": "3",
        "sales_price":"10",
        "weight": "300",
        "quantity": "1",
        "product_customs_property":["其它"],
        "attachment-url":"http://www.qqma.com/imgpic2/cpimagenew/2018/4/5/6e1de60ce43d4bf4b9671d7661024e7a.jpg"
      }
    ]
  }
]

line: 创建失败的时候, 会告知是哪一个line出错.

返回

...

collapsetrue

...

2

...

.

...

data是创建成功的订单号和跟踪号的键值对 json对象

内部下单逻辑:

1.正常服务未设置需要预审产品的,下单用这个服务不用填attachment-url:图片URL;(此图片URL字段,对于无需预审的服务,不用填;有些需要预审的,且需要传图片URL的,对于已经在系统备案的产品,下单不用传,填的是新的client_ref:客户sku,这个客户sku第一次要传,所以图片URL字段可设置为非必填字段,但必须对接到贵司erp

2.有些服务,我们系统会勾选上产品需要预审的限制,这类服务下单,从erp推单过来,系统会内部判断client_ref:客户sku是否在我们系统这个客户下存在,且是正常状态;

2.1.如果是正常状态的产品,客户传的订单除了客户sku与数量不变外,其余与系统备案的产品信息不一致的,到我们系统会自动以系统备案的产品信息为准,并将备案的产品信息更新到订单的产品中;

2.2.如果是非正常状态的产品,且非待预审状态的产品,会弹出报错提示,提示这个产品有问题;

...

1 批量创建
2.1 批量创建