# Allemagne
> Les documents allemands : de la Rechnung au Lieferschein par type, USt-IdNr. et Steuernummer, catégories de TVA, le contrôle du § 14 UStG, XRechnung et ZUGFeRD.
>
> Avant: [Le document](https://ocost.io/docs/fr/document.md)

Ce qu'Ocost lit sur un document allemand et où il l'écrit dans [`ocost.document.v1`](https://ocost.io/docs/fr/document.md).

## Documents

| Imprimé comme | `kind` | `kind_detail` |
| --- | --- | --- |
| Rechnung | `invoice` | `invoice` |
| Abschlagsrechnung, Teilrechnung | `invoice` | `partial_invoice` |
| Schlussrechnung | `invoice` | `final_invoice` |
| Anzahlungsrechnung | `invoice` | `advance_payment_invoice` |
| Gutschrift im Gutschriftverfahren | `invoice` | `credit_invoice` |
| Gutschrift, Storno | `credit_note` | `credit_note` |
| Rechnungskorrektur | `invoice_correction` | `invoice_correction` |
| Proforma-Rechnung | `pro_forma` | `pro_forma_invoice` |
| Quittung, Kassenbon | `receipt` | `receipt` |
| Lieferschein | `delivery_note` | `delivery_note` |
| Bestellung, Auftrag | `order` | `order` |
| Auftragsbestätigung | `order_confirmation` | `order_confirmation` |
| Angebot | `quote` | `offer` |
| Vertrag, Mietvertrag | `contract` | `contract`, `lease_contract` |
| Mahnung, Zahlungserinnerung | `payment_reminder` | `payment_reminder` |
| Nebenkostenabrechnung | `other` | `cost_statement` |

Une Gutschrift peut signifier deux choses. Celle qui annule une facture est une `credit_note`. Celle que le client rédige à la place de la facture du fournisseur est une `credit_invoice`, et `attention` contient `self_billed`.

## Identifiants

| Imprimé comme | Champ | Contrôle |
| --- | --- | --- |
| USt-IdNr. (`DE` et neuf chiffres) | `vat_id`, `identifiers` en `EU_VAT` | Contrôle `vat_id` : son format. Ocost n'interroge pas VIES. |
| Steuernummer | `tax_registration_id`, `identifiers` en `DE_STNR` | Aucun |
| Handelsregister : HRB ou HRA avec son tribunal | `legal_registration_id`, `identifiers` en `COMMERCIAL_REGISTER` | Aucun. Gardé seulement s'il nomme un registre et un numéro. |
| Leitweg-ID | `buyer_reference` | Lu seulement dans une XRechnung |
| IBAN | `payment.iban` | Contrôle `iban` : ses chiffres de contrôle |

## TVA

Ocost lit les taux qu'un document imprime, en général 19 % et 7 %. Chaque taux forme un groupe de `vat_breakdown`. Le contrôle `vat` tient quand la TVA d'un groupe est égale à son montant HT multiplié par son taux.

| Catégorie | Sur un document allemand |
| --- | --- |
| `S` | 19 % ou 7 % |
| `Z` | 0 % |
| `E` | Steuerfrei (§ 4 UStG), avec le motif imprimé |
| `AE` | § 13b UStG : « Steuerschuldnerschaft des Leistungsempfängers » |
| `K` | Innergemeinschaftliche Lieferung |
| `G` | Exportation hors de l'UE |
| `O` | Nicht steuerbar |

## Le contrôle des factures

`tax_check` contient ce qui manque à une facture entrante pour la déduction de la TVA. Ocost le remplit quand votre entreprise et le fournisseur sont en Allemagne. Ocost prend le pays du fournisseur dans son adresse, sinon dans son numéro de TVA. Il couvre les factures à payer et les reçus jusqu'à 250 €. Pour tout le reste, il vaut `null`.

| `case` | Ce qu'Ocost exige |
| --- | --- |
| `standard` | § 14 Abs. 4 UStG : noms et adresses des deux parties, votre entreprise comme destinataire, numéro fiscal ou numéro de TVA du fournisseur, date, numéro, biens ou services, date de la prestation et montant HT. Puis le taux et la TVA. |
| `small` | § 33 UStDV, jusqu'à 250 € TTC : nom et adresse du fournisseur, date, biens ou services, et le taux |
| `reverse_charge` | Les mentions standard jusqu'au montant HT, et la mention que vous devez la TVA |
| `intra_eu` | Les mentions standard jusqu'au montant HT, la mention et les deux numéros de TVA |
| `exempt` | Les mentions standard jusqu'au montant HT, et le motif de l'exonération |

Chaque élément de `missing` nomme sa `law`. `at_stake` vaut `true` quand il coûte la déduction. `vat_charged` signale une TVA allemande que vous devez vous-même selon le § 13b. Elle n'est pas déductible, et la payer revient à la payer deux fois. Ocost retient une telle facture pour qu'une personne décide.

## Factures électroniques

Ocost lit XRechnung en UBL et CII, ainsi que ZUGFeRD ou Factur-X, sans modèle. Il prend le XML seul ou à l'intérieur du PDF. `read_with` vaut `e_invoice`, et chaque valeur est `checked`.

## Dates, montants et langue

Les documents allemands impriment `03.11.2026` et `1.270,92 €`. Ocost écrit `2026-11-03`, `1270.92` et `EUR`. `sources` garde la citation telle qu'imprimée. Les conditions de Skonto vont dans `early_payment_discounts`. Les noms et les lignes restent dans les mots du document.

## Votre entreprise

Ocost distingue l'entrant du sortant grâce à vos données dans [Paramètres › Données de l'entreprise](https://app.ocost.io/settings/company). Une entreprise allemande a besoin de son adresse et de sa USt-IdNr. ou de sa Steuernummer. Une GmbH, UG, AG, KG, OHG ou e.K. ajoute son tribunal d'enregistrement et son numéro.

Ocost remplit un champ vide à partir de vos documents et de ceux du groupe, là où un identifiant exact vous nomme. Il n'écrase jamais une valeur.

Le courrier à `belege@<name>.ocost.io` arrive chez Ocost. Le nom est le vôtre sans forme juridique, umlauts écrits en toutes lettres, comme `mueller-bau`.

## Exemple

Un extrait d'une facture entrante :

```json
{
  "kind": "invoice",
  "kind_detail": "invoice",
  "type_code": "380",
  "number": "RE-2026-0412",
  "currency": "EUR",
  "seller": {
    "name": "Beispiel Werkstatt GmbH",
    "identifiers": [
      { "scheme": "EU_VAT", "value": "DE123456788", "valid": null },
      { "scheme": "DE_STNR", "value": "21/815/08150", "valid": null },
      { "scheme": "COMMERCIAL_REGISTER", "value": "Amtsgericht Köln HRB 12345", "valid": null }
    ],
    "vat_id": "DE123456788",
    "tax_registration_id": "21/815/08150",
    "legal_registration_id": "Amtsgericht Köln HRB 12345"
  },
  "totals": { "net": 500, "tax": 95, "gross": 595, "payable": null, "prices_include_vat": false },
  "vat_breakdown": [
    { "category": "S", "rate": 19, "taxable_amount": 500, "tax_amount": 95, "exemption_reason": null }
  ],
  "early_payment_discounts": [
    { "days": 10, "percent": 2, "base_amount": null, "due_date": "2026-11-13" }
  ],
  "tax_check": { "case": "standard", "missing": [] },
  "read_with": "reader"
}
```

## Voir aussi

- [Le document](https://ocost.io/docs/fr/document.md): Le schéma ocost.document.v1 dans les termes de l'EN 16931 (transposable en UBL et CII) : un exemple, type et sens, sources, contrôles, versions, et chaque champ et chaque valeur.
- [Unités et codes](https://ocost.io/docs/fr/units.md): Les listes de codes du document : unités UNECE avec leurs mots imprimés, devises et pays ISO, catégories de TVA, moyens de paiement, types de documents, identifiants, ECLASS.
- [Groupes de sociétés](https://ocost.io/docs/fr/groups.md): Groupes de sociétés : les sociétés qu’une clé atteint, l’en-tête Ocost-Business, l’orientation par les identifiants du document, needs_company et les fichiers du groupe.
- Sur ocost.io: [E-invoicing](https://ocost.io/en/product/e-invoicing), [DATEV export](https://ocost.io/en/product/datev-export)
