Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 12 Next »

接口简介

url

http://test.birdsystem.com/client/public/delivery-service

接口功能

邮递服务信息查询. 创建出库单时需要指定物流渠道,即delivery_service_id参数. 是从这里获取

支持格式

json

开发人员

请求方式

get

发布日期

请求参数描述

参数名

说明

字段类型

consignment_type

 按订单类型查询邮递服务

 ENUM('LOCAL','DIRECT','RETURN','AGENT_DIRECT')

status

按状态来查询邮递服务

is_tracking

按是否跟踪来查询邮递服务

数字,0或者1

is_signature

按是否签名服务来查询邮递服务

数字,0或者1

is_express

按是否快递来查询邮递服务

数字,0或者1

返回Json描述

参数

说明

类型

id

系统ID

INT(10)

company_id

站点ID, 默认只返回当前登录的company_id下的邮递服务

INT(10)

name

名称

VARCHAR

locale_name

本地名称, 一般是另一个比较好记的邮递服务名称

VARCHAR

consignment_type

订单类型

ENUM('LOCAL','DIRECT','RETURN','AGENT_DIRECT')

status

邮递服务的状态,只有ACTIVE状态的邮递服务才能使用。

ENUM('ACTIVE','DELETED','DORMANT')

is_tracking

是否跟踪服务

数字,0或者1

is_signature

是否签名服务

数字,0或者1

is_international

是否国际服务

数字,0或者1

is_customs_required

是否要求报关

数字,0或者1

is_express

是否快递

数字,0或者1

is_hide_delivery_reference_to_consignment

是否需要获取运输跟踪号

数字,0代表需要,1代表该渠道没有运输跟踪号

请求描述

(以下为折叠内容,签署合同时以下信息无需参考,仅供第三方对接参考)

 (以下为折叠内容,签署合同时以下信息无需参考,仅供第三方对接参考)

使用接口调试工具postman
请求描述:
温馨提示:

1、只有邮递服务状态为正常时,该服务才能正常下单。(举例:&status=ACTIVE
Http请求格式:

GET /client/delivery-service/?status=ACTIVE HTTP/1.1
Host: {{Bird_URL}}
Headres:
  api_key: {{api_key}}
  company_id: {{company_id}}
  Cookie: PHPSESSID=3s3nejv43u9bhirsrvq9nge254
Body
  raw
    [{"id"=6306}]

返回结果:

{
    "total": 1,
    "data": [
        {
            "id": 6306,
            "company_id": 36,
            "restrict_max_length_contact": "0",
            "restrict_max_length_address_line1": "0",
            "restrict_max_length_address_line2": "0",
            "restrict_max_length_address_line3": "0",
            "restrict_max_length_post_code": "0",
            "restrict_regex_post_code": null,
            "restrict_regex_telephone": null,
            "name": "AD Royal Mail Tracked 48",
            "locale_name": "",
            "is_signature": "0",
            "is_tracking": "1",
            "is_express": "0",
            "is_international": "0",
            "is_customs_required": "1",
            "is_check_post_code": "0",
            "is_check_telephone": "0",
            "is_allow_urgent_consignment": "1",
            "is_hide_delivery_reference_to_consignment": "0",
            "special_type": "BIRDSYSTEM",
            "consignment_type": "AGENT_DIRECT",
            "consignment_notice_enable": "0",
            "consignment_notice": "",
            "status": "ACTIVE"
        }
    ],
    "success": true,
    "moduleName": "client"
}
  • No labels