站长答疑:(张先生) 手机:18616712339 在线QQ: .
 
 
返回首页 · 软件简介 · 软件逻辑 · 安装试用 · 购买预算方案 · 设备推荐购买 · 相关电脑知识 · 业务操作教程 · 快递网站 · 常见问题
 
分享和转发请复制下面链接,或者直接点开下面的链接,然后分享静态格式链接↓
分享链接加载中....



钮门快递软件 >> 常见问题

基于钮门系统Emmis+Ginfo基础套餐基础上的会员价格查询的api接口 | 额外开发的中间件重新包装的Json数据

【0】这个是对接开发人员看的Api接口文档

假设使用钮门系统的快递公司的服务器IP是:12.123.23.88

假设使用钮门系统的快递公司的服务器api中间件对外的web端口是:8084

那么

Url请求的正式环境↓

http://12.123.23.88:8084/KeHu_PriceQueryApi_with_GinfoHome

——————————————————

Request请求包是Json。提交方式为POST

Response返回包也是Json

————————————————

请求包的样本↓

{

"GinfoWeb_KeHu_LoginID":"PTDYJNM",

    "GinfoWeb_KeHu_Password": "7kkx6",

    "Q_Destination":"美国",

    "Q_Weight":"9",

    "Q_Packing_TypeNumCode":"1",

    "Q_Packing_Length":"11",

    "Q_Packing_Width":"12",

    "Q_Packing_Height":"13"

}

————————————————

返回包的样本↓

{

    "ApiRunResult": "会员价格查询成功!一共2条报价数据!",

    "ApiRunStatus": "Success",

    "PriceQuery_DataList": [

        {

            "i_CustomsPrice": "4.0",

            "i_ExpressType_GroupMark": "V4",

            "i_ExpressType_Name": "Z_中国邮政",

            "i_ExpressType_ServiceStation": "上海",

            "i_ExpressType_can_be_Track": "NO",

            "i_FuelPrice_with_Percent": "17.0%",

            "i_PackageDelivery_TimeFrame": "2-5()",

            "i_Package_MaxLength": "2.5",

            "i_Package_MaxVolume": "2.3平方米",

            "i_Package_MaxWeight": "15.0公斤",

            "i_Package_VipPrice": "4.87",

            "i_PriceCalculation_Detail": "      1.00(速查0-999000)<BR>-       0.26(折扣:1.00*26.00%)<BR>+       0.13(燃附17.00%)<BR>+       4.00(报关费)<BR>────────────────<BR> =      4.87(会员价)<BR>",

            "i_PriceCalculation_be_with_LWH": "YES",

            "i_PriceQueryMemo": "全球200多个国家都可以到达!<BR>可走电子产品。"

        },

        {

            "i_CustomsPrice": "10.0",

            "i_ExpressType_GroupMark": "V2",

            "i_ExpressType_Name": "M_美国邮政",

            "i_ExpressType_ServiceStation": "深圳",

            "i_ExpressType_can_be_Track": "YES",

            "i_FuelPrice_with_Percent": "21.3%",

            "i_PackageDelivery_TimeFrame": "3-6()",

            "i_Package_MaxLength": "1.3",

            "i_Package_MaxVolume": "1.2平方米",

            "i_Package_MaxWeight": "20.0公斤",

            "i_Package_VipPrice": "191.95",

            "i_PriceCalculation_Detail": "    150.00(速查0-666000)<BR>+      31.95(燃附21.30%)<BR>+      10.00(报关费)<BR>────────────────<BR> =    191.95(会员价)<BR>",

            "i_PriceCalculation_be_with_LWH": "YES",

            "i_PriceQueryMemo": "美国全境直达。<BR>不接受仿货。"

        }

    ]

}

————————————————

