Beiträge in diesem Abschnitt

Notifications

Nasif Siddiqui
  • Aktualisiert
Folgen

Notifications dienen der Kommunikation zwischen Servern - also die Kommunikation von einer Applikation zu einer anderen Applikation. So wird ermöglicht, dass der Eintritt eines bestimmten Ereignisses (bspw. Buchung eines neuen Produkts, Änderung von Kundendaten) einer damit verbundenen Applikation mitgeteilt und daraufhin eine entsprechende Reaktion ausgelöst wird. Die Mitteilungen zu den Ereignissen werden als Notifications bezeichnet. Ein JSON Post Request wird an die hinterlegte URL geschickt. Dieser POST Request enthält einen „Contentstream“, wodurch es keine Limitierung auf den Inhaltsumfang gibt. Der Request lässt sich beispielsweise so auswerten:

 

$data = json_decode(file_get_contents("php://input"), true);
echo $data['type'];

 

Die Einstellungen finden Sie unter

 

⇨ Konto-Einstellungen ⇨ Grundeinstellungen ⇨ API & Notifications

Um die Daten zusätzlich zu schützen, ist es möglich einen Benutzernamen und ein Passwort festzulegen (HTTP Basic Authentication).

Sie haben die Möglichkeit auch Notifications per Email zu empfangen, was sich gut zu Test- und Auswertungszwecken eignet.

mceclip0.png

 

Empfang der Notifications gewährleisten

Um sicherzustellen, dass die Notifications von Monsum übermittelt werden, muss folgendes beachtet werden:

 

  • Unter ⇨ Kontoeinstellungen ⇨ Einstellungen ⇨ Grundeinstellungen ⇨ API & Notifications ⇨ Neuer Webhook müssen Empfänger-URL und ggf. Benutzername und Passwort richtig hinterlegt werden.              
  • Nach dem erfolgreichen Versand der Notification muss Monsum einen HTTP Status Code zwischen 200 und 299 als Antwort erhalten. Liegt der Code nicht in diesem Bereich bzw. erhält Monsum keine Antwort, so gilt der Versand als fehlgeschlagen. In diesem Fall wird die Notification im 10-Minuten-Takt fünf weitere Male versandt. Dabei handelt es sich jedes Mal um die identische Notification.         
  • Sollte Ihr Server über einen längeren Zeitraum nicht erreichbar sein, wenden Sie sich bitte an unser Monsum-Team.

Übersicht aller Notifications

Notification

Erklärung

 customer.created

Kunde erstellt

 customer.changed

Kundendaten geändert

 customer.deleted

Kundenakte gelöscht

 subscription.created

Abonnement gebucht/erstellt

 subscription.changed

Abonnement/-daten geändert

 subscription.canceled

Abonnement gekündigt (Abo endet am Kündigungstag)

 subscription.closed

Abonnement Ende (Kündigungstag erreicht)

 subscription.reactivate

Aufhebung der Kündigung

 payment.created

Rechnung erstellt / Zahlung erhalten

 payment.failed

Zahlung fehlgeschlagen

 payment.reminded

Mahnung zu Rechnung versendet

 payment.chargeback

Zahlung zurückgebucht (Rücklastschrift)

 payment.refunded

Zahlung erstattet wird aktuell nicht verschickt → ist jedoch zukünftig geplant)

 invoice.created

Rechnung wurde erstellt (automatisch/manuell)

 invoice.deleted

Rechnung wurde gelöscht (nur im Entwurf möglich)

 invoice.changed

Rechnungsdaten wurde geändert (wird mehrmals beim Erstellen versendet)

 

Wann werden welche Notifications erzeugt?

Das Erzeugen von Notifications steht im Zusammenhang mit Änderungen im Account, das heißt in den Kundendaten, bei den Abonnements oder den Rechnungen/Zahlungen. Hierbei werden sowohl manuelle (über das Backend oder die API), wie auch automatische Ereignisse berücksichtigt. Die Bezeichnung beschreibt das Ereignis, welches die Notification ausgelöst hat.

 

Beispiel:         1. Löschen einer Kundenakte

                                   

