Versions Compared

Key

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

Jira Legacy
serverJIRA (birdsystem.atlassian.net)
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId8f66dbbd-3e3f-362c-9504-10d94c645e59
keyBS-2565

客户端流程:


Table of Contents



一. 通过API一键创建订单(对接)

  1. url: /client/consignment/Post-Pending-Consignment-With-Products-Json?type=client_direct
    参数

    Code Block
    collapsetrue
    [
      {
        "delivery_service_id" : "1",
        "delivery_package_size_id" : "1",
        "contact" : "abc",
        "address_line1" : "Sömmeringstr. 78",
        "city" : "Hördt",
        "county" : "Rheinland-Pfalz",
        "post_code" : "76771",
        "country_iso" : "DE",
        "telephone" : "0204342535",
    
        "packages" : [
          {
            "reference" : "1",
            "length" : "3",
            "width" : "2",
            "depth" : "1",
            "weight" : "1",
    
            "products" : [
              {
                "name" : "light",
                "commodity_code" : "hscode",
                "quantity" : "2",
                "price" : "3",
                "price_customs_export" : "3"
              }
            ]
          },
          {
            "reference" : "1",
            "length" : "3",
            "width" : "2",
            "depth" : "1",
            "weight" : "1",
    
            "products" : [
              {
                "name" : "light",
                "commodity_code" : "hscode",
                "quantity" : "2",
                "price" : "3",
                "price_customs_export" : "3",
                "net_weight" : "3",
                "origin_country_iso" : "CN"
              },
              {
                "name" : "light2",
                "commodity_code" : "hscode2",
                "quantity" : "2",
                "price" : "3",
                "price_customs_export" : "3",
                "net_weight" : "3",
                "origin_country_iso" : "CN"
              }
            ]
          }
        ]
      },
      {
        "delivery_service_id" : "1",
        "delivery_package_size_id" : "1",
        "contact" : "abc",
        "address_line1" : "Sömmeringstr. 78",
        "city" : "Hördt",
        "county" : "Rheinland-Pfalz",
        "post_code" : "76771",
        "country_iso" : "DE",
        "telephone" : "0204342535",
    
        "packages" : [
          {
            "reference" : "1",
            "length" : "3",
            "width" : "2",
            "depth" : "1",
            "weight" : "1",
    
            "products" : [
              {
                "name" : "light",
                "commodity_code" : "hscode",
                "quantity" : "2",
                "price" : "3",
                "price_customs_export" : "3",
                "net_weight" : "3"
              }
            ]
          }
        ]
      }
    ]


    具体通讯流程请看 Home
    通过api传入的尺寸单位为cm, 重量单位为kg

二. 通过鸟系统创建订单

  1. excel的格式请参考下载模板

    Image Added

三. 通过鸟系统创建订单

  1. 创建订单

    Image Added
  2. 添加包裹

    Image Added
    通过系统添加的 默认尺寸单位为mm, 重量单位为g, 可在admin端设置系统的默认单位.
  3. 添加产品

    Image Added

...

. 获取 Delivery Reference

...

  1. 修改订单状态到pending 获取delivery reference
    1. 注意: 在生产环境, 改到pending后, 系统会在后台自动获取地址贴, 获取地址贴后会更新订单的delivery reference
    2. 测试环境下, 需要手动获取地址贴 http://www.bs-2565.test.birdsystem.co.uk/client/Printer/Packing-Slip/1701060020000001?type=AddressLabel&forceRequest=1
      forceRequest=1 这个参数的意思是重新获取地址贴, 不带这个参数就是只显示地址贴
    Image Added


. 打印地址贴, 发票

  1. 打印地址贴

    Image Added 
  2. 打印发票

    Image Added