29.历史发货单查询（gy.erp.trade.deliverys.history.get）

马浩栋 • 发表于：2019年01月28日 17:39:27 • 更新于：2021年12月17日 10:47:00

此接口需要使用奇门自定义接口调用

1.1    业务简述

1.2    请求参数

字段名

类型

描述

必填

备注

page_no

int

页码

否

默认为1

page_size

int

每页大小

否

默认为10

start_delivery_date

datetime

发货时间开始段

是

与end_delivery_date搭配使用，时间跨度不能超过24小时

end_delivery_date

datetime

发货时间结束段

是

与start_delivery_date搭配使用，时间跨度不能超过24小时

shop_code

string

店铺代码

否

提供此参数则发货时间参数可不填

code

string

单据编号

否

提供此参数则发货时间参数可不填

sync_status

int

数据同步状态

否

-1:同步失败

0:未同步

1:已同步

不传，不检查该状态

Json请求示例：

{
    "appkey": "112194",
    "sessionkey": "754a424bb6874a1fb8a7371f05e83974",
    "method": "gy.erp.trade.deliverys.history.get",
    "page_no": "1",
    "page_size": "2",
    "start_delivery_date": "2019-1-17 00:00:00",
    "end_delivery_date": "2019-1-18 00:00:00",
    "sign": "0F9C6874BCD7DC889113B14B1E7BD36A"
}

1.3    响应参数

字段名

类型

描述

必填

备注

success

boolean

成功与否



errorCode

string

错误代码



subErrorCode

string

子错误代码



errorDesc

string

错误描述



subErrorDesc

string

子错误描述



requestMethod

string

请求方法



deliverys

delivery []

发货单列表



total

int

总记录数



delivery:

字段名

类型

描述

必填

备注

create_date

datetime

制单时间



sync_status

int

数据同步状态


0:未同步

1:已同步

code

string

单据编号



qty

int

商品总数



amount

double

总金额



payment

double

已付金额



pay_time

datetime

支付时间



cod

boolean

是否货到付款



refund

int

是否退款


0:无退款

1:有退款

invoiceDate

datetime

确认开票时间



platform_code

string

平台单号



unpaid_amount

double

未付金额



post_fee

double

物流费用



cod_fee

double

货到付款服务费



discount_fee

double

优惠金额



post_cost

double

物流成本



plan_delivery_date

datetime

预计发货时间



buyer_memo

string

买家留言



seller_memo

string

卖家备注



receiver_name

string

收货人姓名



receiver_phone

string

收货人电话



receiver_mobile

string

收货人手机



receiver_zip

string

收货邮编



receiver_address

string

收货地址



create_name

string

制单人



express_no

string

快递单号



vip_name

string

会员名称



shop_name

string

店铺名称



area_name

string

收货地区



warehouse_name

string

仓库名称



express_code

string

快递公司代码



express_name

string

快递公司名称



tag_name

string

订单标记名称



seller_memo_late

string

二次备注



shelf_no

string

库位代码



details

item[]

商品列表



delivery_statusInfo

statusInfo

单据状态信息



invoices

invoice[]

发票列表



vip_code

string

会员代码



warehouse_code

string

仓库代码



shop_code

string

店铺代码



vip_real_name

string

真实姓名



vip_id_card

string

身份证号码



sync_status

int

数据同步状态


-1:同步失败

0：未同步

1：已同步

sync_memo

string

数据同步备注



picture_bill

boolean

是否多包裹


true：多包裹

false：单包裹

item:

字段名

类型

描述

必填

备注

qty

int

商品数量



price

double

实际单价



amount

double

商品总价



memo

string

备注



picUrl

string

图片地址



trade_code

string

销售订单号



item_id

string

商品ID



item_sku_id

string

规格ID



item_code

string

商品代码



item_name

string

商品名称



sku_code

string

规格代码



sku_name

string

规格名称



sku_note

string

商品的规格备注



discount_fee

double

让利金额



amount_after

double

让利后金额



post_fee

double

物流费用



order_type

string

订单类型



platform_flag

int

平台旗帜



detail_unique

unique[]

唯一码列表



detail_batch

batch[]

批次列表



businessman_name

string

业务员



is_gift

int

是否赠品


0:不是

1:是

platform_code

string

平台单号



tax_rate

double

税率



tax_amount

double

税额



other_service_fee

double

其他服务费



gift_source_view

string

赠品来源



currency_code

string

币别代码



currency_name

string

币别名称



statusInfo:

字段名

类型

描述

必填

备注

scan

boolean

是否扫描



weight

boolean

是否称重



delivery

int

发货状态


-1:发货失败

0:未发货

1:发货中

2:发货成功

cancel

boolean

