# E-Rechnungen von Lieferanten hochladen

<FeatureStatus feature="EInvoiceImport" />

Manche Lieferanten liefern keinen Kostenexport, sondern nur eine Rechnung. Ist diese Rechnung eine
strukturierte E-Rechnung, kann ein eigener Anbieter sie lesen: Sie legen den Anbieter mit dem
Upload-Format **E-Rechnungen** an, laden jede Rechnung dieses Lieferanten hoch, und jede
Rechnungsposition erscheint in Cost Reports unter dem Namen des Anbieters, neben Ihren übrigen
Kosten.

## Wie Costfluent eine Rechnung liest

Costfluent liest die strukturierten Daten der Rechnung, nicht ihr Druckbild. Es liest:

- XRechnung in UBL- oder CII-Syntax.
- ZUGFeRD 2.x und Factur-X in den Profilen BASIC, EN 16931 und EXTENDED.

Jede davon können Sie als XML-Datei hochladen oder als PDF/A-3, das die XML-Datei eingebettet
enthält. Peppol BIS Billing gehört nicht zu diesen Formaten, obwohl es die UBL-Syntax verwendet.

Jede Rechnungsposition wird zu Kosten in Höhe ihres Nettobetrags (BT-131), in der Währung der
Rechnung. Costfluent verteilt sie auf den Zeitraum, den die Position abrechnet: den eigenen
Zeitraum der Position, sonst den Zeitraum der Rechnung, sonst das Lieferdatum, sonst das
Rechnungsdatum. Ein Nachlass auf die ganze Rechnung wird zu einem Rabatt, ein Zuschlag auf die
ganze Rechnung zu einer Gebühr.

- Eine Handelsrechnung (Typ 380) oder eine Teilrechnung (326) fügt Ihren Kosten ihre Positionen
  hinzu.
- Eine Gutschrift (Credit Note, 381) wird mit ihnen verrechnet.
- Eine Rechnungskorrektur (384) ersetzt die Rechnung, auf die sie verweist; diese muss vorher zum
  selben Anbieter hochgeladen worden sein.

Mehrere Rechnungen eines Lieferanten im selben Monat zählen alle. Anders als ein CSV-Upload ersetzt
eine Rechnung keine Tage eines früheren Uploads.

### Umsatzsteuer

Umsatzsteuer zählt nie als Kosten. Jeder Upload zeigt die Nettosumme der Rechnung, ihre
Umsatzsteuer je Kategorie und ihre Bruttosumme. Eine Rechnung im Reverse-Charge-Verfahren
(Steuerkategorie AE) wird als solche gekennzeichnet, und ihr Nettobetrag bleibt die Kosten.

:::note
Costfluent zählt für jede Organisation den Nettobetrag. Umsatzsteuer als Kosten zu zählen, für eine
Organisation ohne Vorsteuerabzug, wird noch nicht unterstützt.
:::

### Kein Rechnungsarchiv

:::caution
Costfluent prüft eine Rechnung nicht gegen die gesetzlichen Anforderungen an Rechnungen und
archiviert Rechnungen nicht so, wie es die Aufbewahrungsregeln für Buchungsbelege verlangen (in
Deutschland die GoBD). Bewahren Sie jede Rechnung in dem Archiv auf, das Ihre Buchhaltung nutzt.
Costfluent behält die ausgelesene XML-Datei nur als Quelle ihres Uploads.
:::

## Voraussetzungen

- Die Berechtigung **Integrationen verwalten**, die Eigentümer und integrationsverantwortliche
  Personen haben, um den Anbieter anzulegen und Rechnungen hochzuladen oder zu löschen. Wer
  **Integrationen anzeigen** hat, sieht die Uploads.
