Prezentare generală · Nexus Gateway

Citește meniul restaurantului, trimite comenzi de pe website și urmărește starea lor în Nexus Retail.

Ești la prima integrare Nexus? Citește mai întâi Cum funcționează: o diagramă și termenii folosiți în toate ghidurile.

Restaurantul publică catalogul din Retail. Preia meniul din backend și folosește ID-urile produselor, prețurile și revizia pentru a forma coșul.

Cheia tenantului permite descoperirea conexiunilor POS activate prin GET /v1/connections. Selectează un ID de conexiune înainte de a citi meniul. Păstrează cheia pe server.

Meniuri și disponibilitate →

curl "https://website.api.pionier.ro/v1/connections/$NEXUS_CONNECTION_ID/menu" \
  -H "Authorization: Bearer $NEXUS_WEBSITE_KEY"

Folosește https://website.api.pionier.ro cu cheia website a tenantului primită de la persoana de contact Nexus. Autentificare

Trimite o comandă

Trimite produsele selectate, datele clientului, modalitatea de onorare și declarația de plată. Salvează cererea completă și un ID unic de comandă înainte de trimitere.

Un răspuns 201 confirmă că Retail a primit comanda. Personalul trebuie încă să o accepte.

Comenzi și plăți →

curl "https://website.api.pionier.ro/v1/connections/$NEXUS_CONNECTION_ID/orders" \
  -H "Authorization: Bearer $NEXUS_WEBSITE_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @order-pickup.json

Descarcă cererea demonstrativă. Înlocuiește ID-urile și revizia cu valorile meniului publicat pentru conexiunea selectată.

Urmărește comanda

Primește decizia restaurantului și actualizările comenzii prin webhook-uri. Înregistrează callback-ul înainte de trimiterea comenzilor. Folosește GET pentru reconcilierea stării după întreruperi sau când webhook-urile nu sunt disponibile. Un POST repetat întoarce confirmarea inițială de primire, nu progresul curent.

După expirarea timpului de răspuns, reîncearcă folosind aceeași conexiune, același ID și același corp al cererii. Un ID nou poate crea o comandă duplicată.

Starea comenzii → Erori și reîncercări →

curl "https://website.api.pionier.ro/v1/connections/$NEXUS_CONNECTION_ID/orders/shop-1001" \
  -H "Authorization: Bearer $NEXUS_WEBSITE_KEY"

{
  "external_order_id": "shop-1001",
  "status": "accepted",
  "total": 3700,
  "currency": "RON"
}

Ghiduri de integrare

Construiește un coșTransformă opțiunile în linii de comandă și calculează totalul cu cod testat.Tratarea erorilorGestionează coșurile învechite, opțiunile respinse și trimiterile cu rezultat incert.Verificări pentru lansareStabilește cu Nexus configurația de test și verifică întregul flux de comandă împreună cu restaurantul.

Funcționalități disponibile în v1

Funcționalitate	Acoperire
Ridicare și livrare	Folosește modalitățile de onorare activate în meniul publicat.
Prețuri și opțiuni de produs	RON, cantități întregi, variante exacte, pachete, extra, garanții și ambalaje.
Plăți	Declarații de plată online sau numerar/card la primire. Procesatorul tău gestionează încasările online și rambursările.
Progresul comenzii	Actualizări prin webhook-uri semnate și citirea stării pentru reconciliere.
Modificarea meniului	Retail sincronizează automat disponibilitatea pentru meniurile publicate. Pauzele și programul se aplică imediat; prețurile și modificările catalogului necesită publicare. Actualizează meniul înainte de finalizarea comenzii chiar dacă revizia nu s-a schimbat.

Comenzile programate sunt acceptate fără o activare separată de către restaurant. Clienții pot anula comenzile imediate înainte de acceptare și comenzile programate acceptate înainte de începerea preparării. Cupoanele la finalizarea comenzii, bacșișurile pentru personal, actualizările livrării și raportarea rambursărilor externe sunt disponibile. Promoțiile pe produs, taxele arbitrare, cantitățile fracționare, editarea comenzilor și procesarea plăților nu sunt disponibile. Procesatorul tău efectuează rambursările.

Obține acces la API

Solicită persoanei de contact Nexus cheia API website a tenantului tău. Toți tenanții din producție se conectează la https://website.api.pionier.ro. Descoperă conexiunile POS activate cu cheia ta, apoi selectează locația restaurantului și cere publicarea meniului. Stabilește cu Nexus și restaurantul cum se vor testa comenzile înainte de a le trimite.

Exemplele folosesc date fictive. Această documentație nu trimite cereri și nu stochează credențiale.