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 {
  name: String!
  additionalName: String
  contactName: String
  legalForm: String!
  financialInstitution: Boolean!
  email: Email
  mobilePhone: PhoneNumber
  landline: PhoneNumber
  language: CustomerLanguage
  address: AddressInput!
  taxInformation: CorporateEntityTaxIdentificationInput!
}

Fields​

CompanyTypeCustomerInput.name ● String! non-null scalar​

Official registered name of the corporate entity.

CompanyTypeCustomerInput.additionalName ● String scalar​

Additional corporate name or trade name, if applicable (e.g. doing-business-as).

CompanyTypeCustomerInput.contactName ● String scalar​

Name of the primary contact person at the corporate entity.

Legal form of the corporate entity (for example AG, GmbH, OHG, KG). Passed through to the insurance system without translation.

CompanyTypeCustomerInput.financialInstitution ● Boolean! non-null scalar​

Whether the corporate entity is a financial institution. Required for KYC categorisation in the insurance system.

CompanyTypeCustomerInput.email ● Email scalar​

Email address used to reach the corporate entity (typically the primary contact).

CompanyTypeCustomerInput.mobilePhone ● PhoneNumber scalar​

Mobile phone number of the corporate entity's primary contact, in E.164 format (e.g. +4917604069000).

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.

CompanyTypeCustomerInput.address ● AddressInput! non-null input​

Registered address 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