Search
Related topics are listed below.
Introduction All Finance Data Catalog
AFD 2.0 building blocks » Introduction All Finance Data Catalog
Context and history The All Finance Data Catalog (AFD) forms the basis for the digital ecosystem (see also Introduction SIVI AFS). AFD determines how one denotes data (e.g. a date always in the same format) and how one groups this data in a structure (e.g. what data…
SIVI All Finance Standard
Manual SIVI All Finance Standard » SIVI All Finance Standard
The SIVI All Finance Standard (SIVI AFS) is the next growth step in digitization within our industry. In 1985 it was “electronic (ADN) messaging”, in 2004 “Internet” and now it is “API”. In all three cases it is the stepping stone to…
Overview of the API-framework
Domain specific functions » Introduction to all functions » Overview of the API-framework
The API-framework is designed in four levels to find the right API in a few steps. The four levels of the API-framework are: Category Cluster Operation Variant In the remainder of this section all elements will be explained. Figure 5.1.1-1 API-framework…
Manual SIVI All Finance Standard
Manual SIVI All Finance Standard
This manual describes and explains the SIVI All Finance Standard (SIVI AFS). If you have any questions about this manual or suggestions for improvement, please do not hesitate to contact support@sivi.org or call within office hours (030) 698 80 90. Version…
Introduction to all functions
Domain specific functions » Introduction to all functions
API-framework In addition to the All Finance Data Catalog (Introduction All Finance Data Catalog), the All Finance API-framework (AFA) forms the basis for the digital ecosystem (see also Introduction AFS). Within the digital ecosystem, the use of web services plays an…
Mapping-API
Mapping » Mapping-API
Based on the article ‘Mapping van AFD 1.0 naar AFD 2.0 geautomatiseerd’ (in SIVI AFS Magazine May 2022). Mapping-API for all mappings related to SIVI AFS SIVI offers an API to provide mappings from one data catalog to another. More specific, the API…
Overview of all functions
Domain specific functions » Overview of all functions
Introduction The SIVI API-framework function overview contains two documents. One document is based on the Category Functional and contains all the functional functions of this framework. The other document is based on the Category Technical and contains all the…
Introduction SIVI AFS
Manual SIVI All Finance Standard » Introduction SIVI AFS
SIVI digital ecosystem Within the financial services distribution, data and IT are increasingly preconditions for both the shaping of business activities (like acceptance of an insurance policy) and the development of customer services (for instance an insurance…
Introduction to technical functions
Technical functions » Introduction to technical functions
API-framework A short introduction into the API-framework is available in chapter Introduction to all functions. Structure of the API-framework The API-framework technical function hierarchy is designed to support a number of clusters. The clusters are grouped into…
Introduction to AFD structures
AFD structures » Introduction to AFD structures
Bridge between data catalog and API-framework functions In SIVI AFS, the use of AFD structures occupies a prominent place. In thinking about API architectures, the starting point is that functions are defined on the basis of the specific data set to which the function…
Domain specific functions
Domain specific functions
Outline of this chapter The domain specific functions included in the SIVI API-framework cover a wide range of aspects of the operational processes related to the distribution of financial products. The functions included in this chapter are based on either preceding…
Additional support
Additional support
Manual This manual is the first place of information for users of the AFD, API-framework and AFD-definitions. If information is missing or something is unclear, please contact support@sivi.org or call within office hours (030) 698 80 90. Requests for changes and…
Security
Security
*Under construction A more up-to-date description of Security will follow in due time. Integral security agreements In daily practice it is very difficult to make integral security agreements throughout the distribution chain for all systems of all chain parties.…
Operation and variant description: reading guide
Domain specific functions » Introduction to all functions » Operation and variant description: reading guide
This chapter is a reading guide to the detailed descriptions of all variants applicable for a cluster/operation combination. A general overview of the API-framework is available in Overview of the API-framework. You can find a detailed overview of all functions in…
Claim
Domain specific functions » Claim
Clusters are grouped functions with the same characteristics and use. The cluster claim contains all data needed for claims handling. An overview of the clusters can be found in the Overview of the API-framework. The clusters are concentrated around AFD structures.…
Proprietary APIs
Proprietary APIs
The objective of the SIVI AFS API-framework is to provide a blueprint for generic functions that are used in the value chain of financial products. This enables parties to model their APIs in a standard format which is recognizable throughout the industry and…
Technical functions
Technical functions
Outline of this chapter In general, a function is an operational process performed by an API. This chapter focuses on the technical functions, while the chapter Domain specific functions describes the functional functions. On the highest level functions (in SIVI AFS)…
SOAP vs REST
Transaction standards » SOAP vs REST
*Under construction A more up-to-date description of the Transaction standards will follow in due time. Introduction The choice of a specific technical solution or application remains the responsibility of the individual party who develops an API, which is why the…
Abbreviations
Abbreviations
Abbreviations used in this manual are explained below. If you want more information about a topic, please contact SIVI for support. Abbreviation NL Description EN Description ADN Assurantie Data Netwerk Insurance Data…
Object
Domain specific functions » Object
Clusters are grouped functions with the same characteristics and use. The cluster object contains all data with respect to an insured or financed object representing an interest for the owner. An overview of the clusters can be found in the Overview of the…
Party
Domain specific functions » Party
Clusters are grouped functions with the same characteristics and use. The cluster party contains all data with respect to a natural person or an organization. An overview of the clusters can be found in the Overview of the API-framework. The clusters are concentrated…
Task
Domain specific functions » Task
Clusters are grouped functions with the same characteristics and use. The cluster task contains general information about an assignment or task, for example, inspection, valuation or repair of damage. An overview of the clusters can be found in the Overview of the…
Readers guide
Manual SIVI All Finance Standard » Readers guide
This manual describes and explains the SIVI All Finance Standard (SIVI AFS). If you have a managerial role, reading this chapter and subsequently paragraphs 2.1, 5.1 and chapter 14 will give you an overall impression of SIVI AFS. For those with a more substantive…
Ticket
Domain specific functions » Ticket
Clusters are grouped functions with the same characteristics and use. The cluster ticket contains all data of a question, complaint or claim file. Note: a claim file is not itself nested under a ticket, but can be included under a ticket via a reference (using the…
Differences between AFD 1.0 and AFD 2.0
Manual SIVI All Finance Standard » Differences between AFD 1.0 and AFD 2.0
All Finance Data Catalog English as official language The demand for English documented SIVI standards is increasing. The first reason is that software development activities at for instance insurers, service providers and suppliers are increasingly (at least partly)…
Design principles
Domain specific functions » Introduction to all functions » Design principles
Introduction The All Finance API-framework describes API functionality as much as possible in general terms. Where technical context is relevant or needed the REST design principles are used. REST is a set of architectural constraints, not a protocol or a standard. In…
error
AFD 2.0 building blocks » Entities » Technical entities » error
Entity: error The error entity is intended for communicating error messages, primarily used within the API-framework. Example usage Below is an example error entity, filled with some attributes. This example shows a check of the POR code at the moment of receival…
Contract
Domain specific functions » Contract
Clusters are grouped functions with the same characteristics and use. The cluster contract contains everything for the contract administration or policy administration. An overview of the clusters can be found in the Overview of the API-framework. The clusters are…
Swagger examples of domain specific functions
Domain specific functions » Swagger examples of domain specific functions
The SIVI AFS API framework and the overview of functions are the starting point for opening up APIs to the market. In this section we describe how this framework works, using some examples in SwaggerHub. By clicking the green button below, the user gets access to these…
masterAgreementStructure
AFD structures » masterAgreementStructure
General properties The masterAgreementStructure can be used to define a collection of contracts which are linked to each other by a master agreement, for example a package policy, or a framework pension contract. A masterAgreementStructure always consists of a single…
afsTableStructure
AFD structures » afsTableStructure
General properties Within AFD 2.0 and the API-framework, SIVI provides a function for exchanging data in a tabular structure.This enables parties to distribute content (such as tables of data or a codelist) which can be used in for example a drop-down list presented…
pensionStructure
AFD structures » pensionStructure
General properties The pensionStructure is characterized by the presence of the pension entity and a party entity. In addition, relevant entities are available to elaborate on any aspects of pension-related information. See AFD 2.0 Online for the complete and…
AFD structures
AFD structures
Outline of this chapter In the next sections the different structures are explained and defined. For each structure, it is indicated which entities can be used within the structure, and their occurrence requirements. Depending on the actual use of the structure,…
afsStructure
AFD structures » afsStructure
General properties The afsStructure is different from the other structures in that the afsStructure actually does not define any structure at all. The afsStructure only adheres to the set-up of entities and attributes, and can be seen as a ‘master schema’…
Error messages SOAP and REST
Transaction standards » Error messages SOAP and REST
The information in this chapter is described with the REST architecture principles in mind. One of the key elements of that architecture is the fact that data exchange is based directly on the HTTP protocol, and does not use an intermediate layer for functions or…
Initiate
Technical functions » Session » Initiate
*Under construction More detailed information on Session will follow in due time. Request for a url to initiate a browser session with prefilled data. Access to the API and the URLs provided through the API is subject to adequate security measures for…
objectStructure
AFD structures » objectStructure
General properties The main characteristic of the objectStructure is the presence of the object entity. In addition, all relevant entities are available to elaborate on any aspects of related information to the described object. Within the context of AFD, an object is…
taskStructure
AFD structures » taskStructure
General properties The main characteristics of the taskStructure are the presence of the task entity, which groups general information about a task for, for example, inspection, appraisal or repair of damage. Therefore, claim and claim-related entities (party, policy)…
ticketStructure
AFD structures » ticketStructure
General properties Within the insurance market, it is quite common to process customer reports using ‘tickets’. A ticket entity, including a ticketStructure and according attributes is available to support these processes. Mandatory components The table…
AFD-definition standard
AFD-definition standard
*Under construction. The AFD-definition Standard manual can be consulted in Dutch. The English version of the AFD-definition Standard 2.0 will be available soon. Introduction The digitization of insurance processes continues unabated. Applications and data exchange…
loanStructure
AFD structures » loanStructure
General properties The loanStructure is the main structure for exchanging and storing mortgage or other loan data, and is usually made up of the loan entity and two party entities indicating the parties mutually involved in the loan agreement. All relevant entities…
Message
Technical functions » Message
*Under construction More detailed information on Message will follow in due time. Messages can be exchanged (in bulk) via a platform, as described in the Message exchange platform section, but they can also be exchanged in a peer-to-peer situation. This chapter…
partyStructure
AFD structures » partyStructure
General properties In many customer folders, the party is located in the center of a web of contracts around it, varying from pensions to policies and even telephone companies or energy contracts, often with explicit relationships to other parties in the database. A…
JSON
Transaction standards » JSON
Introduction JSON is the abbreviation for JavaScript Object Notation. JSON is a syntax used in computer programming for using data in a structured way. JSON is a platform independent, open-standard syntax. Specific open standards such as JSON Schema and AJAX have been…
documentStructure
AFD structures » documentStructure
General properties The documentStructure is basically made up of the document entity, a commonTechnical entity for technical metadata and a commonFunctional entity for functional metadata. The structure is used for exchanging a wide range of document related data: for…
claimStructure
AFD structures » claimStructure
General properties The claimStructure is made up of entities used to notify and register a loss, process a claim and create settlements. Given the fact that a claim is made against the cover of a policy, the policy and coverage entities are available in the…
masterAgreement
AFD 2.0 building blocks » Entities » Supporting entities » masterAgreement
Entity: masterAgreement The masterAgreement entity is used for grouping data about a master agreement, such as a package policy, framework contract or group discount arrangement. The masterAgreement entity is used in combination with loan, pension and/or policy…
policyStructure
AFD structures » policyStructure
General properties The main characteristics of the policyStructure are the presence of the policy entity, a party entity with entityType policyHolder, an object entity to record the insured object, and a coverage entity to describe the protection provided by the…
Where to find details about AFD structures
AFD structures » Where to find details about AFD structures
In the Introduction to AFD structures you will find an explanation on structures and baselines in SIVI AFS. Upon request, SIVI uploads baselines to create structures in AOS. Please note that these baselines are only visible in AOS and not downloadable, but if you are…
messageStructure
AFD structures » messageStructure
General properties A message structure can be considered to be a kind of electronic envelope; it carries information about the sender and receiver on the outside, and a content (letter) on the inside. The envelope/letter can be sent directly to the receiver, or it can…
Where to find elements of SIVI AFS?
Manual SIVI All Finance Standard » Where to find elements of SIVI AFS?
A lot of information is available in this manual. But if you are interested in details about the use of SIVI AFS we recommend you to have a look at the information mentioned below. AFD 2.0 Master table On the SIVI AFS website you will find the AFD 2.0 Master Table…
containerStructure
AFD structures » containerStructure
General properties Data can be exchanged in a synchronous or asynchronous manner, depending on specific processes and circumstances. The most common methods for asynchronous exchange are via File Transfer Protocol and message exchange platforms (MEP), often used in…
Retrieve
Domain specific functions » Object » Retrieve
The operation retrieve in case of an object will fetch the data of an object. Different entity types are available within the objectStructure, for example motorVehicle or building. You can find a complete overview in AFD 2.0 online. How to use variants The…
Retrieve
Technical functions » Message » Retrieve
*Under construction More detailed information on Message will follow in due time. The operation retrieve in case of a message will fetch the message details. How to use variants The retrieve operation is a webservice call without a body. For more information see…
Retrieve
Domain specific functions » Task » Retrieve
The operation retrieve in case of a task will fetch task details which can contain information added by the third party, for instance status or planned time or date of execution. The entityType valuation is always used in case of operation retrieve. The data is…
Retrieve
Domain specific functions » Ticket » Retrieve
The operation retrieve in case of a ticket will fetch ticket details which can contain information added by a third party, for example about a complaint or claim file. The data is selected by providing the {ticketId} as a path parameter of the…
Change
Domain specific functions » Party » Change
The operation change in case of a party will replace a party partially or completely. How to use variants If you need to make changes to an existing party, choose the operation change. If it is only necessary to change some details, the variant ‘detail’…
Change
Domain specific functions » Task » Change
The operation change in case of the entity task will replace an existing task partially or completely. Once the initial task has been sent to a contractor, it may be updated in order to supply additional information. For instance the (temporary) location where a…
Change
Domain specific functions » Ticket » Change
The operation change in case of the entity ticket will replace an existing ticket partially or completely. Once the initial ticket has been filed, it may be updated in order to supply additional information. For instance with more information about a maintained claim…
Retrieve
Domain specific functions » Contract » Retrieve
The operation retrieve will fetch a policy, loan, pension, master agreement or contract within an existing master agreement for a single entry, a range or a list of entries. The output consists of the structures needed in the particular situation, so it can be a…
Message exchange platform
SIVI protocols » Message exchange platform
*Under construction A more thorough description of the Message exchange platform will follow in due time. Introduction The basic goal of a message exchange platform is the secure interchange of structured and unstructured data, as well as documents among trusted…
Change
Domain specific functions » Contract » Change
The operation change of a contract will replace an entity partially or completely. An entity linked to a contract can be a policy, loan, pension, master agreement or contract within an existing master agreement. The payload consists of the structures needed in the…
New
Domain specific functions » Party » New
The operation new in case of a party will add a party. A party can be a natural person (e.g. partner, employee) or an organization (e.g. bank, insurance company). A party can exist without being connected (immediately) to a contract. How to use variants If you want…
New
Domain specific functions » Ticket » New
The operation new in case of a ticket will add a new ticket. A ticket can (for example) be a question, complaint or (claim) file, but the entityType is always default. How to use variants If you want to add a new ticket, choose the operation new. Only one variant is…
Codelists
AFD 2.0 building blocks » Codelists
A codelist can limit the number of permitted values of an attribute. In data modelling terms, a codelist can be seen as an enum(eration) of values allowed. An example codelist of the attribute ‘primaryColors’ could be the enumeration [‘yellow’, ‘blue’,…
Change
Domain specific functions » Claim » Change
The operation change in case of a claim will replace an entity partially or completely, if the processes for handling and settling claims have not been completed, yet. A change to a claim might be necessary, for example, if the claim needs to be linked to another…
New
Technical functions » Message » New
*Under construction More detailed information on Message will follow in due time. The operation new in case of a message will transmit an electronic message to a party (peer to peer) directly without the need of an intermediary service. How to use variants If you…
Retrieve
Domain specific functions » Table » Retrieve
The operation retrieve will fetch data in a tabular structure for use in automated processes and user dialogs. Automated processes often use codelists to enforce the use of valid values for a specific attribute and keep the dataset compact. In a screen dialog this is…
Termination
Domain specific functions » Contract » Termination
The operation termination of a contract puts an end to a policy, loan, pension, master agreement or contract within a master agreement. *The functions, variants and structures concerning pension and loan are under construction and will follow in due time. How to use…
Validation
Domain specific functions » Object » Validation
The operation validation checks whether the object data are valid. An example of a validation is the check of the combination licence plate and chassis number for a motor vehicle. How to use variants The operation validation is a webservice call without a body. A…
Attributes
AFD 2.0 building blocks » Attributes
An attribute describes a characteristic of an entity, for example the date of birth (attribute) of the policyholder (entity), the expiry date (attribute) of the policy (entity), etc. A single entity may contain multiple attributes. Attributes are grouped by entity in…
Retrieve
Domain specific functions » Claim » Retrieve
The operation retrieve in case of a claim will fetch the data or the status of a claim. The retrieval of a single claim can be used as input to a step in the claims handling process, or to provide current claim information to a portal or account page of the broker or…
Transaction standards
Transaction standards
Outline of this chapter The aim of the All Finance Standards is to be as future-proof as possible. On the other hand, linking protocols and – to a lesser extent – syntaxes are more subject to change. By dividing the standards into multiple layers, SIVI AFS can…
New
Domain specific functions » Contract » New
The operation new in case of a contract will add a new policy, loan, pension, master agreement or contract within an existing master agreement). The payload consists of the structures needed in the particular situation, so it can be a policyStructure, a loanStructure,…
Standard attributes
AFD 2.0 building blocks » Attributes » Standard attributes
If attributes are sufficiently generic across the entire financial industry, they are suitable for standardization, and thus for inclusion in AFD. These attributes are standard attributes. Entities can be filled from a list of associated attributes. For example, the…
New
Domain specific functions » Task » New
The operation new in case of a task will create a new task for a third party. Examples of tasks are inspection, valuation or repair of damage. The entityType assignment is always used in case of operation new. How to use variants This function is used to outsource a…
Special limit
Domain specific functions » Contract » Special limit
The operation specialLimit requests and sends messages and registers contracts with conditions that deviate from the usual (standard) conditions. If contracts would have fit in the usual conditions the operation new would have been applicable. *The functions, variants…
New
Domain specific functions » Claim » New
The operation new in case of a claim is used to initiate the claim process with a first notification of loss. The insurance provider creates a claim file and assesses the claim. In the following steps the claim can be rejected, or claim handling will commence. These…
Renewal
Domain specific functions » Contract » Renewal
The operation renewal will return financial information or calculate the rate as a result of a renewal of a policy, loan, pension, master agreement or contract within a master agreement. *The functions, variants and structures concerning pension and loan are under…
Retrieve
Domain specific functions » Party » Retrieve
The operation retrieve in case of a party will fetch the data of that party. How to use variants The operation retrieve is a webservice call without a body. For more information see the Retrieve operations section of the Design principles chapter. The output of…
JSON Schema
AFD-definition standard » JSON Schema
Context JSON Schema is used for defining specifications of messages regarding structures, entities and attributes. The use of JSON Schema promotes the preparation of unambiguous specifications. In addition, JSON Schema can be used as a basis for automated checking of…
Data registration vs services
Domain specific functions » Data registration vs services
Based on the article ‘SIVI AFS: Registratie van gegevens versus services’ (in SIVI AFS Magazine May 2022). Users of SIVI AFS use AFD 2.0 for the performance of services (data exchange) and for registration (data storage). In this article, we show some…
settlement
AFD 2.0 building blocks » Entities » Supporting entities » settlement
Entity: settlement The settlement entity is used for grouping information regarding the handling of a claim. The entity can be used for supporting a claim. Example usage Below is an example settlement entity, filled with some attributes. claimRef refers to the…
XML
Transaction standards » XML
Introduction XML is the abbreviation for Extensible Markup Language. XML is a syntax used in computer programming to enable use of data in a structured way. XML is a platform independent syntax, maintained by W3C. Specific industry standards such as SOAP, XML Schema,…
claim
AFD 2.0 building blocks » Entities » Core entities » claim
Entity: claim The claim entity is used for the grouping of claim-related data. A claim is a request made by the insured for insurer remittance of payment due to loss incurred, and covered under the policy agreement. Example usage Below is an example claim entity,…
partyDetails
AFD 2.0 building blocks » Entities » Supporting entities » partyDetails
Entity: partyDetails The partyDetails entity is used for grouping specific information about a given party, such as health or income data. The entity can be used for supporting a party entity (for example of entityType policyHolder or regularDriver). Example…
Table
Domain specific functions » Table
In order to maintain consistency and traceability in the distribution chain, it is important that parties can exchange data in a tabular structure. The cluster table enables retrieval of information to incorporate in an agent application. It is a way to ensure that…
incident
AFD 2.0 building blocks » Entities » Supporting entities » incident
Entity: incident The incident entity is used for grouping information about the circumstances and damage/loss due to an incident. The entity can be used for supporting a claim. Example usage Below is an example incident entity, filled with some attributes. claimRef…
action
AFD 2.0 building blocks » Entities » Supporting entities » action
Entity: action An action is a task that a party must perform in response to one or more events. An action is often used in combination with a signal entity. Example usage The example below shows some actions related to the life event turning 18 (‘18 jaar…
AFD 2.0 building blocks
AFD 2.0 building blocks
Outline of this chapter This chapter describes the building blocks of AFD 2.0. The All Finance Data catalog consists of entities, attributes, data types, codelists and code values: An entity describes an object or thing from reality, for example a policy, party or…
Mortgage domain mapping
Mapping » Mortgage domain mapping
Based on the article ‘SIVI AFS nu ook geschikt voor modellering hypotheekdomein’ (in SIVI AFS Magazine December 2022). Introduction With the SIVI All Finance Standard (SIVI AFS), it is possible to model the first facets of the mortgage domain. This is the…
Alignment existing SIVI documentation and AFS
Manual SIVI All Finance Standard » Alignment existing SIVI documentation and AFS
A lot of SIVI documentation, related to SIVI AFS, is available on the SIVI website. Most of this information is written in Dutch. The goal of SIVI is to add an English translation of this documentation to the SIVI AFS Manual. You can find some useful links to SIVI…
Standard codelists
AFD 2.0 building blocks » Codelists » Standard codelists
Instead of a data type, the format of an AFD attribute can also be based on a codelist. With a codelist, the number of permitted values of an attribute can be limited further than in the case, a generic data type is used. For example, the attribute tripPurpose is of…
AFD 2.0 Online
Tools » AFD 2.0 Online
Browse the data catalog online Just like for AFD 1.0, SIVI offers a tool for AFD 2.0 to consult the data catalog online. With AFD 2.0 Online Consultation it is possible to easily consult entities, entityTypes, attributes and their interdependence. Moreover, it is…
contactDetails
AFD 2.0 building blocks » Entities » Supporting entities » contactDetails
Entity: contactDetails The contactDetails entity is used for grouping contact details such as email addresses or telephone numbers. Example usage Below is an example contactDetails entity, filled with some attributes. See AFD 2.0 Online for the complete and…
task
AFD 2.0 building blocks » Entities » Supporting entities » task
Entity: task The task entity contains general information about a task for, for example, inspection, appraisal or repair of damage. Example usage Below is an example task entity, filled with some attributes. See AFD 2.0 Online for the complete and up-to-date data…
service
AFD 2.0 building blocks » Entities » Supporting entities » service
Entity: service The service entity gives information about agreements (via subscriptions/contracts) regarding the provision of services such as (financial) advice, mediation and (contract) management. Example usage Below is an example service entity, filled with…
Custom attributes
AFD 2.0 building blocks » Attributes » Custom attributes
Background Standard attributes do not always cover all situations, required by parties or processes. For example the development of a web service for the acceptance and premium calculation of a car insurance policy. In the data catalog of SIVI AFS you can find the…
condition
AFD 2.0 building blocks » Entities » Supporting entities » condition
Entity: condition The condition entity is used for grouping condition-related data, for example policy conditions. The condition entity can also be used for employment-related conditions. Example usage Below is an example condition entity, filled with some…
premium
AFD 2.0 building blocks » Entities » Supporting entities » premium
Entity: premium The premium entity is used for grouping premium-related data. A premium is the amount of money an individual or business must pay for a policy. The premium entity is typically used in conjunction with a policy entity. Example usage Below is an…