...
API代码:JTYL
当前操作文档针对渠道特殊配置进行梳理,更多HKDHLV2基础预报设置可参考:ERP基础物流服务商预报流程
关于授权
填写预先向服务商注册申请的账号授权数据API服务设置,填写预先向服务商注册申请的账号授权数据
关于API服务绑定
服务商管理,更改新API服务绑定服务商管理,添加API服务绑定
关于配置 - 服务商渠道配置
配置位置:服务商渠道-》服务商渠道配置 (必填 / 条件必填)
配置名称:原产国国家代码配置名称:极兔运输方式代码
当配置不进行维护时,默认传发件人国家二字简码;当配置不进行维护时,默认传空值;
当配置进行维护配置后,原产地名称将进行对应匹配;当配置进行维护配置后,运输方式将进行对应匹配随订单提交给服务商;
配置名称:订单描述
当订单属于非电池类时,不需要在输入框维护数据,系统默认传订单中产品的英文申报名称
当订单属于标准锂电池类电池,按照配置说明维护电池型号即可,在面单显示对应订单描述;
配置名称:电池类型
当配置了电池类型,对应的订单描述需要有电池的描述
配置名称:是否推送收件人注册号/税号
当不选择 或者 选择【否】时,系统将不推送收件人注册号/税号数据;
当选择【是】时,系统将订单系统-》订单详情-》收件人税号/CPF税号相关数推给服务商进行预报;
配置名称:收件人税号所属国国家代码取值(当前一配置项选择【是】时方才生效)
配置名称:创建文件包裹类型运单
配置名称:运费付款方
运费付款方 S: 发件人; R: 收件人; T:第三方。默认值S
配置名称:付款账号(条件必填)
运费付款方为收件人和第三方付款时必填
配置名称:使用发件人账号或第三国/地区的账号(条件必填)
使用发件人账号或第三国/地区的账号(收、发件人之外的第三国/地区)支付目的地税金时(即启用DTP服务时),建议同时在SpecialService字段添加DD代码;
启用DTP服务会产生额外服务费用,费用详情请咨询DHL销售经理 或 DHL客服95380;
配置名称:贸易条款所适用的港口名称 (该配置无需客户维护,后续需要废弃)
ERP系统将按照配置【国际贸易简制(TermsOfTrade)】类型,自动配置收件人城市/发件人城市港口名称
配置名称:发件日期
配置名称:国际贸易简制(termsOfTrade)
请求 创建包裹订单 则必填 -》配置:【创建文件包裹类型运单】
配置名称:包裹类型代码
配置名称:原产地名称
不维护时,系统默认传发件人国家全称
配置位置:服务商渠道-》服务商渠道配置 (非必填)
配置名称:签名快照(SignatureImage)
配置名称:快件类别
配置名称:标签类型
标签类型:8X4_A4_PDF,8X4_thermal,6X4_PDF,8X4_PDF等,不传则默认 8X4_PDF
配置名称:是否隐藏发件人账号
是否隐藏发件人账号:Y-是,N-否,不填默认为Y
配置名称:特殊服务类型
可以传多个,用 | 隔开。
WY: 无纸化贸易PLT (仅支持包裹服务)
II: 保险服务
SA 交付签名, SB 内容签名, SC 命名签名, SD 成人签名, SE 合同签名, SW 替代签名, SX 无需签名
IB: 文件保障服务
DD: 预付关税服务 (包裹服务并且是DDP(非收件人支付关税)时候要选)
配置名称:费用类型
配置名称:是否需要单独传买家信息
配置名称:DHL本地代码
配置名称:带电属性集合
配置名称:是否输出Archive或waybill doc 联
是否输出Archive / waybill doc 联, 如果为Y, 则至少输出一张
配置名称:Archive或waybill doc 联需要几张
Archive/ waybill doc 联需要几张, 可选值为:1或2. 不传则默认为1
配置名称:签名标题
配置名称:是否拆分面单
是否拆分面单:N-否,Y-是。默认否
配置名称:是否需要DHL发票
是否需要DHL发票:N-否,Y-是。默认否
配置名称:发票类型
发票类型 CMI: Commercial; PFI: Proforma; 默认为CMI
配置名称:发货时间
默认的是英国格林时间,GMT 00:00时区
配置名称:发件人类型
配置名称:收件人类别
...
常用可选值为:
- COMMERCIAL_INVOICE_L_10
该发票模板可横向打印出Shipper, Recipient, Buyer, Importer以及Exporter的相关信息。
- COMMERCIAL_INVOICE_P_10
该发票模板可以纵向打印出Shipper,Recipient以及另外两种快件相关方的信息。
当Request中存在五种快件相关方时(Shipper, Recipient, Buyer, Importer and Exporter),那么该发票模板将只打印Shipper, Recipient, Importer 和Exporter这四类快件相关方的信息且返回的。
...
其他逻辑
1、API服务设置,①区域选择【东南亚】时,收/发件人国家的三字码必须维护
②区域选择【欧美】时,收/发件人国家的二字码必须维护,取值ERP系统-【国家管理】页面
2、收件人国家,目的国属于 IDN(印尼)时, 出口商品类别productCategory字段 取值ERP系统-产品资料管理-自定义分类
有效自定义分类:“JTYL-”+ 服务商规定分类(E.G. JTYL-鞋类);
当前服务商规定分类:JTYL-其他商品类,JTYL-纺织商品类,JTYL-鞋类,JTYL-包包类,JTYL-化妆品类 (更多分类,建议与服务商沟通确定最新类型,以免影响包裹清关)
(勾选多个时,系统默认取最新选择的提交给服务商)
3、收件人国家,目的国属于 IDN(印尼)时,收件人税号taxCode字段 取值ERP系统-订单详情-收件人税号/CPF税号