Download the PHP package daniel-jorg-schuppelius/orgamax-php-sdk without Composer
On this page you can find all versions of the php package daniel-jorg-schuppelius/orgamax-php-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download daniel-jorg-schuppelius/orgamax-php-sdk
More information about daniel-jorg-schuppelius/orgamax-php-sdk
Files in daniel-jorg-schuppelius/orgamax-php-sdk
Package orgamax-php-sdk
Short Description orgaMAX SDK for PHP
License MIT
Informations about the package orgamax-php-sdk
orgaMAX PHP SDK
Ein modernes PHP-SDK für die orgaMAX-API — nach dem Vorbild von lexoffice-php-sdk und datev-php-sdk, aufgebaut auf dem php-api-toolkit.
🚀 Features
- Vollständige API-Abdeckung: alle 72 Operationen der orgaMAX-OpenAPI-Spec (Artikel, Kunden, Lieferanten, Rechnungen, Angebote, Aufträge, Lieferscheine, Ausgaben, Dateien, To-dos, Tags, Benutzer, Kontenrahmen, Einstellungen)
- Typisierte Entities mit automatischer Reflection-Hydration (JSON ↔ Objekt) und Enums für dokumentierte Wertemengen
- Kompletter Auth-Flow:
Client::fromCredentials()erledigt Basic-Auth → Token-Bezug → Bearer-Client in einem Aufruf - Robuster HTTP-Layer aus dem Toolkit: Retry mit Backoff und
Retry-After, Throttling, Statuscode-→-Exception-Mapping, Log-Redaction sensibler Daten - PDF-Belegabruf für Rechnungen, Angebote, Aufträge und Lieferscheine
- Multipart-Datei-Upload inkl. Belegerkennung (
analyze) - PHPStan Level 8, Laravel Pint, PHPUnit 11 — CI über GitHub Actions (PHP 8.2–8.4)
📋 Voraussetzungen
- PHP >= 8.2 < 8.5
- Composer
- Ein orgaMAX-Konto mit registrierter Erweiterung (Marketplace → Eigene Erweiterungen)
📦 Installation
⚙️ Konfiguration
Die orgaMAX-API nutzt einen zweistufigen Auth-Flow:
- In der orgaMAX-Anwendung als App-Entwickler registrieren und unter Marketplace → Eigene Erweiterungen eine Erweiterung anlegen.
- API-Schlüssel und geheimen API-Schlüssel notieren.
- Die ownershipId aus der Callback-URL der Erweiterung entnehmen (Query-Parameter
iid). - Gewünschte API-Zugriffe der Erweiterung unter API-Zugriffe freischalten.
📚 Verwendung
Artikel anlegen und suchen
Kunden verwalten
Rechnung abrufen, Zahlung erfassen, PDF laden
Datei hochladen und analysieren
🏗️ Projektstruktur
🔌 API-Endpunkte
| Endpoint | Routen | Beschreibung |
|---|---|---|
AuthEndpoint |
POST /auth/token | Bearer-Token aus ownershipId beziehen |
ArticlesEndpoint |
CRUD + Liste /article | Artikelverwaltung |
CustomersEndpoint |
Create/Get/Update + Liste /customer | Kundenverwaltung |
SuppliersEndpoint |
CRUD + Liste /supplier | Lieferantenverwaltung |
InvoicesEndpoint |
/invoice: Get, Liste, Payment, Lock, Send, Document (PDF) | Rechnungen |
OffersEndpoint |
/offer: Create, Update, Get, Liste, Document (PDF) | Angebote |
OrdersEndpoint |
/order: Create, Get, Liste, Document, Order→Invoice | Aufträge |
DeliveryNotesEndpoint |
/deliveryNote: Get, Liste, Document (PDF) | Lieferscheine |
ExpensesEndpoint |
CRUD + Liste /expense, Receipt-Delete | Ausgaben |
FilesEndpoint |
/file: Upload, Download, Meta, Analyze, Delete, Liste | Dokumente & Belegerkennung |
TodosEndpoint |
/todo: Create, Liste, Messages, Link/Unlink, Status, DueDate | To-dos |
TagsEndpoint |
GET /tags | Tags |
UsersEndpoint |
GET /user | Benutzer |
BookkeepingEndpoint |
GET /bookkeeping/getchartofaccounts | Kontenrahmen |
Settings\* |
/setting/account, /setting/miscellaneous, /setting/article, /setting/payCondition, /setting/deliveryCondition | Einstellungen |
Eigenheiten der API (Statuscodes, Trailing Slashes, Spec-Tippfehler) sind in docs/OpenAPI/orgamax-openapi.json.
🧪 Tests
Live-Tests gegen die echte API: .samples/config.json.sample nach .samples/config.json kopieren, Zugangsdaten eintragen und ORGAMAX_SKIP_API_TESTS in phpunit.xml entfernen bzw. auf 0 setzen.
📖 Abhängigkeiten
| Paket | Zweck |
|---|---|
| daniel-jorg-schuppelius/php-api-toolkit | ClientAbstract (Guzzle, Retry, Throttling), EndpointAbstract, NamedEntity/NamedValues (Hydration), Exceptions, Auth-Strategien |
| guzzlehttp/guzzle (transitiv) | HTTP-Transport |
| dschuppelius/php-error-toolkit (transitiv) | Logging (PSR-3), ErrorLog-Trait |
| dschuppelius/php-config-toolkit (transitiv) | Config-Loader für Live-Tests |
📄 Lizenz
MIT — siehe LICENSE.
👤 Autor
Daniel Jörg Schuppelius — schuppelius.org
All versions of orgamax-php-sdk with dependencies
daniel-jorg-schuppelius/php-api-toolkit Version ^2.8
dschuppelius/php-common-toolkit Version ^1.20 || ^2.0