Entwickler
Verbinden Sie Ihr Werkzeug mit der Cortex-Vorbereitung.
Verstehen Sie den Cortex-API-Pfad, die Schlüsselauthentifizierung, die nötigen Rechte und die Verfolgung der Läufe vor dem Export.
GET /api/v1/user/credits HTTP/1.1
Host: cortex-compta.ch
Authorization: Bearer IHR_API_SCHLUESSELJede Anfrage authentifizieren
Die API verwendet einen Schlüssel im Header Authorization: Bearer. Schlüssel werden nach der Anmeldung verwaltet. Bewahren Sie sie serverseitig auf und vergeben Sie nur die nötigen Rechte.
Eine 401 bedeutet fehlende oder ungültige Authentifizierung. Eine 403 bedeutet, dass Schlüssel oder Dossier die nötigen Rechte nicht haben. Ein Limit kann eine 429 erzeugen.
Ablegen, verfolgen, dann holen
Die Ablage startet einen Lauf. Holen Sie seinen Zustand, bevor Sie die vorbereiteten Angaben nutzen. Ein beendeter Lauf ist keine buchhalterische Freigabe.
Die Exporterzeugung wird ebenfalls über ihre Kennung verfolgt. Laden Sie die Datei erst herunter, wenn sie verfügbar ist. Rechte und Kontrollen des Dossiers bleiben anwendbar.
- POST /api/v1/documents/upload — ein Dokument ablegen.
- GET /api/v1/documents/:id — ein Dokument lesen.
- GET /api/v1/treatments/:id — einen Lauf verfolgen.
- POST /api/v1/exports/generate — einen Export anfordern.
- GET /api/v1/exports/:id — seine Vorbereitung verfolgen.
- GET /api/v1/exports/:id/download — die verfügbare Datei holen.
Tatsächlich offengelegte Formate
GET /api/v1/formats listet heute cresus, winbiz, sage, abacus, banana, wineur und excel. DATEV und ZIP existieren als Dateiexporte nach menschlicher Freigabe, ausserhalb dieser API-Liste.
- cresus
- winbiz
- sage
- abacus
- banana
- wineur
- excel
Mit einem beherrschten Dossier testen
Beginnen Sie mit Testdokumenten ohne vertrauliche Daten. Behandeln Sie Fehler, Laufzeiten und Wiederholungen ausdrücklich, um Doppelablagen zu vermeiden.
Die detaillierte Dokumentation und das Parameterschema sind nach der Anmeldung zugänglich. Prüfen Sie Formate und Rechte Ihres Angebots, bevor Sie den Pfad integrieren.