- Ein Lieferant, der seine Rechnungen in einem der obigen Formate schickt und dessen Kosten
  Costfluent nicht bereits erfasst ([Doppelzählung vermeiden](#doppelzählung-vermeiden)).

## Verbinden

### Anbieter anlegen

<Stepper>

1. Öffnen Sie **Einstellungen**, dann **Integrationen**, und wählen Sie unter **Dateien hochladen**
   **Lieferanten-E-Rechnungen**.
2. Wählen Sie **Neuer E-Rechnungs-Anbieter** im Tab **Verwalten** oder **Verbinden**. Der Dialog
   **Neuer eigener Anbieter** öffnet sich mit **E-Rechnungen** unter **Upload-Format** ausgewählt.
3. Geben Sie unter **Anzeigename** einen Namen ein, etwa den des Lieferanten, und optional eine
   **Beschreibung**, und wählen Sie dann **Anbieter erstellen**.

</Stepper>

Die Seite des Anbieters öffnet sich. Ein Anbieter steht für einen Lieferanten: den Rechnungssteller
seiner ersten Rechnung. Legen Sie für jeden Lieferanten einen eigenen Anbieter an. Derselbe Dialog
auf der Seite **Eigener Anbieter** öffnet sich stattdessen mit **FOCUS-CSV-Dateien** ausgewählt. Wie
der Dialog sagt, lässt sich das Format nicht mehr ändern, sobald der Anbieter einen Upload hat.

### Eine Rechnung hochladen

<Stepper>

1. Wählen Sie auf der Seite des Anbieters unter **Uploads** die Option **Rechnung auswählen** und
   wählen Sie eine Rechnung, als `.xml` oder `.pdf`.
2. Wählen Sie **Hochladen**.

</Stepper>

Jeder Upload enthält eine Rechnung. Er durchläuft dieselben Status wie ein CSV-Upload
([Upload-Status](/de/connect/custom-provider#upload-status)). Seine Zeile zeigt:

- **Rechnung**: die Rechnungsnummer, den Rechnungssteller und den Dateinamen, bei diesen Typen mit
  **Gutschrift** oder **Rechnungskorrektur** markiert und bei einer Rechnung im
  Reverse-Charge-Verfahren mit **Reverse-Charge**.
- **Zeitraum**: den Zeitraum, den die Kosten der Rechnung abdecken, sobald der Upload verarbeitet
  ist.
- **Netto**, **USt.** und **Brutto**: die Nettosumme der Rechnung, ihre Umsatzsteuer mit dem Betrag
  je Kategorie und Steuersatz (etwa `S 19 %` oder `AE 0 %`) und ihre Bruttosumme. Die Beträge einer
  Gutschrift erscheinen negativ, wie die Kosten, mit denen sie verrechnet wird.

**Welche Rechnungen gelesen werden**, unter der Beschreibung der Karte, verweist auf diese Seite.

### Doppelzählung vermeiden

Laden Sie keine Rechnung eines Lieferanten hoch, dessen Kosten Costfluent bereits über eine
Verbindung erfasst. Diese Rechnung würde doppelt zählen.

## Rechnungsadresse

Statt jede Rechnung hochzuladen, können Sie die E-Mail weiterleiten, mit der sie kommt. Jede
Organisation hat eine Rechnungsadresse, auf dem Tab **Verwalten** von **Lieferanten-E-Rechnungen**
unter **Rechnungsadresse**. Die Organisationsrollen Eigentümer und Integrationsverantwortliche Person erstellen sie mit
**Adresse erstellen**.

Eine weitergeleitete E-Mail wird innerhalb von Minuten zu einem Upload, wenn all dies zutrifft:

- Sie enthält eine Rechnung nach EN 16931: eine XML-Datei oder ein PDF mit eingebetteten ZUGFeRD- oder
  Factur-X-Daten.
- Ihre DKIM-Signatur der eigenen Domain des Absenders ist unverändert.
- Ihr Absender ist Mitglied Ihrer Organisation oder ein erlaubter Absender.
- Genau ein E-Rechnungs-Anbieter hat bereits einen Upload dieses Verkäufers.

Alles andere wird mit seinem Grund zurückgehalten und nie geraten importiert. Costfluent antwortet
nie auf eine weitergeleitete E-Mail.

### E-Mails weiterleiten

Richten Sie in Ihrem Postfach eine Weiterleitung der Rechnungs-E-Mails an die Adresse ein. Gmail und
Zoho Mail senden zuerst einen Bestätigungscode an die Adresse; er erscheint unter **Zurückgehalten**
mit dem Betreff des Anbieters, wo Sie den Code lesen. In Microsoft 365 muss eine Administratorin oder
ein Administrator die automatische Weiterleitung an eine externe Adresse unter Umständen erlauben.

Eine automatische Weiterleitung behält die Signatur des Lieferanten. Eine von Hand weitergeleitete
E-Mail signiert stattdessen Ihre eigene Domain; sie wird importiert, wenn Sie Mitglied sind, und die
Rechnung darin nennt weiterhin den Lieferanten.

### Erlaubte Absender

Fügen Sie unter **Erlaubte Absender** die genauen Adressen oder `@domain`-Einträge hinzu, deren
Rechnungen neben denen Ihrer Mitglieder importiert werden. Eine zurückgehaltene E-Mail eines
Lieferanten, dem Sie vertrauen, bietet **Absender erlauben und importieren**: Das fügt ihren Absender
hinzu und importiert die Rechnung.

### Zurückgehaltene E-Mails

**Zurückgehalten** listet jede weitergeleitete E-Mail, die nicht importiert wurde, mit Absender,
Betreff, Anhängen und Grund. Ihr Inhalt wird nie gezeigt; das Original bleibt in Ihrem Postfach.

- **Keine E-Rechnung gefunden**: Kein Anhang ist eine strukturierte Rechnung.
- **Absender nicht bestätigt**: Keine gültige Signatur der Domain des Absenders.
- **Absender nicht erlaubt**: Der Absender ist weder Mitglied noch erlaubter Absender.
- **Unbekannter Lieferant**: Kein E-Rechnungs-Anbieter oder mehr als einer hat einen Upload dieses
  Verkäufers. **In Anbieter importieren** importiert sie in den Anbieter Ihrer Wahl.
- **Import abgelehnt**: Die Rechnung wurde gelesen, aber abgelehnt, mit dem Grund, den ein Upload zeigen
  würde.
- **Grenze überschritten**: Die E-Mail ist größer als 25 MiB oder hat zu viele Teile oder verschachtelte
  Nachrichten.
- **Verarbeitung fehlgeschlagen**: Die E-Mail konnte nicht gelesen werden; leiten Sie sie erneut weiter
  oder laden Sie die Rechnung hoch.

Zurückgehaltene Rechnungen können 30 Tage lang importiert werden. Eine zurückgehaltene E-Mail wird
90 Tage lang gelistet.

### Adresse ersetzen

**Adresse ersetzen** gibt der Organisation eine neue Adresse. Die bisherige funktioniert sofort nicht
mehr; stellen Sie Ihre Weiterleitung auf die neue um.

## Daten und Aktualität

Ein Rechnungsupload wird der Reihe nach mit den anderen Uploads zu eigenen Anbietern verarbeitet
([Daten und Aktualität](/de/connect/custom-provider#daten-und-aktualität)).

Wird dieselbe Datei erneut hochgeladen, gibt Costfluent den ersten Upload zurück und importiert
nichts doppelt; die Konsole meldet, dass die Rechnung bereits unverändert hochgeladen wurde, und
nennt ihre Nummer, wenn dieser Upload auf der angezeigten Seite steht. Ein anderes Dokument mit einer Rechnungsnummer, die der Anbieter bereits enthält,
wird abgelehnt.

### Grenzen

- Eine Datei je Upload, höchstens 20 MiB groß.
- Höchstens 10.000 Positionen je Rechnung.

## Berichtsdimensionen

Was jede Gruppierungsdimension eines [Kostenberichts](/de/cost-reports/explore) für eine
Rechnungsposition enthält.

| Dimension | Für eine Rechnungsposition |
|---|---|
| **Verkäufer** | Der Name des eigenen Anbieters |
| **Dienst** | Die Artikelbezeichnung der Rechnungsposition |

Eine lieferantenspezifische Zuordnung gibt es noch nicht, daher ist der Dienst die
Artikelbezeichnung genau so, wie die Rechnung sie angibt.

## Die Public API verwenden

Ein Token mit **Integrationen verwalten** kann dasselbe über die Public API tun, wie die
[API-Referenz](/api) beschreibt:

1. `POST /v1/providers` mit `key` gleich `custom`, einem `displayName`, leeren `credentials` und
   `settings` mit `upload_format` gleich `einvoice` legt den Anbieter an. Ohne diese Einstellung
   nimmt der Anbieter FOCUS-CSV entgegen.
2. `POST /v1/custom-providers/{providerId}/uploads` nimmt eine Rechnung in einem Multipart-Feld
   namens `file` entgegen. Dieselbe Datei antwortet erneut mit dem ersten Upload; ein anderes
   Dokument mit einer Rechnungsnummer, die der Anbieter bereits enthält, wird mit `409` beantwortet.
3. `GET /v1/custom-providers/{providerId}/uploads` listet die Uploads auf, und
   `DELETE /v1/custom-providers/{providerId}/uploads/{uploadId}` löscht einen.

## Aktualisieren oder trennen

Löschen Sie einen Upload in seiner Zeile unter **Uploads**. Nur die Positionen dieser Rechnung
verlassen Ihre Kosten; die übrigen Rechnungen des Anbieters bleiben. Wenn Sie im Tab **Verwalten**
im Menü der Zeile des Anbieters **Verbindung entfernen** wählen, werden alle seine Kosten entfernt
([Verbindung entfernen](/de/connect/manage-connections#verbindung-entfernen)).

## Fehlerbehebung

Eine Rechnung, die Costfluent nicht vollständig lesen kann, lehnt es ab, importiert nichts davon und
nennt den Grund. In der Konsole zeigt die Ablehnung eine Überschrift und darunter den Grund des
Servers, auf Englisch: **Dieser Anbieter hat bereits ein anderes Dokument mit dieser Nummer** für
eine bereits vergebene Rechnungsnummer, **Dieser Anbieter kann diese Rechnung nicht aufnehmen** für
eine Rechnung eines anderen Rechnungsstellers oder eine Rechnungskorrektur, deren ursprüngliche
Rechnung fehlt, und **Die Rechnung konnte nicht gelesen werden** für die übrigen Gründe unten.

- **Die Rechnung hat keine Positionen.** Die ZUGFeRD- und Factur-X-Profile MINIMUM und BASIC WL
  enthalten keine Rechnungspositionen. Bitten Sie den Lieferanten um BASIC, EN 16931, EXTENDED oder
  XRechnung.
- **Das Format wird nicht gelesen.** ZUGFeRD 1.0 wird nicht gelesen, ebenso wenig eine Datei, die
  eine DOCTYPE-Deklaration enthält.
- **Das PDF enthält keine Rechnungsdaten.** Costfluent liest nur die XML-Datei, die ein PDF
  einbettet; Text einer gescannten oder gedruckten Rechnung erkennt es nicht.
- **Der Upload ist zu groß.** Er enthält mehr als eine Datei, die Datei ist größer als 20 MiB, oder
  die Rechnung hat mehr als 10.000 Positionen.
- **Der Rechnungstyp wird nicht gelesen.** Costfluent liest die Typen 380, 326, 384 und 381; eine
  Abrechnung im Gutschriftverfahren (389) oder jeder andere Typ wird abgelehnt.
- **Die Summen der Rechnung gehen nicht auf.** Ihre eigenen Summen passen nicht zu ihren Positionen.
  Bitten Sie den Lieferanten um eine Rechnungskorrektur.
- **Die Rechnung stammt von einem anderen Rechnungssteller.** Der Anbieter steht für den
  Lieferanten seiner ersten Rechnung. Legen Sie für den anderen Lieferanten einen eigenen Anbieter
  an.
- **Die ursprüngliche Rechnung der Rechnungskorrektur fehlt.** Laden Sie die Rechnung, auf die sie
  verweist, zuerst zum selben Anbieter hoch.
- **Die Rechnungsnummer ist bereits vergeben, in der Public API mit `409` beantwortet.** Der
  Anbieter enthält ein anderes Dokument mit derselben Nummer. Löschen Sie den falschen Upload und
  laden Sie dann den richtigen hoch.
- **Das Upload-Format lässt sich nicht ändern.** Der Anbieter hat bereits einen Upload. Legen Sie
  einen neuen Anbieter mit dem benötigten Format an.

## Verwandte Seiten

- [Kosten zu einem eigenen Anbieter hochladen](/de/connect/custom-provider)
- [Verbindungen verwalten](/de/connect/manage-connections)
- [Währung](/de/currency)
- [Kostendaten untersuchen](/de/cost-reports/explore)
