Create customer
Authorizations
Value for the Authorization header parameter.
Body
Can be empty. In this case the default currency of the tenant is used.
The email address used for e-mail communication. This is also the username for the customer login. This needs to be unique.
The timezone of the customer. This is used for the communication with the customer or on generating documents like invoices, reminders, etc.
Can be empty if the customer is a company.
Can be empty if the customer is a company.
The language of the customer. This is used for the communication with the customer or on generating documents like invoices, reminders, etc.
de
, en
This email will be used for sending invoices to the customer. If not provided, we use the default e-mail address.
The ID of the customer in DATEV. If not provided, we will generate a datev id, when the "accounting.useDebitorAccounts" setting is set to true.
This field is needed, to fullfill a collection process on a personal customer.
male
, female
, diverse
The name of the commercial register. This is needed tofullfill the collection processes on companies.
The ID of the customer in the commercial register, e.g. HRB 123456. This is needed tofullfill the collection processes on companies.
Can be empty. In this case the customer number is generated automatically.
The street of the customer. If not provided, we will use empty string.
The house number of the customer. If not provided, we will use empty string.
The zip code of the customer. If not provided, we will use empty string.
The city of the customer. If not provided, we will use empty string.
Additional address line of the customer. If not provided, we will use empty string.
An invoice address for the customer. If not provided, we will use the default address.
Response
IANA time zone
Can be empty if the customer is a company.
Can be empty if the customer is a company.
Can be empty. In this case the default currency of the tenant is used.
Indicates if the VAT ID is valid. This is only available for EU VAT IDs. We validate the VAT IDs each night and directly after change.
The ID of the customer in DATEV
The name of the commercial register. This is needed tofullfill the collection processes on companies.
The ID of the customer in the commercial register, e.g. HRB 123456. This is needed tofullfill the collection processes on companies.
STATUS_ACTIVE
, STATUS_ARCHIVED
, STATUS_SUSPENDED
This field is needed, to fullfill a collection process on a personal customer.
male
, female
, diverse
The language of the customer. This is used for the communication with the customer or on generating documents like invoices, reminders, etc.
de
, en
The current customer rank, based on their revenue. Lower is better. This will calculate each night.
The default address of the customer. This is the address that is used for billing if no other address is specified.
The invoice address of the customer. This is the address that is used for billing if defined. If not defined, the default address is used.
The default email address of the customer. This is the email address that is used for billing if no other email address is specified.
The invoice email address of the customer. This is the email address that is used for billing if defined. If not defined, the default email address is used.
The default payment method of the customer. This is the payment method that is used for billing.
Was this page helpful?