↳ Notification: customer.deleted

 

  1. Anlegen eines neuen Kunden mit Abo-Buchung (ohne Testzeit)

 

↳ neue Kundenakte erstellt

→ Notification: customer.created

                                   

↳ neues Abonnement gebucht

→ Notification:  subscription.created

                                   

↳ neue Rechnung erstellt

→ Notification: payment.created, invoice.created

 

 

Notification Beispiele

Neue Kundenakte erstellt - customer.created

Nach dem Erstellen einer neuen Kundenakte über die Hosted Pages, die API oder im Backend bzw. durch den Import vorhandener Kundendaten, wird eine Notification mit diesem Aufbau erzeugt:

{ 
" id ":269922, 
" type ": " customer.created ", 
" customer ": {
" customer_id ":"578266",
" customer_ext_uid ":null,
" hash ":"a3ba6fa5022f231f72885cc8a7d0a8c9",
" customer_number ":"0077",
" companyname ":"Muster GmbH",
" title ": "Dr",
" salutation ":"Herr", 
" firstname ":"Martin",
" lastname ":"Muster", 
" address ":"",
" address_2 ":"", 
" zipcode ":"", 
" city ": "Musterhausen",
" country_code ": "DE",
" email ": "m.muster@e¬mail.de",
"payment_data_url":"https:\/\/automatic.fastbill.com\/accountdata\/5fb2caf9f2313b53870df18708127296\/a3 ba6fa5022f231f72885cc8a7d0a8c9",
"dashboard_url":"https:\/\/automatic.fastbill.com\/dashboard\/5fb2caf9f2313b53870df18708127296\/a3ba 6fa5022f231f72885cc8a7d0a8c9" 
} 
}

 

Ändern der Kundendaten - customer.changed

Bei Änderung der Kundendaten bzw. der Zahlungsdaten über die API, die Hosted Pages oder im Backend, ist die erzeugte Notification wie folgt strukturiert:

{
"id": 269874,
"type": "customer.changed",
"customer": { "customer_id": "578266",
"customer_ext_uid": null,
"hash": "a3ba6fa5022f231f72885cc8a7d0a8c9",
"customer_number": "0077",
"companyname": "Muster GmbH",
"title": "Dr.",
"salutation": "Herr",
"firstname": "Martin",
"lastname": "Muster",
"address": "Am Musterhuegel 12",
"address_2": "Postfach 4",
"zipcode": "01234",
"city": "Musterhausen",
"country_code": "DE",
"email": "m.muster@e-mail.com",
"payment_data_url":
"https:\/\/automatic.fastbill.com\/accountdata\/5fb2caf9f2313b53870df18708127296\/a3ba6fa5022f231f72885cc8a7d0a8c9",
"dashboard_url":
"https:\/\/automatic.fastbill.com\/dashboard\/5fb2caf9f2313b53870df18708127296\/a3ba6fa5022f231f72885cc8a7d0a8c9"
}
}

 

Löschen einer Kundenakte - customer.deleted

Wird mittels des Backends oder der API eine Kundenakte gelöscht, erzeugt dies eine Notification mit folgender Zusammensetzung:


{
"id": 270034,
"type": "customer.deleted",
"customer": { "customer_id": "578266",
"customer_ext_uid": null,
"hash": "a3ba6fa5022f231f72885cc8a7d0a8c9",
"customer_number": "0077",
"companyname": "Muster GmbH",
"title": "Dr.",
"salutation": "Herr",
"firstname": "Martin",
"lastname": "Muster",
"address": "Am Musterhuegel 12",
"address_2": "",
"zipcode": "01234",
"city": "Musterhausen",
"country_code": "DE",
"email": "m.muster@e-mail.de",
"payment_data_url": "https:\/\/automatic.fastbill.com\/accountdata\/5fb2caf9f2313b53870df18708127296\/a3ba6fa5022f231f72885cc8a7d0a8c9",
"dashboard_url": "https:\/\/automatic.fastbill.com\/dashboard\/5fb2caf9f2313b53870df18708127296\/a3ba6fa5022f231f72885cc8a7d0a8c9"
}
}

 

