Belege-Portal
Über das Rechnungsportal bzw. Belege-Portal, können Sie Ihren Kunden beliebige Belege aus Ihrem ERP bereitstellen.
Es ist möglich, dass auch Belege bereitgestellt werden, die Vorgänge aus anderen Kanälen repräsentierern. Die Funktion ist also nicht auf Bestellungen beschränkt, die im Shop aufgegeben wurden.
Über das Feld orderNumber könenn Sie eine Referenuznummer übergeben. Entspricht diese Referenznummer einer Bestellnummer im Shop (und hat der aufrufende Nutzer das Recht diese zu sehen), wird der Beleg automatisch mit dem Bestellvorgang im Shop verknüpft.
Darstellung der Belege im Account
Die Belege werden gruppiert nach Tabs im Kundenkonto hinterlegt.
Hinzufügen neuer Belege
Belege können ausschließlich über den Webservice hinerlegt werden.
Folgende Werte können im Belege Upload Request gesetzt werden. Diese werden aufgelöst und entsprechend angezeigt.
- customerNumber = Kundennummer
- customerGroupName = Name der Kundengruppe
- companyGroupName = Name des Unternehmens
Man kann den Kunden, Gruppe & Unternehmen auch direkt per ID übergeben:
- customerId
- customerGroupId
- companyGroupId
Du musst nicht per Query den “fileName” übergeben. Das ist optional, ansonsten wird der Dateiname aus der Datei vom Upload genommen. Dies habe ich hier nur drin damit ich immer die selbe Datei hochladen kann. Es wird bei einer bereits existierenden Datei ein Fehler geworfen!
Z.b. so sieht dann ein Reuqest aus welcher das Unternehmen auflöst und zuweist:
curl --location 'https://YOUR_STORE_URL/api/_action/receipt/upload?fileName=Test91112532&XDEBUG_SESSION_START=XDEBUG_ECLIPSE' \
--header 'Authorization: Bearer XXX' \
--form 'file=@"/home/ts/Downloads/Test_PDF.pdf"' \
--form 'active="true"' \
--form 'companyGroupName="digitalmanufaktur GmbH"' \
--form 'type="1"' \
--form 'number="CFD123456"' \
--form 'receiptDate="11.02.2025 15:00"' \
--form 'orderNumber="10028"' \
--form 'netAmount="10"' \
--form 'grossAmount="12"' \
--form 'description="Ein Test (Company)"'Dokument Typen:
- 1 = Rechnung
- 2 = Lieferschein
- 3 = Gutschrift
- 4 = Retouren
- 99 = Andere