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 specifica integrazione.

Dove ti integri

REST API

Leggi i menu, invia ordini, verifica lo stato dei pagamenti, recupera i report. Autenticazione tramite token. Documentato per ogni endpoint con payload di esempio.

Webhooks

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

Connettori POS

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

Handbook MCP

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

Insights MCP

Un server MCP per tenant espone le tue analisi operative — riepiloghi di periodo, performance dei 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 singola 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 al 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 è inoltre esposto tramite 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'engineer 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