Run my Accounts API: Liste der Zahlungen

Eine Liste aller Zahlungen rufen Sie wie folgt ab:

GET https://service.runmyaccounts.com/api/{version}/clients/{mandantenname}/invoices/payment_list

Parameter zum einschränken der Abfrage

ParameterBeschreibungdefault Wert
processedZahlungstransaktionen ab und inkl. einer Datum/Uhrzeit (For­mat yyyy-MM-ddTHH:mm„), welche nicht prozessiert wurden.

Richtiges Vorgehen:

  1. Abholen aller unbearbeiteten Zahlungstranskationen nach (bzw. inkl.) einem Datum.
  2. Prozessieren der Zahlungen (neu und löschen) in der eigenen Software.
  3. Markieren der Zahlungstransaktionen als prozessiert.

Antwort

XML/JSON ElementBeschreibungDefault WertFeldtypPflicht Wert
idEindeutige Erkennung der Zahlung INT
invnumberRechnungsnummer TEXT
datepaidZahlungsdatum DATUMja
sourceBelegnummer der Zahlung TEXT
memoFreier Kommentar zur Zahlung TEXT
amount_paidBetrag der Zahlung DOUBLEja
payment_accnoZahlungskonto1020INT
currencyWährungCHFTEXT
exchangerateWechselkurs1.0DOUBLE
flagMögliche Werte sind: NEW (Zahlung wurde noch nie über API abgefragt), EVEN (Zahlung wurde bereits über API abgefragt, ist aber unverändert), MUTATED (Zahlung wurde bereits über API abgefragt, hat sich aber verändert) und DELETED (Zahlung wurde bereits über API abgefragt, wurde aber inzwischen gelöscht) TEXT

Beispiele

https://service.runmyaccounts.com/api/latest/clients/apitest/invoices/payment_list?processed=2011-08-01T23:59&api_key=d1bvbxkI8f1bnMBJ4sZiC-xupl4fOEzf

XML Beispiel Content:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<payments>
  <payment>
    <id>512</id>
    <invnumber>R-001</invnumber>
    <datepaid>2011-11-23T10:39:17.945+01:00</datepaid>
    <amount_paid>570.0</amount_paid>
    <source/>
    <memo>Anzahlung</memo>
    <payment_accno>1020</payment_accno>
    <exchangerate>1.0</exchangerate>
    <flag>NEW</flag>
  </payment>
</payments> 

JSON Beispiel:

{ payment:
[
{
  "id": "512",  
  "invnumber": "R-001",
  "datepaid": "2011-10-24T10:40:24.826+02:00",
  "amount_paid": "570.0",
  "source": "",
  "memo": "Anzahlung",
  "payment_accno": "1020",
  "exchangerate": "1.0"
  "flag": "NEW"
}
]
}

Zahlungstranskationen als prozessiert markieren:

POST https://service.runmyaccounts.com/api/{version}/clients/{mandantenname}/invoices/set_as_processed

Content-Type: application/x-www-form-urlencoded

Formular ParameterBeschreibungdefault Wert
idId der Zahlungstransaktion