看看Postman测试截图。(因为我测试的时候是用自己电脑做服务器,所以服务器IP是:127.0.0.1

Api中间件端口一般没有特殊情况,客户服务器默认都是8084

如下测试成功的截图:

 

 

再看一下,请求失败的案例样子

 

接口说明:

(1)IP地址就是物流公司的服务器IP

(2)端口号不是默认80,一般是默认8084.(我上面的POSTman截图用的是本地电脑做服务器,端口是8089

(3)详细api的请求字段说明↓

字段名

数据类型以及值的要求

是否必填

GinfoWeb_KeHu_LoginID

(字符串类型)、钮门系统客户档案界面一键生成的网站登录账号。

√·必填

GinfoWeb_KeHu_Password

(字符串类型)、钮门系统客户档案界面一键生成的网站登录账号。

√·必填

Q_Destination

(字符串类型)、目的地汉字或者国家二字编码都行,比如:美国或者US

√·必填

Q_Weight

(字符串类型)、以公斤为单位的重量小数。

√·必填

Q_Packing_TypeNumCode

(字符串类型)、提交的值只能是012这三个数字其中1个。0表示文件、1表示包裹、2表示防水袋。

√·必填

Q_Packing_Length

(字符串类型)、表示包裹长度,可以为空。如果要填写,就是以厘米为单位的整数。

×·非必填

Q_Packing_Width

(字符串类型)、表示包裹宽度度,可以为空。如果要填写,就是以厘米为单位的整数。

×·非必填

Q_Packing_Height

(字符串类型)表示包裹高度,可以为空。如果要填写,就是以厘米为单位的整数。

×·非必填

(4)如果查询成功,返回Json3个字段:

4.1ApiRunResult(程序运行的文字说明,不管接口运行请求成功或者失败,都有文字说明)、

4.2ApiRunStatus(运行成功的状态文字,只会出现2个值:SuccessFail)。你可以把这个作为价格查询成功或者失败的判断标记。

4.3PriceQuery_DataList(这个字段只有在会员价格查询成功的时候才会出现。这个字段的值是列表数组类型。然后列表里的每1个子元素,都是1个字典类型、代表1条会员报价数据。)

 

 

 

以下部分,开发人员可以不用看

【1】这个是给钮门系统的使用者(快递公司)负责人看的文档部分。

先看客户那边对你的服务器发起api请求

 

重点关注是【GinfoWeb_KeHu_LoginID】和【GinfoWeb_KeHu_Password

2个字段,如果开发人员找你要,很简单,

你登录你的钮门系统。

 

弹出这个提示,其实就已经复制了。

你先养成1个好习惯,当场粘贴到这个位置,避免下次客户忘记了。你还有地方可以找↓

 

下次要是客户忘记账号密码,找你要。你就在这个地方找,重新复制给客户就行了。

上面这个操作好以后。你在粘贴一份到客户开发人员的聊天窗口里发给他。然后把你的IP地址发给客户

 

2】再看看返回的数据包。虽然你这边不开发程序。但是这些字段名,作为客户那边的开发人员,可能会就这个字段名问到你。你要知道这个字段名称,对应你的钮门系统是什么数据,来自哪里的设置。

先看图

 

11个的解释。直接上钮门系统的截图,以及对应的设置教程,你就明白。

 

——————————————

i_CustomsPrice】海关报关费。来自如下图这个位置:

 

报关费相关设置教程:https://www.ems-help.com/ems-help/2371/d.htm

 

——————————————

i_ExpressType_GroupMark这个一般可以不用设置。如果你要给你的快递类别报价进行分组的话。可以设置,

设置位置如下:

 

 

————————————————————

i_ExpressType_Name】这个就是你的快递系统里的快递类别名称,如下图:

 

凡是你希望你的快递类别名称,能出现在api里,能让客户通过api查询到报价,还有1个大前提,

必须打勾“客户可见”。

 

如果不打勾“客户可见”,客户通过api查询报价的时候,这个快递类别就不参与报价计算,查询结果里也不会出现这个快递类别报价的结果。

 

i_ExpressType_ServiceStation】:这个是服务站点的意思,一般用于记录,你的这个报价渠道所在的发货城市。

这个字段的作用也是把你的报价分类。你也可以不设置。空着也行。

如果要设置,位置如下:

 

 

i_ExpressType_can_be_Track】:这个是当前这个报价渠道,是否追踪追踪物流轨迹。。这个字段的值只有2个:YES 或者 NO

如果你当前这个快递类别下面的关联追踪网络”↓

如下图:如果关联追踪网络这里空着,那就返回NO”,

如果关联追踪网络这里有关联追踪类别,那就发那会YES”:

 

 

 

 

i_FuelPrice_with_Percent】,燃油费设置。如下图:

你设置燃油的时候,不要设置百分号。

比如燃油费率是17%。那你在下面图片的位置设置17就行了。

 

然后接口返回的燃油费率的结果会自带百分号。

在钮门系统跟燃油费有关的设置教程

燃油费设置教程:https://www.ems-help.com/ems-help/2073/d.htm

 

 

i_PackageDelivery_TimeFrame】,预计送达天数范围。你可以不设置。

如果你要设置就是对应的快递类别这个位置

这个数据设置与不设置,不影响报价计算。就是相当于报价的1个注意事项说明。

 

这个截图的位置是11个的目的地分别设置。

如果你想批量导入设置,看下面教程。

相关教程:https://www.ems-help.com/ems-help/76/d.htm

 

i_Package_MaxLength】:报价查询的长度限制条件。也就是支持最大长度。

这个数据设置与不设置,不影响报价计算。就是相当于报价的1个注意事项说明。

设置位置如下图:

 

这个截图的位置是11个的目的地分别设置。

如果你想批量导入设置,看下面教程。

相关教程:https://www.ems-help.com/ems-help/76/d.htm

 

i_Package_MaxWeight】:这个渠道报价的最大重量限制。

这个数据设置与不设置,不影响报价计算。就是相当于报价的1个注意事项说明。

设置位置如下图:

 

如果你想批量导入设置,看下面教程。

相关教程:https://www.ems-help.com/ems-help/76/d.htm

 

 

i_Package_MaxVolume】:这个渠道报价的最大体积限制。

这个数据设置与不设置,不影响报价计算。就是相当于报价的1个注意事项说明。

设置位置如下图:

 

如果你想批量导入设置,看下面教程。

相关教程:https://www.ems-help.com/ems-help/76/d.htm

 

 

i_Package_VipPrice】:最终的客户会员价格。

就是你给客户设置报价以后,录入客户数据,系统自动计算出来的折扣价,

你把钮门系统的客户报价设置好之后,

对应“报价”查询,输入“客户”之后,查询出来的“客户计价”这1列的数据、

 

 

 

i_PriceCalculation_Detail】:价格算法公式介绍。钮门系统自动生成。

 

i_PriceCalculation_be_with_LWH】:这个是当前的这1条报价,长宽高算出来的体积是否参与价格计算。

这个设置,不影响报价计算结果。只是相当于1个补充备注说明。

设置位置如下图:

 

如果你打勾,api接口返回就是“YES”,

如果不打勾,api接口返回就是“NO”。

 

 

i_PriceQueryMemo】:报价备注。就是针对这个报价的,关于包裹的注意事项。

这个报价的数据的显示,结合来自2个位置的文字设置。

如果2个位置你都设置了报价备注,系统就一起显示出来。

显示在前面的报价备注设置的位置如下:

 

显示在后面的报价备注设置位置(注意这个位置是按目的地、11个的设置的,也支持批量导入):

设置位置如下:

 

你也可以不设置。

如果你想批量导入设置,看下面教程。

相关教程:https://www.ems-help.com/ems-help/76/d.htm

 


钮门快递软件|EMMIS[2023.04.22-19:55]编辑:钮门快递软件|EMMIS 访问:848
[关闭窗口]  


您可能还感兴趣的关联教程文章↓

QQ快递资源群分享1(国际快递代理)
用微信或者QQ扫描即可添加
 
QQ快递资源群分享2(邮政国际小包)
用微信或者QQ扫描即可添加
 
QQ快递资源群分享2(国际快递|航空专线)
用微信或者QQ扫描即可添加
 
钮门快递软件.信息载入中...
 
 
 
友情链接维护中。。。。
人气指数: 高质量高人气,快递行业QQ群(资源分享):      
 
 
关于本网站
...
物流查询工具
网站快速通道
其他服务与支持
购买:186-1671-2339
QQ:154392081
E-mail:emmis@qq.com
快递订单管理系统
瘦客户端了解更多>>
总单插件了解更多>>
 
版权所有 ems-help.com Copyright © ems-help.com | Manager.

软件功能■关键词①: 快递软件 | 快递管理软件 | 快递管理系统 | 快递系统 | 快递查单软件 | 快递财务软件 | 快递面单打印软件 | 快递单号批量查询 | 国际航空小包软件 | 快递查单网站制作
软件公司■关键词②: 钮门快递管理系统 | 钮门软件 | 上海钮门 | 钮门网络科技 | 钮门快递系统 | 钮门系统
其他应用■关键词③: 快递电子秤 | 快递PDA | 快递云服务器 | 快递公司来电监听 | 屏蔽快递单号抓取信息关键词 | 快件签收邮件通知