Thereforeâ„¢-Hilfe

Ein PISTE-Konto erstellen

 

•Gehen Sie zu https://developer.aife.economie.gouv.fr/en/component/apiportal/registration und erstellen Sie ein Konto. Ein PISTE-Konto ist erforderlich, um eine sichere Verbindung zwischen Thereforeâ„¢ und dem Chorus-Portal herzustellen. Es ermöglicht den Zugriff auf einen begrenzten Satz von API-Funktionen mithilfe der bereitgestellten PISTE-Anmeldeinformationen.

•Melden Sie sich bei der folgenden Website an: https://developer.aife.economie.gouv.fr/en/apps

 

Die Anwendung konfigurieren

Ein PISTE-Konto hostet mehrere Anwendungen (Produktion und/oder Sandbox). Jede Anwendung hat ihre eigene eindeutige ID und einen eigenen Geheimwert, der in der Azure-Funktionskonfiguration verwendet wird. Erstellen Sie für jede dieser Strukturen eine getrennte PISTE-Anwendung.

 

 

 

 

So rufen Sie eine PISTE-ID und einen Geheimwert ab:

 

Wählen Sie die Anwendung "TFO_Piste_App" auf der Registerkarte "Anwendungen". Gehen Sie auf der Registerkarte "OAuth-Anmeldeinformationen" zu "Details".
Die Client-ID ist die ID der aktuellen Anwendung. Klicken Sie auf "Geheimnis anzeigen", um den Geheimwert anzuzeigen.

 

 

 

 

 

 

 

So verbinden Sie ein Chorus-Konto mit einem PISTE-Konto:

 

Fügen Sie die Registerkarte "EDI- und API-Verbindungen" über die folgenden Schritten hinzu.

a)Melden Sie sich mit dem Hauptkonto (nicht mit dem technischen Konto) beim Chorus-Portal an. Rufen Sie die Registerkarte "Manageraktivitäten" auf. Erweitern Sie "Bereiche der Struktur auflisten" und klicken Sie auf die Schaltfläche "+Bereiche hinzufügen".

b)Aktivieren Sie in der Spalte "Ändern die" Kontrollkästchen "Sulvl des Flux" und "Raccordement EDI et API" (dies wird später benötigt). Klicken Sie auf "Validieren".

 

c)Rufen Sie die Registerkarte "EDI- und API-Verbindungen" im Chorus Pro-Portal auf. Navigieren Sie zu "API-Verbindung verwalten".

d)Navigieren Sie zu "Deklarations-API-Verbindungsanfrage von PISTE".

e)Wählen Sie die für Sie passende Struktur aus. Wählen Sie Ihren PISTE-App-Namen aus dem Set "PISTE-Anwendungsname" aus.  Wählen Sie "Benutzer einer internen Anwendung" aus dem Set "Verwendungsart" aus. Für jede Struktur ist eine getrennte App erforderlich.

Geben Sie unter "Technischer Kontakt" die Details der Person ein, die für diese API-Verbindung verantwortlich ist.

 

 

Einen neuen Workflow für das Hochladen an Chorus erstellen

 

Erstellen Sie einen Workflow für Ihre Upload-Aktivität. Die folgende Grafik zeigt ein grundlegendes Beispiel für einen Workflow.

Ein Workflow besteht aus zwei Workflow-Aktivitäten.

1.Aktivität "Indexdaten einbetten"

Diese Aktivität bettet XML in eine PDF/A-3-Datei ein (die Workflow-Aktivität konvertiert PDF zu PDF/A-3).

2.Aktivität "Funktion aufrufen"

Diese Aktivität löst die Azure-Funktion aus, mit Argumenten wie dem technischen Konto und dem Kennwort für Chorus Pro. Die Azure-Funktion führt die folgenden Schritte aus:

a)OAuth-Token von PISTE abrufen.

b)Datei nach Chorus Pro hochladen.

c)Prüfen, ob die Datei hochgeladen und von Chorus erfolgreich verarbeitet wurde.

d)Alle während der Verarbeitung/des Hochladens aufgetretenen Fehler im Workflow-Verlauf und im Chorus-Portal unter "Datenfluss-Überblick" anzeigen.

e)Wenn der Status der Rechnung "Integriert" ist, wird sie unter "Ausgestellte Rechnungen" gespeichert und sie kann über die Registerkarten "Suchen" oder "Dashboard" aufgerufen werden.

 

Workflow-Aktivitäten einrichten

 

Aktivität "Indexdaten einbetten"

Wenn mehr als eine Rechnung einem Therefore™-Dokument entspricht, führen Sie die Rechnungen über das Kontrollkästchen "In eine Datei zusammenführen" zu einer Datei zusammen. Andernfalls lädt Chorus nur die erste Rechnung hoch. Beachten Sie, dass nur Dateien mit einer Größe von maximal 90 MB an Chorus gesendet werden können.

 

Verwenden Sie die folgenden Einstellungen:

-Profil: "Factur–X"

-Konformitätsstufe: "EN16931"

-Name der eingebetteten XML-Datei: Standard (factur-x.xml)

