DAB · api v1
Para conectar el sistema del restaurante o de la empresa —su TPV, su ERP, su gestoría— con DAB. Todo en JSON sobre HTTPS, con una clave por cliente.
La dirección base es https://api.delamotech.es/v1. Cada petición lleva su clave
en la cabecera:
curl https://api.delamotech.es/v1/ping \
-H "Authorization: Bearer dab_live_…"La respuesta dice de quién es la clave y qué se puede pedir con ella. Empieza siempre por
ahí: si ping contesta, el resto va a funcionar.
El cliente nunca va en la URL
Sale de la clave. No hay ningún parámetro para elegir restaurante: una clave solo puede ver y tocar los datos de su cuenta, y no hay forma de pedir los de otra.
La clave no tiene permisos propios: hereda los módulos que ese cliente tiene
contratados. Si algo no está contratado, la respuesta es un 403 con el
motivo escrito.
| Área | Cuándo está disponible |
|---|---|
| Carta | Cuentas de restaurante |
| Comandas | Restaurantes con el módulo de comandas |
| Gastos | Cualquier cuenta con el módulo de Costes |
/v1/carta/platos/ref:CROQ-JAM.precio, disponible, stock o ref_externa. Manda solo lo que quieras cambiar. Admite ref: igual que el GET.curl -X PUT https://api.delamotech.es/v1/carta/platos/42 \
-H "Authorization: Bearer dab_live_…" \
-H "Content-Type: application/json" \
-d '{"precio": 13.50, "disponible": true}'Dos campos que se confunden. disponible es si el plato está en la carta;
stock son las raciones que quedan hoy (0 = agotado hoy,
null = sin control). El stock se borra solo mañana; disponible, no.
Lo primero que conviene hacer es emparejar las dos cartas una sola vez. Bajáis
/v1/carta, decidís qué plato vuestro es cada uno y lo mandáis todo junto:
curl -X POST https://api.delamotech.es/v1/carta/referencias \
-H "Authorization: Bearer dab_live_…" \
-H "Content-Type: application/json" \
-d '{"referencias":[{"plato_id":39,"ref":"CROQ-JAM"},
{"plato_id":41,"ref":"ARR-SEN"}]}'A partir de ahí ya no necesitáis nuestros identificadores para nada: se pide y se cambia cada plato por el vuestro.
curl -X PUT https://api.delamotech.es/v1/carta/platos/ref:CROQ-JAM \
-H "Authorization: Bearer dab_live_…" \
-H "Content-Type: application/json" \
-d '{"precio": 13.50}'Cada referencia tiene que ser única dentro de la cuenta; si se repite, la respuesta es
un 409 y no se guarda nada. Con "ref": null se deshace el
emparejamiento de un plato.
desde (fecha ISO), estado y limite. Trae las líneas de cada comanda.curl "https://api.delamotech.es/v1/comandas?desde=2026-08-10T00:00:00Z&limite=50" \
-H "Authorization: Bearer dab_live_…"desde, hasta, estado, limite.Fiaos solo de «confirmado»
Un documento en pendiente_revision lo ha leído la IA pero todavía no lo ha
dado por bueno una persona. Para contabilidad, filtrad por
estado=confirmado.
Los errores siempre tienen la misma forma:
{ "error": { "codigo": "sin_modulo",
"mensaje": "Esta cuenta no tiene el módulo de Costes contratado." } }| Código | Qué ha pasado |
|---|---|
| 401 clave_invalida | Falta la clave, está mal escrita o ha sido revocada. |
| 403 sin_modulo | La clave es buena, pero esa cuenta no tiene ese módulo. |
| 404 no_encontrado | Ese id no existe en esta cuenta. |
| 400 datos_invalidos | Lo que has mandado no vale; el mensaje dice por qué. |
| 429 demasiadas_peticiones | Más de 60 por minuto. Espera lo que diga Retry-After. |
PUT dejan siempre el mismo resultado: si se
cae la línea y reintentáis, no pasa nada./v2 y la /v1 sigue funcionando.Lo que esta API no hace
No emite facturas, no cobra y no toca nada de Verifactu. DAB alimenta vuestro sistema; la facturación sigue siendo vuestra.