Neues Abonnement erstellt - subscription.created

Bei der Buchung bzw. Erstellung eines neuen Abonnements im Account z.B. über die Buchungsformulare, wird eine Notification mit einer solchen Struktur erzeugt:

{
"id":398154,
"type": "subscription.created",
"customer": { 
 "customer_id": "578266",
 "customer_ext_uid": null,
 "hash": "a3ba6fa5022f231f72885cc8a7d0a8c9",
 "customer_number": "0077",
 "companyname": "Muster GmbH",
 "title": "Dr.",
 "salutation": "Herr",
 "firstname": "Martin",
 "lastname": "Muster",
 "address": "Am Musterhuegel 12",
 "address_2": "",
 "zipcode": "01234",
 "city": "Musterhausen",
 "country_code": "DE",
 "email": "m.muster@e-mail.de",
 "payment_data_url": "https:\/\/automatic.fastbill.com\/accountdata\/5fb2caf9f2313b53870df18708127296\/a3ba6fa5022f231f72885cc8a7d0a8c9",
 "dashboard_url": "https:\/\/automatic.fastbill.com\/dashboard\/5fb2caf9f2313b53870df18708127296\/a3ba6fa5022f231f72885cc8a7d0a8c9"
},
"subscription": { 
 "subscription_id": 216084,
 "subscription_ext_uid": "",
 "hash": "619ce278a8aaafddba697fcf2cd4bd62",
 "article_code": "072",
 "quantity": "1",
 "start_date": "2014-03-13 11:36:04",
 "last_event": "2014-03-13 11:36:04",
 "next_event": "2014-03-20 11:36:04",
 "cancellation_date": "0000-00-00 00:00:00",
 "status": "trial",
 "expiration_date": "2014-03-20 11:36:04"
},
"created": "2014-03-13 11:36:04"
}

 

Änderungen im Abonnement - subscription.changed

Es können Änderungen am Abonnement vorgenommen werden, wie das Hinzufügen eines Rabattcodes. Dadurch entsteht eine folgenderweise aufgebaute Notification:

{
"id": 398158,
"type": "subscription.changed",
"customer": { 
 "customer_id": "578266",
 "customer_ext_uid": null,
 "hash": "a3ba6fa5022f231f72885cc8a7d0a8c9",
 "customer_number": "0077",
 "companyname": "Muster GmbH",
 "title": "Dr.",
 "salutation": "Herr",
 "firstname": "Martin",
 "lastname": "Muster",
 "address": "Am Musterhuegel 12",
 "address_2": "Postfach",
 "zipcode": "01234",
 "city": "Musterhausen",
 "country_code": "DE",
 "email": "m.martin@e-mail.de",
 "payment_data_url": "https:\/\/automatic.fastbill.com\/accountdata\/5fb2caf9f2313b53870df18708127296\/a3ba6fa5022f231f72885cc8a7d0a8c9",
 "dashboard_url": "https:\/\/automatic.fastbill.com\/dashboard\/5fb2caf9f2313b53870df18708127296\/a3ba6fa5022f231f72885cc8a7d0a8c9"
},
"subscription": { 
 "subscription_id": 216084,
 "subscription_ext_uid": "",
 "hash": "619ce278a8aaafddba697fcf2cd4bd62",
 "article_code": null,
 "quantity": null,
 "start_date": "2014-03-13 11:36:04",
 "last_event": "2014-03-13 11:36:04",
 "next_event": "2014-03-06 00:00:00",
 "cancellation_date": "0000-00-00 00:00:00",
 "status": "trial",
 "expiration_date": "2014-03-21 00:00:00"
},
"created": "2014-03-13 11:37:07"
}

 

 

Kündigung des Abonnements - subscription.canceled

Beendet ein Kunde sein Abonnement über die möglichen Kündigungswege, ist die anschließend erzeugte Notification folgendermaßen strukturiert:

{
"id": 398310,
"type": "subscription.canceled",
"customer": { 
 "customer_id": "578266",
 "customer_ext_uid": null,
 "hash": "a3ba6fa5022f231f72885cc8a7d0a8c9",
 "customer_number": "0077",
 "companyname": "Muster GmbH",
 "title": "Dr.",
 "salutation": "Herr",
 "firstname": "Martin",
 "lastname": "Muster",
 "address": "Am Musterhuegel 12",
 "address_2": "Postfach 4",
 "zipcode": "01234",
 "city": "Musterhausen",
 "country_code": "DE",
 "email": "m.muster@e-mail.de",
 "payment_data_url": "https:\/\/automatic.fastbill.com\/accountdata\/5fb2caf9f2313b53870df18708127296\/a3ba6fa5022f231f72885cc8a7d0a8c9",
 "dashboard_url": "https:\/\/automatic.fastbill.com\/dashboard\/5fb2caf9f2313b53870df18708127296\/a3ba6fa5022f231f72885cc8a7d0a8c9"
},
"subscription": { 
 "subscription_id": 216084,
 "subscription_ext_uid": "",
 "hash": "619ce278a8aaafddba697fcf2cd4bd62",
 "article_code": "072",
 "quantity": 1,
 "start_date": "2014-03-13 11:36:04",
 "last_event": "2014-03-06 00:00:00",
 "next_event": "2014-03-27 00:00:00",
 "cancellation_date": "2014-06-05 00:00:00",
 "status": "active",
 "expiration_date": "2014-06-05 00:00:00"
},
"created": "2014-03-13 13:30:31"
}

 

Beendigung eines Abonnements subscription.closed

Hat ein bereits gekündigtes oder zeitlich begrenztes Abonnement den Tag seiner Beendigung erreicht und läuft aus, ist die anschließend erzeugte Notification folgendermaßen strukturiert:

{
"id":1329098,
"type":"subscription.closed",
"customer":{ 
 "customer_id":"840738",
 "customer_ext_uid":null,
 "hash":"11adb7078879ea620f696337cc2a1b75",
 "customer_number":"3305",
 "companyname":"",
 "title":"",
 "salutation":"",
 "firstname":"",
 "lastname":"cfk@fastmail.net",
 "address":"",
 "address_2":"",
 "zipcode":"",
 "city":"",
 "country_code":"AT",
 "email":"cfk@fastmail.net",
 "telephone":"",
 "telefax":"",
 "payment_data_url":
 "http:\/\/automatic.fastbill.com\/accountdata\/7fe9875f5ebf8e2bd9367dcc071cc8f0\/11adb7078879ea620f696337cc2a1b75",
 "dashboard_url": "http:\/\/automatic.fastbill.com\/dashboard\/7fe9875f5ebf8e2bd9367dcc071cc8f0\/11adb7078879ea620f696337cc2a1b75"
},
"subscription":{ 
 "subscription_id":412486,
 "subscription_ext_uid":"",
 "hash":"9c1e4833fe2f8dd9a2c606e8f5774b13",
 "article_code":"1",
 "quantity":"1",
 "start_date":"2015-03-29 15:14:27",
 "last_event":"2015-03-29 15:14:27",
 "next_event":"2015-04-29 15:14:27",
 "cancellation_date":"2015-04-29 15:14:27",
 "status":"canceled",
 "expiration_date":"2015-04-29 15:14:27",
 "coupons":[ { "code":"FIRSTTIME1ONLY",
 "title":"Einmaliger Rabatt f\u00fcr den ersten Monat",
 "discount_amount":"13.0000",
 "discount_type":"fixed",
 "status":"active"
}
]
},
"created":"2015-04-29 10:15:10"
}

 

Reaktivierung eines Abonnements - subscription.reactivate

Wird ein bereits gekündigtes Abonnement reaktiviert, ist die anschließend erzeugte Notification folgendermaßen strukturiert:

