# DeliveryInvoiceAddress

Dolibarr-Modul zur Verwendung von Rechnungs-, Liefer- und Serviceadressen in ODT-Vorlagen und E-Mail-Templates.

## Funktionen

- Separate Rechnungsadresse in Angeboten, Aufträgen und Rechnungen
- Lieferadresse für Versanddokumente
- Serviceadresse für Servicedokumente
- Automatische Erkennung des Dokumenttyps (Angebot/Auftrag/Rechnung)
- CUSTOMER-Kontakt als Fallback für BILLING bei Angeboten/Aufträgen
- Fallback-Platzhalter: Rechnungskontakt oder automatisch Kundenname

## Installation

1. Modul-Ordner nach `htdocs/custom/deliveryinvoiceaddress/` kopieren
2. In Dolibarr: Home → Setup → Modules → DeliveryInvoiceAddress aktivieren

## Unterstützte Dokumenttypen

| Dokumenttyp | Element | Kontakttypen |
|-------------|---------|--------------|
| Angebot (Propal) | `propal` | BILLING, CUSTOMER |
| Auftrag (Commande) | `commande` | BILLING, CUSTOMER, SERVICE, SHIPPING |
| Rechnung (Facture) | `facture` | BILLING, SERVICE, SHIPPING |

## Verfügbare Platzhalter

Alle Platzhalter sind in zwei Formaten verfügbar:
- **ODT-Vorlagen**: `{key}` (z.B. `{billing_contact_fullname}`)
- **E-Mail-Vorlagen**: `__KEY__` (z.B. `__BILLING_CONTACT_FULLNAME__`)

### Rechnungsadresse (Billing)

| ODT-Tag | E-Mail-Tag | Beschreibung |
|---------|------------|--------------|
| `{billing_contact_firstname}` | `__BILLING_CONTACT_FIRSTNAME__` | Vorname |
| `{billing_contact_name}` | `__BILLING_CONTACT_NAME__` | Nachname |
| `{billing_contact_fullname}` | `__BILLING_CONTACT_FULLNAME__` | Vorname + Nachname |
| `{billing_contact_address}` | `__BILLING_CONTACT_ADDRESS__` | Straße und Hausnummer |
| `{billing_contact_zip}` | `__BILLING_CONTACT_ZIP__` | Postleitzahl |
| `{billing_contact_town}` | `__BILLING_CONTACT_TOWN__` | Ort |
| `{billing_contact_country}` | `__BILLING_CONTACT_COUNTRY__` | Land |

### Lieferadresse (Delivery/Shipping)

| ODT-Tag | E-Mail-Tag | Beschreibung |
|---------|------------|--------------|
| `{delivery_contact_firstname}` | `__DELIVERY_CONTACT_FIRSTNAME__` | Vorname |
| `{delivery_contact_name}` | `__DELIVERY_CONTACT_NAME__` | Nachname |
| `{delivery_contact_fullname}` | `__DELIVERY_CONTACT_FULLNAME__` | Vorname + Nachname |
| `{delivery_contact_address}` | `__DELIVERY_CONTACT_ADDRESS__` | Straße und Hausnummer |
| `{delivery_contact_zip}` | `__DELIVERY_CONTACT_ZIP__` | Postleitzahl |
| `{delivery_contact_town}` | `__DELIVERY_CONTACT_TOWN__` | Ort |
| `{delivery_contact_country}` | `__DELIVERY_CONTACT_COUNTRY__` | Land |

### Serviceadresse (Service)

| ODT-Tag | E-Mail-Tag | Beschreibung |
|---------|------------|--------------|
| `{service_contact_firstname}` | `__SERVICE_CONTACT_FIRSTNAME__` | Vorname |
| `{service_contact_name}` | `__SERVICE_CONTACT_NAME__` | Nachname |
| `{service_contact_fullname}` | `__SERVICE_CONTACT_FULLNAME__` | Vorname + Nachname |
| `{service_contact_address}` | `__SERVICE_CONTACT_ADDRESS__` | Straße und Hausnummer |
| `{service_contact_zip}` | `__SERVICE_CONTACT_ZIP__` | Postleitzahl |
| `{service_contact_town}` | `__SERVICE_CONTACT_TOWN__` | Ort |
| `{service_contact_country}` | `__SERVICE_CONTACT_COUNTRY__` | Land |

### Fallback-Platzhalter (Rechnungskontakt ODER Kundenname)

Zeigt den Rechnungskontakt an, wenn zugeordnet. Sonst automatisch den Kundennamen.

| ODT-Tag | E-Mail-Tag | Beschreibung |
|---------|------------|--------------|
| `{billing_or_thirdparty}` | `__BILLING_OR_THIRDPARTY__` | Fullname oder Kundenname |
| `{billing_or_thirdparty_firstname}` | `__BILLING_OR_THIRDPARTY_FIRSTNAME__` | Vorname (leer bei Fallback) |
| `{billing_or_thirdparty_name}` | `__BILLING_OR_THIRDPARTY_NAME__` | Nachname oder Kundenname |

## Verwendung in ODT-Vorlagen

### Beispiel: Automatischer Fallback (empfohlen)

```
{billing_or_thirdparty}
{billing_contact_address}
{billing_contact_zip} {billing_contact_town}
```

### Beispiel: Zwei Adressen nebeneinander

```
Rechnungsadresse:              Lieferadresse:
{billing_contact_fullname}     {delivery_contact_fullname}
{billing_contact_address}      {delivery_contact_address}
{billing_contact_zip} {billing_contact_town}    {delivery_contact_zip} {delivery_contact_town}
```

## Verwendung in E-Mail-Vorlagen

```
Sehr geehrte/r __BILLING_OR_THIRDPARTY__,

anbei erhalten Sie Ihre Rechnung __REF__.
```

## Kontakte zuordnen

1. Öffne das Dokument (Angebot/Auftrag/Rechnung)
2. Gehe zum Tab "Kontakte/Adressen"
3. Füge einen Kontakt hinzu und wähle die entsprechende Rolle:
   - **Kundenkontakt für Rechnungen** (BILLING) → `billing_contact_*`
   - **Kundenkontakt für Lieferung** (SHIPPING) → `delivery_contact_*`
   - **Kundenkontakt für Service** (SERVICE) → `service_contact_*`

## Technische Details

### Datenbankstruktur

| Tabelle | Beschreibung |
|---------|--------------|
| `llx_element_contact` | Verknüpfung Dokument ↔ Kontakt |
| `llx_c_type_contact` | Kontakttyp-Definitionen |
| `llx_socpeople` | Kontaktdaten |
| `llx_c_country` | Länderbezeichnung |

### Hauptfunktion

```
deliveryinvoiceaddress_completesubstitutionarray()
```

Datei: `core/substitutions/functions_deliveryinvoiceaddress.lib.php`

## Autor

Eduard Wisch - DATA IT Solution
https://data-it-solution.de

## Lizenz

GPL v3 oder höher

## Version

- **Version:** 1.3
- **Dolibarr:** 15.0+
- **PHP:** 7.1+