---
title: "Addresses"
description: "A partner address is a physical location associated with a business partner."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.beelocity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Addresses

A **partner address** is a physical location associated with a business partner. Each partner can have multiple addresses, each serving a different purpose — because in practice, the place you send invoices to is often not the same place you ship goods to.

## Address Types

| Type             | Definition                                                          | Typical use                                                            |
| ---------------- | ------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| **Billing**      | Where invoices and payment correspondence are sent.                 | Used on purchase orders and invoices as the financial contact address. |
| **Shipping**     | Where goods are physically delivered to or shipped from.            | Used for logistics planning and delivery scheduling.                   |
| **Returns**      | A dedicated address for returned goods, if different from shipping. | Used when a partner has a separate returns processing facility.        |
| **Headquarters** | The partner's main office or legal registered address.              | Used for contracts, formal correspondence, and as a general reference. |

A small partner might have one address for everything — in that case, use **Headquarters** as the catch-all. Larger partners often have separate billing, shipping, and headquarters addresses in different cities or even different countries.

## Address Fields

Each address includes:

| Field              | Description                                                                                                                            |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Address line 1** | Street name and number (e.g., "23 Rue Didouche Mourad").                                                                               |
| **Address line 2** | Building, floor, suite, or additional details (optional).                                                                              |
| **City**           | The city or municipality.                                                                                                              |
| **State**          | The state, province, or wilaya (e.g., "Algiers", "Oran", "Constantine").                                                               |
| **Postal code**    | The postal or ZIP code.                                                                                                                |
| **Country**        | Selected from Beelocity's [country list](../organizations/settings.html#countries).                                                      |
| **Default** flag   | Marks this as the **primary** address for its type. When the system needs a billing address for this partner, it uses the default one. Setting it automatically removes the flag from the partner's other addresses of the same type, so there is always at most one default per type. |

## Managing Addresses

Addresses are managed from the partner's detail page. You can:

- **Add** new addresses as the partner opens new locations.
- **Edit** existing addresses when details change (e.g., a new postal code or phone number).
- **Set defaults** — mark one address as the default for each type so automated processes know which address to use. New sales orders, invoices, and delivery notes pre-fill the client's default billing/shipping address automatically; you can still pick a different address on the document.
- **Deactivate** old addresses when a partner relocates.

## Tips

- **Always set a default per type** — when generating documents or planning shipments, the system needs to know which billing or shipping address to use. If no default is set, the process may not have an address to use.
- **Deactivate rather than delete when a partner moves** — creating a new address and deactivating the old one preserves the old address on historical documents like past invoices and completed purchase orders. Deleting would leave those documents without a valid address reference.
- **One address is often enough** — for a small partner with a single location, one **Headquarters** address covers everything. You do not need to create separate billing and shipping entries if they all point to the same place.
- **Keep addresses up to date** — an incorrect shipping address causes delivery failures. An incorrect billing address causes payment delays. A quick annual review of partner addresses can prevent both.

Source: https://docs.beelocity.com/en/business-partners/addresses/index.mdx