Dinaup DocsAPI y Webhooks
Dos direcciones de integración: la API REST para leer y escribir datos, y los webhooks salientes para recibir eventos cuando cambian tus datos.
Dinaup integra en dos direcciones. Eliges según quién empieza la conversación.
| Dirección | Quién llama | Para qué |
|---|---|---|
| API REST (entrantes) | Tú → Dinaup | Lees informes, generas documentos y escribes registros con peticiones HTTP |
| Webhooks salientes | Dinaup → Tú | Dinaup avisa a tu servidor cuando se crea o modifica un registro |
Las dos usan el mismo servidor: https://webhook.dinaup.com.
API REST — tú preguntas, Dinaup responde
Envías peticiones HTTP y recibes JSON. Sirve para conectar una tienda online, alimentar un dashboard, importar datos en lote o sincronizar con otro sistema desde cualquier lenguaje.
Cinco endpoints y dos herramientas de validación fiscal:
| Endpoint | Método | Para qué |
|---|---|---|
/ | GET | Ping. Comprueba que el servidor responde |
/api/whoami | GET | Devuelve el usuario asociado a tu clave |
/api/reports | POST | Ejecuta un informe de Flex y devuelve sus filas |
/api/dynamicdocuments | POST | Renderiza un documento dinámico |
/api/writeoperations | POST | Crea, edita o elimina registros en cualquier sección |
/api/tools/aeat/NIFCheck | GET | Valida un NIF/CIF contra la AEAT |
/api/tools/vies/VATCheck | GET | Valida un NIF intracomunitario contra el VIES |
Cada petición viaja firmada con un Token Bearer en la cabecera. El token hereda los permisos del usuario de la clave: solo lee y escribe lo que ese usuario puede ver.
→ Referencia completa de endpoints
Webhooks salientes — Dinaup te avisa
Configuras una URL y Dinaup le envía un POST cuando cambia un registro de la sección que vigilas. Reaccionas al momento, sin consultar la API en bucle.
- Eliges la sección a vigilar y si disparas en altas, en modificaciones o en ambas.
- Acotas con campos disparadores y campos obligatorios.
- Tu servidor recibe el registro antes y después del cambio.
→ Configuración de webhooks salientes
Qué dirección uso
| Necesitas | Usa |
|---|---|
| Leer o escribir datos desde tu código | API REST |
| Crear facturas desde una tienda online | API REST — POST /api/writeoperations |
| Volcar un informe a un dashboard | API REST — POST /api/reports |
| Enterarte al instante de una venta nueva | Webhook saliente en la sección de ventas |
| Sincronizar clientes con un CRM | Webhook saliente (avisa) + API REST (lee el detalle) |
| Automatizar sin escribir código | Webhook saliente hacia n8n, Make o Zapier |
Playground
Prueba los endpoints y simula un webhook saliente desde Dinaup, sin herramientas externas. El Playground también genera el Token Bearer de cada clave API.
Referencia de la API REST
Mapa de la API REST pública de Dinaup (webhook.dinaup.com). Qué hace cada endpoint, cómo te autenticas y dónde está el detalle técnico.
API REST — Referencia de endpoints
Los endpoints de la API REST de Dinaup (webhook.dinaup.com): autenticación, informes, documentos, WriteOperations, herramientas fiscales, límites de tasa y códigos de respuesta.