Per sviluppatori, integratori e partner POS

Costruisci sul livello operativo.

Fooodo espone una REST API, eventi webhook, un contratto tipizzato per nuovi connettori POS e due server MCP per client AI — uno per il manuale pubblico, uno per tenant Insights. Il riferimento completo è in preparazione per il rilascio generale; contatta il team di engineering per l'accesso anticipato sulla tua integrazione specifica.

Dove ti integri

REST API

Leggi menu, invia ordini, verifica lo stato dei pagamenti, scarica report. Autenticazione tramite token. Documentazione per endpoint con payload di esempio.

Webhooks

Eventi di ordine, pagamento e stato tavolo recapitati al tuo endpoint. Payload firmati, retry su 5xx, chiavi di idempotenza.

Connettori POS

Un contratto tipizzato per nuovi sistemi POS — Fooodo sviluppa e gestisce il connettore verso la tua API POS. Nessuna implementazione all'interno di Fooodo; pagamenti, multi-tenancy e reportistica sono inclusi. R-Keeper è l'implementazione di riferimento.

Handbook MCP

Un endpoint MCP su /api/mcp consente agli agenti AI di consultare il manuale Fooodo e inviare richieste di contatto per conto di un acquirente. Integralo nel tuo editor o nel tuo agente.

Insights MCP

Un server MCP per tenant espone le tue analisi operative — riepiloghi di periodo, performance di canali di vendita e marketing, performance per prodotto e per ristorante, P&L e tre agenti AI specializzati — a qualsiasi client compatibile con MCP tramite OAuth 2.1. Disattivato per impostazione predefinita; abilitabile per organizzazione.

Un esempio concreto

Invia un ordine a Fooodo dalla tua applicazione. L'ordine arriva in R-Keeper esattamente come se un cameriere lo avesse inserito manualmente.

POST /api/v1/orders
curl -X POST https://api.fooodo.com/v1/orders \
  -H "Authorization: Bearer $FOOODO_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "table_id": "tbl_x7g2",
    "items": [
      { "product_id": "prod_pep_30", "qty": 2 },
      { "product_id": "prod_cola_05", "qty": 2 }
    ],
    "tip_amount_minor": 200,
    "payment": { "method": "card", "return_url": "https://your-app/return" }
  }'

Su cosa puoi contare

  • Contratti stabili — versionati, deprecati con preavviso, mai interrotti silenziosamente
  • Chiavi di idempotenza su ogni scrittura, così i tentativi ripetuti non duplicano gli ordini
  • Firme webhook per verificare la provenienza di ogni evento
  • Ospitato in EU, conforme a GDPR, senza sorprese sulla residenza dei dati in paesi terzi

Leggi il manuale di integrazione

Architettura, flussi degli ordini, integrazione R-Keeper, pagamenti, il riferimento API e le specifiche di valutazione dei vendor POS sono tutti nella documentazione. Il manuale è anche esposto via MCP per client AI.

Sfoglia la documentazioneRequisiti di integrazione POS

Parla con il team di engineering

Dicci cosa stai costruendo — connettore POS, integrazione degli ordini, export analytics, agente AI sul server MCP. Ti metteremo in contatto con l'ingegnere giusto e i token di accesso appropriati.

Inviando questo modulo accetti di essere contattato da Fooodo in merito alla tua richiesta. Non condividiamo i tuoi dati con terze parti. Consulta la nostra Informativa sulla privacy per sapere come trattiamo i dati.

Stai guardando Fooodo da un'altra prospettiva? Per i ristoranti · Partner · Insights · Sicurezza