Quan apareix un ordre d'Uber Eats a la vostra caixa, és gràcies a un diàleg entre diversos sistemes a través d'APIs (Interfaces de Programació d'Aplicacions). Entendre com funciona us ajuda a triar millor les vostres eines i diagnosticar els problemes.
Què és una API?
Una API és un protocol de comunicació entre programes. Concretament, és una manera estandarditzada perquè un sistema pugui demanar dades o desencadenar accions en un altre sistema.
L'API Uber Eats permet à un agrégateur de récupérer les nouvelles commandes L'API de votre POS permet à un agrégateur d'y injecter une commande L'API Stripe permet à votre POS de déclencher un paiement
Les API solen utilitzar HTTP/REST amb dades en format JSON.
El flux complet d'un comandament de lliurament
Aquí és el que passa quan un client fa una comanda a Uber Eats:
- Client de comanda : l'aplicació Uber Eats envia la comanda als servidors d'Uber
- Notificació al restaurant : Uber notifica el vostre restaurant a través de webhook (notificació push)
- Recepció per l'agregador : si utilitzeu Pepprio, és ell qui rep el webhook
- Injecció al vostre POS : Pepprio crida a l'API del vostre POS per crear la comanda
- Visualització a la cuina : el vostre KDS rep la comanda del vostre POS
- Confirmació de preparació : quan "batem" la comanda prènia, el vostre POS en informa a Pepprio
- Actualització d'Uber : Pepprio crida a l'API d'Uber per indicar que la comanda està prènia
- Lliurador informat : Uber informa al lliurador que la comanda pot ser recollida
Aquesta cadena s'executa en qüestió de segons.
Els estàndards d'API en restauració
Webhooks
Notificació asíncrona: el sistema A envia una sol·licitud HTTP a una URL del sistema B tan aviat com es produeix un esdeveniment. Ideal per a les ordres: no cal que B faci un bucle de comprovació.
API REST
Estandar d'arquitectura per a les sol·licituds/respostes. El sistema B "sol·licita" a A dades o accions. És el que utilitzem per actualitzar l'estat d'un comandament, desactivar un article, modificar un preu.
Autenticació
Les API de restaurants utilitzen generalment clàusoles API o OAuth 2.0. Aquestes són "contrasenyes de màquina" que autentiquen les sol·licituds. Crucial per a la seguretat.
Els reptes tècnics
Latència
Cada crida a l'API tarda (50-500 ms). En una cadena de 7-8 crides, això pot representar diverses segons. En període de pic, aquesta latència pot acumular-se.
Gestió d'errors
Què passa si l'API del POS està inactiva quan arriba un ordre? Els bons agregadors implementen el retry (tornada automàtica) i la dead letter queue (espera de missatges rebuts que no han tingut èxit per a un tractament posterior).
Evolució de les API
Les plataformes actualitzen les seves API regularment. Una mala gestió de les versions pot trencar la vostra integració sense preavisament. Les bones integracions inclouen un monitoratge que detecta els canvis i alerta abans que un problema afecti els clients.
Sincronització
Si un ordre és modificat en curs de preparació per part d'Uber Eats, com remunta la informació? Les API han de gestionar aquests casos. No totes ho fan bé.
Per què un agregador és més fiable que una integració directa
Un agregador de notícies utilitza un sistema de filtrat i de classificació per seleccionar les notícies més rellevants per a l'usuari. Aquest sistema és dissenyat per evitar la sobrecàrrega d'informació i per assegurar que l'usuari rebi només les notícies que li interessen. En comparació, una integració directa implica que l'usuari ha de consultar directament diverses fonts de notícies, cosa que pot ser avorridora i ineficient. A més, una integració directa pot ser vulnerable a errors i a la inestabilitat de les fonts individuals.
Un agregador, per contra, actua com a intermediari, filtrant i combinant les notícies de diverses fonts. Això redueix el risc de rebre informació incorrecta o obsoleta, ja que l'agregador s'encarrega de verificar la fiabilitat de les fonts i de garantir que les notícies presentades siguin correctes. També, un agregador pot gestionar errors i problemes tècnics a les fonts individuals, assegurant que l'usuari continuï rebent notícies de manera constant.
Finalment, un agregador ofereix una experiència més personalitzada i eficient, ja que l'usuari no ha de buscar activament les notícies que necessita. L'agregador fa aquesta feina per a ell, oferint-li un flux de notícies adaptat als seus interessos.
En teoria, podríeu integrar directament Uber Eats al vostre POS a través d'API. Diverses limitacions:
Les plataformes no obren les seves API a tothom Uber Eats reserva l'accés a la seva API a socis seleccionats. Pepprio és un soci oficial.
La manteniment és pesat. Cada plataforma evoluciona independentment. Mantenir 4 integracions directes (Uber, Deliveroo, Just Eat, Glovo) actualitzades és una feina a temps complet.
Les normes varien Un comandament Uber no té la mateixa estructura que un comandament Deliveroo. El treball de normalització és important.
La tolerància a les avaries Un agregador professional té servidors redundants, monitoratge 24/7 i plans de continuïtat. Difícil de reproduir per a un restaurant independent.
És per això que un agregador com Pepprio és no només més senzill, sinó sovint més fiable tècnicament que una integració directa feta a casa.
Els elements a verificar en una API
- Seguretat:
- Autenticació i autorització: assegurar-se que la API requereix autenticació adequada i que els accessos estan restringits a les funcions i dades corresponents.
- Criptografia: verificar que les comunicacions entre el client i la API estan protegudes amb TLS/SSL.
- Validació d'entrada: assegurar-se que la API valida correctament les dades de entrada per prevenir vulnerabilitats com ara injecció SQL o XSS.
- Funcionalitat:
- Cobertura: assegurar-se que la API cobreix totes les funcionalitats necessàries.
- Fiabilitat: verificar que la API respon correctament i de manera consistent en diverses condicions.
- Rendiment: mesurar el temps de resposta de la API i assegurar-se que és suficient per a les aplicacions que la utilitzen.
- Documentació:
- Claredat: la documentació ha de ser clara, concisa i fàcil d'entendre.
- Exemples: incloure exemples de codi que mostrin com utilitzar la API.
- Endpoints: documentar tots els endpoints de la API, incloent els paràmetres de consulta i les respostes esperades.
- Gestió d'errors:
- Codis d'error: definir codis d'error clars i significatius.
- Missatges d'error: proporcionar missatges d'error descriptius que ajudin a diagnosticar el problema.
- Manejament d'excepcions: assegurar-se que la API gestiona correctament les excepcions i retorna respostes d'error adequades.
- Versió:
- Control de versions: implementar un sistema de control de versions per garantir la compatibilitat entre les versions de la API.
- Retrocompatibilitat: assegurar-se que les noves versions de la API són retrocompatible amb les versions anteriors.
Quan valoreu un agregador o un POS, preguntes sobre la seva API:
Quins esdeveniments estan sincronitzats? Creació, modificació, cancel·lació, estat, pagament? Qual és la latència mitjana? Quant de temps entre un comandament a Uber Eats i la seva aparició a la caixa? Com es gestionen els errors? Reintent automàtic? Notificació al restaurant? L'API està versionada? Una nova versió trenca la vella? Quin monitoratge està en marxa? Panell de control visible per al restaurant? Qual és la disponibilitat (SLA)? 99%? 99.9%? 99.99%?
En aquest darrer punt, la diferència és important. 99% d'uptime = 7,3 hores d'inassistència al mes. 99,9% = 43 minuts al mes. En hora punta, la diferència es mesura en comandes perdudes.
L'arquitectura moderna d'un restaurant connectat implica una combinació de factors clau per crear una experiència client atractiva i eficient.
- Espais oberts i flexibles: Els restaurants connectats solen comptar amb espais amplis i oberts que permeten una circulació fluida i una adaptació a diferents tipus d'ubicacions de taula.
- Il·luminació intel·ligent: La il·luminació ajustable i controlada per sensors permet crear l'ambient desitjat i reduir el consum energètic.
- Tecnologia integrada: Incorporació de pantalles tàctils, sistemes de comandament de taula, càmeres de vigilància i sensors de qualitat de l'aire.
- Mobiliari modular: Mobilià adaptable i fàcilment reconfigurables per optimitzar l'espai i satisfer les necessitats dels clients.
- Connexió Wi-Fi de qualitat: Una connexió Wi-Fi robusta i fiable és essencial per a la funcionalitat de les aplicacions i sistemes connectats.
La distribució de l'espai ha de ser pensada per facilitar la comunicació entre el personal i els clients, i per assegurar una experiència senzilla i agradable. La integració de la tecnologia ha de ser discreta i funcional, sense interrompre l'atmosfera del restaurant. L'objectiu final és crear un espai que sigui a la vegada elegant, funcional i tecnològicament avançat.
Una pila tècnica de restaurant modern sembla:
Platesformes de lliurament → Agregador (Pepprio) → POS → KDS de cuina ↓ Anàlisis consolidada ↓ Contabilitat, BI
Cada fletxa és una integració a través d'API. La robustesa de l'ensemble depèn de la robustesa de cada element.
En conclusió, la situació és complexa i requereix un enfocament multifacètic. És fonamental abordar les causes subjacents del problema, com ara la desigualtat econòmica i la manca d'oportunitats educatives. També cal promoure la participació ciutadana i el diàleg entre tots els actors implicats. No obstant això, no hi ha solucions fàcils ni ràpides. Cal ser pacient i persistent, i estar disposats a adaptar les nostres estratègies a mesura que evoluciona la situació. Finalment, creiem que la clau delèxit rau en la capacitat de construir una societat més justa, equitativa i sostenible per a tothom.
No és necessari tenir coneixements tècnics per fer una lliurament. Però comprendre l'arquitectura ajuda a formular les preguntes adequades als proveïdors i a triar eines sòlides.
Pepprio està invertint massa en la qualitat de les seves integracions d'API: monitoratge continu, reintent automàtic, SLA elevat. És invisible quan tot funciona, però és el que marca la diferència un divendres a les 20:30.