面单API中文FAQ 汇总

面单API中文FAQ 汇总

 1.    介绍

      1.1.   什么是Calista面单系统

      Calista面单是一个尾程服务商提供方， 通过本系统可以使用统一格式对接多家尾程快递提供方。 可将本系统的API视为一个尾程快递提供方对接在贵司的系统中。 

      1.2.   对接接口文件在哪

请访问 https://developer.globaletrade.services/ 并查看eCommerce部分


2.    账户及系统

      2.1.   如何申请测试账户

请联系我司销售或支持人员并提供以下信息。开户成功后，您会得收到重置密码链接邮件和APIkey

  1. Company Name(公司名中文名）:
  2. Company Name(公司名英文名）:
  3. Business Registration Number（营业执照号码):
  4. Email Address邮箱（用测试账户名称并接收测试账户密码）:
  5. First Name/Last Name 用户姓名:

      2.2.   如何重置初始密码

      开户后，您将收到来自Calista账户邮件，访问 如何重置初始密码 

      2.3.   GeTS面单系统的网页端地址是什么 ？

      GeTS CeC电商面单系统的网页端地址为：

      2.4.   如何找回密码

       请访问 如何找回密码

3.    接口对接

      3.1.   对接接口文件

      请访问 https://developer.globaletrade.services/ 并查看eCommerce部分

      3.2.   打印的面单，要实现哪些接口

      3.3.   示例请求文件在哪里

      在接口文档，查看Create New Delivery Order请求体，即可查看面单的json示例

      3.4.   接口中使用到的代码库在哪里

      在线文档中如有用到代码库，均已指向对应的代码库。 

      3.5.   deliveryOrderRefNo可以重复吗？

  1. 在调用创建面单(delivery-order)时， deliveryOrderRefNo需要唯一，之后打印面单时需要通过这个deliveryOrderRefNo去调用打印面单，所以要唯一； 
  2. 在修改面单接口中， 该字段需要为已创建的面单的deliveryOrderRefNo一致； 

      3.6.   shipmentProvider 是什么意思，如何填写?

      shipmentProvider是尾程快递供应商名称，在开户时，由GeTS提供值给客户。

      3.7.    trackingNo是什么意思，如何填写？

      trackingNo为尾程快递号码， 正常不填写，在打印面单时由系统生成。

      3.8.   packages.item.price是总价还是单价？

      packages.item.price是某个货物总价。 
      比如，货物单价为10USD且件数为3件。 此时， packages.item.price填写为总价30 USD， packages.item.quantity填写为3

      3.9.   接口中的invoiceOrder.grantTotal和invoiceOrder.declareAmount可以一样吗？

      可以

      3.10.   接口中的UOM的类型有哪些？

      请访问 UOM代码库

      3.11.   如何添加包裹类型

      在创建面单时，请选择对应的包裹类型。如未提供包裹类型，则为 自备包裹
      在API中， 可通过指定packages.packageType来决定包裹类型。可访问 包裹类型代码库 以查询具体代码

4.    常见错误回执及解决方案

      4.1.   接口开发时， 调用gettoken，遇到Invalid Username or Password

      4.2.   创建面单时，遇到Invalid Token错误

      此错误为token过期或token有问题， 遇到此错误需要重新通过gettoken刷新token;或每次创建面单都都先更新下token

      4.3.   遇到DELIVERY_ORDER_REF_NO already exists错误

      在调用delivery-order创建面单时， deliveryOrderRefNo值要唯一，不可重复；
      如果要修改已有面单，可以通过update delivery order接口去修改，此时要用旧的deliveryOrderRefNo，修改完面单后，要再次调用打印面单接口delivery-order/label

      4.4.   遇到state_exceed_length错误

  1.       收货人的州/省(consignee.address.state)，在接口中要传输代码， 由ISO 3166-1 2位国家代码 + ISO 3166-2 州/省代码组成

  3.       对于发货人，可以通过填写state="Other", stateOther填写省名来解

      4.5.   遇到property data.shipment.parcels.0.items.0.price.amount is a required错误

      请输入packages.item.price.declaredPrice

      4.6.   遇到property data.shipment.parcels.0.items.0.price.currency is a required错误

      请输入salesOrder.currency

      4.7.   遇到Address Validation Error on ShipTo address错误

      请检查地址中有没有特殊字符或中文空格。