Domain Model

This chapter provides an overview of the relevant SAP FS-CD domain entities, their relationship to Faktor Zehn entities and the domain model of the FS-CD Adapter.

SAP FS-CD Concepts

Insurance Object (IO)

Groups receivables and payments related to a specific policy, claim, or commission contract. References business partners and payment method details such as bank account information.

Business Partner (BP)

A natural or legal person that can assume various roles in business transactions, such as policyholder, premium payer, payee, or broker. An insurance object is associated with one or multiple business partners.

Document

Represents an accounting record in SAP FS-CD that FS-CD creates from postings transferred by the FS-CD Adapter.

For comprehensive details about the SAP FS-CD domain model, refer to the official SAP FS-CD documentation.

Relationship Between Faktor Zehn Entities and Insurance Objects

The following table shows how Faktor Zehn entities map to FS-CD insurance objects:

Faktor Zehn Entity Relationship to FS-CD Insurance Object Main Business Partner Alternative Business Partner

Policy

One Insurance Object per policy in IPM

Policyholder

Premium payer (if different from policyholder)

Claim Reserve

One Insurance Object for all reserves of a claim in ICS

Policyholder

-

Claim Payment

One Insurance Object for all payments of a claim in ICS

Policyholder

Payee (if different from policyholder)

Claim Receivable

One Insurance Object per receivable of a claim in ICS

Policyholder

-

Commission

One Insurance Object per commission contract

Broker or agent

-

See Default Assignment Logic for how insurance object numbers are assigned.

FS-CD Adapter Domain Model

The FS-CD Adapter provides a simplified domain model that abstracts SAP FS-CD complexity. The adapter maps domain objects to and from the SAP domain model during read and write operations.

The following diagram depicts the classes:

adapter domain

Additional Explanations

SepaMandateCreation

Represents a SEPA direct debit mandate for creation, associated with an insurance object.

SepaMandate

Represents a SEPA direct debit mandate for reading.

BusinessLock

Represents a financial hold on an insurance object or document that prevents or restricts payment processing.

Posting

Represents a financial transaction (debit or credit) to record in SAP FS-CD.

Document

Represents an accounting record in SAP FS-CD that FS-CD creates from postings.

InsuranceObject

Represents an insurance object to create in SAP FS-CD and groups documents.

InsuranceObjectInfo

Represents an insurance object with a subset of fields for reading basic information about multiple insurance objects.

InsuranceObjectDetail

Represents an insurance object with comprehensive information for detailed reads.

AccountBalance

Provides balance information for an insurance object.

DunningInfo

Contains dunning (collection) information for overdue payments on an insurance object.

Reference

Encapsulates SAP object identifiers and references

Result

Encapsulates the result of an SAP API call with success/error information