CompanyTypeCustomerInput
Input to create a new corporate-entity customer (a company) inline as part of an offer.
Used today by Value Invest VWL where the offer's PAYER must be the employee's
employer — a corporate entity. The employee remains an individual and is provided
via newCustomer or existingCustomer.
input CompanyTypeCustomerInput {
additionalName: String
address: AddressInput!
contactName: String
email: Email
financialInstitution: Boolean!
landline: PhoneNumber
language: CustomerLanguage
legalForm: String!
mobilePhone: PhoneNumber
name: String!
taxInformation: CorporateEntityTaxIdentificationInput!
}
Fields
CompanyTypeCustomerInput.additionalName ● String scalar
Additional corporate name or trade name, if applicable (e.g. doing-business-as).
CompanyTypeCustomerInput.address ● AddressInput! non-null input
Registered address of the corporate entity.
CompanyTypeCustomerInput.contactName ● String scalar
Name of the primary contact person at the corporate entity.
CompanyTypeCustomerInput.email ● Email scalar
Email address used to reach the corporate entity (typically the primary contact).
CompanyTypeCustomerInput.financialInstitution ● Boolean! non-null scalar
Whether the corporate entity is a financial institution. Required for KYC categorisation in the insurance system.
CompanyTypeCustomerInput.landline ● PhoneNumber scalar
Landline phone number of the corporate entity.
CompanyTypeCustomerInput.language ● CustomerLanguage enum
Preferred communication language for the corporate entity. Defaults to de_DE if not provided.
CompanyTypeCustomerInput.legalForm ● String! non-null scalar
Legal form of the corporate entity (for example AG, GmbH, OHG, KG).
Passed through to the insurance system without translation.
CompanyTypeCustomerInput.mobilePhone ● PhoneNumber scalar
Mobile phone number of the corporate entity's primary contact.
CompanyTypeCustomerInput.name ● String! non-null scalar
Official registered name of the corporate entity.
CompanyTypeCustomerInput.taxInformation ● CorporateEntityTaxIdentificationInput! non-null input
Tax information of the corporate entity (VAT number, tax residency country, US tax status).