eEIR对接总体实施步骤细节分享

++++++以下是厦门堆场成功经验分享+++++

1、E-EIR API总体实施步骤

2、我司E-EIR API具体联调步骤如下,（下列的step对应为上方实施表中的步骤）：

步骤1–获取API文件（Step1）
向eEIR小组申请获取API文件，我司对接过程中获取的API文档已整理归类，具体详见附件；

步骤2–向eEIR申请生产凭证（Step3）

step3的步骤需提前，即为MSK的供应商需向eEIR申请生产凭证（Credentials）以便后续API测试。

MSK供应商需将以下信息通过邮件方式发送给eEIR小组（eEIRSupport@maersk.com/karishma.verma1@maersk.com）申请凭证；

1. Shop Code:
2. Shop Name:
3. Full name:
4. Email Id:

步骤3–eEIR小组向MSK供应商提供生产凭证（Step4）

step4的步骤需提前，eEIR support小组在收到供应商申请邮件后，会根据供应商Shop Code代码和邮箱地址在数据库中注册，并提供以下Client ID和Secret Key给MSK供应商。

Client ID和Secret Key作为调用API时必备的凭证，邮箱则作为接收eEIR反馈的默认邮箱地址；

示例（Sample）：

步骤4–使用POSTMAN或开发系统在低级环境中测试API（Step2）
MSK供应商在取得上述步骤3的Client ID和Secret Key后，使用Postman或其他开发系统在低级环境中测试API，手工测试API接口；

步骤5–根据API文件开发系统，直至堆场系统开发完成（Step5&Step6&Step7&Step8）

Step5&Step6&Step7都是根据API文件，开发&修改堆场系统，以使用API。

过程中需与eEIR的IT团队保持沟通，通过EIR API进行发送测试，发送成功，则注册的邮箱会收到来自eeirappnoreply@maersk.com的反馈邮件，反馈附件为以箱号命名的PDF文档，且eEIR APP端也能查到对应的记录;

步骤9–检测eEIRs（Step9）
监测eEIRs，并做日志跟踪记录，以便后续报错能及时发现;

以下为我司对接过程中的细节分享：

1. EIR传输进场或出场的信息时，都必须随带着估价和照片一起上传才能成功。只能一次性上传（需一次性将进出场信息和照片发送给eEIR），无法分步上传（不可信息和照片分作两步发送），若分步上传，会导致eEIR系统只能收到进出场信息，而接收不到照片；
2. 必填字段说明：
   1. moveType类型：EXP-Export/VSA-Vessel Sharing Agreement/DEL-Delivery；
   2. moveStatus动态：IN–进场/OUT-出场；
   3. damageLocation破损位置：分为两种3P(Third party）/Wear&Tear/
      • 3P破损估价条目的位置：需用实际损坏位置代码（例如：BL1N），用ISO位置代码发送；
      • Wear&Tear破损估价条目的位置：需将位置代码置换成0000发送；
   4. damageType损坏代码：1-污箱、2-破损、3-切口、4-锈破、5-凹陷、6-丢失、7-松动、8-自然磨损、9-油污/油渗透、10-杂标、11-破裂、12-毁坏、13-弯曲、14-脱层、分层、16-其他损坏；
   5. tpIndicator估价项目责任方：1-Owner箱主、2-Third Party第三方、3-Wear&Tear自然磨损；
   6. 照片规则

• • 照片需与项目绑定，且一一对应上传，我司采用的方式是将估价条目和照片的ID做绑定；
  • 每个Third Party第三方项目的照片不能超过三张；
  • 好箱或Wear&Tear项目照片总体不能超过20张，且照片总大小不能超过30M；
  • 命名规则：例如：T_sketch_TR1N_1；“T”表示集装箱损坏区域首字母代码，“sketch”照片的大致描述（或固定使用这个字段），“TR1N”破损的实际位置，“1”表示该项目的第一张照片，最多不能超过三张。