是否取消



print_express

boolean

是否打印快递单



express_print_name

string

物流单打印人



express_print_date

datetime

物流单打印时间



print_delivery

boolean

是否打印发货单



delivery_print_name

string

发货单打印人



delivery_print_date

datetime

发货单打印时间



scan_name

string

扫描人



scan_date

datetime

扫描时间



weight_name

string

称重人



weight_date

datetime

称重时间



wms_order

int

是否外仓订单


0:不是

1:是

delivery_name

string

发货人



delivery_date

datetime

发货时间



cancel_name

string

取消人



cancel_date

datetime

取消时间



weight_qty

double

重量



thermal_print

boolean

电子面单打印状态



thermal_print_status

string

电子面单分配状态



invoice:

字段名

类型

描述

必填

备注

address

string

地址



phone

string

电话



invoice_type_name

string

发票种型名称


增值普通发票

or

增值专用发票

invoice_title

string

发票抬头



invoice_content

string

发票内容



invoice_amount

double

发票金额



invoice_no

string

发票号



tex_payer_number

string

纳税人识别号



bank_name

string

开户行



bank_account

string

账号



unique:

字段名

类型

描述

必填

备注

unique_code

string

唯一码



imei

string

串码



qty

int

数量



warwhouse_name

string

仓库名称



unique_custom_attr_list

object

唯一码自定义属性列表


值键对。结构：{ "属性名1":"属性值1"，"属性名2":"属性值2" }

batch:

字段名

类型

描述

必填

备注

batchNumber

string

批次号



qty

int

数量



productionTime

datetime

生产日期



validTime

datetime

有效日期



Json返回示例：