Klicken Sie auf "Vorlagen-XML laden…" und wählen Sie die unten angefügte XML-Datei aus (minimal erforderliche XML-Datei). Sie enthält die erforderlichen Informationen, die unter "Indexdaten als XML (vorlagenbasiert)" bereitgestellt werden müssen.

 

Geben Sie die folgenden Daten ein, nachdem die XML-Vorlage geladen wurde. Verwenden Sie dazu die Indexdatenwerte aus Kategorie. Wenn ein Feld leer bleibt, wird es mit Werten aus der ausgewählten XML-Vorlage befüllt.

Verwenden Sie die folgenden Einstellungen.

1.urn:factur-x.eu:1p0:minimum

2.Eindeutige Rechnungsnummer. Achten Sie darauf, dies als Zeichenfolge zu belassen.

3.380

4.Ausstellungsdatum und Uhrzeit. Um sicherzustellen, dass das Datum im richtigen Format vorliegt, fügen Sie das Format in die XML-Datei ein. Wenn Sie die oben angefügte Datei factur-x.xml verwenden, sind keine Änderungen erforderlich.
<udt:DateTimeString format="102">

5.Name des Verkäufers

6.SIRET-Nummer des Verkäufers. Muss 14 Ziffern lang sein. Wenn die SIRET-Nummer weniger als 14 Ziffern hat, fügen Sie wie erforderlich Nullen hinzu (z. B. 123 => 00000000000123). Die Zahl muss als Zeichenfolge belassen werden.

7.Landes-ID (z. B. FR für Frankreich)

8.Name des Käufers.

9.SIRET-Nummer des Käufers. Muss 14 Ziffern lang sein. Wenn die SIRET-Nummer weniger als 14 Ziffern hat, fügen Sie wie erforderlich Nullen hinzu (z. B. 123 => 00000000000123). Die Zahl muss als Zeichenfolge belassen werden.

10.Landes-ID (z. B. FR für Frankreich)

11.Auftragsnummer. Diese Zahl muss genau 10 Ziffern lang sein. Sie ist nur dann verbindlich, wenn "Numéro d’Engagement obligatoire" auf "Oui" eingestellt ist, für das Unternehmen, das Sie suchen unter: https://communaute.chorus-pro.gouv.fr/annuaire-des-entites-publiques-destinatrices-de-factures/?lang=en

12.Muss leer sein

13.Währungscode der Rechnung (z. B. EUR für Euro)

14.Betrag ohne Steuern

15.MwSt

16.Betrag inklusive Steuern

17.Zu zahlenden Betrag aus der Rechnung

 

 

Die Vorlage factur-x.xml enthält noch ein weiteres Feld: BuyerReference.

 

 

Weitere Informationen über Factur-X finden Sie in der folgenden Dokumentation:

Factur-X-Referenz

Aktivität "Funktion aufrufen"

Anfrage-URL:

https://tfochorusupload.azurewebsites.net/api/v1/ChorusUpload

cpro_account und cpro_password sind Ihr technisches Konto und Ihr Kennwort für Chorus Pro.
piste_account and piste_password sind Ihr Konto und Ihre Kennwort für PISTE.

Diese Azure-Funktion ist nur für Therefore™ Online in Europa verfügbar.
 

 

 

Häufige auftretende Fehler

 

Fehler: ExchangedDocument ID existiert bereits in Ihrer Struktur in Chorus.

Lösung: Prüfen Sie, ob das Dokument bereits hochgeladen wurde (manchmal kann die Azure-Funktion zweimal für dasselbe Dokument aufgerufen werden). Ist dies nicht der Fall, ändern Sie die ExchangedDocument ID.

 

Fehler: Die SIRET-Nummer für den Verkäufer oder den Käufer hat ungültige Anzahl von Ziffern (mehr oder weniger als 14).

Lösung: Wenn die SIRET-Nummer kürzer als 14 Ziffern ist, fügen Sie wie erforderlich Nullen hinzu.

Beispiel: SIRET ist 12345. Eingabe: 00000000012345.

 

Fehler: SIRET-Nummer für Verkäufer oder Käufer existiert nicht in Chorus.

Lösung: Überprüfen Sie hier, ob die SIRET-Nummer korrekt ist. Geben Sie den Namen oder die SIRET-Nummer des Unternehmens ein und prüfen Sie die Informationen.
https://communaute.chorus-pro.gouv.fr/annuaire-des-entites-publiques-destinatrices-de-factures/?lang=en

 

Fehler: Nicht alle Pflichtfelder sind ausgefüllt.

Lösung: Füllen Sie alle Pflichtfelder aus. Wenn Felder ausgefüllt sind, vergewissern Sie sich, dass

GuidelineSpecifiedDocumentContextParameter ID den Wert urn:factur-x.eu:1p0:minimum hat und dass die korrekte XML-Datei verwendet wurde.

 

Fehler:  "Kontaktieren Sie Ihren Administrator, um die PISTE-Anmeldeinformationen einzurichten/zu konfigurieren" im Workflow-Verlauf.

Lösung: Kontaktieren Sie Ihren Administrator. Bei TFO, wenden Sie sich an den Therefore-Support.