报关订单接口

说明

华讯会轮询该接口,商城将用户已支付成功, 且支付成功时间条件为 大于等于 pay_start_time 且 小于 pay_end_time 的需要报关发货的订单发给报关平台

调用方式

报关平台 => 商城

请求方式

方式: POST(x-www-form-urlencoded)

请求参数:

参数名称 是否必须 参数类型 说明 备注
pay_start_time 是 string 支付开始时间 时间字符串:2019-01-01 00:00:00
pay_end_time 是 string 支付结束时间 时间字符串:2019-01-01 00:00:00
timestamp 是 string 请求时间戳 十位时间串:1653910996
sign 是 string 签名串

md5(timestamp+key), key从报关后台获取

如果timestamp = 20190101081000, key = abc

则 sign = md5(1653910996abc) = 34ea75492bd37597ae75ffa72231e72d

返回数据:

格式: json字符串, 无数据请返回[], 有数据则返回[{...},{...},...]
名称 是否必须 参数类型 说明 其他信息
order_no 是 string 订单编号 报关用的,与支付订单号一致
pay_amount 是 string 实际支付总金额 单位元
buyer_name 是 string 订购人姓名
buyer_idcard 是 string 订购人身份证号码
buyer_mobile 否 string 订购人手机号 如果不传,则取收货人手机号
consignee_name 是 string 收货人姓名
consignee_mobile 是 string 收货人手机号码
consignee_address 是 string 详细的收货地址 需包含省市区等详细地址信息
customs 否 string 指定发送海关 如果不传,默认发送后台配置的口岸
goods[] 是 object
list		 订单商品 商品数组
goods[].goods_title 是 string 商品名称
goods[].goods_id 是 string 商品id
goods[].model 否 string 商品SKU规格

如果一个商品id对应多个不同SKU,此字段为必填,

此字段与goods_id绑定一条报关商品
goods[].number 是 number 商品销售数量
goods[].price 是 double 商品销售单价 单位:元
goods[].tax_rate 否 double   商品进口综合税率 ,例:9.10%
plat_order_no 否 string

扩展字段,

平台订单号

 如果支付单号与订单编号不一致的可以填此字段
logistics_name 否 string

扩展字段,

物流服务商

 

如果是通过平台发货,指定发哪家物流,

取值:圆通,中通,申通,韵达,顺丰,邮政EMS,京东
logistics_no 否 string

扩展字段,

快递单号

 如果是自己发货的,请在此填写快递单号
extend 否 扩展信息,json字符串 其他扩展信息 示例:{"ebpCode":"电商平台代码","ebpName":"电商平台代码"}

返回示例:

[
    {
        "order_no": "SN2021054545455", 
        "pay_amount": "1312.50", 
        "buyer_name": "刘德华", 
        "buyer_idcard": "3707198654124598", 
        "consignee_name": "张学友", 
        "consignee_mobile": "15888888888", 
        "consignee_address": "山东省青岛市崂山区凯旋山庄16号楼6单元808 ", 
        "goods": [
            {
                "goods_title": "爱他美奶粉", 
                "goods_id": "123", 
                "model": "1盒装", 
                "number": 12, 
                "price": 50.25
            }
        ]
    },
     {
        "order_no": "SN2021054545456", 
        "pay_amount": "1312.50", 
        "buyer_name": "刘德华", 
        "buyer_idcard": "3707198654124598", 
        "consignee_name": "张学友", 
        "consignee_mobile": "15888888888", 
        "consignee_address": "山东省青岛市崂山区凯旋山庄16号楼6单元808 ", 
        "goods": [
            {
                "goods_title": "爱他美奶粉", 
                "goods_id": "123", 
                "model": "2盒装", 
                "number": 12, 
                "price": 50.25
            }
        ]
    }
]

接口调试:

订单接口地址
支付时间 至
签名key
调试结果
报关订单取消接口

说明

如果平台需要取消订单,调用此接口

调用方式

商城 => 报关平台

请求方式

方式: POST(x-www-form-urlencoded)

请求参数:

参数名称 是否必须 参数类型 说明 备注
order_no 是 string 订单编号  
timestamp 是 string 请求时间戳 十位时间串:1653910996
sign 是 string 签名串

md5(timestamp+key), key从报关后台获取

如果timestamp = 20190101081000, key = abc

则 sign = md5(1653910996abc) = 34ea75492bd37597ae75ffa72231e72d

返回数据:

格式: json字符串, 无数据请返回[], 有数据则返回[{...},{...},...]
名称 是否必须 参数类型 说明 其他信息
order_no 是 string 订单编号
pay_amount 是 string 实际支付总金额 单位元
buyer_name 是 string 订购人姓名
buyer_idcard 是 string 订购人身份证号码
buyer_mobile 否 string 订购人手机号 如果不传,则取收货人手机号
consignee_name 是 string 收货人姓名
consignee_mobile 是 string 收货人手机号码
consignee_address 是 string 详细的收货地址 需包含省市区等信息
customs 否 string 指定发送海关 如果不传,默认发送后台配置的口岸
goods[] 是 object
array		 订单商品 商品数组
goods[].goods_title 是 string 商品名称
goods[].goods_id 是 string 商品id
goods[].model 否 string 商品规格SKU

如果一个商品id对应多个不同SKU,此字段为必填,

此字段与goods_id绑定一条报关商品
goods[].number 是 number 商品销售数量
goods[].price 是 double 商品销售单价 单位:元

返回示例:

[
    {
        "order_no": "SN2021054545455", 
        "pay_amount": "1312.50", 
        "buyer_name": "刘德华", 
        "buyer_idcard": "3707198654124598", 
        "consignee_name": "张学友", 
        "consignee_mobile": "15888888888", 
        "consignee_address": "山东省青岛市崂山区凯旋山庄16号楼6单元808 ", 
        "goods": [
            {
                "goods_title": "爱他美奶粉", 
                "goods_id": "123", 
                "model": "1盒装", 
                "number": 12, 
                "price": 50.25
            }
        ]
    },
     {
        "order_no": "SN2021054545456", 
        "pay_amount": "1312.50", 
        "buyer_name": "刘德华", 
        "buyer_idcard": "3707198654124598", 
        "consignee_name": "张学友", 
        "consignee_mobile": "15888888888", 
        "consignee_address": "山东省青岛市崂山区凯旋山庄16号楼6单元808 ", 
        "goods": [
            {
                "goods_title": "爱他美奶粉", 
                "goods_id": "123", 
                "model": "2盒装", 
                "number": 12, 
                "price": 50.25
            }
        ]
    }
]

接口调试:

订单接口地址
支付时间 至
签名key
调试结果