Coupa Pay-Auszüge-API (/coupa_pay/statements)
Auszüge von Zahlungspartnern können mit einem API-GET-Aufruf abgerufen werden, und ein PUT-AUFRUF kann diesen Auszug als exportiert markieren.
Übersicht
Kontoauszüge von Geschäftskarten-Zahlungspartnern, die den Status zur Zahlung genehmigt haben, können von Coupa an das ERP abgerufen werden, indem eine GET-Anforderung an den Kontoauszugs-API-Endpunkt gesendet wird: https://{your_instance_name}/api/coupa_pay/statements
Sobald ein Auszug für die Buchhaltung oder ERP-Zahlung exportiert wurde, sollte dieser Auszug mit dem PUT-Aufruf als exportiert markiert werden, damit er nicht ein zweites Mal abgerufen wird.
Unterstützte API-Vorgänge:
- ABFRAGEN
- PUT(nur um exportiert zu markieren)
Der API-Schlüssel, der zum Abrufen/Aktualisieren von Daten verwendet wird, muss über die Berechtigung zum Indizieren, Anzeigen und Aktualisieren von Api/Coupa_Pay/Abrechnungsdaten verfügen.
Auszugsdaten können von allen Feldern innerhalb der Nutzlast abgefragt werden. Typische Abfrageparameter sind:
- ?exported=false
- ?payment-partner[issuing-bank]=<Bank_Name>
- ?status=approved_for_payment (Status ist nicht in der Nutzlastantwort enthalten)
Diese Abfrageparameter können wie folgt zu einer Anweisung kombiniert werden:
-
API ABRUFEN
https://{your_instance_name}/api/coupa_pay/statements?status=approved_for_payment&exported=false&payment-partner[issuing-bank]=XYZBank
- Dadurch werden Abrechnungen für XYZBank Issuer Payment Partner zurückgegeben, die genehmigt, aber nicht exportiert wurden.
- Für ERP-Zahlungen sollten Sie nur genehmigte Abrechnungen von Coupa in das ERP ziehen.
Eine exportierte Anweisung sollte nach erfolgreichem Abruf als exportiert markiert werden. Sie können dies mit einem Anruf wie dem folgenden tun:
-
API-PUT
https://{your_instance_name}/api/coupa_pay/statements/<ID>?exported=true
oder -
API
https://{your_instance_name}/api/coupa_pay/statements/<ID>
mit einer Nutzlast wie:-
<statement><exported>wahr</exported></statement>
-
Elemente
iD | Eindeutiger Identifikator (schreibgeschützt) | Ja | ja | ganze Zahl | |||
created-at | Automatisch von Coupa erstellt im Format JJJJ-MM-TTTHH:MM:SS+HH:MMZ (schreibgeschützt) | ja |
zeichenfolge($datetime) |
||||
updated-at | Automatisch von Coupa erstellt im Format JJJJ-MM-TTTHH:MM:SS+HH:MMZ (schreibgeschützt) | ja | zeichenfolge($datetime) | ||||
external-ref-id | Externe Referenzkennung | Ja | ja | string(255) | |||
coupa-pay-id | ja | ganze Zahl | |||||
name | Name | string(255) | |||||
betrag | dollarbetrag für diese Zuweisung | ja | dezimalzahl(30,2) | ||||
statement-Datum | Quittungszeitstempel im Format: JJJJ-MM-TTTHH:MM:SS+HH:MMZ | Ja | ja | zeichenfolge($datetime) | |||
anzahl der Zeilen | (schreibgeschützt) | Ja | ganze Zahl | ||||
gesamt | Summe aller Auszugszeilen (schreibgeschützt) | Ja | dezimalzahl(16,10) | ||||
last-exported-at | zeitstempel | zeichenfolge($datetime) | |||||
exported | Richtig / Falsch war die Aussage, die an ein externes Aufzeichnungssystem gesendet wurde. (schreibgeschützt) | Ja | boolean | ||||
payment-partner | Coupa Pay - Virtueller Kartenpartner | ||||||
währung | Währung | ja | ja | ||||
erstellt von | Benutzer der Erstellung | ja | |||||
aktualisiert von | Benutzer der Aktualisierung | ja |