{
    "success": true,
    "errorCode": "",
    "subErrorCode": "",
    "errorDesc": "",
    "subErrorDesc": "",
    "requestMethod": "gy.erp.trade.deliverys.history.get",
    "deliverys": [{
        "create_date": "2019-01-17 12:12:22",
        "code": "SDO105011099021",
        "qty": 1.0,
        "amount": 0.0,
        "payment": 0.0,
        "pay_time": null,
        "cod": false,
        "refund": 0,
        "invoiceDate": null,
        "bigchar": null,
        "platform_code": "O1901171868972914140731",
        "unpaid_amount": 0.0,
        "post_fee": 0.0,
        "cod_fee": 0.0,
        "discount_fee": 18146.31,
        "post_cost": 0.0,
        "plan_delivery_date": null,
        "buyer_memo": null,
        "seller_memo": "",
        "receiver_name": "几家",
        "receiver_phone": "",
        "receiver_mobile": "18588582786",
        "receiver_zip": "",
        "receiver_address": "西藏自治区拉萨市城关区可口可乐了",
        "create_name": "铂涛",
        "express_no": "1212121212121",
        "vip_name": "BT_TEST_XX_181295316",
        "shop_name": "BT店铺",
        "area_name": "西藏自治区-拉萨市-城关区",
        "warehouse_name": "BT_TEST_1仓库",
        "express_code": "BT_TEST_XX_8",
        "express_name": "BT中通快递",
        "tag_name": null,
        "seller_memo_late": null,
        "shelf_no": null,
        "details": [{
            "qty": 1.0,
            "price": 18146.31,
            "amount": 18146.31,
            "refund": 0,
            "memo": null,
            "picUrl": null,
            "oid": "O1901171868972914140731_1339",
            "trade_code": "SO104983386397",
            "origin_price": 0.0,
            "item_id": "69555969494",
            "item_sku_id": "69555964962",
            "item_code": "BT_TEST_XX_569",
            "item_name": "EAS测试商品",
            "sku_code": "BT_TEST_XX_1339",
            "sku_name": "40、绿",
            "sku_note": "",
            "combine_item_code": null,
            "platform_code": "O1901171868972914140731",
            "discount_fee": 18146.31,
            "amount_after": 0.0,
            "post_fee": 0.0,
            "post_cost": 0.0,
            "tax_rate": 0.0,
            "tax_amount": 0.0,
            "order_type": null,
            "platform_flag": 0,
            "detail_unique": null,
            "detail_batch": [],
            "businessman_name": null,
            "is_gift": 0,
            "other_service_fee": 0.0,
            "gift_source_view": null,
            "currency_code": null,
            "currency_name": null
        }],
        "delivery_statusInfo": {
            "scan": false,
            "weight": false,
            "wms": 0,
            "delivery": 2,
            "cancel": false,
            "print_express": true,
            "express_print_name": "铂涛",
            "express_print_date": "2019-01-17 12:12:47",
            "print_delivery": true,
            "delivery_print_name": "铂涛",
            "delivery_print_date": "2019-01-17 12:12:47",
            "scan_name": null,
            "scan_date": null,
            "weight_name": null,
            "weight_date": null,
            "wms_order": 0,
            "delivery_name": "铂涛(强制发货)",
            "delivery_date": "2019-01-17 12:13:20",
            "cancel_name": null,
            "cancel_date": null,
            "weight_qty": "0.0",
            "thermal_print": 2,
            "thermal_print_status": 0
        },
        "invoices": [],
        "vip_code": "BT_TEST_XX_181295316",
        "warehouse_code": "BT_TEST_XX_1",
        "shop_code": "BT_SHOP001",
        "vip_real_name": "",
        "vip_id_card": "",
        "package_center_code": null,
        "package_center_name": null,
        "sync_status": 1,
        "sync_memo": null,
        "picture_bill": false
    }, {
        "create_date": "2019-01-17 14:29:43",
        "code": "SDO105033131066",
        "qty": 6.0,
        "amount": 0.0,
        "payment": 0.0,
        "pay_time": null,
        "cod": false,
        "refund": 0,
        "invoiceDate": null,
        "bigchar": null,
        "platform_code": "S11201901170000006",
        "unpaid_amount": 0.0,
        "post_fee": 0.0,
        "cod_fee": 0.0,
        "discount_fee": 7.2,
        "post_cost": 0.0,
        "plan_delivery_date": null,
        "buyer_memo": null,
        "seller_memo": null,
        "receiver_name": "打发奥德赛",
        "receiver_phone": "",
        "receiver_mobile": "13568998988",
        "receiver_zip": null,
        "receiver_address": "上海上海市黄浦区大沙发的是",
        "create_name": "上海关爱通",
        "express_no": "852852",
        "vip_name": "gat_member",
        "shop_name": "GAT",
        "area_name": "上海-上海市-黄浦区",
        "warehouse_name": "采购单默认仓库",
        "express_code": "YTO",
        "express_name": "圆通速递",
        "tag_name": null,
        "seller_memo_late": null,
        "shelf_no": null,
        "details": [{
            "qty": 6.0,
            "price": 1.2,
            "amount": 7.2,
            "refund": 0,
            "memo": "",
            "picUrl": null,
            "oid": "825",
            "trade_code": "SO105032794342",
            "origin_price": 0.0,
            "item_id": "104481894978",
            "item_sku_id": "104481895829",
            "item_code": "MA70011962",
            "item_name": "香蕉",
            "sku_code": "MA70011962-0003",
            "sku_name": "香蕉-五星级",
            "sku_note": "",
            "combine_item_code": null,
            "platform_code": "S11201901170000006",
            "discount_fee": 7.2,
            "amount_after": 0.0,
            "post_fee": 0.0,
            "post_cost": 0.0,
            "tax_rate": 0.0,
            "tax_amount": 0.0,
            "order_type": null,
            "platform_flag": 0,
            "detail_unique": null,
            "detail_batch": [{
                "qty": 1.0,
                "productionTime": "2019-01-14 16:33:55",
                "validTime": "2020-09-05 16:33:55",
                "batchNumber": "201901141633"
            }, {
                "qty": 5.0,
                "productionTime": "2019-01-14 15:55:26",
                "validTime": "2020-09-05 15:55:26",
                "batchNumber": "201901141555"
            }],
            "businessman_name": null,
            "is_gift": 0,
            "other_service_fee": 0.0,
            "gift_source_view": null,
            "currency_code": null,
            "currency_name": null
        }],
        "delivery_statusInfo": {
            "scan": true,
            "weight": true,
            "wms": 0,
            "delivery": 2,
            "cancel": false,
            "print_express": true,
            "express_print_name": "上海关爱通",
            "express_print_date": "2019-01-17 14:30:13",
            "print_delivery": false,
            "delivery_print_name": null,
            "delivery_print_date": null,
            "scan_name": "上海关爱通",
            "scan_date": "2019-01-17 14:30:39",
            "weight_name": "上海关爱通",
            "weight_date": "2019-01-17 14:31:12",
            "wms_order": 0,
            "delivery_name": "上海关爱通",
            "delivery_date": "2019-01-17 14:32:21",
            "cancel_name": null,
            "cancel_date": null,
            "weight_qty": "9.0",
            "thermal_print": 2,
            "thermal_print_status": 0
        },
        "invoices": [],
        "vip_code": "gat_member",
        "warehouse_code": "WAREHOUSE_DEFAULT",
        "shop_code": "003",
        "vip_real_name": null,
        "vip_id_card": null,
        "package_center_code": null,
        "package_center_name": null,
        "sync_status": 1,
        "sync_memo": null,
        "picture_bill": false
    }],
    "total": 3
}