# Anwendung / Nutzung

Hier wird der Prozesses von der Bereitstellung validierter Squeeze Einkaufsbelege an externe Workflows bis zur Buchungsübergabe freigegebener Belege beschrieben.

# Breeze Interface Belege

Hier werden alle Belege welche sich im Breeze Prozess befinden aufgelistet.

[![image-1677146997274.png](https://docs.squeeze.one/uploads/images/gallery/2023-02/scaled-1680-/image-1677146997274.png)](https://docs.squeeze.one/uploads/images/gallery/2023-02/image-1677146997274.png)

##### Statuswerte

- WaitingForRetrieval: Der Beleg ist bereit und wartet darauf vom Workflow System abgeholt zu werden.
- Retrieved: Der Beleg wurde vom Workflow abgeholt.
- Processed: Der Beleg wurde erfolgreich verarbeitet.
- Error: Der Beleg weist zumindest einen Fehler auf, welcher im Workflow korrigiert werden muss.
- Rejected: Der Beleg wurde vom Workflow System als abgelehnt gekennzeichnet.
- WaitingForJson: Der Beleg wartet auf die Anreicherung der Json Datei.
- ChangeCompany: Der Beleg wartet darauf vom Hintergrundprozess verarbeitet und in einen anderen Mandanten übertragen zu werden.

# Übergabe in die ungebuchten EK-Belege

Nach der Freigabe des EK-Belegs durch das Workflow System wird der Beleg an das Breeze Interface übergeben. Im Anschluss findet eine Plausibilitätsprüfung im Interface statt. Wenn die Prüfung erfolgreich war, wird ein ungebuchter EK-Beleg angelegt.

Wenn die Plausibilitätsprüfung fehlschlug, wird der Beleg auf den Status "error" gesetzt und die Fehlermeldung an der jeweiligen Stelle in der Json Struktur des Belegs angehängt. Nun wartet der Beleg wieder auf Abholung und Korrektur durch den Workflow.

[![image-1677150630849.png](https://docs.squeeze.one/uploads/images/gallery/2023-02/scaled-1680-/image-1677150630849.png)](https://docs.squeeze.one/uploads/images/gallery/2023-02/image-1677150630849.png)

Der ungebuchte EK-Beleg wird mit allen Daten aus der Json Struktur angelegt. Sollten Anhänge aus dem Prozess angehängt worden sein, werden auch diese mit an den ungebuchten Beleg übergeben.

[![image-1677149521926.png](https://docs.squeeze.one/uploads/images/gallery/2023-02/scaled-1680-/image-1677149521926.png)](https://docs.squeeze.one/uploads/images/gallery/2023-02/image-1677149521926.png)

## Zuständigkeitseinheit und MwSt.-Geschäftsbuchungsgruppe

Enthält der Belegkopf die Werte `responsibilityCenter` (Zuständigkeitseinheit) und `vatBusPostingGroup` (MwSt.-Geschäftsbuchungsgruppe), werden sie in den ungebuchten EK-Beleg übernommen: bei Rechnungen und Gutschriften beide, bei Bestellungen die MwSt.-Geschäftsbuchungsgruppe (die Zuständigkeitseinheit wurde bei Bestellungen schon bisher übernommen). Ein leerer Wert lässt die Vorgabe stehen, die Business Central aus dem Kreditor bzw. der Benutzereinrichtung setzt. Die MwSt.-Geschäftsbuchungsgruppe des Belegkopfs ist die Vorgabe für die Zeilen; eine in der Zeile angegebene Gruppe hat Vorrang.

Die Plausibilitätsprüfung meldet dabei

- eine Zuständigkeitseinheit oder MwSt.-Geschäftsbuchungsgruppe, die im System nicht existiert,
- eine Zuständigkeitseinheit, die der Benutzer, unter dem das Breeze Interface den Beleg verarbeitet, laut Benutzereinrichtung (oder Firmendaten) für Einkaufsbelege nicht verwenden darf.

<p class="callout info">Auftragsbestätigungen ändern beide Felder an der bestehenden Bestellung nicht.</p>

# Breeze Interface API

Hier finden Sie die Dokumentationen zu folgenden Produkten:

- [Rechnungen / Invoice](https://documenter.getpostman.com/view/23495599/2s83YTnmEF#intro)
- [Bestellanfragen - Procurement](https://documenter.getpostman.com/view/23495599/2s93z9b2mn)
- [Auftragsbestätigungen - Order Confirmation](https://documenter.getpostman.com/view/23495599/2s93z9b2r4)
- [Lieferscheine - Delivery Note](https://documenter.getpostman.com/view/23495599/2s93z9b2r5)

### BC-seitige API

Zusätzlich stellt das Breeze Interface folgende Business-Central-seitigen API- und Webdienst-Endpunkte bereit (APIPublisher: dexprosolutionsgmbh):

- **Breeze Documents API** (`breezedocumentsapi`): API-Seite zum Anlegen und Abrufen von Breeze-Belegen.
- **Breeze Attachments API** (`breezeattachmentsapi`): API-Seite für Belegdateianhänge; die Dateidaten werden über das Feld `dataAsBase64` Base64-kodiert übergeben.
- **GetDocumentStatus**: Statusabruf zu einem Beleg (Webdienst `BREEZEApi`), liefert u. a. Buchungs- und Ausgleichsstatus zum verknüpften Business-Central-Beleg zurück.

Für Nachschlagevorgänge stehen zudem folgende schreibgeschützten Webdienst-Lookup-Seiten zur Verfügung:

- **Bin List** (`brz_accounting_bin`)
- **GL Setup Dimensions** (`brz_GLSetupDimensions`)
- **Orderdata Purchase Lines** (`brz_orderdataPurchLines`)
- **Posted Purchase Rcpt. Lines**