如何通过Amadeus API的PNR_AddMultiElements为PNR添加Special Keywords(SK)

核心操作指引 #

• 确认PNR状态：必须是ACTIVE状态，未出票、未关闭的PNR才能添加SK元素
• 权限与认证：确保你的Amadeus开发者账号开通了PNR_AddMultiElements接口权限，调用前完成OAuth2认证拿到有效token
• 参数关键规则：
  • segmentName必须设为SK，明确标识这是特殊关键字段
  • 通过referenceForDataElement的PT qualifier关联旅客，number填PNR里的旅客序号（从1开始）

代码修正与示例 #

你提供的原代码存在结构错误：SK属于特殊关键字段，不该嵌套在SSR服务请求节点里，正确的结构应该用<specialKeyword>节点替代<ssr>。

修正后的XML请求片段 #

<dataElementsIndiv>
  <elementManagementData>
    <segmentName>SK</segmentName>
  </elementManagementData>
  <specialKeyword>
    <type>PARK</type>
    <freetext>SYD.CAR WASH</freetext>
    <companyId>LH</companyId>
  </specialKeyword>
  <referenceForDataElement>
    <reference>
      <qualifier>PT</qualifier>
      <number>1</number>
    </reference>
  </referenceForDataElement>
</dataElementsIndiv>

实用技巧 #

• 多旅客批量添加：给多个旅客加SK时，重复<dataElementsIndiv>节点，修改number对应的旅客序号即可
• 类型代码合规：type字段必须用Amadeus系统认可的SK类型代码（比如PARK对应停车服务），可查系统编码手册确认合法值
• 文本限制：freetext字符数不能超60，避免用特殊符号（如@、#），防止接口报错
• 结果校验：调用接口后，用PNR_Retrieve接口查PNR，确认SK段状态为HK（已确认）才算添加成功

参考资源 #

• Amadeus开发者门户PNR_AddMultiElements接口官方文档（章节：PNR管理 > 添加元素）
• Amadeus系统编码手册：特殊关键字（SK）类型代码对照表
• Amadeus测试沙箱：可在沙箱里模拟PNR创建、SK添加操作，验证调用有效性

内容的提问来源于stack exchange，提问作者edidiong john