Create address

post

https://api.instellix.io/v2/customers/{ident}/addresses

Create a new address for a specific customer

Path Params

ident

string

required

Unique external reference.

Body Params

An address create request that is assigned to a specific debtorId. Can be of addressType INVOICE or SHIPPING.

academicTitle

string | null

Size must be between 0 and 255.

addressAddition

string | null

Optional additional address information. Size must be between 0 and 255.

addressIdent

string | null

Unique external reference. If not provided NBX will auto generate a UUID. Must have size between 1 and 100 and match with the regular expression '[a-zA-Z0-9_.~-]{1,100}'.

addressType

string

required

Cannot be amended after the initial POST. Must not be null. Must be one of:


INVOICE
SHIPPING

agencyProfessionTitle

string | null

Agency Profession Title. Size must be between 0 and 255.

city

string | null

City. Size must be between 0 and 255.

company

string | null

Company name. Size must be between 0 and 255.

country

string

required

Country code for country of address. Uses Alpha-2 or Alpha3 code (ISO 3166): https://www.iban.com/country-codes. Must not be null.

department

string | null

Department within a company. Size must be between 0 and 255.

eInvoicingParameters

object | null

Provides information needed to handle e-invoicing.

string | null

Recipient's email. It becomes mandatory for addresses of addressType INVOICE and preferredDocumentDelivery EMAIL. Size must be between 0 and 255.

firstname

string | null

First name of recipient. Size must be between 0 and 255.

gender

string | null

Recipient's gender. Must be one of:


MALE
FEMALE
OTHER
NOTSET

lastname

string | null

Last name of recipient. Size must be between 0 and 255.

postOfficeBox

string | null

Number of post office box. Size must be between 0 and 255.

preferredDocumentDelivery

string

Defaults to NONE

Defines the preferred way of delivering documents to this customer. Only used for Addresses of Type INVOICE. When set to EMAIL and addressType is INVOICE, the field email must be filled. Must be one of:


EMAIL
LETTER
NONE

properties

array of objects | null

Array of properties assigned to the specific address.

properties

state

string | null

State. Size must be between 0 and 255.

stateCode

string | null

State code. ISO 3166-2 subdivision code. Size must be between 0 and 255.

street

string | null

Name of street. Size must be between 0 and 255.

streetNo

string | null

Street Number. Size must be between 0 and 255.

taxNumber

string | null

The taxNumber is the local country tax number given to a legal entity by their tax authority such as the German Steuernummer or Italian Codice Fiscale. Size must be between 0 and 32.

validationStatus

string | null

Status of address validation if required by configured tax provider. Must be one of:


TAXABLE
NON_TAXABLE
VALIDATION_PENDING
VALIDATION_NOT_REQUIRED
NOT_VALIDATED
VALIDATION_FAILED

vatId

string | null

Also known as VAT identification number (VATIN). An identifier used by countries for Value Added Tax purposes to identify legal entities, especially in the EU. Size must be between 0 and 20.

zip

string | null

Postcode. Size must be between 0 and 10.

Responses

201The request has been fulfilled, resulting in the creation of a new resource.

4XXerror response for all http error codes in range 4XX

5XXerror response for all http error codes in range 5XX