{
"id":298638,
"type":"subscription.reactivate",
"customer":{ 
 "customer_id":"524246",
 "customer_ext_uid":"60716",
 "hash":"7b5f967d622a4ea924018ba7de92a3ac",
 "customer_number":"11632",
 "companyname":"nici.nagel@web.de",
 "salutation":"",
 "firstname":"",
 "lastname":"",
 "address":"",
 "address_2":"",
 "zipcode":"",
 "city":"",
 "country_code":"DE",
 "email":"nici.nagel@web.de",
 "payment_data_url": "https:\/\/registration.gymondo.de\/accountdata\/5adeddadb645c1069b3b929393796dc2\/7b5f967d622a4ea924018ba7de92a3ac",
 "dashboard_url": "https:\/\/registration.gymondo.de\/dashboard\/5adeddadb645c1069b3b929393796dc2\/7b5f967d622a4ea924018ba7de92a3ac"
},
"subscription":{ 
 "subscription_id":163480,
 "subscription_ext_uid":"",
 "hash":"276185735278f814bd18a57d21975a2c",
 "article_code":null,
 "quantity":null,
 "start_date":"2014-01-13 15:49:40",
 "last_event":"2014-01-13 15:49:40",
 "next_event":"2014-01-20 00:00:00",
 "cancellation_date":"0000-00-00 00:00:00",
 "status":"active",
 "expiration_date":"2014-01-20 00:00:00"
},
"created":"2014-01-20 13:52:48"

 

Rechnung erstellt/Zahlung erhalten - payment created

Durch die automatisierte Erstellung einer Rechnung (ggf. mit einem Zahlungseinzug verbunden) wird eine so aufgebaute Notification erzeugt:

 

{
"id": 398160,
"type": "payment.created",
 "customer": { 
 "customer_id": "578266",
 "customer_ext_uid": null,
 "hash": "a3ba6fa5022f231f72885cc8a7d0a8c9",
 "customer_number": "0077",
 "companyname": "Muster GmbH",
 "title": "Dr.",
 "salutation": "Herr",
 "firstname": "Martin",
 "lastname": "Muster",
 "address": "Am Musterhuegel 12",
 "address_2": "Postfach 4",
 "zipcode": "01234",
 "city": "Musterhausen",
 "country_code": "DE",
 "email": m.muster@e-mail.de",
 "payment_data_url": "https:\/\/automatic.fastbill.com\/accountdata\/5fb2caf9f2313b53870df18708127296\/a3ba6fa5022f231f72885cc8a7d0a8c9",
 "dashboard_url": "https:\/\/automatic.fastbill.com\/dashboard\/5fb2caf9f2313b53870df18708127296\/a3ba6fa5022f231f72885cc8a7d0a8c9"
},
"subscription": { 
 "subscription_id": 216084,
 "subscription_ext_uid": null,
 "hash": "619ce278a8aaafddba697fcf2cd4bd62",
 "article_code": "072",
 "quantity": "1"
},
"payment": { 
 "payment_id": 180828,
 "invoice_id": 447236,
 "invoice_number": "8",
 "invoice_url": "https:\/\/automatic.fastbill.com\/download\/N3SEw3Bh9oZIIN6IIEBj2yBCPR0jesDsiVxQKyyGYJOgWGpeKqbBCqS2MxhQbB",
 "total_amount": 4.7005,
 "currency": "EUR",
 "method": "creditcard",
 "gateway": "Adyen",
 "reference": null,
 "test": 1,
 "type": "charge",
 "status": "open",
 "next_event": "2014-03-27 00:00:00",
 "created": "2014-03-06 00:00:00"
},
"created": "2014-03-13 11:37:08"
}

 

 

Zahlung fehlgeschlagen - payment.failed

Beim Fehlschlagen einer Zahlung (z.B. bei nicht gedeckter Kreditkarte) ist die erzeugte Notification in folgender Weise strukturiert:

{
"id": 397960,
"type": "payment.failed",
"customer": { 
 "customer_id": "578266",
 "customer_ext_uid": null,
 "hash": "a3ba6fa5022f231f72885cc8a7d0a8c9",
 "customer_number": "0077",
 "companyname": "Muster GmbH",
 "title": "Dr.",
 "salutation": "Herr",
 "firstname": "Martin",
 "lastname": "Muster",
 "address": "Am Musterhuegel 12",
 "address_2": "Postfach 4",
 "zipcode": "01234",
 "city": "Musterhausen",
 "country_code": "DE",
 "email": "m.muster@e-mail.de",
 "payment_data_url": "https:\/\/automatic.fastbill.com\/accountdata\/5fb2caf9f2313b53870df18708127296\/a3ba6fa5022f231f72885cc8a7d0a8c9",
 "dashboard_url": "https:\/\/automatic.fastbill.com\/dashboard\/5fb2caf9f2313b53870df18708127296\/a3ba6fa5022f231f72885cc8a7d0a8c9"
},
"subscription": { 
 "subscription_id": 216084,
 "subscription_ext_uid": null,
 "hash": ""619ce278a8aaafddba697fcf2cd4bd62",
 "article_code": "072",
 "quantity": "1"
},
"payment": { 
 "payment_id": 180828,
 "invoice_id": 447236,
 "invoice_number": "8",
 "invoice_url": 
 "https:\/\/automatic.fastbill.com\/download\/N3SEw3Bh9oZIIN6IIEBj2yBCPR0jesDsiVxQKyyGYJOgWGpeKqbBCqS2MxhQbB",
 "total_amount": 4.7005,
 "currency": "EUR",
 "payment_method": "creditcard",
 "gateway": "Adyen",
 "reference": null,
 "type": "charge",
 "status": "error",
 "next_event": "2014-03-27 00:00:00",
 "created": "2014-03-06 00:00:00"
},
"created": "2014-03-13 11:04:12"
}

 

Mahnung zur Rechnung versandt - payment.reminded

Beim Versenden einer Mahnung zu einer bestimmten Rechnung ist die erzeugte Notification in folgender Weise strukturiert:

{
"id":131050,
"type":"payment.reminded",
"customer": { 
 "customer_id":"363522",
 "customer_ext_uid":null,
 "hash":"94f5b27227c3fc902d7ea37860b997f1",
 "customer_number":"847787",
 "companyname":"BasicFBTestForSteve23123 testSteve321321",
 "salutation":"Herr",
 "firstname":"BasicFBTestForSteve23123",
 "lastname":"testSteve321321",
 "address":"dsda342",
 "address_2":"",
 "zipcode":"111111111132131",
 "city":"Leipzig321321",
 "country_code":"DE",
 “email":"matiu16342432@gmx.pl",
 "payment_data_url": "https:\/\/automatic.fastbill.com\/accountdata\/4d88d4d09d0f4b3084c86e68270c39be\/94f5b27227c3fc902d7ea37860b997f1",
 "dashboard_url": "https:\/\/automatic.fastbill.com\/dashboard\/4d88d4d09d0f4b3084c86e68270c39be\/94f5b27227c3fc902d7ea37860b997f1"
},
"subscription": { 
 "subscription_id":35690,
 "subscription_ext_uid":null,
 "hash":"516c5aa1dad1544628ddf87952e194b1",
 "article_code":null
},
"payment":{ 
 "level":1
},
"created":"2013-11-11 19:48:47"
}

 

Rechnung erstellt - invoice.created

{
"id": 464,
"type": "invoice.created",
"created": "2015-09-08 08:50:24",
"account_hash": "0ba0ec6c8835e09d5b25ea84edaeb263",
"invoice": {
 "invoice_id": "772330",
 "status": "paid",
 "type": "outgoing",
 "currency_code": "EUR",
 "subscription_invoice_counter": 3,
 "invoice_number": "410000000659",
 "invoice_title": "",
 "salutation": "Sehr geehrter Herr Rene Test,",
 "introtext": "wir erlauben uns für unsere Bemühungen folgende Positionen in Rechnung zu stellen.",
 "payment_conditions": "Der o.g. Rechnungsbetrag wird mittels SEPA-Lastschrift zum Mandat FECE4UWKVF mit der Gläubiger-Identifikationsnummer von Ihrem Konto IBAN DE12500105170648489890 bei der DAB Bank (BIC BENEDEPPYYY) zum Fälligkeitstag am 11.09.2015 eingezogen. Wir bitten Sie für entsprechende Kontodeckung zu sorgen.\n\n\n",
 "outstanding_amount": 0,
 "paid_date": "2015-09-08 00:00:00",
 "is_canceled": false,
 "invoice_date": "2015-09-08 00:00:00",
 "due_date": "2015-09-08 00:00:00",
 "delivery_date": "08.09.2015 - 07.10.2015",
 "cash_discount_percent": "0.00",
 "cash_discount_days": 0,
 "sub_total": 59,
 "vat_total": 11.21,
 "vat_items": [
{
 "vat_percent": "19.00",
 "complete_net": 59,
 "vat_value": 11.21
}
],
"items": [
{
 "invoice_item_id": "1411895",
 "article_number": "1600A00J2W",
 "description": "Test Description",
 "quantity": 1,
 "unit_price": 59,
 "vat_percent": "19.00",
 "vat_value": 11.21,
 "complete_net": 59,
 "complete_gross": 70.21,
 "sort_order": "1"
}
],
"total": 70.21,
"document_url": "http://automatic.fastbill.com/download/12Ei4dYIeZp8e1qCAlPe28PM60TYDCC54Hbxl05DOj_tYqvZP-4F6HS17mN_pQ4i",
"trigger": "renewal",
"shipment": "0"
},
"customer": {
 "customer_id": "805270",
 "customer_ext_uid": null,
 "hash": "67c16bd6e6035e1ccfa59af142731e02",
 "customer_number": "10001",
 "companyname": "FastBill GmbH",
 "title": "",
 "salutation": "mr",
 "firstname": "Rene",
 "lastname": "Test",
 "address": "Kaiserleistraße 51",
 "address_2": "",
 "zipcode": "63067",
 "city": "Offenbach am Main",
 "country_code": "DE",
 "language_code": "de",
 "vat_id": "",
 "tax_id": "93815/08152",
 "email": "test@test.de",
 "phone": "",
 "telefax": "",
 "payment_method": "directdebit",
 "days_for_payment": "0",
 "bank_name": "DAB Bank",
 "bank_account_owner": "Alex Tabo",
 "bank_iban": "DE12500105170648489890",
 "bank_bic": "BENEDEPPYYY",
 "invoice_delivery_method": "mail",
 "affiliate": null,
 "payment_data_url":
 "http://automatic.fastbill.com/accountdata/0ba0ec6c8835e09d5b25ea84edaeb263/67c16bd6e6035e1ccfa59af142731e02",
 "dashboard_url": "http://automatic.fastbill.com/dashboard/0ba0ec6c8835e09d5b25ea84edaeb263/67c16bd6e6035e1ccfa59af142731e02",
 "x_attributes": {
}
},
"subscription": {
 "subscription_id": "459825",
 "subscription_ext_uid": "",
 "hash": "d206a79488da0a6ddf062cdba86d97b6",
 "article_code": "1600A00J2W",
 "quantity": "1",
 "start_date": "2015-09-08 08:34:22",
 "last_event": "2015-09-08 08:47:19",
 "next_event": "2015-09-08 00:00:00",
 "cancellation_date": "0000-00-00 00:00:00",
 "status": "active",
 "last_renewal_date": "2015-09-08 08:34:22",
 "expiration_date": "0000-00-00 00:00:00",
 "coupons": []
}
}

 

Rechung gelöscht - invoice.deleted

Nur bei Rechnungen im Entwurfsmodus relevant

{
"id": 888418,
"type": "invoice.deleted",
"created": "2016-02-03 08:38:00",
"account_hash": "6a7cbd49249c07ed0bbe894c2ec8dfe3",
"invoice": {
 "invoice_id": "964590",
 "status": "overdue",
 "type": "draft",
 "currency_code": "EUR",
 "subscription_invoice_counter": 0,
 "invoice_number": "4962",
 "invoice_ext_uid": null,
 "invoice_title": "",
 "salutation": "Sehr geehrte Damen und Herren,",
 "introtext": "wir erlauben uben uns für unsere Bemühungen folgende Positionen in Rechnung zu stellen.",
 "payment_conditions":"Bitte überweisen Sie den Rechnungsbetrag sofort.\n\n\n",
 "outstanding_amount": 300.27,
 "paid_date": "0000-00-00 00:00:00",
 "is_canceled": false,
 "invoice_date": "2016-01-25 00:00:00",
 "due_date": "2016-01-25 00:00:00",
 "delivery_date": "Leistungszeitraum:" ",
 "cash_discount_percent": "0.00",
 "cash_discount_days": 0,
 "sub_total": 252.33,
 "vat_total": 47.94,
 "vat_items": [
{
 "vat_percent": "19.00",
 "complete_net": 252.33,
 "vat_value": 47.27
}
],
"items": [
{
 "invoice_item_id": "1683464",
 "article_number": "1001",
 "description": "Chili 2<br>Test",
 "quantity": 1,
 "unit_price": 245,
 "vat_percent": "19.00",
 "vat_value": 46.55,
 "complete_net": 245,
 "complete_gross": 291.55,
 "sort_order": ="1",
 "type": "invoiceItem"
},
{
 "invoice_item_id": "1683466",
 "article_number": "",
 "description": "Setup fee",
 "quantity": 1,
 "unit_price": 20,
 "vat_percent": "19.00",
 "vat_value": 3.8,
 "complete_net": 20,
 "complete_gross": 23.8,
 "sort_order": "2",
 "type": "invoiceItem"
},
{
 "invoice_item_id": "1683468",
 "article_number": "",
 "description": "Credit from other payments.",
 "quantity": 1,
 "unit_price": -12.67,
 "vat_percent": "19.00",
 "vat_value": -2.41,
 "complete_net": -12.67,
 "complete_gross": -15.08,
 "sort_order": "3",
 "type": "creditItemManual"
}
],
"total": 300.27,
"document_url": "https:\/\/automatic.fastbill.com\/download\/SrBbjRlvc3Afuh2SwdDcnPKkVbFRTtimYkB72mrSerxNNnf9FjZtyjRI_XZTE75d",
"trigger": "renewal",
"shipment": "0"
},
"customer": {
 "customer_id": "989727",
 "customer_ext_uid": null,
 "hash": "9196967ba634edcdb161bb271095b698",
 "customer_number": "23",
 "companyname": "Patrice Test",
 "title": "Mr",
 "salutation": "mr",
 "firstname": "Patrice",
 "lastname": "Test",
 "address": "",
 "address_2": "",
 "secondary_address": "Billstrasse 23",
 "zipcode": "73373737",
 "city": "Frankfurt",
 "country_code": "DE",
 "language_code": "de",
 "vat_id": "",
 "tax_id": "23",
 "email": "test@test.com",
 "phone": "",
 "telefax": "",
 "payment_method": "invoice",
 "days_for_payment": "0",
 "bank_name": "",
 "bank_account_owner": "",
 "bank_iban": "",
 "bank_bic": "",
 "invoice_delivery_method": "mail",
 "affiliate": null,
 "credit_balance": 0,
 "payment_data_url": "https:\/\/automatic.fastbill.com\/accountdata\/6a7cbd49249c07ed0bbe894c2ec8dfe3\/9196967ba634edcdb161bb271095b698",
 "dashboard_url": "https:\/\/automatic.fastbill.com\/dashboard\/6a7cbd49249c07ed0bbe894c2ec8dfe3\/9196967ba634edcdb161bb271095b698",
 "x_attributes": [ 
]
},
"subscription": {
 "subscription_id": "605564",
 "subscription_ext_uid": "",
 "hash": "68e3124dfea060dac099959011a1f4ce",
 "article_code": "1001",
 "quantity": "1",
 "start_date": "2016-01-25 07:08:27",
 "last_event": "2016-01-25 00:00:00",
 "next_event": "2016-02-25 00:00:00",
 "cancellation_date": "0000-00-00 00:00:00",
 "status": "active",
 "last_renewal_date": "2016-01-25 07:08:27",
 "expiration_date": "2016-03-25 07:08:27",
 "coupons": [
],
 "x_attributes": [
],
"features": [
{
 "title": "Hallo",
 "code": "123chili",
 "quantity": "500",
 "value": "sdf"
}
],
"addons": [ 
]
}
}

Verwandte Beiträge

Kommentare

0 Kommentare

Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.