Exxas
Verbindet Uella mit deinem Exxas-Mandanten über die API 2.0: Kontakte, Kunden, Dokumente, Positionen, Verträge, Aufgaben und GraphQL.
Kategorie: Integrationen & Business | Quelldatei: exxasBlock.js (v4.1) | Auth: Benutzer + App-Passwort
Was brauche ich dafür?
- In Exxas ein App-Passwort für den API-Benutzer erzeugen.
- In Uella: Profil → API-Keys → Exxas
- Benutzer: Exxas-Login (E-Mail)
- App-Passwort
- Der Block holt automatisch Token und System-ID über
POST https://api.exxas.net/get-webToken.
REST-Basis danach: https://api.exxas.net/cloud/{sysId}/api/v2
Header: Authorization: ApiKey … (oder Bearer)
Swagger/GraphQL nach Login: api.exxas.net
Was kann dieser Block?
- Verbindung:
whoami,login - Kontakte & Kunden: listen, suchen, CRUD, Kategorien
- Dokumente: Offerten (
typ=o), Aufträge (a), Rechnungen (r), Service (s) — inkl. schliessen, verbuchen, archivieren, Rechnung erzeugen - Positionen auf Dokumenten
- Verträge, Chancen, Aufgaben, Fristen, Kampagnen, Wissen, E-Mails, Lager, Benutzer
- Generisch:
request(beliebiger REST-Pfad),graphql
Suche ist immer ein Array:
json
[{ "field": "kt_nachname", "condition": "like", "value": "Ackermann" }]Updates gehen per POST /{id} (kein PATCH). Antworten kommen als { success, message }.
Typische Agent-Aufgaben
| Aufgabe | Operation | Parameter |
|---|---|---|
| Verbindung prüfen | whoami | — |
| Kontakt suchen | contact_search | query + optional field |
| Kunden listen | customer_list | optional limit |
| Offerten | document_search | typ: "o" |
| Dokument lesen | document_get | id |
| GraphQL | graphql | query |
Beispiel: Kontakt suchen
json
{
"operation": "contact_search",
"field": "kt_nachname",
"condition": "like",
"query": "Ackermann"
}Beispiel: Offerten
json
{
"operation": "document_search",
"typ": "o"
}Hinweise
- App-Passwort nicht im Flow speichern, wenn ein Profil-/Org-Key gesetzt ist.
- Exxas limitiert API-Calls (typisch 500/Tag inklusive, im Admin erweiterbar).
- Artikel und einzelne Module können je nach Mandantenrecht
permission deniedliefern.