POS/ERP/PSP-SyncPOS/ERP/PSP Sync

GROW

Bidirektionale Synchronisation mit deinem Kassensystem, ERP und Zahlungsanbieter. Systemagnostisch, dein System bleibt Single Source of Truth.

Bidirectional sync with your POS, ERP and payment provider. System-agnostic, your system stays the single source of truth.

Unterstützte SystemeSupported Systems

Korona

POS

Vectron

POS

Casio

POS

Lightspeed

POS

SumUp POS

POS

Zettle

POS

SAP Business One

ERP

lexoffice

ERP

sevDesk

ERP

Xentral

ERP

weclapp

ERP

Stripe

PSP

Adyen

PSP

Mollie

PSP

Payone

PSP

Unzer

PSP

SumUp

PSP

payabl

PSP

Dein System fehlt? Nutze "generic" als system Parameter. Die API-Schnittstelle ist identisch.Your system is missing? Use "generic" as the system parameter. The API interface is identical.

ArchitekturArchitecture

IntegrationIntegration

Test-Keys erstellenGenerate Test Keys

Im Dashboard Test-Keys generieren. Sandbox-Keys haben PRIME-Berechtigungen.Generate test keys in the Dashboard. Sandbox keys have PRIME permissions.

System konfigurierenConfigure Your System

PSP via configurePSP einrichten. POS/ERP Credentials bereithalten.Set up PSP via configurePSP. Have POS/ERP credentials ready.

Sync testenTest Sync

Katalog via syncPOS oder syncERP importieren. Daten in der Sandbox prüfen.Import catalog via syncPOS or syncERP. Verify data in the Sandbox.

Live schaltenGo Live

GROW-Paket aktivieren, Live-Keys generieren. Webhooks für integration.* Events registrieren.Activate GROW package, generate live keys. Register webhooks for integration.* events.

EndpointsEndpoints

POST /api/v1/syncPOS POS-Katalog importierenImport POS catalog GROW

Importiert Produktkatalog, Kategorien und Preise aus dem Kassensystem nach BEEP!.

Imports product catalog, categories and prices from the POS system into BEEP!.

Parameter	Type		Description
system	string	required	`"korona"`, `"vectron"`, `"casio"`, `"lightspeed"`, `"sumup"`, `"generic"`
storeId	string	required	Store ID
credentials	object	required	POS-API-Zugangsdaten (systemabhängig)POS API credentials (system-specific)

Response 200

{ "success": true, "system": "korona", "synced": { "products": 42, "categories": 5, "priceUpdates": 8 } }

POST /api/v1/pushToPOS Daten an POS sendenPush data to POS GROW

Schreibt Verkaufsdaten und Kassenbons aus BEEP! zurück ins Kassensystem.

Writes sales data and receipts from BEEP! back to the POS system.

Parameter	Type		Description
system	string	required	`"korona"`, `"vectron"`, `"casio"`, `"lightspeed"`, `"sumup"`, `"generic"`
dataType	string	required	`"sales_record"`, `"receipt"`, `"inventory_update"`
records	array	required	Array der DatensätzeArray of records

Response 200

{ "success": true, "data": { "system": "korona", "storeId": "store_abc", "dataType": "sales_record", "recordsReceived": 3, "status": "push_queued" } }

POST /api/v1/syncERP ERP-Daten importierenImport ERP data GROW

Synchronisiert Bestand, Bestellungen und Lieferanten-Daten aus dem ERP.

Syncs inventory, orders and supplier data from the ERP.

Parameter	Type		Description
system	string	required	`"sap"`, `"lexoffice"`, `"sevdesk"`, `"xentral"`, `"weclapp"`, `"generic"`
storeId	string	required	Store ID
credentials	object	required	ERP-API-ZugangsdatenERP API credentials

POST /api/v1/pushToERP Daten an ERP sendenPush data to ERP GROW

Überträgt Transaktionsdaten und Bestandsänderungen ins ERP.

Transfers transaction data and inventory changes to the ERP.

Parameter	Type		Description
system	string	required	`"sap"`, `"lexoffice"`, `"sevdesk"`, `"xentral"`, `"weclapp"`, `"generic"`
dataType	string	required	`"transaction"`, `"inventory_update"`, `"order"`
records	array	required	Array der DatensätzeArray of records

Response 200

{ "success": true, "data": { "system": "lexoffice", "storeId": "store_abc", "dataType": "transaction", "recordsReceived": 5, "status": "push_queued" } }

POST /api/v1/configurePSP PSP konfigurierenConfigure PSP GROW

Konfiguriert den Payment Service Provider für einen Store. BEEP! leitet Zahlungen über das PSP-Konto des Händlers.

Configures the payment service provider for a store. BEEP! routes payments through the merchant's PSP account.

Parameter	Type		Description
provider	string	required	`"stripe"`, `"adyen"`, `"mollie"`, `"payone"`, `"unzer"`, `"sumup"`, `"payabl"`, `"custom"`
storeId	string	required	Store ID
config	object	required	PSP-Konfiguration (API-Keys, Account-IDs)PSP configuration (API keys, account IDs)

Response 200

{ "success": true, "data": { "storeId": "store_abc", "provider": "stripe", "status": "configured" } }

POST /api/v1/processPayment Zahlung auslösenProcess payment GROW

Löst eine Zahlung über den konfigurierten PSP aus.

Triggers a payment via the configured PSP.

configurePSP muss zuvor für den Store aufgerufen worden sein.configurePSP must have been called for the store first.

Parameter	Type		Description
amount	integer	required	Betrag in Cent (357 = 3,57 €)Amount in cents (357 = 3.57 €)
currency	string	optional	Default: `"EUR"`
paymentMethod	string	optional	`"card"`, `"nfc"`, `"qr"`
metadata	object	optional	Referenz-ID, Beschreibung etc.Reference ID, description etc.

Response 200

{ "success": true, "data": { "paymentId": "pay_7c3f8e1a...", "amount": 357, "currency": "EUR", "pspProvider": "stripe", "status": "pending" } }

400: No PSP configured

{ "success": false, "error": "No PSP configured for this store. Call configurePSP first." }

POST /api/v1/refundPayment ErstattungRefund GROW

Initiiert eine (Teil-)Rückerstattung über den konfigurierten PSP.

Initiates a (partial) refund via the configured PSP.

Parameter	Type		Description
paymentId	string	required	ID der ursprünglichen ZahlungOriginal payment ID
amount	integer	optional	Erstattungsbetrag in Cent (ohne = Vollerstattung)Refund amount in cents (omit = full refund)
reason	string	optional	`"requested_by_merchant"`, `"duplicate"`, `"fraudulent"`

Response 200

{ "success": true, "data": { "refundId": "ref_9a2b4c6d...", "paymentId": "pay_7c3f8e1a...", "amount": 357, "currency": "EUR", "status": "pending" } }

404: Payment not found

{ "success": false, "error": "Payment not found or not associated with this store" }

Webhook EventsWebhook Events

integration.pos.synced

POS-Sync abgeschlossenPOS sync completed

integration.pos.pushed

Daten an POS gepushtData pushed to POS

integration.erp.synced

ERP-Sync abgeschlossenERP sync completed

integration.erp.pushed

Daten an ERP gepushtData pushed to ERP

integration.psp.configured

PSP konfiguriertPSP configured

payment.created

Zahlung initiiertPayment initiated

payment.refunded

Erstattung initiiertRefund initiated