Versions Compared

Key

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

...

三. 获取 Delivery Reference

四. 打印地址贴, 发票


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

  1. url: /client/consignment/batch-create-client-direct-consignment
    参数

    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. 创建订单
    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