# Visión general

Dinaup se conecta con tu ecosistema de herramientas a través de múltiples canales. Elige la integración que mejor se adapte a tu caso de uso.

***

## API REST

Interactúa directamente con tus datos mediante peticiones HTTP. Lee informes, genera documentos y escribe registros desde cualquier lenguaje de programación.

**Base URL:** `https://webhook.dinaup.com`

| Endpoint                | Método | Descripción                                                                       |
| ----------------------- | ------ | --------------------------------------------------------------------------------- |
| `/api/whoami`           | GET    | Verifica la autenticación y obtiene datos del usuario                             |
| `/api/reports`          | POST   | Consulta informes configurados en Flex                                            |
| `/api/dynamicdocuments` | POST   | Genera documentos dinámicos (HTML, JSON, PDF)                                     |
| `/api/writeoperations`  | POST   | Crea o edita registros (`id=""` = crear, UUID = editar, `eliminado=1` = eliminar) |
| `/api/tools/aeat`       | GET    | Valida NIF/CIF contra la AEAT                                                     |
| `/api/tools/vies`       | GET    | Valida NIF intracomunitario (VIES)                                                |

→ [Documentación completa de la API](/integraciones/webhook.md)

***

## Webhooks salientes

Recibe notificaciones HTTP en tiempo real cuando se crean o modifican registros en Dinaup. Configúralos desde Dinaup Flex seleccionando la sección, los campos disparadores y la URL de destino.

→ [Configurar webhooks salientes](/integraciones/webhook/salientes.md)

***

## Automatización sin código

Conecta Dinaup con miles de aplicaciones sin escribir código usando plataformas de automatización:

| Plataforma            | Estado     | Descripción                                                                          |
| --------------------- | ---------- | ------------------------------------------------------------------------------------ |
| **n8n**               | Disponible | Flujos de automatización self-hosted o cloud. Conexión directa con la API de Dinaup. |
| **Make** (Integromat) | Disponible | Escenarios visuales de automatización con cientos de integraciones.                  |
| **Zapier**            | Disponible | La plataforma de automatización más popular. Conecta Dinaup con 5000+ apps.          |

→ [Guía de integración con n8n](/integraciones/zapier-make-y-n8n/dinaup-and-n8n.md)

***

## PostgreSQL Sync

Dinaup puede sincronizar tus datos en una base de datos PostgreSQL propia. Esto permite:

* **Consultas SQL directas** sobre tus datos para análisis avanzado
* **Conexión con Power BI**, Metabase, Grafana u otras herramientas de BI
* **Backups propios** con la frecuencia que necesites
* **Desarrollo de aplicaciones** que lean datos de Dinaup en tiempo real

La sincronización es unidireccional (Dinaup → PostgreSQL) y se configura desde el panel de administración.

→ [Configurar PG Sync](/integraciones/dinaup-pg-sync.md)

***

## Power BI

Conecta tus datos de Dinaup directamente con Power BI para crear dashboards y reportes avanzados. La conexión se realiza a través de PostgreSQL Sync.

→ [Guía de Power BI](/integraciones/power-bi.md)

***

## SDK .NET

Cliente oficial para desarrollo en .NET. Permite operaciones de lectura, escritura y consulta de informes con tipado fuerte. El SDK se conecta a `api.dinaup.com` (distinto de `webhook.dinaup.com`).

```csharp
// Ejemplo: leer informes
var data = await client.GetReportAsync(reportId, page: 1, resultsPerPage: 100);

// Ejemplo: escribir datos
await client.RunWriteOperationAsync(sectionId, writeOperation);
```

→ [Documentación del SDK .NET](/desarrollo/sdk.md)

{% hint style="info" %}
**¿API REST o SDK .NET?** Si tu aplicación es .NET, usa el SDK: tiene tipado fuerte, gestión de sesiones y todas las secciones de MyDinaup con nombres de campo legibles. La API REST (`webhook.dinaup.com`) es para integraciones desde cualquier lenguaje.
{% endhint %}

***

## Cloudflare Workers

Ejecuta lógica personalizada en el edge usando Cloudflare Workers conectados a la API de Dinaup. Útil para:

* Transformación de datos en tiempo real
* Proxies de autenticación
* Lógica de negocio distribuida

→ [Guía de Cloudflare Workers](/integraciones/cloudflare-worker.md)

***

## Resumen de opciones

| Necesidad                                | Solución recomendada            |
| ---------------------------------------- | ------------------------------- |
| Leer/escribir datos (cualquier lenguaje) | API REST (`webhook.dinaup.com`) |
| Desarrollo de aplicaciones .NET          | SDK .NET (`api.dinaup.com`)     |
| Reaccionar a eventos en tiempo real      | Webhooks salientes              |
| Automatizar sin código                   | n8n, Make o Zapier              |
| Análisis avanzado con SQL                | PostgreSQL Sync                 |
| Dashboards de BI                         | PostgreSQL Sync + Power BI      |
| Lógica en el edge                        | Cloudflare Workers              |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.dinaup.com/integraciones/integraciones.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.