openapi: 3.0.2 info: title: Interhyp Submission commands logbook API version: 2.0.0 contact: name: Interhyp AG (Team Provider Excellence) email: support_submission_api@interhyp.de license: name: Interhyp AG description: '### This document describes the RESTful API and resources provided by Interhyp AG.
The RESTful API provides access to resources associated to submission process via *URI* paths, a client application will make an HTTP request using standard HTTP methods like *GET, PUT, POST and DELETE* and parse the response in *JSON* format.
### API Audience
The API is intended to be consumed by clients who want to integrate Interhyp submission process in their own workflow. + **Bank Partners** ### API design Principles
During API design a set of principles were taken into consideration. + **API First** + **Mobile First** ### API client
As an API client you should adhere to the following robustness principle
+ **Tolerant Reader** Be tolerant with unknown fields in the payload. This is required to avoid new API versions if new fields were added, i.e. ignore new fields but do not eliminate them from payload if needed for subsequent *PUT* requests
+ Be prepared to handle HTTP status codes not explicitly specified in endpoint definitions.'
servers:
- url: https://api-test.interhyp.de/submission
description: Test-Staging
- url: https://api.interhyp.de/submission
description: Production
security:
- BearerAuth: []
tags:
- name: logbook
description: provides endpoints to access submission logbook
paths:
/submissions/{submissionId}/logbook:
get:
summary: Get submission logbook entries
description: Delivers detailed information about logbook entries associated with a specific submission.
operationId: getLogbookBySubmissionId
tags:
- logbook
parameters:
- $ref: '#/components/parameters/submission-id'
responses:
'200':
description: Submission logbook entries are returned
content:
application/json:
schema:
$ref: '#/components/schemas/SubmissionLogbook'
'400':
description: Error indicates missing or wrong request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'401':
description: Error indicates no access to the required resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthProblem'
'404':
description: Error indicates that a requested submission resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'500':
description: Unexpected Error
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
components:
schemas:
DefaultLogbookEntry:
allOf:
- $ref: '#/components/schemas/BaseLogbookEntry'
SavingsPlanTimeline:
type: object
properties:
startDate:
description: 'DE: Sparbeginn.
EN: Saving start date.
'
$ref: '#/components/schemas/ISODate'
endDate:
description: 'DE: Datum letzter Sparbeitrag.
EN: The end date of the savings phase.
'
$ref: '#/components/schemas/ISODate'
duration:
description: 'DE: Voraussichtliche Anspardauer.
EN: Expected saving duration.
'
$ref: '#/components/schemas/Duration'
AuxiliaryLoan:
description: 'DE: Information zum Nachrangdarlehen.
EN: Information about the auxiliary loan.
'
type: object
required:
- product
allOf:
- $ref: '#/components/schemas/BaseLoan'
properties:
annuityDetails:
$ref: '#/components/schemas/AnnuityDetails'
product:
$ref: '#/components/schemas/AuxProductType'
UploadedDocumentTypeKey:
type: string
example: CONTRACT
x-extensible-enum:
- CONTRACT
- CONTRACT_ADDENDA
- LAND_REGISTER_EXTRACT
- PAYOUT_REQUIREMENT
- OTHER
Contact:
type: object
properties:
phoneNumbers:
type: array
items:
$ref: '#/components/schemas/Phone'
email:
type: string
description: 'DE: E-Mail des Antragstellers
EN: E-Mail of the customer
'
example: primary@example.com
PersonName:
type: object
required:
- gender
- firstName
- lastName
properties:
gender:
type: string
description: 'DE: Geschlecht der Person (nicht abschließende Aufzählung), z. B. M=männlich, F=weiblich, D=divers, UNSPECIFIED.
EN: Open ended enum contains gender of the person, possible values are M=male, F=female, D=diverse, UNSPECIFIED.
'
x-extensible-enum:
- M
- F
- D
- UNSPECIFIED
title:
$ref: '#/components/schemas/Title'
firstName:
type: string
description: 'DE: Vorname der Person.
EN: First name of the person.
'
lastName:
type: string
description: 'DE: Nachname der Person.
EN: Last name of the person.
'
maidenName:
type: string
description: 'DE: Geburtsname der Person.
EN: Maiden name of the person.
'
InterestMaturity:
oneOf:
- $ref: '#/components/schemas/VariableInterestMaturity'
- $ref: '#/components/schemas/FixedInterestMaturity'
discriminator:
propertyName: type
mapping:
VARIABLE: '#/components/schemas/VariableInterestMaturity'
FIXED_PERIOD: '#/components/schemas/FixedInterestMaturity'
AssignProcessorLogbookEntry:
type: object
description: 'DE: Ein Logbucheintrag mit Informationen zu dem neu zugewiesenen Bearbeiter.
EN: A logbook entry holds information about assigning a loan partner processor to the submission.
'
allOf:
- $ref: '#/components/schemas/BaseLogbookEntry'
properties:
assignedTo:
$ref: '#/components/schemas/UserData'
AcceptedCounterOfferLogbookEntryDetails:
type: object
description: Accepted counter offer submission logbook entry details
required:
- id
allOf:
- $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails'
properties:
id:
$ref: '#/components/schemas/SubmissionCounterOfferId'
RefuseSignContractReason:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/RefuseSignContractReasonKey'
SuspendedAmortizationDetails:
type: object
required:
- rateType
description: 'DE: Information zum Tilgungssurrogat.
EN: Information about the repayment surrogate.
'
allOf:
- $ref: '#/components/schemas/BaseRateDetails'
properties:
type:
$ref: '#/components/schemas/SuspendedRepaymentProductType'
sum:
description: 'DE: Tilgungsbetrag.
EN: Amortisation sum.
'
$ref: '#/components/schemas/EuroAmount'
contractSignedWith:
description: 'DE: Referenz zu den Antragsteller der den Vetrag unterschrieben hat.
EN: Reference to the applicant who signed the contract.
'
$ref: '#/components/schemas/ApplicantIdRef'
contractDuration:
description: 'DE: Vertragsdauer.
EN: Contract duration.
'
$ref: '#/components/schemas/Duration'
upcomingPayments:
$ref: '#/components/schemas/UpcomingPayments'
savingBurden:
$ref: '#/components/schemas/PeriodicalEuroAmount'
depositValue:
$ref: '#/components/schemas/EuroAmount'
contractNumber:
description: 'DE: Vertragsnummer.
EN: Contract number.
'
type: string
combinedProduct:
$ref: '#/components/schemas/SuspendedAmortizationCombinedProduct'
debtId:
description: Id of an existing mortgage saving plan
$ref: '#/components/schemas/DebtId'
amortizationProvider:
description: Amortization product in case of mortgage saving plan or company providing life insurance in case of life insurance
type: string
homePurchaseSavingProvider:
$ref: '#/components/schemas/HomePurchaseSavingProvider'
externalId:
description: id (projection id) used to identify the product used as a suspended amortization in the bank external system
type: string
Title:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/TitleKey'
Phone:
type: object
required:
- phoneNumber
- type
properties:
phoneNumber:
type: string
description: 'DE: Mobil- oder Festnetztelefonnummer des Antragstellers.
EN: Mobile or landline telephone number of the customer.
'
example: +49 160 123456
type:
$ref: '#/components/schemas/PhoneType'
reachable:
$ref: '#/components/schemas/PhoneReachability'
UnavailableEquity:
type: object
required:
- investmentType
- investmentAmount
description: 'DE: Information zur Zwischenfinanzierung in Zusammenhang mit nicht verfügbaren Eigenkapital.
EN: Bridging Debt associated with unavailable equity
'
allOf:
- $ref: '#/components/schemas/BaseBridgingLoanDetails'
properties:
investmentType:
description: 'DE: Art der Kapitalbeteiligung.
EN: Type of the equity investment.
'
type: string
investmentCompany:
description: 'DE: Unternehmen in welches das Kapital investiert wurde.
EN: Company in which the equity is invested.
'
type: string
investmentAmount:
description: 'DE: Investionsbetrag.
EN: Investment amount.
'
$ref: '#/components/schemas/EuroAmount'
LoanId:
type: object
description: 'DE: ID des Darlehens.
EN: Loan identifier.
'
properties:
value:
type: string
PublicPreFinancing:
type: object
required:
- amount
- type
description: 'DE: Information zu einem Zwischenfinanzierung in Zusammenhang mit einer öffentlichen Vorfinanzierung.
EN: Bridging debt associated with public pre-financing.
'
allOf:
- $ref: '#/components/schemas/BaseBridgingLoanDetails'
properties:
type:
description: 'DE: Art der öffentlichen Vorfinanzierung.
EN: Type of the public pre financing.
'
type: string
company:
description: 'DE: Unternehmen, welches die öffentlichen Vorfinanzierung bereitgestellt hat.
EN: Company that provided the pre-financing.
'
type: string
amount:
description: 'DE: Vorfinanzierungsbetrag.
EN: Pre-financing amount.
'
$ref: '#/components/schemas/EuroAmount'
RegularPayment:
description: 'DE: Information über den regulären Zahlungen.
EN: Information about regular payment.
'
type: object
properties:
paymentTime:
$ref: '#/components/schemas/PaymentTime'
freePeriod:
description: 'DE: Tilgungsfreie Anlaufzeit.
EN: Amortisation-free period.
'
$ref: '#/components/schemas/Duration'
amount:
description: 'DE: Rate in der tilgungsfreien Anlaufzeit.
EN: Amortisation during amortisation-free period.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
amountAfterFreePeriod:
description: 'DE: Rate nach Ablauf der tilgungsfreien Anlaufzeit.
EN: Rate after amortisation-free period.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
PauseReason:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/PauseReasonKey'
MainLoanAdditionalInfo:
type: object
description: 'DE: Zustzäliche Information zum Hauptdarlehen.
EN: Additional informations for main loan.
'
properties:
conditionDetails:
type: array
description: 'DE: Zusätzliche Konditionsdetails für das Hauptdarlehen (Schlüssel-Werte Paar).
EN: Additional condition details for the main loan (key-value pairs).
'
items:
$ref: '#/components/schemas/AdditionalInfo'
provisionDetails:
type: array
description: 'DE: Zusätzliche Provisionsdetails für das Hauptdarlehen (Schlüssel-Werte Paar).
EN: Additional commission (provision) details for the main loan (key-value pairs).
'
items:
$ref: '#/components/schemas/AdditionalInfo'
CreditPhaseTimeline:
type: object
properties:
amortisationStartDate:
description: 'DE: Tilgungsbeginn.
EN: The date on which the amortisation starts.
'
$ref: '#/components/schemas/ISODate'
amortisationEndDate:
description: 'DE: Tilgungsende.
EN: The date on which the amortisation end.
'
$ref: '#/components/schemas/ISODate'
duration:
description: 'DE: Voraussichtliche Kreditsdaur.
EN: credit phase duration.
'
$ref: '#/components/schemas/Duration'
SubmissionStatusChangedLogbookEntry:
type: object
allOf:
- $ref: '#/components/schemas/BaseLogbookEntry'
properties:
details:
$ref: '#/components/schemas/SubmissionStatusChangedLogbookEntryDetails'
BaseSpecialRepayment:
type: object
required:
- type
description: 'DE: Information zur Sondertilgung.
EN: Special repayment information.
'
properties:
type:
$ref: '#/components/schemas/SpecialRepaymentType'
discriminator:
propertyName: type
PhoneTypeKey:
type: string
description: 'DE: Art der Telefonnummer (nicht abschließende Aufzählung, zum Beispiel: MOBILE = Mobilfunknummer, LANDLINE = Festnetznummer, UNSPECIFIED = nicht angegeben, MOBILE_WORK= Firmenhandynummer).
EN: Type of the phone number, possible values are MOBILE, LANDLINE, UNSPECIFIED, MOBILE_WORK.
'
x-extensible-enum:
- MOBILE
- LANDLINE
- UNSPECIFIED
- MOBILE_WORK
LogbookEntryType:
type: string
description: 'DE: Art des Logbookentry (nicht abschließende Aufzählung), z.B. (SUBMISSION_CREATED, SUBMISSION_EDITED, DECISION_DATE_UPDATED, UPLOADED_DOCUMENT, STATUS).
EN: open ended enum contains possible logbook entry types, possible values are (SUBMISSION_CREATED, SUBMISSION_EDITED, DECISION_DATE_UPDATED, UPLOADED_DOCUMENT, STATUS).
'
example: UPLOADED_DOCUMENT
x-extensible-enum:
- SUBMISSION_CREATED
- SUBMISSION_EDITED
- SUBMISSION_MIGRATED
- SUBMISSION_CREDIT_LOANS_UPDATED
- LOAN_PARTNER_PROCESSOR_ASSIGNED
- UPLOADED_DOCUMENT
- DECISION_DATE_UPDATED
- STATUS
- SUBMISSION_COUNTER_OFFER_REVOKED
- SUBMISSION_STATUS_CHANGED
- CONTACT_ADVISOR_UPDATED
- LOAN_CONTRACT_NUMBER_UPDATED
- SUBMISSION_DATA_VIOLATIONS_SET
- SUBMISSION_REVOKED
- SUBMISSION_LOAN_PARTNER_DOCUMENT_CREATED
- SUBMISSION_LOAN_PARTNER_DOCUMENT_UPDATED
- SUBMISSION_LOAN_PARTNER_DOCUMENT_DELETED
- LOAN_PARTNER_PROCESSING_UNIT_CHANGED
- SUBMISSION_NOTE_ADDED
DefaultSubmissionStatusChangedLogbookEntryDetails:
allOf:
- $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails'
RevokeSubmissionCounterOfferReasonKey:
type: string
description: 'DE: Grund für den Entzug, mögliche Werte sind COUNTER_OFFER_EXPIRED=Gegenangebot kann nicht mehr aufrechterhalten werden, READJUST_COUNTER_OFFER=Gegenangebot soll nach Rücksprache nochmal angepasst werden, COUNTER_OFFER_NOT_ACCEPTED=Gegenangebot wird nicht angenommen, OTHER=Nicht aufgeführter Grund EN: Reason for revocation, possible values are COUNTER_OFFER_EXPIRED, READJUST_COUNTER_OFFER, COUNTER_OFFER_NOT_ACCEPTED, OTHER
'
example: OTHER
x-extensible-enum:
- COUNTER_OFFER_EXPIRED
- READJUST_COUNTER_OFFER
- COUNTER_OFFER_NOT_ACCEPTED
- OTHER
PercentageSpecialRepayment:
description: 'DE: Sondertilgung in Prozent pro Periode.
EN: Special repayment presented as percent per period.
'
type: object
required:
- percent
allOf:
- $ref: '#/components/schemas/BaseSpecialRepayment'
properties:
description:
description: 'DE: Beschreibung der Sondertilgung.
EN: Special repayment description.
'
type: string
percent:
description: 'DE: Sondertilgung in Prozent.
EN: Payment percent per period.
'
$ref: '#/components/schemas/PeriodicalPercentage'
LoanPartnerProcessingUnitId:
description: 'DE: ID der Einheit des Kreditgebers, welche den Kreditantrag bearbeitet.
EN: Id of the loan partner processing unit.
'
required:
- value
properties:
value:
type: string
SavingsPlanBurdenSpecialPayment:
type: object
required:
- period
- amount
properties:
period:
$ref: '#/components/schemas/SavingsPlanBurdenSpecialPaymentPeriod'
amount:
$ref: '#/components/schemas/EuroAmount'
frequency:
description: 'DE: Häufigkeit der Zahlungen.
EN: Frequency of payments
'
$ref: '#/components/schemas/Cycle'
PeriodicalPercentage:
description: 'DE: Periodischer Prozentsatz als double.
EN: Periodical percentage as double.
'
type: object
required:
- percentage
- cycle
properties:
percentage:
$ref: '#/components/schemas/Percentage'
cycle:
$ref: '#/components/schemas/Cycle'
EuroAmount:
description: 'DE: Euro Betrag as double.
EN: Euro amount as double
'
type: object
required:
- value
properties:
value:
description: 'DE: Betrag.
EN: Value.
'
type: number
format: double
OAuthProblem:
type: object
description: Error while Authentication
required:
- error
- error_description
properties:
error:
type: string
description: Summary of the error type
example: invalid_token
error_description:
type: string
description: Detailed information about the error
example: Access token expired
InterestRateUpdate:
oneOf:
- $ref: '#/components/schemas/AnnuityInterestRateUpdate'
- $ref: '#/components/schemas/BuildingSavingPlanInterestRateUpdate'
discriminator:
propertyName: rateUpdateType
mapping:
ANNUITY: '#/components/schemas/AnnuityInterestRateUpdate'
BUILDING_SAVING_PLAN: '#/components/schemas/BuildingSavingPlanInterestRateUpdate'
DecisionDateLogbookEntry:
type: object
description: 'DE: Ein Logbucheintrag mit Informationen zu dem geänderten Entscheidungsdatum.
EN: A logbook entry holds information about updating submission decision date.
'
allOf:
- $ref: '#/components/schemas/BaseLogbookEntry'
properties:
newDecisionDate:
$ref: '#/components/schemas/ISODate'
SubmissionAdditionalProductsUpdatedLogbookEntryDetails:
type: object
properties:
updatedProducts:
type: array
items:
$ref: '#/components/schemas/SubmissionAdditionalProduct'
minItems: 0
originalProducts:
type: array
items:
$ref: '#/components/schemas/SubmissionAdditionalProduct'
minItems: 0
BaseLogbookEntry:
type: object
required:
- id
- type
description: 'DE: Informationen zu einem Logbucheintrag.
EN: Holds information about a logbook entry.
'
properties:
id:
$ref: '#/components/schemas/LogbookEntryId'
type:
$ref: '#/components/schemas/LogbookEntryType'
createdAt:
description: 'DE: Ein UTC Zeitstempel wann die mit dem Logbucheintrag verknüpfte Aktion ausgelöst wurde.
EN: A UTC date-time indicates when the event associated to the logbook entry took place.
'
$ref: '#/components/schemas/ISODateTime'
createdBy:
description: 'DE: Der Nutzer, welcher die Aktion ausgelöst hat, die zu dem Logbucheintrag führt.
EN: User who triggered the event associated to the logbook entry.
'
$ref: '#/components/schemas/UserData'
remark:
type: string
discriminator:
propertyName: type
ResourceRef:
required:
- href
properties:
href:
type: string
description: 'DE: Link zu einer spezifischen Ressource.
EN: Link to retrieve a specific resource.
'
example: http://some-domain/some/link/to/somewhere
x-skip-camel-case-check: true
ProductTypeKey:
type: string
description: 'DE: Art des Zusatzprodukten.
EN: Enum contains type of the additional product.
'
example: BAU_SPAR
x-extensible-enum:
- A_FONDS
- AU_AL
- BH_HAFTPF
- BAU_SPAR
- BU
- CONTAINER
- DREAD_DIS
- FONDS_HYP
- FONDS_LV
- FONDS_RV
- FONDS_SPAR
- GES_FOND
- GIRO
- GFV
- GRUND
- HAFTPFL
- HAUSRAT
- HYPO
- BSCHUTZ
- INVEST
- VERK_LVRV
- KAPITAL_LV
- PENSIONK
- PRIV_KRANK
- CREDIT
- RECHT
- RENTEN
- RES_DEB_INS
- RISIKO_LV
- RURUP_RIEST
- SOLAR
- TEDDY
- UNFALL
- BUI
- PREPAY_HARD
- PREPAY_RELO
- PREPAY_DIV
- OTHER
DebtId:
type: object
description: 'DE: ID der Verbindlichkeit.
EN: ID of the associated Debt.
'
required:
- value
properties:
value:
type: string
OpenPropertySale:
type: object
description: 'DE: Information zur Zwischenfinanzierung in Zusammenhang mit einem Immobilienverkauf.
EN: Information about bridging debt associated with property sale.
'
allOf:
- $ref: '#/components/schemas/BaseBridgingLoanDetails'
properties:
debtAmount:
description: 'DE: Aktuelle Grundschuldhöhe.
EN: Current debt amount.
'
$ref: '#/components/schemas/EuroAmount'
residualDebt:
description: 'DE: Aktuelle Restschuld.
EN: Current remaining debt.
'
$ref: '#/components/schemas/EuroAmount'
AnnuityDetails:
description: 'DE: Detaillierte Information über das Annuitätsdarlehen.
EN: Detailed information about periodic loan.
'
type: object
required:
- rateType
allOf:
- $ref: '#/components/schemas/BaseRateDetails'
properties:
amortisationRate:
description: 'DE: Tilgungsrate (Prozent pro Periode).
EN: Amortisation rate (percent per period).
'
$ref: '#/components/schemas/PeriodicalPercentage'
fullAmortizer:
type: boolean
description: 'DE: Volltilger.
EN: Full Amortizer.
'
ExternalProcessingReason:
type: string
description: 'EN: Open ended enum contains possible reasons for external processing (EXTERNAL_EXPERT_ASSESSMENT, INTERNAL_EXPERT_ASSESSMENT, DECISION_INTERNAL_UNIT, CONTRACT_CREATION, FORWARD_FINAL_DECISION, REJECT_NOTICE, WAITING_FOR_ORIGINAL_CONTRACT, OTHER) DE: Mögliche Gruende fur das Warten auf externe Faktoren (EXTERNAL_EXPERT_ASSESSMENT=Externes Gutachten, INTERNAL_EXPERT_ASSESSMENT=Internes Gutachten, DECISION_INTERNAL_UNIT=Entscheidung Marktfolge, CONTRACT_CREATION=Vertragserstellung, FORWARD_FINAL_DECISION=Weitergabe finale Genehmigung, REJECT_NOTICE=Ablehnungsankündigung, WAITING_FOR_ORIGINAL_CONTRACT=Warten auf Vertragsoriginal, OTHER=Nicht aufgeführter Grund)
'
example: OTHER
x-extensible-enum:
- EXTERNAL_EXPERT_ASSESSMENT
- INTERNAL_EXPERT_ASSESSMENT
- DECISION_INTERNAL_UNIT
- CONTRACT_CREATION
- FORWARD_FINAL_DECISION
- REJECT_NOTICE
- WAITING_FOR_ORIGINAL_CONTRACT
- OTHER
RejectedCounterOfferLogbookEntryDetails:
type: object
required:
- id
allOf:
- $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails'
properties:
id:
$ref: '#/components/schemas/SubmissionCounterOfferId'
reason:
$ref: '#/components/schemas/RejectSubmissionCounterOfferReason'
KfwProgram:
type: object
properties:
key:
deprecated: true
description: '@deprecated: Use field type for the program instead.
'
$ref: '#/components/schemas/KfwProgramKey'
type:
$ref: '#/components/schemas/KfwProgramType'
ContractCanceledStatusLogbookEntryDetails:
type: object
allOf:
- $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails'
properties:
reason:
$ref: '#/components/schemas/CancelContractReason'
cancellationDate:
$ref: '#/components/schemas/ISODate'
CreditPhaseBurden:
type: object
properties:
creditBurden:
description: 'DE: Darlehensrate.
EN: The credit rate.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
lastCreditBurden:
description: 'DE: Schlussrate.
EN: The last credit rate.
'
$ref: '#/components/schemas/EuroAmount'
totalRatesPayed:
description: 'DE: Zins- und Tilgungsbeiträge insgesamt (inkl. Sondertilgungen).
EN: Sum of all payments made during credit phase.
'
$ref: '#/components/schemas/EuroAmount'
numberOfCreditBurdens:
description: 'DE: Anzahl der Zins- und Tilgungsbeiträge (inkl. Schlussrate).
EN: Number of payed burdens including the last one.
'
type: integer
format: int32
CreditPhasePayout:
properties:
amount:
description: 'DE: Bauspardarlehenssumme.
EN: The loan amount in EUR that is provided by the Bausparkasse.
'
$ref: '#/components/schemas/EuroAmount'
payoutDate:
description: 'DE: Datum der Auszahlungsdatum.
EN: The date on which the credit is paid out.
'
$ref: '#/components/schemas/ISODate'
RejectReason:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/RejectReasonKey'
ApplicantId:
type: object
required:
- value
properties:
value:
description: 'DE: Id des Antragstellers.
EN: Id of the applicant.
'
type: string
example: '1'
LoanPartnerQueueId:
type: object
required:
- value
description: 'DE: ID der loan parnter queue.
EN: Loan partner queue id.
'
properties:
value:
type: string
LogbookEntryId:
type: object
properties:
value:
type: string
TextSpecialRepayment:
description: 'DE: Sondertilgung in Textform.
EN: Special repayment presented as text.
'
type: object
required:
- text
allOf:
- $ref: '#/components/schemas/BaseSpecialRepayment'
properties:
text:
description: 'DE: Sondertilgung in Textform.
EN: Special repayment in text format.
'
type: string
AuxProductType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/AuxProductTypeKey'
LoanPartnerQueue:
type: object
required:
- id
description: 'DE: Informationen zur Kredigeber Warteschlange. EN: Information about loan partner queue.
'
properties:
id:
description: 'DE: ID der Kredigeber Warteschlange.
EN: Loan partner queue id.
'
$ref: '#/components/schemas/LoanPartnerQueueId'
name:
description: 'DE: Name der Kredigeber Warteschlange. EN: Name of the loan partner queue.
'
type: string
description:
description: 'DE: Beschreibung der Kreditgeber Warteschlange: EN: Description of the loan partner queue.
'
type: string
SubmissionRevokedReason:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/SubmissionRevokedReasonKey'
AdditionalInfo:
type: object
description: 'DE: Zusätzliche Information als Schlüssel-Wert Paar.
EN: Additional Information as key-value pairs.
'
properties:
key:
type: string
value:
type: string
CreditLoanId:
type: object
description: 'DE: Id der Finanzierungsstruktur.
EN: Credit Loan identifier.
'
required:
- value
properties:
value:
type: string
KfwProgramType:
type: string
description: 'DE: KFW-Förderprogramm (nicht abschließende Aufzählung), z.B. KFW_124, KFW_151, KFW_152, KFW_153, KFW_159, KFW_167.
EN: Open ended enum contains possible programs for Kfw, i.e. KFW_124, KFW_151, KFW_152, KFW_153, KFW_159, KFW_167.
'
example: KFW_124
x-extensible-enum:
- KFW_124
- KFW_151
- KFW_152
- KFW_153
- KFW_159
- KFW_167
- KFW_261
- KFW_262
- KFN_297
- KFN_QNG_297
- KFN_298
- KFN_QNG_298
- WEP_300
- WEP_QNG_300
- WEP_JKA_308
- KFW_358
- KFW_359
- KNN_296
- UNKNOWN
SavingsPlanInterest:
type: object
properties:
interestRate:
description: 'DE: Guthabenzinssatz.
EN: interest rate.
'
$ref: '#/components/schemas/PeriodicalPercentage'
interestAccumulated:
description: 'DE: Guthabenzinsen insgesamt.
EN: The savings interest accumulated.
'
$ref: '#/components/schemas/EuroAmount'
HomePurchaseSavingProviderKey:
type: string
example: OTHER
description: Home purchase saving plan provider (BHWDISPO - BHW, DEUTDEFF - Deutsche Bank, ALTEDEFA - Alte Leipziger, LBS - LBS, BSWLDE - Wüstenrot, STARTBS - start:bausparkasse)
x-extensible-enum:
- BHWDISPO
- ALTEDEFA
- DEUTDEFF
- LBS
- BSWLDE
- STARTBS
- OTHER
ApplicantIdRef:
type: object
description: 'DE: Id und Referenz des Antragstellers.
EN: Id and reference of the applicant.
'
properties:
_href:
x-skip-camel-case-check: true
$ref: '#/components/schemas/ResourceRef'
applicantId:
$ref: '#/components/schemas/ApplicantId'
SubmissionLogbookEntry:
oneOf:
- $ref: '#/components/schemas/DefaultLogbookEntry'
- $ref: '#/components/schemas/AssignProcessorLogbookEntry'
- $ref: '#/components/schemas/DocumentLogbookEntry'
- $ref: '#/components/schemas/DecisionDateLogbookEntry'
- $ref: '#/components/schemas/CounterOfferRevokedLogbookEntry'
- $ref: '#/components/schemas/SubmissionStatusChangedLogbookEntry'
- $ref: '#/components/schemas/ContactAdvisorUpdatedLogbookEntry'
- $ref: '#/components/schemas/LoanContractNumberUpdatedLogbookEntry'
- $ref: '#/components/schemas/SubmissionDataViolationsLogbookEntry'
- $ref: '#/components/schemas/RevokedSubmissionLogbookEntry'
- $ref: '#/components/schemas/SubmissionLoanPartnerDocumentLogbookEntry'
- $ref: '#/components/schemas/LoanPartnerProcessingUnitChangedLogbookEntry'
- $ref: '#/components/schemas/SubmissionAdditionalProductsUpdatedLogbookEntry'
discriminator:
propertyName: type
mapping:
SUBMISSION_CREATED: '#/components/schemas/DefaultLogbookEntry'
SUBMISSION_EDITED: '#/components/schemas/DefaultLogbookEntry'
SUBMISSION_NOTE_ADDED: '#/components/schemas/DefaultLogbookEntry'
SUBMISSION_CREDIT_LOANS_UPDATED: '#/components/schemas/DefaultLogbookEntry'
SUBMISSION_MIGRATED: '#/components/schemas/DefaultLogbookEntry'
LOAN_PARTNER_PROCESSOR_ASSIGNED: '#/components/schemas/AssignProcessorLogbookEntry'
UPLOADED_DOCUMENT: '#/components/schemas/DocumentLogbookEntry'
DECISION_DATE_UPDATED: '#/components/schemas/DecisionDateLogbookEntry'
SUBMISSION_COUNTER_OFFER_REVOKED: '#/components/schemas/CounterOfferRevokedLogbookEntry'
SUBMISSION_STATUS_CHANGED: '#/components/schemas/SubmissionStatusChangedLogbookEntry'
CONTACT_ADVISOR_UPDATED: '#/components/schemas/ContactAdvisorUpdatedLogbookEntry'
LOAN_CONTRACT_NUMBER_UPDATED: '#/components/schemas/LoanContractNumberUpdatedLogbookEntry'
SUBMISSION_DATA_VIOLATIONS_SET: '#/components/schemas/SubmissionDataViolationsLogbookEntry'
SUBMISSION_REVOKED: '#/components/schemas/RevokedSubmissionLogbookEntry'
SUBMISSION_LOAN_PARTNER_DOCUMENT_CREATED: '#/components/schemas/SubmissionLoanPartnerDocumentLogbookEntry'
SUBMISSION_LOAN_PARTNER_DOCUMENT_UPDATED: '#/components/schemas/SubmissionLoanPartnerDocumentLogbookEntry'
SUBMISSION_LOAN_PARTNER_DOCUMENT_DELETED: '#/components/schemas/SubmissionLoanPartnerDocumentLogbookEntry'
LOAN_PARTNER_PROCESSING_UNIT_CHANGED: '#/components/schemas/LoanPartnerProcessingUnitChangedLogbookEntry'
ADDITIONAL_PRODUCTS_UPDATED: '#/components/schemas/SubmissionAdditionalProductsUpdatedLogbookEntry'
SpecialRepayment:
oneOf:
- $ref: '#/components/schemas/PercentageSpecialRepayment'
- $ref: '#/components/schemas/TextSpecialRepayment'
discriminator:
propertyName: type
mapping:
PERCENTAGE: '#/components/schemas/PercentageSpecialRepayment'
TEXT: '#/components/schemas/TextSpecialRepayment'
KfwCallType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/KfwCallTypeKey'
PhoneReachabilityKey:
type: string
description: 'DE: Erreichbarkeit unter dieser Telefonnumer (nicht abschließende Aufzählung, zum Beispiel: DAYTIME = tagsüber, EVENING = abends).
EN: Reachable by this phone number, possible values are DAYTIME, EVENING.
'
x-extensible-enum:
- DAYTIME
- EVENING
BaseLoan:
type: object
description: 'DE: Information zum Darlehen(-objekt).
EN: Information about the financial loan.
'
required:
- id
- type
- amount
- loanPartner
properties:
id:
$ref: '#/components/schemas/LoanId'
seq:
type: integer
format: int32
deprecated: true
description: '@deprecated: Use field id for identification instead.
'
type:
$ref: '#/components/schemas/LoanType'
amount:
description: 'DE: Darlehnsbetrag (per Tranche).
EN: Loan amount (for loan component).
'
$ref: '#/components/schemas/EuroAmount'
maturity:
description: 'DE: Information zur Sollzinsbindung.
EN: Information about interest rate maturity.
'
$ref: '#/components/schemas/InterestMaturity'
specialRepayment:
$ref: '#/components/schemas/SpecialRepayment'
payout:
$ref: '#/components/schemas/PayoutInfo'
duration:
description: 'DE: Darlehensdauer/Gesamtlaufzeit.
EN: Loan duration.
'
$ref: '#/components/schemas/Duration'
loanPartner:
description: Please use the loanPartnerId instead.
deprecated: true
$ref: '#/components/schemas/LoanPartnerProcessingUnit'
loanPartnerId:
$ref: '#/components/schemas/CompanyId'
financedMortgageProperty:
description: 'DE: Referenz zu einem Beleihungsobjekt.
EN: Reference to a lending object.
'
$ref: '#/components/schemas/EstateRef'
contractNumber:
type: string
description: 'DE: Darlehensnummer / Vertragsnummer.
EN: Loan number / contract number.
'
commission:
$ref: '#/components/schemas/CommissionInfo'
isSecuredByLandRegister:
type: boolean
description: 'DE: Ist das Darlehen grundpfandrechtlich besichert?
EN: Is the loan secured by land register?
'
commitmentInterest:
description: 'DE: Bereitstellungszins.
EN: Periodical commitment interest rate.
'
$ref: '#/components/schemas/PeriodicalPercentage'
eHypCent:
description: 'DE: Platformnutzungsgebühr .
EN: Platform usage fees.
'
$ref: '#/components/schemas/EuroAmount'
isForwardLoan:
type: boolean
discriminator:
propertyName: type
MainLoan:
description: 'DE: Information zum Hauptdarlehen.
EN: Information about the main loan.
'
type: object
required:
- product
allOf:
- $ref: '#/components/schemas/BaseLoan'
properties:
product:
$ref: '#/components/schemas/MainProduct'
rateDetails:
description: 'DE: Detailinformation zu den Raten.
EN: Detailed information about the rates.
'
$ref: '#/components/schemas/RateDetails'
additionalInfo:
$ref: '#/components/schemas/MainLoanAdditionalInfo'
SavingsPlanFees:
type: object
properties:
accountFee:
description: 'DE: Kontoführungsgebühr.
EN: Account maintenance fee.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
closingFee:
description: 'DE: Abschlussgebühr für das Produkt.
EN: Acquisition fee for the product.
'
$ref: '#/components/schemas/EuroAmount'
payedFees:
description: 'DE: Gebühren insgesamt.
EN: The sum of all the fees payed in the savings phase.
'
$ref: '#/components/schemas/EuroAmount'
SubmissionStatusChangedLogbookEntryDetails:
oneOf:
- $ref: '#/components/schemas/ContractDeliveredStatusLogbookEntryDetails'
- $ref: '#/components/schemas/ContractSignedStatusLogbookEntryDetails'
- $ref: '#/components/schemas/ContractCanceledStatusLogbookEntryDetails'
- $ref: '#/components/schemas/ExternalProcessingAwaitedLogbookEntryDetails'
- $ref: '#/components/schemas/SubmissionProcessingPausedStatusLogbookEntryDetails'
- $ref: '#/components/schemas/DefaultSubmissionStatusChangedLogbookEntryDetails'
- $ref: '#/components/schemas/SubmissionProcessingResumedStatusLogbookEntryDetails'
- $ref: '#/components/schemas/RejectSubmissionStatusChangedLogbookEntryDetails'
- $ref: '#/components/schemas/CreatedCounterOfferLogbookEntryDetails'
- $ref: '#/components/schemas/AcceptedCounterOfferLogbookEntryDetails'
- $ref: '#/components/schemas/RejectedCounterOfferLogbookEntryDetails'
- $ref: '#/components/schemas/ContractSignRefusedStatusLogbookEntryDetails'
discriminator:
propertyName: type
mapping:
CONTRACT_DELIVERED: '#/components/schemas/ContractDeliveredStatusLogbookEntryDetails'
CONTRACT_SIGNED: '#/components/schemas/ContractSignedStatusLogbookEntryDetails'
CONTRACT_CANCELED: '#/components/schemas/ContractCanceledStatusLogbookEntryDetails'
AWAIT_EXTERNAL_PROCESSING: '#/components/schemas/ExternalProcessingAwaitedLogbookEntryDetails'
PROCESSING_PAUSED: '#/components/schemas/SubmissionProcessingPausedStatusLogbookEntryDetails'
INWORK: '#/components/schemas/DefaultSubmissionStatusChangedLogbookEntryDetails'
APPROVED: '#/components/schemas/DefaultSubmissionStatusChangedLogbookEntryDetails'
REJECTED_AND_CLOSED: '#/components/schemas/DefaultSubmissionStatusChangedLogbookEntryDetails'
PROCESSING_RESUMED: '#/components/schemas/SubmissionProcessingResumedStatusLogbookEntryDetails'
CANCELED: '#/components/schemas/DefaultSubmissionStatusChangedLogbookEntryDetails'
CONFIRMED: '#/components/schemas/DefaultSubmissionStatusChangedLogbookEntryDetails'
REJECTION_REVOKED: '#/components/schemas/DefaultSubmissionStatusChangedLogbookEntryDetails'
REJECTED: '#/components/schemas/RejectSubmissionStatusChangedLogbookEntryDetails'
COUNTER_OFFER_CREATED: '#/components/schemas/CreatedCounterOfferLogbookEntryDetails'
COUNTER_OFFER_ACCEPTED: '#/components/schemas/AcceptedCounterOfferLogbookEntryDetails'
COUNTER_OFFER_REJECTED: '#/components/schemas/RejectedCounterOfferLogbookEntryDetails'
CONTRACT_SIGN_REFUSED: '#/components/schemas/ContractSignRefusedStatusLogbookEntryDetails'
BridgingFinancingMainProduct:
type: object
description: 'DE: Information zur Zwischenfinanzierung im Annuitätendarlehen.
EN: Information on the bridging financing product in the annuity product.
'
allOf:
- $ref: '#/components/schemas/BaseMainProduct'
properties:
details:
$ref: '#/components/schemas/BridgingLoanDetails'
ISODateTime:
description: 'DE: Datum, Syntax nach RFC 3339
EN: Date according to RFC 3339
'
type: string
format: date-time
nullable: true
example: 2019-12-29 10:22:50+00:00
RejectSubmissionStatusChangedLogbookEntryDetails:
type: object
allOf:
- $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails'
properties:
reason:
$ref: '#/components/schemas/RejectReason'
solution:
type: string
SubmissionCounterOffer:
type: object
properties:
id:
$ref: '#/components/schemas/SubmissionCounterOfferId'
offeredLoans:
type: array
items:
$ref: '#/components/schemas/CreditLoan'
validUntil:
$ref: '#/components/schemas/ISODate'
offerDate:
$ref: '#/components/schemas/ISODate'
AnnuityInterestRateUpdate:
description: details of annuity interest rate update
type: object
allOf:
- $ref: '#/components/schemas/BaseInterestRateUpdate'
properties:
baseInterestRate:
$ref: '#/components/schemas/InterestRate'
amortizationRate:
$ref: '#/components/schemas/PeriodicalPercentage'
Percentage:
description: 'DE: Prozentsatz als double.
EN: Percentage as double.
'
type: object
required:
- value
properties:
value:
description: 'DE: Prozentsatz.
EN: Percentage.
'
type: number
format: double
BaseInterestRateUpdate:
type: object
required:
- rateUpdateType
properties:
rateUpdateType:
type: string
x-extensible-enum:
- ANNUITY
- BUILDING_SAVING_PLAN
discriminator:
propertyName: rateUpdateType
Cycle:
description: 'DE: Wrapper für Zykluswerte
EN: Wrapper for cycle values.
'
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/CycleKey'
VariableInterestMaturity:
description: 'DE: Information über die variable Sollzinsbindung.
EN: Information about variable interest rate maturity.
'
type: object
required:
- type
allOf:
- $ref: '#/components/schemas/BaseInterestMaturity'
MainProductType:
type: string
description: 'DE: Produkttyp des Darlehens (nicht abschließende Aufzählung), z.B. (ANNUITAET=Annuitätendarlehen, W_RIESTER=Wohnriesterdarlehen, ZWIFI=Zwischenfinanzierung, FLEX_PLUS, FLEX, FORWARD, KOMBI, KONSTANT, KONST_KOMBI, VERSICHER, VOLLTILGER, OTHER) EN: open ended enum contains loan product type, possible values are (ANNUITAET, W_RIESTER, ZWIFI, FLEX_PLUS, FLEX, FORWARD, KOMBI, KONSTANT, KONST_KOMBI, VERSICHER, VOLLTILGER, OTHER)
'
example: ANNUITAET
x-extensible-enum:
- ANNUITAET
- W_RIESTER
- ZWIFI
- FLEX_PLUS
- FLEX
- FORWARD
- KOMBI
- KONSTANT
- KONST_KOMBI
- VERSICHER
- VOLLTILGER
- OTHER
LoanPartnerProcessingUnitName:
description: 'DE: Bezeichnung / Name der Einheit des Kreditgebers, welche den Kreditantrag bearbeitet.
EN: Name of the loan partner processing unit.
'
type: object
properties:
value:
type: string
SubmissionAdditionalProductsUpdatedLogbookEntry:
type: object
allOf:
- $ref: '#/components/schemas/BaseLogbookEntry'
properties:
details:
$ref: '#/components/schemas/SubmissionAdditionalProductsUpdatedLogbookEntryDetails'
CreatedCounterOfferLogbookEntryDetails:
type: object
allOf:
- $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails'
properties:
originalComponents:
type: array
items:
$ref: '#/components/schemas/CreditLoan'
offer:
$ref: '#/components/schemas/SubmissionCounterOffer'
SuspendedAmortizationCombinedProduct:
oneOf:
- $ref: '#/components/schemas/SuspendedAmortizationOtherProduct'
- $ref: '#/components/schemas/SuspendedAmortizationBuildingSavingProduct'
discriminator:
propertyName: product
mapping:
OTHER: '#/components/schemas/SuspendedAmortizationOtherProduct'
DT_KAP_LV: '#/components/schemas/SuspendedAmortizationOtherProduct'
DT_KAP_RV: '#/components/schemas/SuspendedAmortizationOtherProduct'
BRIT_KAP_LV: '#/components/schemas/SuspendedAmortizationOtherProduct'
BRIT_KAP_RV: '#/components/schemas/SuspendedAmortizationOtherProduct'
FONDS_LV: '#/components/schemas/SuspendedAmortizationOtherProduct'
FONDS_RV: '#/components/schemas/SuspendedAmortizationOtherProduct'
FONDS_SPAR: '#/components/schemas/SuspendedAmortizationOtherProduct'
BAU_SPAR: '#/components/schemas/SuspendedAmortizationBuildingSavingProduct'
ClosedPropertySale:
description: 'DE: Information zur Zwischenfinanzierung in Zusammenhang mit einem abgeschlossenen Immobilienverkauf.
EN: Bridging debt associated with a closed property sale.
'
allOf:
- $ref: '#/components/schemas/BaseBridgingLoanDetails'
UserData:
type: object
properties:
userId:
$ref: '#/components/schemas/UserId'
name:
$ref: '#/components/schemas/PersonName'
contact:
$ref: '#/components/schemas/Contact'
jobTitle:
type: string
LoanPartnerProcessingUnitChangedLogbookEntry:
type: object
required:
- updatedProcessingUnit
- previousProcessingUnit
allOf:
- $ref: '#/components/schemas/BaseLogbookEntry'
properties:
updatedProcessingUnit:
$ref: '#/components/schemas/ProcessingUnit'
previousProcessingUnit:
$ref: '#/components/schemas/ProcessingUnit'
ContractInfo:
type: object
description: 'DE: Vertragsnummer mit Referenznummer ID.
EN: Contract number and reference id pair.
'
required:
- contractNumber
- loanType
- referenceId
properties:
contractNumber:
type: string
description: 'DE: Darlehensnummer / Vertragsnummer.
EN: Loan number / contract number.
'
referenceId:
$ref: '#/components/schemas/ContractInfoReferenceId'
loanType:
$ref: '#/components/schemas/ContractInfoLoanType'
ContractInfoLoanType:
description: 'DE: Type des Loans dessen Vertragsnummer aktualisiert werden soll.
EN: Type of loan where the contract number should be updated.
'
type: string
x-extensible-enum:
- LOAN
- SUSPENDED_AMORTIZATION_COMBINED_BUILDING_LOAN
- RESIDUAL_DEBT_PROTECTION_BUILDING_SAVING_PLAN
ExtendedContractInfo:
type: object
description: 'DE: Vertragsnummer mit Referenznummer ID.
EN: Contract number and reference id pair with additional loan details.
'
required:
- contractNumber
- loanType
- referenceId
properties:
contractNumber:
type: string
description: 'DE: Darlehensnummer / Vertragsnummer.
EN: Loan number / contract number.
'
referenceId:
$ref: '#/components/schemas/ContractInfoReferenceId'
loanType:
$ref: '#/components/schemas/ContractInfoLoanType'
loanDetails:
$ref: '#/components/schemas/LoanDetails'
SuspendedRepaymentProductTypeKey:
type: string
description: 'DE: Art des Tilgungssurrogats (nicht abschließende Aufzählung), z.B. DT_KAP_LV, DT_KAP_RV, BRIT_KAP_LV, BRIT_KAP_RV, FONDS_LV, FONDS_RV, FONDS_SPAR, BAU_SPAR, OTHER.
EN: Open ended enum contains type of repayment surrogate, possible values are DT_KAP_LV, DT_KAP_RV, BRIT_KAP_LV, BRIT_KAP_RV, FONDS_LV, FONDS_RV, FONDS_SPAR, BAU_SPAR, OTHER.
'
example: DT_KAP_LV
x-extensible-enum:
- DT_KAP_LV
- DT_KAP_RV
- BRIT_KAP_LV
- BRIT_KAP_RV
- FONDS_LV
- FONDS_RV
- FONDS_SPAR
- BAU_SPAR
- OTHER
Company:
description: 'DE: Informationen zu einem Unternehmen. EN: Information of a company.
'
required:
- companyId
properties:
companyId:
$ref: '#/components/schemas/CompanyId'
name:
readOnly: true
$ref: '#/components/schemas/CompanyName'
LoanPartnerProcessingUnit:
type: object
description: 'DE: Informationen zur Einheit des Kreditgebers, welche den Kreditantrag bearbeitet.
EN: Information about the processing unit of the financing partner.
'
required:
- id
deprecated: true
properties:
id:
$ref: '#/components/schemas/LoanPartnerProcessingUnitId'
name:
$ref: '#/components/schemas/LoanPartnerProcessingUnitName'
parentUnit:
description: 'DE: Zeigt die übergeordnete Orginazitioneinheit von der für den Kreditantrag zuständigen Einheit an.
> z.B. Hauptsitz und Filiale einer Bank.
EN: Information about the processing unit hierarchy by establishing a reference to the parent processing unit.
> i.e. Branch as a processing unit can have Bank as a parent processing unit, etc ...
'
$ref: '#/components/schemas/LoanPartnerProcessingUnit'
CompanyName:
type: object
properties:
name:
type: string
BaseSuspendedAmortizationCombinedProduct:
type: object
required:
- product
properties:
product:
$ref: '#/components/schemas/SuspendedRepaymentProductTypeKey'
discriminator:
propertyName: product
UploadedDocumentType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/UploadedDocumentTypeKey'
CycleKey:
type: string
description: 'DE: Mögliche Zykluswerte (nicht abschließende Aufzählung), z.B. MONTHLY, QUARTERLY, HALF_YEARLY, ANNUAL, ONE_TIME.
EN: Open ended enum contains possible cycle values, possible values are MONTHLY, QUARTERLY, HALF_YEARLY, ANNUAL, ONE_TIME.
'
example: ANNUAL
x-extensible-enum:
- MONTHLY
- QUARTERLY
- HALF_YEARLY
- ANNUAL
- ONE_TIME
SubmissionDataViolationSeverityKey:
type: string
x-extensible-enum:
- INFO
- WARN
- ERROR
SubmissionDataViolationsLogbookEntry:
type: object
allOf:
- $ref: '#/components/schemas/BaseLogbookEntry'
properties:
submissionDataViolations:
type: array
items:
$ref: '#/components/schemas/SubmissionDataViolation'
PhoneReachability:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/PhoneReachabilityKey'
Loan:
oneOf:
- $ref: '#/components/schemas/MainLoan'
- $ref: '#/components/schemas/KfwPromotionLoan'
- $ref: '#/components/schemas/AuxiliaryLoan'
discriminator:
propertyName: type
mapping:
MAIN_LOAN: '#/components/schemas/MainLoan'
KFW_PROMOTION_LOAN: '#/components/schemas/KfwPromotionLoan'
AUXILIARY_LOAN: '#/components/schemas/AuxiliaryLoan'
PauseReasonKey:
type: string
x-extensible-enum:
- DOCUMENTS
- INFOS
- BY_CUSTOMER
- ONHOLD
- EXPERTISE
- ORIG_CONTR
- REJ_SOON
- FIN_APPROV
- MIN_DOCS
- OTHER
BridgingLoanDetails:
oneOf:
- $ref: '#/components/schemas/OpenPropertySale'
- $ref: '#/components/schemas/ClosedPropertySale'
- $ref: '#/components/schemas/UnavailableEquity'
- $ref: '#/components/schemas/PublicPreFinancing'
- $ref: '#/components/schemas/ExistingBuildingSavingPlan'
discriminator:
propertyName: reason
mapping:
OPEN_PROPERTY_SALE: '#/components/schemas/OpenPropertySale'
CLOSED_PROPERTY_SALE: '#/components/schemas/ClosedPropertySale'
UNAVAILABLE: '#/components/schemas/UnavailableEquity'
PUBLIC_PRE_FINANCE: '#/components/schemas/PublicPreFinancing'
EXISTING_BUILDING_SAVING_PLAN: '#/components/schemas/ExistingBuildingSavingPlan'
ContactAdvisorUpdatedLogbookEntry:
type: object
allOf:
- $ref: '#/components/schemas/BaseLogbookEntry'
properties:
updatedUserContact:
$ref: '#/components/schemas/UserData'
CreditLoan:
type: object
description: 'DE: Informationen zur Finanzierungsstruktur.
EN: A Credit Loan represents specific financing structure component.
'
properties:
id:
$ref: '#/components/schemas/CreditLoanId'
financingLoans:
type: array
items:
$ref: '#/components/schemas/Loan'
minItems: 1
handover:
$ref: '#/components/schemas/Handover'
UpcomingPayments:
type: object
description: 'DE: Kosten für das Tilgungssurrogat in den Folgeperioden.
EN: Upcoming payments for repayment surrogate product.
'
properties:
upcomingFees:
deprecated: true
description: '@deprecated: Upcoming fees are inadmissible. This was decided by the Federal Court of Justice in its ruling of November 15, 2022.
DE: Höhe der wiederkehrenden Kosten.
EN: Upcoming costs.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
closingFee:
description: 'DE: Abschlussgebühr für das Tilgungssurrogat.
EN: Acquisition fee for the repayment surrogate product.
'
$ref: '#/components/schemas/EuroAmount'
paymentDuration:
description: 'DE: Laufzeit des Tilgungssurrogats.
EN: Duration of the repayment surrogate product.
'
$ref: '#/components/schemas/Duration'
CancelContractReason:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/CancelContractReasonKey'
EstateId:
type: object
required:
- value
description: 'DE: ID der Immobilie.
EN: ID of the estate.
'
properties:
value:
type: string
SubmissionLoanPartnerDocumentLogbookEntry:
type: object
required:
- documentId
allOf:
- $ref: '#/components/schemas/BaseLogbookEntry'
properties:
documentId:
$ref: '#/components/schemas/DocumentId'
documentType:
$ref: '#/components/schemas/UploadedDocumentType'
filename:
type: string
RFC7807Problem:
type: object
title: RFC7807Problem
description: 'DE: Angaben zum zurueckgegebenen Fehler. EN: Holds information on the returned error.
'
required:
- timestamp
- traceId
- instance
- title
- status
properties:
timestamp:
type: string
format: date-time
description: 'DE: Ein UTC-Zeitstempel, der den Fehlerzeitpunkt angibt (https://de.wikipedia.org/wiki/Koordinierte_Weltzeit). EN: A UTC date-time indicating the error timestamp (https://en.wikipedia.org/wiki/Coordinated_Universal_Time).
'
example: 2024-06-29 19:22:50+00:00
type:
type: string
format: uri
description: 'DE: Verknuepfung zum Abruf von mehr Informationen zu dem Fehler. EN: URL referring to more information about the error.
'
default: about:blank
title:
type: string
description: 'DE: Kurzbeschreibung des Fehlers. EN: Error short description.
'
example: Bad Request
status:
type: integer
format: int32
description: 'DE: HTTP-Status-Code gemaess Konvention (https://tools.ietf.org/html/rfc2616#section-10). EN: HTTP status code following standared error codes (https://tools.ietf.org/html/rfc2616#section-10).
'
example: 400
minimum: 100
maximum: 599
detail:
type: string
description: 'DE: Detaillierte Beschreibung des Fehlers. EN: Detailed description for the returned error.
'
example: JSON parse error
traceId:
type: string
description: 'DE: Eindeutige Kennung zur Verfolgung der Anfrage. EN: Unique trace id for problematic request.
'
example: avx1234asd
instance:
type: string
format: uri
description: 'DE: Pfad zur betreffenden Resource. EN: Path of requested resource.
'
example: http://localhost/resources/123
violations:
type: array
description: 'DE: Abfolge der Verstoesse in der Anfrage. EN: Collection of the invalid content of the request.
'
items:
$ref: '#/components/schemas/Violation'
InterestMaturityType:
type: string
description: 'DE: Art der Sollzinsbindung(nicht abschließende Aufzählung), z.B. FIXED_PERIOD, VARIABLE.
EN: Open ended enum contains types of the interest maturity, possible values are FIXED_PERIOD, VARIABLE.
'
example: FIXED_PERIOD
x-extensible-enum:
- FIXED_PERIOD
- VARIABLE
- OTHER
KfwCallTypeKey:
type: string
description: 'DE: Art der KFW-Reservierung (nicht abschließende Aufzählung), z.B. LIGHT, PLUS.
EN: Open ended enum contains Kfw reservation process call type, possible values are LIGHT, PLUS.
'
example: PLUS
x-extensible-enum:
- LIGHT
- PLUS
- OTHER
SuspendedRepaymentProductType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/SuspendedRepaymentProductTypeKey'
CommissionInfo:
type: object
required:
- percent
description: 'DE: Abschließende Information zur Provision.
EN: Complete information about commissions.
'
properties:
percent:
description: 'DE: Provision in Prozent.
EN: Commision in percent.
'
$ref: '#/components/schemas/Percentage'
amount:
description: 'DE: Provisionsbetrag.
EN: Provision amount.
'
$ref: '#/components/schemas/EuroAmount'
HandoverReport:
type: object
description: "DE: Metadaten zur den Einreichungsunterlagen.
\nEN: Metadata regarding the system generated reports for a specific submission.\nHandover reports including but not limited to:\n - Übergabeprotokoll\n\n - Provideranschreiben\n\n - Überarbeiteter Antrag\n\n - Kalkulation\n\n - HH-Rechnung\n"
required:
- name
- description
- createdAt
properties:
name:
type: string
description: 'DE: Bezeichnung der Einreichungsunterlage.
EN: Name of the handover report.
'
description:
type: string
description: 'DE: Kurze Beschreibung der Einreichungsunterlage.
EN: Short description of the handover report.
'
createdAt:
$ref: '#/components/schemas/ISODateTime'
context:
type: array
description: 'DE: Einreichungsunterlage nach Art des Darlehens.
EN: A set of financing structure contexts, which are associated with this handover report (i.e `Main` or `Nachrang` component)..
'
items:
$ref: '#/components/schemas/LoanType'
x-is-plural: true
content:
description: 'DE: Link zur Unterlage als `PDF` Document.
EN: Link to retrieve the content of a specific handover report as `PDF` document.
'
$ref: '#/components/schemas/ResourceRef'
SubmissionRevokedReasonKey:
type: string
description: 'DE: open ended enum enthält mögliche Gründe für den Widerruf der Anmeldung
EN: open ended enum contains possible submission revocation reasons
'
example: TIME
x-extensible-enum:
- TIME
- COND
- DOCS
- NO_OBJECT
- MAIN
- AUX
- WRONG_BID
- ERROR_USE
- ERROR_TEC
- TERMINATION
- REALLOCATION
- OTHER
ProcessingUnit:
description: 'DE: Informationen zur Einheit des Kreditgebers, welche die Einreichung bearbeitet. EN: Id of the loan partner processing unit.
'
required:
- processingUnit
properties:
loanPartnerQueue:
$ref: '#/components/schemas/LoanPartnerQueue'
processingUnit:
description: The current processing unit of a submission. If the processing unit is not provided while creating, the loan partner will be used as processing unit.
$ref: '#/components/schemas/Company'
ContractSignedStatusLogbookEntryDetails:
type: object
allOf:
- $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails'
properties:
contractSignDate:
$ref: '#/components/schemas/ISODate'
contracts:
type: array
items:
$ref: '#/components/schemas/ExtendedContractInfo'
ExternalProcessing:
type: object
description: 'EN: Information regarding the external processing
'
required:
- details
properties:
details:
type: array
minItems: 1
items:
$ref: '#/components/schemas/ExternalProcessingDetail'
estimatedConclusion:
$ref: '#/components/schemas/ISODate'
remark:
type: string
PaymentTimeKey:
type: string
description: 'DE: Mögliche Zahlungszeit-Arten (nicht abschließende Aufzählung), z.B. ADVANCE=Vorschüssig, ARREARS=Nachschüssig.
EN: Open ended enum contains possible payment time types, possible values are ADVANCE, ARREARS.
'
example: ADVANCE
x-extensible-enum:
- ADVANCE
- ARREARS
RevokeSubmissionCounterOfferReason:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/RevokeSubmissionCounterOfferReasonKey'
KfwLoanAdditionalInfo:
type: object
description: 'DE: Zustzäliche Information zum KFW Darlehen.
EN: Additional informations for kfw loan.
'
properties:
provisionDetails:
type: array
description: 'DE: Zusätzliche Provisionsdetails für das KFW Darlehen (Schlüssel-Werte Paar).
EN: Additional commission (provision) details for the kfw loan (key-value pairs).
'
items:
$ref: '#/components/schemas/AdditionalInfo'
MainProduct:
oneOf:
- $ref: '#/components/schemas/RegularMainProduct'
- $ref: '#/components/schemas/BridgingFinancingMainProduct'
discriminator:
propertyName: product
mapping:
ANNUITAET: '#/components/schemas/RegularMainProduct'
W_RIESTER: '#/components/schemas/RegularMainProduct'
ZWIFI: '#/components/schemas/BridgingFinancingMainProduct'
FLEX_PLUS: '#/components/schemas/RegularMainProduct'
FLEX: '#/components/schemas/RegularMainProduct'
FORWARD: '#/components/schemas/RegularMainProduct'
KOMBI: '#/components/schemas/RegularMainProduct'
KONSTANT: '#/components/schemas/RegularMainProduct'
KONST_KOMBI: '#/components/schemas/RegularMainProduct'
VERSICHER: '#/components/schemas/RegularMainProduct'
VOLLTILGER: '#/components/schemas/RegularMainProduct'
OTHER: '#/components/schemas/RegularMainProduct'
RateDetails:
oneOf:
- $ref: '#/components/schemas/AnnuityDetails'
- $ref: '#/components/schemas/SuspendedAmortizationDetails'
discriminator:
propertyName: rateType
mapping:
ANNUITY: '#/components/schemas/AnnuityDetails'
SUSPENDED_AMORTIZATION: '#/components/schemas/SuspendedAmortizationDetails'
AuxProductTypeKey:
type: string
description: 'DE: Typ des Nachrangdarlehens (nicht abschließende Aufzählung), z.B. DSL_PRIVAT, OYAK_ANKER, HANSEATIC_ALL.
EN: Open ended enum contains auxiliary loan product types, possible values are DSL_PRIVAT, OYAK_ANKER, HANSEATIC_ALL.
'
example: HANSEATIC_ALL
x-extensible-enum:
- DSL_PRIVAT
- HANSEATIC_ALL
- OYAK_ANKER
- OTHER
EstateRef:
type: object
required:
- estateId
description: 'DE: Id und Referenz zu der Immobilie.
EN: Id and Reference to the estate.
'
properties:
_href:
x-skip-camel-case-check: true
$ref: '#/components/schemas/ResourceRef'
estateId:
$ref: '#/components/schemas/EstateId'
SubmissionAdditionalProduct:
description: a specific submission additional product
type: object
required:
- provider
- product
- commissionBase
properties:
additionalProductId:
type: string
provider:
$ref: '#/components/schemas/CompanyId'
product:
$ref: '#/components/schemas/ProductType'
applicants:
type: array
items:
$ref: '#/components/schemas/ApplicantId'
minItems: 1
policyNumber:
type: string
netBurden:
$ref: '#/components/schemas/PeriodicalEuroAmount'
duration:
$ref: '#/components/schemas/Duration'
commissionBase:
$ref: '#/components/schemas/EuroAmount'
commission:
$ref: '#/components/schemas/Percentage'
approved:
description: a flag indicates whether the provided additional product has been approved and hence not changeable anymore.
type: boolean
nullable: true
SubmissionProcessingPausedStatusLogbookEntryDetails:
type: object
allOf:
- $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails'
properties:
reason:
$ref: '#/components/schemas/PauseReason'
dueDate:
$ref: '#/components/schemas/ISODate'
CreditPhaseInterest:
type: object
properties:
interestRate:
$ref: '#/components/schemas/InterestRate'
interestPayed:
description: 'DE: Sollzinsen insgesamt.
EN: Total of credit interest payed.
'
$ref: '#/components/schemas/EuroAmount'
BaseMainProduct:
type: object
description: 'DE: Information zum Hauptdarlehensprodukt.
EN: Main loan product information.
'
required:
- product
properties:
product:
description: 'DE: Typ des Hauptdarlehensproduktes.
EN: Main loan product type.
'
$ref: '#/components/schemas/MainProductType'
productName:
description: 'DE: Name des Hauptdarlehensproduktes.
EN: Main loan product name.
'
type: string
discriminator:
propertyName: product
FixedInterestMaturity:
description: 'DE: Information über die Sollzinsbindung mit dem festen Dauer.
EN: Information about fixed interest rate maturity.
'
type: object
required:
- type
- period
allOf:
- $ref: '#/components/schemas/BaseInterestMaturity'
properties:
period:
description: 'DE: Dauer der Sollzinsbindung.
EN: Fixed interest rate duration.
'
$ref: '#/components/schemas/Duration'
fixedUntil:
description: 'DE: Enddatum der Sollzinsbindung.
EN: End date of the fixed interest rate.
'
$ref: '#/components/schemas/ISODate'
bulletLoan:
type: boolean
description: 'DE: Endfällig.
EN: Bullet loan.
'
ExistingBuildingSavingPlan:
type: object
required:
- reason
- contractNumber
description: 'DE: Information zur Zwischenfinanzierung in Zusammenhang mit einem bald fälligen Bestandsbausparers.
EN: Information about bridging debt associated with a building saving plan that is due soon.
'
allOf:
- $ref: '#/components/schemas/BaseBridgingLoanDetails'
properties:
contractNumber:
type: string
readOnly: true
description: 'DE: Vertragsnummer eines bald fälligen Bestandsbausparers Bausparvertrags (components.schemas.BuildingSavingPlanEquity.properties.contractNumber).
EN: Contract number referring to a soon due building saving plan (components.schemas.BuildingSavingPlanEquity.properties.contractNumber).
'
Duration:
type: object
title: Duration
description: 'DE: Gibt einen Zeitraum an. EN: Specifies a duration.
'
required:
- value
- unit
properties:
value:
type: integer
format: int32
description: 'DE: Die Menge der gewaehlten Zeiteinheit. EN: The amount of the selected temporal unit.
'
unit:
type: string
enum:
- YEARS
- MONTHS
- DAYS
description: 'DE: Die Zeiteinheit. EN: The temporal unit.
'
SubmissionCounterOfferId:
type: object
required:
- value
description: 'DE: ID vom Gegenangebot. EN: Id of the counter offer.
'
properties:
value:
type: string
KfwReservationInfo:
type: object
description: 'DE: Zusätzliche Information zur KFW-Darlehensreservierung.
EN: Additional Information about the Kfw Loan reservations
'
properties:
id:
type: string
description: 'DE: Identifizierungsnummer einer sofortigen (Kfw) Bestätigung.
EN: Identification nummer for a immediate (Kfw) confirmation.
'
callType:
$ref: '#/components/schemas/KfwCallType'
conditionReservationDate:
description: 'DE: Konditionsreservierungsdatum.
EN: Condition reservation date.
'
$ref: '#/components/schemas/ISODate'
validity:
description: 'DE: Ablaufdatum der Kondition.
EN: Condition expiry date.
'
$ref: '#/components/schemas/ISODate'
BuildingSavingPlan:
description: 'DE: Information zum Bauspardarlehen.
EN: Information about the building saving loan.
'
type: object
properties:
tariff:
$ref: '#/components/schemas/SavingPlanTariff'
amount:
description: 'DE: Bausparsumme.
EN: Saving plan amount.
'
$ref: '#/components/schemas/EuroAmount'
contractingDate:
description: 'DE: Vertragsbeginn.
EN: Contract start date.
'
$ref: '#/components/schemas/ISODate'
duration:
description: 'DE: Darlehensdauer/Gesamtlaufzeit.
EN: Loan duration.
'
$ref: '#/components/schemas/Duration'
allocationDate:
$ref: '#/components/schemas/ISODate'
savingsPhase:
$ref: '#/components/schemas/SavingsPhase'
creditPhase:
$ref: '#/components/schemas/CreditPhase'
contractSignedWith:
description: 'DE: Referenz zu den Antragsteller der den Vetrag unterschrieben hat.
EN: Reference to the applicant who signed the contract.
'
$ref: '#/components/schemas/ApplicantIdRef'
remark:
type: string
contractNumber:
type: string
readOnly: true
description: 'DE: Vertragsnummer.
EN: Contract number.
'
commission:
$ref: '#/components/schemas/CommissionInfo'
RefuseSignContractReasonKey:
type: string
description: 'DE: Grund für die Ablehnung des Vertrags, mögliche Werte sind NOTARY_APPOINTMENT_UNAVAILABLE=Notartermin kann nicht rechtzeitig stattfinden, OBJECT_UNAVAILABLE=Objekt hat sich zerschlagen, VENTURE_UNAVAILABLE=Vorhaben hat sich zerschlagen, CUSTOMER_DECIDED_DIFFERENT_PROVIDER=Kunde hat sich für einen anderen Finanzierungspartner entschieden, NO_CUSTOMER_INTEREST=Kunde hat sich nicht mehr gemeldet, OTHER=Nicht aufgeführter Grund EN: Reason for refusing contract, possible values are NOTARY_APPOINTMENT_UNAVAILABLE, OBJECT_UNAVAILABLE, VENTURE_UNAVAILABLE, CUSTOMER_DECIDED_DIFFERENT_PROVIDER, NO_CUSTOMER_INTEREST, OTHER
'
x-extensible-enum:
- NOTARY_APPOINTMENT_UNAVAILABLE
- OBJECT_UNAVAILABLE
- VENTURE_UNAVAILABLE
- CUSTOMER_DECIDED_DIFFERENT_PROVIDER
- NO_CUSTOMER_INTEREST
- OTHER
ExternalProcessingAwaitedLogbookEntryDetails:
type: object
allOf:
- $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails'
properties:
externalProcessing:
$ref: '#/components/schemas/ExternalProcessing'
SavingsPlanBurdenSpecialPaymentPeriod:
type: object
required:
- from
- to
properties:
from:
$ref: '#/components/schemas/ISODate'
to:
$ref: '#/components/schemas/ISODate'
BaseBridgingLoanDetails:
type: object
required:
- neededAmount
- reason
description: 'DE: Information zur Zwischenfinanzierung.
EN: Details about bridging loan.
'
properties:
reason:
type: string
description: 'DE: Grund für die Zwischenfinanzierung (nicht abschließende Aufzaehlung), z.B. OPEN_PROPERTY_SALE, CLOSED_PROPERTY_SALE, UNAVAILABLE, PUBLIC_PRE_FINANCE, EXISTING_BUILDING_SAVING_PLAN.
EN: Open ended enum contains bridging loan debt reason, possible values are OPEN_PROPERTY_SALE, CLOSED_PROPERTY_SALE, UNAVAILABLE, PUBLIC_PRE_FINANCE, EXISTING_BUILDING_SAVING_PLAN.
'
example: OPEN_PROPERTY_SALE
x-extensible-enum:
- OPEN_PROPERTY_SALE
- CLOSED_PROPERTY_SALE
- UNAVAILABLE
- PUBLIC_PRE_FINANCE
- EXISTING_BUILDING_SAVING_PLAN
neededAmount:
description: 'DE: Zwischenfinanzierungsbetrag.
EN: Bridging loan amount.
'
$ref: '#/components/schemas/EuroAmount'
equityAvailabilityDate:
description: 'DE: Verfügbarkeit des Kapitals.
EN: Bridging loan availability date.
'
$ref: '#/components/schemas/ISODate'
discriminator:
propertyName: reason
PeriodicalEuroAmount:
description: 'DE: Euro Betrag in einem bestimmten Zeitraum.
EN: Euro amount for a specific period.
'
type: object
required:
- amount
- cycle
properties:
amount:
$ref: '#/components/schemas/EuroAmount'
cycle:
$ref: '#/components/schemas/Cycle'
InterestRate:
description: 'DE: Information über den Zins.
EN: Information about the interest rate.
'
type: object
properties:
nominal:
description: 'DE: Nominalzins (Sollzins) in Prozent
EN: Nominal interest rate percent per period.
'
$ref: '#/components/schemas/PeriodicalPercentage'
effective:
description: 'DE: Effektivzins in Prozent.
EN: Effective interest rate percent per period.
'
$ref: '#/components/schemas/PeriodicalPercentage'
KfwPromotionLoan:
description: 'DE: Information zum Kfw-Darlehen.
EN: Information about the KFW promotion loan.
'
type: object
allOf:
- $ref: '#/components/schemas/BaseLoan'
properties:
program:
$ref: '#/components/schemas/KfwProgram'
annuityDetails:
$ref: '#/components/schemas/AnnuityDetails'
reservations:
description: "DE: Sammlung von KFW-Darlehensreservierungen.
\n EN: Collection of KFW loan reservations.\n"
type: array
items:
$ref: '#/components/schemas/KfwReservationInfo'
additionalInfo:
$ref: '#/components/schemas/KfwLoanAdditionalInfo'
ContractSignRefusedStatusLogbookEntryDetails:
type: object
required:
- reason
allOf:
- $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails'
properties:
reason:
$ref: '#/components/schemas/RefuseSignContractReason'
remark:
type: string
BaseSubmissionStatusChangedLogbookEntryDetails:
type: object
description: Change submission logbook entry details
required:
- type
properties:
type:
$ref: '#/components/schemas/SubmissionStatusChangedLogbookEntryDetailsType'
discriminator:
propertyName: type
LoanDetails:
description: details of the loan to be updated
type: object
required:
- amount
properties:
amount:
$ref: '#/components/schemas/EuroAmount'
maturity:
$ref: '#/components/schemas/InterestMaturity'
interestRateUpdate:
$ref: '#/components/schemas/InterestRateUpdate'
specialRepayment:
$ref: '#/components/schemas/SpecialRepayment'
commission:
$ref: '#/components/schemas/CommissionInfo'
RejectSubmissionCounterOfferReasonKey:
type: string
description: 'DE: offenes Enum enthält mögliche Gründe für die Ablehnung eines Gegenangebots, mögliche Werte sind (CONDITION_NOT_ATTRACTIVE_FOR_CUSTOMER = Konditionen waren für den Kunden nicht attraktiv, CUSTOMER_DECIDED_DIFFERENT_PROVIDER=Kunden hat sich für einen anderen Finanzierungspartner (besseres Angebot) entschieden, CONDITION_NOT_FEASIBLE_FOR_CUSTOMER=Bedingung der Bank für den Kunden nicht darstellbar, OTHER=Nicht aufgeführter Grund). EN: open ended enum contains possible counter offer rejection reasons, possible values are (CONDITION_NOT_ATTRACTIVE_FOR_CUSTOMER, CUSTOMER_DECIDED_DIFFERENT_PROVIDER, CONDITION_NOT_FEASIBLE_FOR_CUSTOMER, OTHER).
'
example: OTHER
x-extensible-enum:
- CONDITION_NOT_ATTRACTIVE_FOR_CUSTOMER
- CUSTOMER_DECIDED_DIFFERENT_PROVIDER
- CONDITION_NOT_FEASIBLE_FOR_CUSTOMER
- OTHER
SavingsPlanBurden:
type: object
properties:
savingsBurden:
description: 'DE: Sparrate.
EN: Periodical saving rate.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
additionalSavings:
description: 'DE: Zusätzlicher Sparbeitrag.
EN: Additional savings.
'
$ref: '#/components/schemas/EuroAmount'
numberOfSavingsBurdens:
description: 'DE: Anzahl zu zahlender Sparraten.
EN: Number of to be paid saving rates.
'
type: integer
format: int32
payedRates:
description: 'DE: Sparbeiträge insgesamt.
EN: The sum of the rates payed in the savings phase.
'
$ref: '#/components/schemas/EuroAmount'
specialPayments:
type: array
description: 'DE: Sonderzahlungen.
EN: Special payments.
'
items:
$ref: '#/components/schemas/SavingsPlanBurdenSpecialPayment'
LoanType:
type: string
description: 'DE: Art des Darlehens (nicht abschließende Aufzählung), z.B. MAIN_LOAN, AUXILIARY_LOAN, KFW_PROMOTION_LOAN.
EN: Open ended enum contains possible loan types, possible values are MAIN_LOAN, AUXILIARY_LOAN, KFW_PROMOTION_LOAN.
'
example: MAIN_LOAN
x-extensible-enum:
- MAIN_LOAN
- AUXILIARY_LOAN
- KFW_PROMOTION_LOAN
- OTHER
DocumentLogbookEntry:
type: object
description: 'DE: Ein Logbucheintrag mit Informationen zu einem hochgeladenen Einreichungsdokument.
EN: A logbook entry holds information about uploading submission document.
'
allOf:
- $ref: '#/components/schemas/BaseLogbookEntry'
properties:
documentName:
type: string
ISODate:
description: 'DE: Datum, Syntax nach RFC 3339
EN: Date according to RFC 3339
'
type: string
format: date
nullable: true
example: '2019-12-29'
PayoutInfo:
type: object
description: 'DE: Information zur Auszahlung des Darlehens.
EN: Loan payout information.
'
properties:
firstPayout:
description: 'DE: Datum der ersten Teilauszahlung.
EN: First payout date.
'
$ref: '#/components/schemas/ISODate'
freeAllocationPeriod:
description: 'DE: Bereitstellungszinsfreie Zeit.
EN: Interest free period.
'
$ref: '#/components/schemas/Duration'
payoutRate:
description: 'DE: Auszahlungskurs.
EN: Payout rate.
'
$ref: '#/components/schemas/Percentage'
CounterOfferRevokedLogbookEntry:
type: object
allOf:
- $ref: '#/components/schemas/BaseLogbookEntry'
properties:
details:
$ref: '#/components/schemas/RevokedCounterOfferLogbookEntryDetails'
PhoneType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/PhoneTypeKey'
CreditPhase:
type: object
description: The credit phase object (Darlehensphase).
properties:
amount:
description: 'DE: Tilgungssumme
EN: Loan amount to be amortized.
'
$ref: '#/components/schemas/EuroAmount'
timeline:
$ref: '#/components/schemas/CreditPhaseTimeline'
payout:
$ref: '#/components/schemas/CreditPhasePayout'
interest:
$ref: '#/components/schemas/CreditPhaseInterest'
burden:
$ref: '#/components/schemas/CreditPhaseBurden'
residualDebt:
description: 'DE: Restschuld am Sollzinsbindungsende.
EN: remaining debt by the end of the maturity.
'
$ref: '#/components/schemas/EuroAmount'
premium:
description: 'DE: Agio/ Laufzeitabhängiger Zinsbestandteil, der dem Nennbetrag des Darlehens zugeschlagen wird und damit die Darlehensschuld erhöht.
EN: Agio/ term-dependent interest component that is added to the nominal amount of the loan and thus increases the loan debt.
'
$ref: '#/components/schemas/EuroAmount'
youthBonus:
description: 'DE: Jugendbonus wenn man bei Vertragsabschluss < 26 Jahre ist.
EN: youth bonus when one at the contract''s conclusion < 26 Years old.
'
$ref: '#/components/schemas/EuroAmount'
SavingPlanTariff:
type: object
required:
- id
- name
- loanPartner
properties:
id:
description: 'DE: ID der gewählter Bauspartarif.
EN: ID of the chosen savings plan tariff.
'
example: KF.195
type: string
name:
description: 'DE: Name der gewählter Bauspartarif.
EN: Name of the chosen savings plan tariff.
'
example: D/Komfort 1,95%
type: string
loanPartner:
deprecated: true
description: Can be removed after the changes to the loan partner structure have been released
$ref: '#/components/schemas/LoanPartnerProcessingUnit'
loanPartnerId:
$ref: '#/components/schemas/CompanyId'
variantPrice:
description: 'DE: einmalig Variantepreis.
EN: costs for variant.
'
$ref: '#/components/schemas/EuroAmount'
magazineCosts:
description: 'DE: !!!.
EN: The potential costs of the saving plan magazines.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
UserId:
type: object
required:
- value
description: 'DE: ID des Users.
EN: ID of a user.
'
properties:
value:
type: string
RevokedSubmissionLogbookEntry:
type: object
allOf:
- $ref: '#/components/schemas/BaseLogbookEntry'
properties:
details:
$ref: '#/components/schemas/RevokedSubmissionLogbookEntryDetails'
SpecialRepaymentType:
type: string
description: 'DE: Typ der speziellen Rückzahlung (nicht abschließende Aufzählung), z.B. PERCENTAGE, TEXT.
EN: Open ended enum contains possible special repayment types, possible values are PERCENTAGE, TEXT.
'
example: PERCENTAGE
x-extensible-enum:
- PERCENTAGE
- TEXT
RejectReasonKey:
type: string
x-extensible-enum:
- OBJ_CRAFT
- GRND_PRICE
- BAD_UTILIZE
- BAD_STATE
- LUX_HOBBY
- CREDIT_NEG
- REL_DEBIT
- HH_INC_TO_VOL
- HH_CREDITS
- HH_NO_DEDUCT
- HH_HI_INCOME
- HH_EXPENSES
- HH_NEG_BAL
- SCHUFA_NEG
- SCHUFA_SCOR
- INTERN_RED
- FRAME
- LOW_EQUITY
- DEBT_RATIO
- JOB_AMOUNT
- RENT_RISK
- PROBATION
- SHORT_SE
- SECTION2
- SECTION3
- EXIST_CUST
- MANIPULATE
- EVIDENCE
- UNKNOWN
- CONTRACT
- OVERALL_CONSTELLATION
- NEGATIVE_HOUSEHOLD_CALCULATION
- PROPERTY_VALUATION_LOAN_QUOTA
- OTHER
CompanyId:
type: object
required:
- value
description: 'DE: ID des Unternehmes. EN: ID of the company.
'
properties:
value:
type: string
RegularMainProduct:
allOf:
- $ref: '#/components/schemas/BaseMainProduct'
Handover:
type: object
description: 'DE: Beratunsprotokoll und Empfehlung des Beraters.
EN: Advisor Handover notes and recommendations.
'
properties:
hints:
type: string
description: 'DE: Hinweise des Beraters.
EN: Hints provided by the financing advisor.
'
documents:
description: Link to retrieve list of handover documents
$ref: '#/components/schemas/ResourceRef'
example: https://api.interhyp.de/submission/v2/submissions/de-20230424-krczwx6-5sves/handover-documents
handoverReports:
deprecated: true
description: '@deprecated: Please use field documents to get list of handover documents
'
type: array
items:
$ref: '#/components/schemas/HandoverReport'
KfwProgramKey:
type: string
description: 'DE: KFW-Förderprogramm (nicht abschließende Aufzählung), z.B. Wohneigen, Wohn159, Energie153-40, Energie151, Energie152, Energie167.
EN: Open ended enum contains possible programs for Kfw, i.e. Wohneigen, Wohn159, Energie153-40, Energie151, Energie152, Energie167.
'
example: Wohneigen
x-extensible-enum:
- Wohneigen
- Wohn159
- Energie153-40
- Energie151
- Energie152
- Energie167
- Eff261
- Einzel262
- KFNWohnselbst297
- KFNWohnselbstQNG297
- KFNWohnkapital298
- KFNWohnkapitalQNG298
- WEPFamilien300
- WEPFamilienQNG300
- WEPFamilienJKA308
- EMKreditPlus
- EMKredit
- KNN296WOHN
ProductType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/ProductTypeKey'
RateDetailsType:
type: string
description: 'DE: Mögliche Darlehensart (nicht abschließende Aufzählung), z.B. ANNUITY=Annuitätsdarlehen, SUSPENDED_AMORTIZATION=Tilgungsaussetzungsdarlehen.
EN: Open ended enum contains possible rates type, possible values are ANNUITY, SUSPENDED_AMORTIZATION.
example: ANNUITY
'
x-extensible-enum:
- ANNUITY
- SUSPENDED_AMORTIZATION
TitleKey:
type: string
description: 'DE: Akademischer Titel des Antragstellers (nicht abschließende Aufzählung, zum Beispiel: DR, PH_D, PD_DR, PROF, PROF_DR).
EN: Open ended enum contains possible title values, possible values are DR, PH_D, PD_DR, PROF, PROF_DR.
'
example: PROF_DR
x-extensible-enum:
- DR
- PH_D
- PD_DR
- PROF
- PROF_DR
- OTHER
BaseRateDetails:
type: object
required:
- rateType
properties:
rateType:
$ref: '#/components/schemas/RateDetailsType'
interestRate:
$ref: '#/components/schemas/InterestRate'
payment:
$ref: '#/components/schemas/RegularPayment'
residualDebt:
description: 'DE: Restschuld nach Ablauf der Sollzinsbindung.
EN: Remaining debt at the end of fixed interest maturity.
'
$ref: '#/components/schemas/EuroAmount'
discriminator:
propertyName: rateType
RevokedSubmissionLogbookEntryDetails:
type: object
properties:
revokeReason:
$ref: '#/components/schemas/SubmissionRevokedReason'
reasonDescription:
type: string
Violation:
description: 'DE: Ein Verstoss gegen die Schnittstellenspezifikation. EN: A violation against the API schema.
'
type: object
title: Violation
properties:
field:
type: string
description: 'DE: Bezeichner des problematischen Felds. EN: Name of the problematic field.
'
example: address.city.numberOfInhabitants
message:
type: string
description: 'DE: Beschreibung des Verstosses. EN: Description of the violation.
'
example: Must be greater than or equal to 0.
ContractInfoReferenceId:
type: object
description: 'DE: Referenz zu einem Baustein, dessen Vertragsnummer aktualisiert werden soll. EN: Reference to a component whose contract number should be updated.
'
properties:
value:
type: string
PaymentTime:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/PaymentTimeKey'
SubmissionLogbook:
type: object
description: 'DE: Enthält alle Logbucheinträge.
EN: Holds submission logbook entries.
'
properties:
entries:
type: array
items:
$ref: '#/components/schemas/SubmissionLogbookEntry'
SubmissionDataViolationSeverity:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/SubmissionDataViolationSeverityKey'
SuspendedAmortizationOtherProduct:
type: object
allOf:
- $ref: '#/components/schemas/BaseSuspendedAmortizationCombinedProduct'
SuspendedAmortizationBuildingSavingProduct:
type: object
allOf:
- $ref: '#/components/schemas/BaseSuspendedAmortizationCombinedProduct'
properties:
productDetails:
description: 'EN: details to the building saving plan being created. Only relevant when the building saving plan will be created during the credit decision process.
'
$ref: '#/components/schemas/BuildingSavingPlan'
productIdentifier:
type: string
BuildingSavingPlanInterestRateUpdate:
description: details of building saving plan interest rate update
type: object
allOf:
- $ref: '#/components/schemas/BaseInterestRateUpdate'
properties:
savingPhaseInterestRate:
$ref: '#/components/schemas/SavingsPlanInterest'
creditPhaseInterestRate:
$ref: '#/components/schemas/InterestRate'
CancelContractReasonKey:
type: string
description: 'DE: Grund für die Vertragskündigung, mögliche Werte sind NOTARY_APPOINTMENT_UNAVAILABLE=Notartermin kann nicht rechtzeitig stattfinden, OBJECT_UNAVAILABLE=Objekt hat sich zerschlagen, VENTURE_UNAVAILABLE=Vorhaben hat sich zerschlagen, CUSTOMER_DECIDED_DIFFERENT_PROVIDER=Kunde hat sich für einen anderen Finanzierungspartner entschieden, NO_CUSTOMER_INTEREST=Kunde hat sich nicht mehr gemeldet, OTHER=Nicht aufgeführter Grund EN: Reason for canceling contract, possible values are NOTARY_APPOINTMENT_UNAVAILABLE, OBJECT_UNAVAILABLE, VENTURE_UNAVAILABLE, CUSTOMER_DECIDED_DIFFERENT_PROVIDER, NO_CUSTOMER_INTEREST, OTHER
'
x-extensible-enum:
- NOTARY_APPOINTMENT_UNAVAILABLE
- OBJECT_UNAVAILABLE
- VENTURE_UNAVAILABLE
- CUSTOMER_DECIDED_DIFFERENT_PROVIDER
- NO_CUSTOMER_INTEREST
- OTHER
LoanContractNumberUpdatedLogbookEntry:
type: object
allOf:
- $ref: '#/components/schemas/BaseLogbookEntry'
properties:
contracts:
type: array
items:
$ref: '#/components/schemas/ContractInfo'
SubmissionDataViolation:
description: a specific submission violation
type: object
required:
- description
properties:
code:
type: string
description:
type: string
proposedSolution:
type: string
severity:
$ref: '#/components/schemas/SubmissionDataViolationSeverity'
HomePurchaseSavingProvider:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/HomePurchaseSavingProviderKey'
ExternalProcessingDetail:
type: object
required:
- reason
properties:
reason:
$ref: '#/components/schemas/ExternalProcessingReason'
SavingsPhase:
type: object
description: Sparphase
properties:
timeline:
$ref: '#/components/schemas/SavingsPlanTimeline'
savings:
$ref: '#/components/schemas/SavingsPlanBurden'
interest:
$ref: '#/components/schemas/SavingsPlanInterest'
contractFees:
$ref: '#/components/schemas/SavingsPlanFees'
accountBalanceAtAllocation:
description: 'DE: Bausparguthaben bei Zuteilung.
EN: The account balance at the moment of allocation.
'
$ref: '#/components/schemas/EuroAmount'
currentBalance:
description: 'DE: Aktuelles Bausparguthaben.
'
allOf:
- $ref: '#/components/schemas/EuroAmount'
RevokedCounterOfferLogbookEntryDetails:
type: object
required:
- type
- id
properties:
id:
$ref: '#/components/schemas/SubmissionCounterOfferId'
reason:
$ref: '#/components/schemas/RevokeSubmissionCounterOfferReason'
BaseInterestMaturity:
type: object
required:
- type
properties:
type:
$ref: '#/components/schemas/InterestMaturityType'
discriminator:
propertyName: type
RejectSubmissionCounterOfferReason:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/RejectSubmissionCounterOfferReasonKey'
SubmissionStatusChangedLogbookEntryDetailsType:
type: string
description: 'DE: offenes Enum enthält mögliche Details zum Status der Einreichung von Logbucheinträgen geändert
EN: open ended enum contains possible logbook entry submission status changed details
'
example: PROCESSING_PAUSED
x-extensible-enum:
- CONTRACT_DELIVERED
- CONTRACT_SIGNED
- CONTRACT_CANCELED
- AWAIT_EXTERNAL_PROCESSING
- PROCESSING_PAUSED
- PROCESSING_RESUMED
- REJECTED
- CANCELED
- REJECTION_REVOKED
- INWORK
- APPROVED
- CONFIRMED
- COUNTER_OFFER_CREATED
- COUNTER_OFFER_ACCEPTED
- COUNTER_OFFER_REJECTED
SubmissionProcessingResumedStatusLogbookEntryDetails:
type: object
allOf:
- $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails'
properties:
status:
type: string
DocumentId:
required:
- value
properties:
value:
type: string
description: 'An Id refers to a specific document resource.
'
type: object
description: 'DE: ID vom Dokument. EN: Id of the document.
'
ContractDeliveredStatusLogbookEntryDetails:
type: object
allOf:
- $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails'
properties:
contractDeliverDate:
$ref: '#/components/schemas/ISODate'
contracts:
type: array
items:
$ref: '#/components/schemas/ExtendedContractInfo'
parameters:
submission-id:
name: submissionId
in: path
required: true
schema:
type: string
description: Id for the requested submission.
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT