=== UD WooCommerce AbaNinja ===
Requires at least: 6.5
Requires PHP: 8.2
Stable tag: 1.1.0
License: Proprietary

Verbindet WooCommerce mit AbaNinja. Installierbares Release 1.1.0 für den bestehenden Testbetrieb.

== Beschreibung ==

Dieses Release enthält den aktuellen Funktionsstand mit Unterstützung abweichender Lieferadressen bei Rechnungen. Die bestehende Account-Sicherheitsprüfung verlangt bei API-Schreiboperationen weiterhin ein AbaNinja-Konto mit dem Namen TEST. Eine Freigabe für produktive AbaNinja-Konten ist damit nicht verbunden.

Aktueller Funktionsumfang:

* WooCommerce-Kunden als Personen oder Firmen in AbaNinja zuordnen bzw. anlegen.
* Bei Rechnung / Banküberweisung eine AbaNinja-Rechnung erstellen.
* Abweichende WooCommerce-Lieferadressen bei Rechnungen separat synchronisieren und über deliveryAddressUuid zuordnen. Eindeutig passende Lieferadressen werden wiederverwendet; die Rechnungsadresse bleibt erhalten. Bei ungeklärter Lieferadressanlage wird keine Rechnung erstellt.
* BACS-Rechnungen wahlweise als Entwurf erstellen oder automatisch per AbaNinja-E-Mail versenden.
* Bei TWINT, Kreditkarte und anderen bestätigten Online-Zahlungen einen AbaNinja-Lieferschein statt einer Rechnung erstellen.
* Schweizer Kantone aus vorhandenen Kantonscodes bzw. den mitgelieferten PLZ-/Ortsdaten auflösen.
* Bei nicht eindeutigem oder unbekanntem Schweizer Kanton den neutralen AbaNinja-State XX verwenden. WooCommerce-Adressfelder bleiben unverändert; nach erfolgreicher Übertragung entsteht eine private Hinweisnotiz.
* Bestellungen manuell prüfen und die anschliessende Kundenzuordnung bzw. Dokumenterstellung separat bestätigen.
* Bestellungen und Rückerstattungen bei aktivierter automatischer Synchronisation über die bestehenden Trigger verarbeiten.
* Vorhandene Dokumentzuordnungen erkennen und doppelte Dokumenterstellung verhindern.
* Echte Synchronisationsfehler durch private Bestellnotizen und eine sichtbare Kennzeichnung in der Bestellübersicht anzeigen, auch mit HPOS.
* Die bestehende Rückerstattungs-/Gutschrift- und Rechnungsstornierungslogik verwenden. Diese erweitert Lieferscheine nicht um eine neue Rechnungs- oder Zahlungslogik.

Beim Entwurfsmodus bleibt die WooCommerce-E-Mail «Bestellung in Wartestellung» aktiv. Beim automatischen BACS-Rechnungsversand wird sie entsprechend der bestehenden Versandlogik unterdrückt. Bei Online-Zahlungen bleiben die regulären WooCommerce-E-Mails aktiv.

== Voraussetzungen ==

* WordPress ab 6.5, PHP ab 8.2 und aktiviertes WooCommerce ab 8.0.
* Ein konfiguriertes AbaNinja-TEST-Konto mit gültigem API-Token und Konto-ID.
* Der WooCommerce Action Scheduler für die bestehenden automatischen Synchronisationsaufträge.

== Installation ==

1. Das Plugin-ZIP unter Plugins > Installieren > Plugin hochladen auswählen und installieren.
2. WooCommerce aktivieren, sofern es noch nicht aktiv ist, und anschliessend das Plugin aktivieren.
3. Unter WooCommerce > Einstellungen > AbaNinja API-Token und AbaNinja-Konto-ID speichern.
4. Die Verbindung manuell testen. Ein gespeicherter Token wird nicht ins Formular zurückgeschrieben; ein leeres Token-Feld behält ihn beim Speichern bei.
5. Den gewünschten BACS-Rechnungsmodus wählen. Automatische Synchronisation nur aktivieren, wenn sie für den Testbetrieb gewünscht ist; sie ist standardmässig ausgeschaltet.

Das ZIP enthält den benötigten Autoloader und die Schweizer PLZ-/Kantonsdaten. Auf dem Zielsystem ist keine separate Composer-Installation erforderlich. Vorhandene Plugin-Einstellungen und Zuordnungen werden durch dieses Release nicht automatisch zurückgesetzt.

== Bekannte Einschränkungen ==

Die Lieferadressübertragung für Privatkunden wurde im TEST-Account auf Rechnungen bestätigt. Firmenlieferadressen sind implementiert und offline geprüft; ein vollständiger Firmen-Integrationstest steht noch aus. Die API-Unterstützung gemischter Empfängertypen (Person mit Lieferfirma bzw. Firma mit privatem Lieferempfänger) ist nicht bestätigt. API-Ablehnungen führen zum kontrollierten Abbruch ohne Rechnung.

Bei Lieferscheinen wird eine tatsächlich abweichende Lieferadresse vor der Dokumenterstellung kontrolliert abgewiesen. Die Bestellung erhält die bestehende private Fehlernotiz und AbaNinja-Fehlerkennzeichnung. Nach Korrektur kann die Synchronisation erneut ausgeführt werden. Rechnungs-/Kundenadressen werden dadurch nicht überschrieben und es wird kein künstlicher zusätzlicher Kunde angelegt.

Ungeklärte Kunden- und Lieferadressanlagen werden nicht automatisch wiederholt. Nur ein eindeutiger Abgleich mit den ursprünglichen Daten kann einen ungeklärten Versuch auflösen. Bei hartem Prozessabbruch zurückgebliebene Sperren benötigen eine manuelle Prüfung; sie laufen nicht automatisch ab. Interne AbaNinja-WebAPI-Endpunkte werden nicht verwendet.

== Lizenzierung ==

Produkt-ID: ud-woocommerce-abaninja (fest). Neue schreibende Synchronisationen
benötigen eine verifizierte aktive Lizenz oder eine gültige technische Grace Period.
Verwaltung unter WooCommerce > Einstellungen > AbaNinja > Lizenz. Die Felder der
AbaNinja-Verbindung bleiben separat. Lizenzaktionen benötigen manage_woocommerce
und eine Nonce. Gespeicherte Lizenzschlüssel werden im HTML niemals zurückgegeben.

Der Client verwendet HTTPS, Ed25519 und das unveränderte UDLM-v1-Protokoll des
License Managers 0.3.0. HTTP-Status, Operation, Lizenz-Lookup, Produkt, Domain,
Environment und Installation sind kryptografisch gebunden. Serverzeit: höchstens
600 Sekunden Abweichung in beide Richtungen und niemals kleiner als die zuletzt
akzeptierte signierte Zeit; gleiche Sekunden sind erlaubt. Objekte und Listen
bleiben bei der Canonicalization unterscheidbar. Es gibt keinen Key-Download.

Die einmalige UUID bleibt in ud_abaninja_installation_id dauerhaft gespeichert.
Lizenzschlüssel und Cache liegen separat in ud_abaninja_license_key bzw.
ud_abaninja_license_state. Alle drei Optionen werden ohne Autoload angelegt.
Kein Hardware-Identifier, keine proprietäre Verschlüsselung und keine Löschung
bei normalen Einstellungen oder Plugin-Deaktivierung. Letztere stoppt nur Cron;
eine Server-Aktivierung wird ausschließlich über die Lizenzfunktion freigegeben.

Die Umgebung kann im Lizenzbereich als Automatisch, Produktion, Staging oder
Entwicklung gewählt werden; wp-config.php muss dafür nicht geändert werden.
Automatisch (Default) verwendet wp_get_environment_type(): production/staging
unverändert; local/development werden development. Explizite Auswahl hat Vorrang.
Eine bekannte Aktivierung sperrt Änderungen, auch bei Grace Period oder
Verbindungsproblemen. Zuerst ausdrücklich deaktivieren. Nach administrativer
Deaktivierung im License Manager bestätigt „Lizenz prüfen“ den inaktiven Zustand;
danach Umgebung bewusst auswählen und erneut aktivieren. Normales Speichern
löst keine externe Deaktivierung oder automatische Migration aus. Domain: normalisierter kleingeschriebener Home-URL-Host ohne
Schema, Port, Pfad oder Query; internationale Namen als Punycode.

Produktiver Default: https://licenses.ulrich.digital/wp-json/ud-license/v1/
Technischer Override: Konstante oder Environment UD_ABANINJA_LICENSE_SERVER_URL.
Nur HTTPS-REST-Basis-URLs ohne Userinfo, Query oder Fragment; keine Weiterleitungen.
Die URL ist nicht im Shopmanager-UI konfigurierbar.

Der Production-Public-Key mit key_id 2026-10 ist im Plugin eingebettet und ohne
wp-config-Override verfügbar (Standard-Base64 der 32 Public-Key-Bytes):
OCRsK4bCHQ+GkB1EpISohVmYsqapRR/XJZNNkRlqRVc=
UD_ABANINJA_LICENSE_TRUSTED_KEYS als Array key_id => public_key ergänzt den
eingebetteten Keyring; gleiche IDs werden bewusst über diesen Deployment-Override ersetzt.
UD_ABANINJA_LICENSE_DEVELOPMENT_KEYS als Array nur außerhalb von production;
Development-Keys können eingebettete Production-Key-IDs nicht ersetzen.
Mehrere Key-IDs können parallel vertraut werden. Den neuen Public Key vor der
Server-Umschaltung verteilen; den alten erst nach der Übergangsfrist entfernen.
Private Keys und lokale Betriebsschlüssel werden nicht ausgeliefert.
Lokale wp-config-Dateien gehören nicht zum Plugin-Release.

Aktivieren validiert und speichert den eingegebenen Schlüssel, erstellt bei Bedarf
die dauerhafte UUID und akzeptiert ausschließlich signierten fachlichen Erfolg.
Ein neuer Schlüssel übernimmt niemals die Grace Period des bisherigen Schlüssels.
Check erzeugt keine Identität und reaktiviert keine Installation. Deaktivieren
ändert den lokalen Status ausschließlich nach verifiziertem Server-Erfolg;
Schlüssel und UUID bleiben erhalten. Signierte fachliche Ablehnungen sind sofort
maßgeblich und können nicht durch spätere Transportfehler wieder aufgehoben werden.

Ein täglicher WordPress-Cron und ein Check vor einer neuen Synchronisation prüfen
veraltete Zustände. Alle drei Lizenzoperationen teilen einen atomaren 120-Sekunden-
Options-Lock; stale Locks und Releases verwenden Compare-and-delete. Unter dem
Lock wird die Fälligkeit erneut geprüft. Fehlgeschlagene automatische Prüfungen
werden ebenfalls höchstens einmal pro 24 Stunden versucht; manuelle Prüfung
bleibt möglich. Es gibt keine Lizenzrequests bei normalen Frontend-Seitenaufrufen.

Grace Period: maximal 14 Tage seit der letzten erfolgreich verifizierten gültigen
Activate-/Check-Antwort, begrenzt durch ein bekanntes Lizenzablaufdatum. Nur bei
technischen Problemen, 429, 5xx oder nicht sicher verifizierbaren Antworten.
Keine Grace bei erstmaliger fehlgeschlagener Aktivierung, signierten Ablehnungen
oder bewusster Deaktivierung. Cached Freigaben sind zusätzlich an die aktuelle
Lizenz, Domain, Umgebung, Installation und Server-URL gebunden.

LicenseGuard schützt automatische/manuelle Bestellsynchronisation, Customer-Anlage,
Invoice, Delivery Note, Gutschriften, Storno, Recovery, Lifecycle und Payment-
Schreibaktionen. Der HTTP-Client schützt Schreibrequests zusätzlich; ungefährliche
GETs und Calculate bleiben verfügbar. Bestehende TEST-Account-Prüfungen,
Idempotenz, Locks, Mapping, Preise, MWST und Mail-Suppression bleiben erhalten.
Automatische Lizenzsperren erzeugen eine private deduplizierte Lizenznotiz, keinen
AbaNinja-Syncfehler, keine Statusänderung und keine E-Mail.

== Changelog ==

= 1.1.0 =
* Unterstützung abweichender Lieferadressen bei Rechnungen mit separater Zuordnung und Wiederverwendung vorhandener Lieferadressen.
* Firmenmatching um das bestätigte API-Antwortfeld company_name ergänzt; bisheriges name-Format bleibt kompatibel.
* Kundenanlage gegen doppelte POSTs und parallele Bestellungen abgesichert; ungeklärte Ergebnisse nur nach eindeutigem GET-Abgleich wieder aufnehmen.
* API-Fehlerdiagnose verbessert: redigierte Validierungs- und Konfliktdetails intern erhalten, generische sichere Logmeldungen beibehalten.

= 1.0.1-rc.5 =
* WooCommerce-Einstellungen mit Statusübersicht, responsiven Cards und lokal begrenztem Admin-CSS neu strukturiert.
* Bestehende Felder, Aktionen und Fachlogik beibehalten; Statusanzeige ohne zusätzliche Netzwerkabfragen.

= 1.0.1-rc.4 =
* Umgebung im Lizenzbereich wählbar; aktive Bindungen vor Änderungen geschützt.
* Nach bestätigter Deaktivierung bewusste Auswahl und Reaktivierung möglich.

= 1.0.1-rc.3 =
* Production-Public-Key 2026-10 eingebettet; Key-Rotation und technische Overrides erhalten.
* Development-Keys vor dem Austausch eingebetteter Production-Key-IDs gesperrt.
* Produktiven License-Server-Default und bestehende AbaNinja-TEST-Beschränkung beibehalten.

= 1.0.1-rc.2 =
* Zentralen signaturgeprüften License Client mit Admin-UI, Daily Check, Replay-Schutz,
  14-Tage-Grace-Period und Guards vor neuen AbaNinja-Schreibaktionen ergänzt.

= 1.0.1-rc.1 =
* Installierbaren Zwischenstand mit dezentem Hinweis vor dem Einstellungs-Footer bereitstellen.
* Funktionsumfang, TEST-Kontoprüfung und den tatsächlichen Umfang der Lieferadress-Einschränkung dokumentieren.
* Keine Änderung der Connector-Fachlogik oder bestehender Settings-Keys und Werte.
