# Alemania
> Documentos alemanes: de la Rechnung al Lieferschein por tipo, USt-IdNr. y Steuernummer, categorías de IVA, la comprobación del § 14 UStG, XRechnung y ZUGFeRD.
>
> Antes: [El documento](https://ocost.io/docs/es/document.md)

Lo que Ocost lee en un documento alemán y dónde lo escribe en [`ocost.document.v1`](https://ocost.io/docs/es/document.md).

## Documentos

| Impreso como | `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` |

Una Gutschrift puede significar dos cosas. La que anula una factura es una `credit_note`. La que escribe el cliente en lugar de la factura del proveedor es una `credit_invoice`, y `attention` contiene `self_billed`.

## Identificadores

| Impreso como | Campo | Comprobación |
| --- | --- | --- |
| USt-IdNr. (`DE` y nueve dígitos) | `vat_id`, `identifiers` como `EU_VAT` | Comprobación `vat_id`: su formato. Ocost no consulta VIES. |
| Steuernummer | `tax_registration_id`, `identifiers` como `DE_STNR` | Ninguna |
| Handelsregister: HRB o HRA con su juzgado | `legal_registration_id`, `identifiers` como `COMMERCIAL_REGISTER` | Ninguna. Solo se guarda cuando nombra un registro y un número. |
| Leitweg-ID | `buyer_reference` | Solo se lee de una XRechnung |
| IBAN | `payment.iban` | Comprobación `iban`: sus dígitos de control |

## IVA

Ocost lee los tipos que imprime un documento, normalmente 19 % y 7 %. Cada tipo es un grupo de `vat_breakdown`. La comprobación `vat` se cumple cuando el IVA de un grupo es su neto por su tipo.

| Categoría | En un documento alemán |
| --- | --- |
| `S` | 19 % o 7 % |
| `Z` | 0 % |
| `E` | Steuerfrei (§ 4 UStG), con el motivo impreso |
| `AE` | § 13b UStG: "Steuerschuldnerschaft des Leistungsempfängers" |
| `K` | Innergemeinschaftliche Lieferung |
| `G` | Exportación fuera de la UE |
| `O` | Nicht steuerbar |

## La comprobación de facturas

`tax_check` contiene lo que le falta a una factura entrante para deducir el IVA soportado. Ocost lo rellena cuando tu empresa y el proveedor están en Alemania. Ocost toma el país del proveedor de su dirección o, si falta, de su número de IVA. Cubre las facturas por pagar y los recibos de hasta 250 €. Para todo lo demás es `null`.

| `case` | Lo que Ocost exige |
| --- | --- |
| `standard` | § 14 Abs. 4 UStG: nombres y direcciones de ambas partes, tu empresa como destinataria, la Steuernummer o la USt-IdNr. del proveedor, fecha, número, bienes o servicios, fecha de la prestación y neto. Después, el tipo y el IVA. |
| `small` | § 33 UStDV, hasta 250 € brutos: nombre y dirección del proveedor, fecha, bienes o servicios, y el tipo |
| `reverse_charge` | Los elementos estándar hasta el neto, y la nota de que el IVA lo debes tú |
| `intra_eu` | Los elementos estándar hasta el neto, la nota y ambas USt-IdNr. |
| `exempt` | Los elementos estándar hasta el neto, y el motivo de la exención |

Cada elemento de `missing` nombra su `law`. `at_stake` es `true` cuando cuesta la deducción. `vat_charged` señala IVA alemán que debes tú mismo según el § 13b. No es deducible, y pagarlo es pagarlo dos veces. Ocost retiene esa factura hasta que decida una persona.

## Facturas electrónicas

Ocost lee XRechnung en UBL y CII, y ZUGFeRD o Factur-X, sin un modelo. Toma el XML solo o desde dentro del PDF. `read_with` es `e_invoice`, y cada valor es `checked`.

## Fechas, importes e idioma

Los documentos alemanes imprimen `03.11.2026` y `1.270,92 €`. Ocost escribe `2026-11-03`, `1270.92` y `EUR`. `sources` guarda la cita tal como está impresa. Las condiciones de Skonto van a `early_payment_discounts`. Los nombres y las líneas se quedan en las palabras del documento.

## Tu empresa

Ocost distingue lo entrante de lo saliente por tus datos en [Ajustes › Empresa](https://app.ocost.io/settings/company). Una empresa alemana necesita su dirección y su USt-IdNr. o su Steuernummer. Una GmbH, UG, AG, KG, OHG o e.K. añade su juzgado de registro y su número.

Ocost rellena un campo vacío a partir de tus documentos y los del grupo, donde un identificador exacto te nombra. Nunca sobrescribe un valor.

El correo a `belege@<name>.ocost.io` llega a Ocost. El nombre es el tuyo sin forma jurídica, con las diéresis escritas por extenso, como `mueller-bau`.

## Ejemplo

Un extracto de una factura 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"
}
```

## Véase también

- [El documento](https://ocost.io/docs/es/document.md): El esquema ocost.document.v1 en términos de EN 16931 (se corresponde con UBL y CII): un ejemplo, tipo y dirección, fuentes, comprobaciones, versiones, y cada campo y valor.
- [Unidades y códigos](https://ocost.io/docs/es/units.md): Las listas de códigos del documento: unidades UNECE con sus palabras impresas, monedas y países ISO, categorías de IVA, medios de pago, tipos de documento, identificadores, ECLASS.
- [Grupos de empresas](https://ocost.io/docs/es/groups.md): Grupos de empresas: a qué sociedades llega una clave, la cabecera Ocost-Business, el enrutado por los identificadores del documento, needs_company y los archivos del grupo.
- En ocost.io: [E-invoicing](https://ocost.io/en/product/e-invoicing), [DATEV export](https://ocost.io/en/product/datev-export)
