Ich schau mir das mal mit einem Testaccount an...

Welche Funktionen würdest Du denn benötigen? Da lässt sich über die API ja einiges steuern.... 

:) juht, guck ich mir morgen mal an... 

Also Grundsätzlich läuft die Anbindung... wie kann man dich erreichen? Mail mich doch mal bitte an tobias (ät) firstlineaudio punkt kom

Also Grundsätzlich läuft die Anbindung... wie kann man dich erreichen? Mail mich doch mal bitte an tobias (ät) firstlineaudio punkt kom

Juht, dieses geniale Forum hat uns allen schon viel geholfen, hier also das generelle Vorgehen für alle die das Thema auch interessieren mag:

Für die Authentifizierung benötigt man den API Key vonFastBill sowie die zur Anmeldung genutzte eMail-Adresse.

Die FastBill API nutzt die Basic Authentifizierung, dabei werden email und API Key im base64 Format verschlüsselt übertragen. Für die Verschlüsselung der eigenen "eMail:Key" kombination einfach einen Online Encoder nutzen (z.B. https://www.base64decode.org/ )

Hier wird dann der string:     "emil@email.de:DeinAPIKey" eingegeben und zu "dG9iaWFzQGZpcnMoJK8bL...blabla Wirres Zeug" umgewandelt.

Für Testumgebungen in Sachen API lege ich mir immer ein mehrzeiliges Textfeld namens APIResonse sowie einen Button an.

In den Button kommt in "Beim Anklicken":

APIResponse := null;
let auth := {
Authorization: "Basic derUmgewandelteBase64String",
'Content-Type': "application/json"
};
let response := do as server
http("POST", "https://my.fastbill.com/api/1.0/api.php", auth, {
SERVICE: "invoice.create",
DATA: {
CUSTOMER_ID: KundenID,
ITEMS: [{
ARTICLE_NUMBER: 1003,
DESCRIPTION: "Super Gerät",
QUANTITY: 3,
UNIT_PRICE: 30.5,
VAT_PERCENT: 16
}, {
ARTICLE_NUMBER: 1045,
DESCRIPTION: "Tolles Ding mit Deckel",
QUANTITY: 3,
UNIT_PRICE: 30.5,
VAT_PERCENT: 16
}]
}
})
end;
APIResponse := text(response)

Die Authentifizierung ist der Übersicht halber als Variable ausgelagert... der Rest erklärt sich anhand der FastBill API Dokumentation eigentlich von selbst. ITEMS ist in diesem Fall ein Array [in eckigen Klammern] in welchem die einzelnen ITEMS kommagetrennt in {geschweiften Klammern}übertragen werden... also ITEMS: [{},{},{}] usw.

Es wird immer ein SERVICE angesprochen.... "invoice.create", "customer.create", "customer.get" usw. und dazu im DATA Body die entsprechenden Felder übermittelt. Diese können entweder direkt "hardcoded" im Script übermittelt werden (siehe obiges Beispiel DESCRIPTION) oder es wird ein Feld aus dem Datensatz abgefragt (siehe CUSTOMER_ID - da fragt er das Feld KundenID aus der Ninox ab).

WICHTIG: Zahlen mit Punkt statt Komma darstellen

Wenn alles richtig ist, gibt der Aufruf einen JSON String zurück und legt ihn im Feld APIResonse ab. Das sieht dann so aus:

{"result":{"REQUEST":{"SERVICE":"invoice.create","DATA":{"CUSTOMER_ID":"9326461","ITEMS":[{"ARTICLE_NUMBER":1003,"DESCRIPTION":"Super Gerät","QUANTITY":3,"UNIT_PRICE":30.5,"VAT_PERCENT":16},{"ARTICLE_NUMBER":1045,"DESCRIPTION":"Tolles Ding mit Deckel","QUANTITY":3,"UNIT_PRICE":30.5,"VAT_PERCENT":16}]}},"RESPONSE":{"STATUS":"success","INVOICE_ID":22584574,"DOCUMENT_ID":"","INVOICE_NUMBER":[]}}}

Über einen JSON Beautifier (z.B. https://jsonformatter.org/) kann man sich die Struktur etwas "aufgehübscht" anzeigen lassen um die Verschachtelungen besser zu vertehen.

Prinzipiell kann man in der NINOX nun mit dem zurückgegebenen JSON String arbeiten. Über die sog. Punkt-Navigation kann man z.B. aus dem obigen JSON String seine Datenfelder bestücken oder abfragen einrichten. 

Lege ich z.B. ein Textfeld "Status" an, kann ich in den obigen Code noch

Status := text(response.result.RESPONSE.STATUS)

einfügen....

"response" beinhaltet ja den komplette JSON String, "result" ist darin dann die erste Ebene, diese beinhaltet REQUEST und RESPONSE, darin wählen wir RESPONSE und wiederum darin wählen wir STATUS... der Wert von STATUS wird dann in unser Textfeld übertragen.

Fertig...

Nun steht uns Tür und Tor offen für alle möglichen Spielereien, dieser API Call kann sowohl in Buttons als auch in "Bei Änderung..." usw abgeschossen werden.

Viel Spass damit :) 

Tobias

Super dass das schonmal klappt.... ja, mit den Anführungszeichen ist das immer so ne Sache wenn man versucht Begriffe darzustellen ... sorry :))

format(Datum, "YYYY-MM-DD") ist die Antwort....

Du kannst übrigens mal eine komplette Rechnung in FastBill anlegen und dann in der NINOX mit invoice.get abrufen... im JSON siehst Du dann die benötigte Struktur und kannst die sogar übernehmen... musst dann nur die " " wegnehmen...

Ahoi! Du kannst dein Rechnungsdatum-Feld mit number(Rechnungsdatum) auslesen. Dir wird hier die Anzahl der vergangenen Millisekunden seit 01.01.1970 (Beginn der UNIX- Zeit) angegeben. Beim DUE_DATE rechnest Du dann für 10 Tage einfach 864 000 000 dazu (Millisekunde x 1000 x 60 x 60 x 24 x 10).

Ein NINOX Datumsfeld kannst du einfach mit diesem berechneten Wert belegen, da wir aber für die API das andere Datumsformat brauchen muss das erst in ein Datum umgewandelt werden und dann umformatiert werden... also:

DUE_DATE: format(date(number(Rechnungsdatum) + 864000000)), "YYYY-MM-DD")

Sauber! Ja, file upload via API im multipart/form-data aufruf klappt bei mir auch nicht, hab hier schon entsprechend angefragt im Forum.