Skip to content

Update addresses

In tebio each customer can have multiple addresses. A distinction is made between billing addresses and delivery addresses.

You need this function if a customer’s address data changes or additional addresses are required:

  • A customer moves and needs a new billing address.
  • A customer wants physical products, such as magazines, temporarily delivered to a vacation address.
  • A business customer needs a different delivery address for a specific branch.
  • The customer must exist in the portal.
  • You need the authorization role to edit customer data.
  • For automatic address validation, the Endereco integration must be activated under Settings > Services and integrations.

Address management takes place in the customer profile.

Open the profile of the desired customer and go to the Addresses tab in the top menu. There you will see the currently valid billing address and, if available, a different delivery address.

If you want to add a new address, for example because of a move, follow these steps:

  1. In the Addresses tab, click on the option to create a new address or open the context menu of the respective address card.
  2. Fill out the basic information, such as country, zip code, city, street and house number. Depending on the address type, additional fields are available:
    • Billing address: You can optionally specify a PO box.
    • Shipping address: Shipping addresses may contain additional information, such as a purpose or process-specific information.
  3. Endereco Address Check: If the Endereco integration is active, tebio suggests standardized addresses as you enter them and automatically validates them. This reduces typos, incomplete addresses and subsequent returns.
  4. If necessary, assign a different recipient to the address, for example using Select from contacts or Create new contact.
  5. Use the switches to determine whether the address should be used as a billing address or used as a delivery address.

3. Change existing address or manage validity

Section titled “3. Change existing address or manage validity”

Often an address should not be overwritten immediately. Instead, a validity period can be defined, for example for a temporary vacation address.

Open the three-dot menu of an existing address and select Edit. In the form you will find the date fields Valid from and Valid to.

[!TIP] Automatic invalidation: If you create a new billing address for a customer with a future valid from date, tebio automatically terminates the validity of the previous billing address. The valid until date of the previous address is set to the day before the start of the new address. This avoids overlaps when creating invoices.

After making your adjustments, click Save.

Newly created or updated addresses will be used for future invoices, receipts and physical shipping orders, taking into account their validity periods.

  • Change country for B2B customers: If you change the billing address of a business customer to a different country, this may have an impact on the automatic tax calculation, for example on the reverse charge procedure. In such cases, check whether the associated VAT ID is still valid.
  • Recipient Names: You can link a specific contact to the address under Change Recipient. This allows the name of the selected person to be used on shipping documents instead of the general company name.

Addresses can also be managed via sub-resources of the Customer endpoint:

End pointMethodDescriptionOperationId
/v1/customer/{uuid}/addressPOSTAdd address to a customeraddCustomerAddress
/v1/customer/{uuid}/address/{addressUuid}PUTUpdate customer addressupdateCustomerAddress
/v1/customer/{uuid}/address/{addressUuid}DELETEDelete customer addressdeleteCustomerAddress