Run my Accounts API: Beispiel B1.1 - Gutschrift einbuchen

An diesem Beispiel zeigen wir Ihnen, wie Sie eine Gutschrift über das Run my Accounts API einbuchen können:

Voraussetzung: Rechnung gebucht, wie zum Beispiel hier.

Aufruf:

POST https://service.runmyaccounts.com/api/latest/clients/{mandant}/invoices

XML:

<?xml version="1.0" encoding="UTF-8"?>
<invoice>
   <invnumber>B1.1</invnumber>
   <ordnumber />
   <status>OVERDUE</status>
   <currency>CHF</currency>
   <ar_accno>1100</ar_accno>
   <transdate>2012-08-06T00:00:00+02:00</transdate>
   <duedate>2012-08-06T00:00:00+02:00</duedate>
   <description>Gutschrift</description>
   <notes />
   <intnotes />
   <taxincluded>false</taxincluded>
   <customernumber>K-001</customernumber>
   <incomeentries>
      <incomeentry>
         <amount>-300.0</amount>
         <income_accno>3400</income_accno>
         <description />
      </incomeentry>
   </incomeentries>
   <taxentries>
      <taxentry>
         <amount>-24.0</amount>
         <tax_accno>2201</tax_accno>
      </taxentry>
   </taxentries>
</invoice>

JSON:


    {
       "invnumber": "B1.1",
       "ordnumber": "",
       "status": "OVERDUE",
       "currency": "CHF",
       "ar_accno": "1100",
       "transdate": "2012-08-06T00:00:00+02:00",
       "duedate": "2012-08-06T00:00:00+02:00",
       "description": "Gutschrift",
       "notes": "",
       "intnotes": "",
       "taxincluded": "false",
       "customernumber": "K-001",
       "incomeentries":
       {
           "incomeentry":
           {
               "amount": "-300.0",
               "income_accno": "3400",
               "description": ""
           }
       },
       "taxentries":
       {
           "taxentry":
           {
               "amount": "-24.0",
               "tax_accno": "2201"
           }
       }
    }

Teilschliessung der offenen Rechnung:

Die ursprüngliche Rechnung wird entweder Teilbezahlt oder gar nicht bezahlt. Da der teil-unbezahlte Betrag offen bleibt, muss dieser über das Transferkonto und damit gegen die Gutschriftsbuchung ausgeglichen werden. Dies geschieht über das das Transferkonto 1090.

POST https://service.runmyaccounts.com/api/latest/clients/{mandant}/invoices/R-001/payments

XML:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<payment>
  <datepaid>2011-11-01T08:57:09.769+02:00</datepaid>
  <amount_paid>324.0</amount_paid>
  <source/>
  <memo>Teilschliessung</memo>
  <payment_accno>1090</payment_accno>
</payment>

JSON:

{
  "datepaid": "2011-11-01T08:57:09.769+02:00",
  "amount_paid": "324.0",
  "memo": "Teilschliessung",
  "payment_accno": "1090"
}

Schliessung der Gutschrift:

POST https://service.runmyaccounts.com/api/latest/clients/{mandant}/invoices/G-001/payments

Da die Gutschrift ebenfalls nicht automatisch geschlossen wird, muss diese ebenfalls geschlossen werden, damit das Transferkonto auf 0 saldiert wird. Achten Sie darauf, dass die Schliessung der Rechnung als auch der Gutschrift am selben Datum geschieht, damit das Transferkonto zu jeder Zeit auf 0 zu stehen kommt.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<payment>
  <datepaid>2011-11-01T08:57:09.769+02:00</datepaid>
  <amount_paid>-324.0</amount_paid>
  <source/>
  <memo>Schliessung der Gutschrift</memo>
  <payment_accno>1090</payment_accno>
</payment>

JSON:

{
  "datepaid": "2011-11-01T08:57:09.769+02:00",
  "amount_paid": "-324.0",
  "memo": "Schliessung der Gutschrift",
  "payment_accno": "1090"
}

Die eigentliche Zahlung wird analog diesem Beispiel gemacht.