Versions Compared

Key

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

获取预置信息

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

获取邮递服务

...

获取可用的产品属性

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

...

创建订单

地址: 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"

weight:重量,单位为g [必填]

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,传送图片链接供飞鸟质检审核产品(只能传网上的图片,不能传本地的)

returnLabel:直接对接获取面单参数标识 ,returnLable =1 时可以直接获取面单,=0 不直接获取面单。(只适用于下一个订单的情况,批量创建多个订单的时候不起作用)

接口:http://test.birdsystem.com/client/Consignment/post-Pending-Consignment-With-Products-Json?returnLabel=1&company_id=36&api_key=a0366845436b4775e6c5caef5ebc0d0d
Image Removed

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",
    "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出错.

返回

Code Block
collapsetrue
{
    "success": true,
    "data": [
        {
            "id": 2001210360000027,
            "company_id": 36,
            "client_id": 47,
            "warehouse_id": null,
            "consignment_product_quantity": "2",
            "consignment_product_reference": "3apple29,4apple29",
            "delivery_service_id": 5198,
            "delivery_service_id_internal": 5198,
            "delivery_package_size_id": 877,
            "total_price": "0.00",
            "total_delivery_fee": "9.00",
            "total_handling_fee": "0.00",
            "length": "0.00",
            "width": "0.00",
            "depth": "0.00",
            "total_weight": "600.00",
            "total_volume": "0.00",
            "total_volume_weight": "0.0000",
            "guarantee_percentage": "0.00",
            "contact": "Rochelle Kerr",
            "business_name": null,
            "address_line1": "23 Portelet Court",
            "address_line2": null,
            "address_line3": null,
            "city": "London",
            "county": "London",
            "post_code": "N1 5TL",
            "country_iso": "GB",
            "telephone": "07983-467763-467763",
            "email": null,
            "sender_contact": null,
            "sender_business_name": null,
            "sender_address_line1": null,
            "sender_address_line2": null,
            "sender_address_line3": null,
            "sender_city": null,
            "sender_county": null,
            "sender_post_code": null,
            "sender_country_iso": null,
            "sender_email": null,
            "sender_telephone": null,
            "sales_reference": null,
            "sales_price": "0.000",
            "customs_price": "6.000",
            "custom_identity_reference": "224SF242321",
            "sales_order_id": null,
            "payment_reference": null,
            "delivery_reference": "0B043873700001DFE9790",
            "tracking_reference": null,
            "special_instruction": null,
            "neighbour_instruction": null,
            "temp_consignment_info_id": null,
            "is_urgent": "0",
            "is_forced_delivery_service": "0",
            "create_time": "2020-01-21 18:22:57",
            "finish_time": null,
            "arrive_time": null,
            "update_time": "2020-01-21 18:22:57",
            "type": "AGENT_DIRECT",
            "status": "ADDRESS_LABEL_PRINTED",
            "stock_status": "ONLY_ORI_STOCK_ENOUGH",
            "is_hide_delivery_reference_to_consignment": "0"
        }
    ],
    "moduleName": "client"
}

...

Include Page
2.1 批量创建
2.1 批量创建