该功能适用版本为金蝶云·苍穹V5.0.021及以上。

基于金蝶动态领域模型，苍穹国际化能力提供了多语言的支撑能力，OpenAPI支持查询单据或基础资料中的多语言文本字段，也可以通过接口保存当前语言或所有语言数据。

通过OpenAPI执行操作时，自动根据接口访问令牌（accesstoken）上下文中的语言（language），进行多语言文本处理。在新版本中，OpenAPI对多语言文本的处理更加灵活，支持以下场景：

1) 查询操作API。通过开关配置，支持一次返回字段所有语言数据；

2) 保存操作API。使用map形式传入多语言字段，支持保存字段所有语言数据；

3) 支持调用接口时自定义语言环境。

示例1：查询接口多语言 -- 返回所有语言的供应商名称。

当企业有部分供应商为跨国公司，在进行供应商管理时，需要启用多语言字段，分别维护供应商的英语名称与简称。

供应商名称的多语言信息

当通过接口查询供应商信息时，首先需要获取accesstoken信息。在获取登录令牌时，传入默认系统语言。简体中文为 zh_CN、繁体中文 zh_TW，英文 en_US，这里传入英文标识en_US，如下图所示：

获取accesstoken（英文语言环境）

在请求中，携带accesstoken调用接口，默认返回英文语言的数据，如下图所示，查询供应商名称和简称时，会返回对应的英文名称。

接口查询英文环境下的供应商名称

若需要一次返回所有语言的供应商名称信息，则需要打开“返回多语言”开关，路径：【开发服务云】 → 【开放平台】→ 【API管理】→ 【API开发】。

打开API配置【返回多语言】

再次调用接口，此时会返回所有语言的供应商名称信息。

接口查询所有语言的供应商名称

示例2：保存接口多语言 -- 保存所有语言的供应商名称。

以供应商基础资料为例，通过接口保存不同语言的供应商名称。

当只需要保存某个语言数据时，我们同样可以在获取accesstoken的请求参数中，传入语言（language），同示例1，将环境语言定义为英文en_US。

接口保存供应商 - 名称为英文

接口保存成功后，查看生成的供应商名称，如下所示：

接口保存的供应商名称多语言信息

当需要一次保存所有语言的供应商名称时，在请求参数中传入如下map样式，如下所示：

接口保存供应商 - 名称传入所有语言

接口保存的供应商名称所有多语言信息

示例3：接口自定义语言环境。

当使用accesstoken进行认证时，有时候我们不想在上下文中固定环境的语言，或者使用基本认证等方式，无法定义访问令牌的语言环境。为了解决这个问题，开放平台OpenAPI支持通过请求头自定义Accept-Language。

在这种情况下，如果你通过接口查询多语言字段（不打开“返回多语言”开关），系统会优先输出Accept-Language中的多语言数据。同样地，如果你通过接口保存多语言字段时（不传入map参数），系统会默认保存Accept-Language中定义的语言数据。

这样的设计使得API更加灵活和易用，让用户能够根据自己的需求自定义语言环境，无需依赖固定的上下文或其他认证方式。

关闭接口多语言开关，测试Accept-Language

请求头Accept-Language测试示例

亮点一：助力全球化

通过支持多语言的API接口，能够满足全球用户的需求。用户可以使用自己熟悉的语言与软件进行交互，无论是进行数据查询、保存还是其他操作，都能够以其偏好的语言进行。

亮点二：灵活易用

提供了灵活易用的API开发体验，开发人员可以轻松地处理和操作来自不同语言环境的数据，无需额外的语言处理代码或复杂的转换过程，开发过程更加高效，提升了开发人员的生产力和工作效率。