Skip to main content

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, in E.164 format (e.g. +493023125000).

CompanyTypeCustomerInput.language ● CustomerLanguage enum​

Preferred communication language for the corporate entity. Defaults to de_DE if not provided.

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, in E.164 format (e.g. +4917604069000).

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).

Member Of​

CreateOfferCustomerByInput input