银行和金融机构的标记
银行和金融机构的标记
介绍
此页面提供有关使用 schema.org 标记银行及其产品的背景信息。有关更多信息和与项目社区的沟通，请参考 http://w3.org/community/fibo/。
这项工作源于金融行业商业本体项目（参见 http://www.fibo.org/schema 了解详情）。许多类和属性定义受到启发、基于或与 http://www.fibo.org 对齐。
概述
金融扩展指的是与银行和金融机构相关的现实世界最重要的对象。有三个主要类别的对象反映在此扩展中：
- 银行及其识别机制
- 金融产品
- 向客户提供的报价
在为每个对象类别选择类型和属性时，扩展作者（见”致谢”）受到简单性和实用性原则的激励。’简单性’导致了一个极小的术语集，从而产生了一个精简的扩展，而’实用性’将术语范围限制为从零售银行角度看到的、最重要的对象。
‘奥卡姆剃刀’原则规定了重点关注反映消费者偏好的术语，这些偏好是从他们的搜索和典型数字金融活动中观察到的。
一些反映这些对象的类型和属性已经从 schema.org 的开始就定义了。其他类型在 2016 年 5 月发布的 schema.org v3.0 中进入了”核心”词汇，并在 2017 年 3 月发布的 schema.org v3.2 中提供了术语的全部内容。在此之前，大多数这些术语现在位于 http://pending.schema.org。按照 schema.org 扩展规则，它们享有 schema.org 主命名空间的规范性。
尽管它们有各种起源，在此页面中，我们平等对待它们所有，使用”金融扩展”的伞状术语。由于所有这些都存在于共同的共享 schema.org 命名空间中，从实用角度来看，如何进入存在是无关紧要的。
毫无疑问，当前形式的扩展可能无法满足银行和其他金融机构的所有需求。然而，它创建了一个现在可以利用的框架，并带来巨大好处，尽管其占用空间很小。
该项目的作者致力于 schema.org 词汇的”金融”面的未来发展。这将包括向 schema.org 核心添加最重要的类型和属性，向托管扩展添加，以及未来需要不受”精简””方法限制的 schema.org 外部金融扩展。
金融扩展的概念地图和层次结构
以下图表呈现了扩展的概念地图。正如之前解释的，该地图包含来自 schema.org “核心”和实际金融扩展（在撰写本文时位于 pending.schema.org）的元素：
银行由其 LEI（法律实体标识符）代码识别：leiCode（上图）和 schema.org 中已经存在的术语（见”基本模型”）。
扩展中的大多数术语允许描述金融产品及其特征，反射扩展对”零售”金融行业的首要关注。
还有辅助术语帮助描述银行的报价（”ExchangeRateSpecification“，”RepaymentSpecification“）。
金融扩展的完整层次结构
所有扩展术语都在红色中描绘。schema.org 中已经定义的分支在灰色中描绘。
类型：
属性：
- Thing
- Property
- annualPercentageRate
- feesAndCommissionsSpecification
- interestRate
- identifier
- duration
- requiredCollateral
- accountMinimumInflow
- accountOverdraftLimit
- amount
- bankAccountType
- beneficiaryBank
- cashBack
- contactlessPayment
- currency
- currentExchangeRate
- domiciledMortgage
- downPayment
- earlyPrepaymentPenalty
- exchangeRateSpread
- floorLimit
- gracePeriod
- loanMortgageMandateAmount
- loanPaymentAmount
- loanPaymentFrequency
- loanRepaymentForm
- loanType
- monthlyMinimumRepaymentAmount
- numberOfLoanPayments
- recourseLoan
- renegotiableLoan
- Property
金融对象的模型
下面的图表说明了描述金融对象主要类别的基本模式。
银行
描述银行和信用合作社的主要类型，BankOrCreditUnion 是以下 schema.org 类的子类序列：FinancialService -> LocalBusiness -> (Organization 和 Place)。机构可以通过以下 schema.org 属性识别：name、contactPoint、address 和网站 url。扩展添加了金融机构的基本全球标识符：leiCode：法律实体标识符（字母数字代码或 LEI URI）。
金融产品
描述金融产品的顶级’类型’，FinancialProduct（它是 schema.org Service 类型的子类）被最重要的特定产品子类化：BankAccount、PaymentCard、LoanOrCredit、InvestmentOrDeposit、PaymentService 和 CurrencyConversionService。
特定产品的示例在以下图表中说明：
在此示例中，DepositAccount（InvestmentOrDeposit -> FinancialProduct 序列的子类）通过以下属性描述：amount、interestRate、provider 和 availableChannel。
在此示例中，MortgageLoan（LoanOrCredit -> FinancialProduct 序列的子类）通过以下属性描述：amount、interestRate、annualPercentageRate（代表 APR）、loanTerm 和 loanRepaymentForm。
报价
对于大多数金融产品，我们进入了 schema.org 相关商业报价和其他来自 GoodRelations 电子商务词汇的相关术语的领域：
在此示例中，Offer 类型用于描述向客户提供的 PaymentService（FinancialProduct 的子类）作为服务。服务可以正确命名（name），提供的价格通过 PriceSpecification 表示，允许指定价格（price）本身、货币（priceCurrency）和数量（eligibleQuantity）。
在另一个流行示例中，支付卡（PaymentCard）（从 PaymentMethod 和 FinancialProduct 两者子类化）可以正确命名（name），并使用 Offer 类型的元素向客户提供，允许表达提供者（offeredBy）及其实际功能（BusinessFunction）。
使用示例
在此文档部分，我们呈现了在 HTML 页面中使用 schema.org 标记的几个示例。有 BrokerageAccount、InvestmentFund、MortgageLoan、RepaymentSpecification、ExchangeRateSpecification、CreditCard 和 MoneyTransfer 的示例。
第一个示例（BrokerageAccount）由假设的预标记代码和三种可接受格式的标记说明：Microdata、RDFa 和 JSON-LD。其余示例仅由 JSON-LD 代码说明。
BrokerageAccount
此示例描述了一个典型的经纪账户，允许投资者存入资金并通过许可经纪人或经纪公司下投资订单。该账户由其名称和描述识别。关于它的具体数据通过最低账户金额 (minAmount)、其基本货币（currency）、费用和佣金规范（feesAndCommissionsSpecification）和可用访问渠道（availableChannel）表示：
预标记：
1 | |
微数据：
1 | |
RDFa：
1 | |
JSON-LD：
1 | |
InvestmentFund
此示例说明了支持投资基金描述的 JSON-LD 代码片段。该基金可以通过名称和描述识别。典型投资的细节可以使用 currency、”minAmount”、”maxAmount” 和 interestRate 指定。
JSON-LD：
1 | |
MortgageLoan, RepaymentSpecification
此示例说明了补充某些抵押贷款及其还款规范描述的 JSON-LD 代码片段。贷款可以通过其类型、名称和描述识别。贷款细节使用以下描述：amount 由其值和货币详细说明、loanTerm 由年数详细说明（具有对应于一年的 unitCode 的 QuantitativeValue）、interestRate 及其 APR – annualPercentageRate。
还款规范通过其频率（loanPaymentFrequency）、分期付款数量（numberOfLoanPayments）、首付百分比（downPayment）和付款金额（loanPaymentAmount）描述，进一步由 amount 和 currency 详细说明。
JSON-LD：
1 | |
CreditCard
此示例说明了使用 JSON-LD 代码片段补充信用卡描述。正在描述的特定卡由其名称（name）识别。卡提供的报价的细节通过以下表示：annualPercentageRate、interestRate、百分比的”cashback“（如果适用）、卡宽限期（gracePeriod）和非接触式付款的标志（contactlessPayment）。其他属性，如 offeredBy 允许指示卡的发行者和卡的年度持卡人成本（price） – 进一步由其货币（currency）和类型 (“@type”) 详细说明。
JSON-LD：
1 | |
MoneyTransfer
此示例说明了使用 JSON-LD 代码片段描述请求的银行转账。转账的目标使用其 name 表示。转账金额由 amount 表示，由实际金额和货币（currency）详细说明。转账受益人由相应属性（beneficiaryBank）指示。
JSON-LD：
1 | |
致谢
我们要感谢以下个人：Dominik Kuzinski、Robert Trypuz、Richard Wallis、Adam Lis、Martin Hepp 和 Piotr Goetzen，由 MakoLab SA 的 Mirek Sopek 协调，创建了金融扩展和此文档。
这项工作已得到 EDM Council 及其由 Dennis Wisnosky 和 David Newman 协调的 FIBO 团队的认可。
维护和新元素提案以及讨论由 W3C 社区协调：https://www.w3.org/community/fibo/。