View on GitHub

runmyaccounts-rest-api

RESTful API Documentation

Use cases

(Sorry, German only)

Create invoice

Artikel-Variante

Nr Short description Examples Description
A5 Rechnung mit Artikel einbuchen A5.1 Rechnung mit x Artikeln einbuchen. Den Artikeln sind sowohl Buchhaltungskonten als auch MWST Codes zugeordnet. Auf die Kontierung und die MWST kann über die Artikel kein Einfluss ausgeübt werden.
A6 Rabatt mit Artikel A6.1 Auf einer Rechnung soll transparent ein Rabatt ausgewiesen und dieser soll als negativer Umsatz (wahlweise über einen speziellen Rabatt-Artikel oder auf einen normalen Umsatzartikel) gebucht werden. Die Rabattbuchung ist MWST-relevant analog A5. Die MWST Buchung muss nicht berücksichtigt werden, da dies über den Artikel gesteuert wird.
A7 Akonto A7.1 Ein Betrag wird über ein Akonto-Artikel auf ein Passiven-Konto (z.B. 2030 - Anzahlungen von Kunden) gebucht. Falls Relevant werden auch MWST Beträge über den Artikel auf MWST Konten gebucht.
A8 Akonto Schlussabrechnung A8.1 Gesamtbetrag wird mit x Artikeln gebucht. Ein oder mehrere negative Akonto Artikel in der gesamten Höhe der Akontozahlungen werden abgezogen

Buchungs-Variante (ohne Artikel)

Nr Short description Examples Description
A1 Rechnung einbuchen A1.1 A1.2 x Beträge werden auf x Buchhaltungskonten (Ertragskonten) kontiert. Falls Relevant wird werden auch MWST Beträge auf MWST Konten gebucht.
A2 Rabatt A2.1 Auf einer Rechnung soll transparent ein Rabatt ausgewiesen und dieser soll als negativer Umsatz (wahlweise auf ein spezielles Rabatt-Konto oder auf ein Umsatzkonto) gebucht werden. Die Rabattbuchung ist MWST-relevant analog A1.
A3 Akonto Buchung A3.1 Ein Betrag wird auf ein Passiven-Konto (z.B. 2030 - Anzahlungen von Kunden) gebucht. Falls Relevant werden auch MWST Beträge auf MWST Konten gebucht.
A4 Akonto Schlussabrechnung A4.1 Gesamtbetrag wird als x Beträge auf x Buchhaltungskonten gebucht (Ertragskonten). Ein negativer Akonto Betrag in der gesamten Höhe der Akontozahlungen wird vom Passivenkonto abgezogen

Gutschrift

Artikel-Variante

Nr Short description Examples Description
B2 Gutschrift mit Artikel buchen B2.1 Eine Gutschrift wird exakt wie eine Rechnung behandelt, nur dass die Beträge auf den Artikeln negativ eingebucht werden. Die Gutschriftsbeträge auf den einzelnen Artikeln dürfen sich von den Rechnungsbeträgen unterscheiden.

Buchungs-Variante (ohne Artikel)

Nr Short description Examples Description
B1 Gutschrift buchen B1.1 Eine Gutschrift wird exakt wie eine Rechnung behandelt, nur dass die Beträge auf den Konten negativ eingebucht werden. Die Gutschriftsbeträge auf den einzelnen Konten dürfen sich von den Rechnungsbeträgen unterscheiden.

Rechnung löschen

Das Löschen von Rechnungen ist nicht vorgesehen, da in einer ordentlich geführten Buchhaltung Löschungen nicht vorgesehen sind. Falsch eingebuchte Rechnungen sollen über Gutschriften über die selben Beträge und Artikel neutralisiert werden

Artikel-Variante

Nr Short description Examples Description
C3 Storno mit Artikel buchen C3.1 Ein Storno wird exakt wie eine Rechnung behandelt, nur dass die Artikel negativ eingebucht werden. Der Storno hat das selbe Datum wie die Rechnung. Die Stornobeträge auf den einzelnen Artikeln dürfen sich nicht von den Rechnungsbeträgen unterscheiden. Ausbuchen des Stornos über das Transferkonto. Ein Storno kann nur gebucht werden, so lange Run my Accounts keine MWST Abrechnung erstellt hat. Alternative: Gutschrift mit aktuellem Datum

Buchungs-Variante (ohne Artikel)

Nr Short description Examples Description
C2 Storno buchen C2.1 Ein Storno wird exakt wie eine Rechnung behandelt, nur dass die Beträge auf den Konten negativ eingebucht werden. Der Storno hat das selbe Datum wie die Rechnung. Die Stornobeträge auf den einzelnen Konten dürfen sich nicht von den Rechnungsbeträgen unterscheiden. Ausbuchen des Stornos über das Transferkonto. Ein Storno kann nur gebucht werden, so lange Run my Accounts keine MWST Abrechnung erstellt hat. Alternative: Gutschrift mit aktuellem Datum

Zahlungen

Nr Short description Examples Description
D1 Zahlung erfassen D1.1 Eine Zahlung wird unter Angabe von Datum, Betrag und Kontonummer eingebucht. Die Zahlung muss dem tatsächlich auf dem Bankkonto oder in der Kasse eingegangenen Betrag entsprechen. Teilzahlungen sind möglich.
D2 Rabatt/Preisnachlass D2.1 Entspricht der Zahlung nicht exakt dem offenen Rechnungsbetrag und soll auf eine weitere Zahlungseintreibung resp. Rückvergütung verzichtet werden, kann der noch offene / überschüssige Betrag über das Konto 3901 Rabatte und Preisnachlässe ausgebucht werden.
D3 Bank- / PC-Spesen D3.1 Ist der Zahlungseingang tiefer als die offene Position, weil die Banktransaktion für den Empfänger kostenpflichtig war, kann die Differenz auf das Konto 6840 Bank-/PC-Spesen gebucht werden
D4 Skonto D4.1 Macht der Rechnungsempfänger einen Skonto-Abzug geltend, wird der Skontobetrag auf das Konto 3900 gebucht.
D5 Transferkonto D5.1 Das Transferkonto wird dazu verwendet, Rechnungen / Gutschriften / Stornos miteinander zu verrechnen. Eine Position wird mit einem Betrag geschlossen, eine andere Position wird durch einen negativen Betrag ebenfalls geschlossen, so dass sich der Saldo des Transferkonto nicht verändert. Achtung: Nach Abschluss aller Transaktionen muss das Transferkonto auf 0 stehen.