---
id: KB-IN-002
url: https://app.codecontract.io/ayuda/integraciones/tres-formas-de-conectar-vuestros-sistemas
idioma: es
categoria: integraciones
audiencia: desarrollador
nivel: intermedio
actualizado: 2026-08-13
tambienEn: [en]
relacionados: [KB-IN-001, KB-TZ-001]
citadoPor: [KB-IN-005, KB-IN-006, KB-IN-007, KB-IN-011, KB-IN-015, KB-IN-010, KB-IN-003]
---

# Conectarlo con vuestros sistemas

_Las tres formas de conectar, y cuál elegir según lo que necesites._

**Responde a:** integrar code contract con nuestro erp · api para crear procesos automáticamente · recibir avisos cuando alguien firma · conectar con sharepoint

Si ya tenéis un sistema donde vive la información —un ERP, un CRM, una carpeta compartida—, hay tres formas de conectarlo. La diferencia está en quién empieza la conversación.

| Forma | Quién empieza | Para qué sirve |
| --- | --- | --- |
| API | Vuestro sistema | Crear procesos, subir documentos, consultar estados desde vuestro código |
| Avisos automáticos | La plataforma | Enteraros al momento de que alguien firmó o entregó, sin preguntar cada rato |
| Carpeta conectada | Los dos | Que los documentos aparezcan donde vuestra gente ya trabaja |

## Cuál elegir

- Si vuestro sistema es el que manda y quiere lanzar procesos: API.
- Si lo que necesitáis es reaccionar a lo que pasa aquí: avisos automáticos.
- Si la gente ya trabaja en una carpeta compartida y no queréis cambiar su costumbre: carpeta conectada.

No son excluyentes, y lo habitual es acabar con dos: la API para lanzar y los avisos para enterarse.

> [!WARNING]
> Los avisos automáticos hay que confirmarlos: si vuestro sistema no responde, se reintenta. Un endpoint que devuelve error a todo genera reintentos indefinidos y ruido.

## Antes de escribir código

La documentación técnica con los endpoints, la autenticación y los ejemplos está en la propia plataforma. Este artículo es el mapa; ahí está el detalle.

**¿Hay entorno de pruebas?**

Sí, para no ensuciar los datos de verdad mientras se desarrolla.

**¿Las claves de acceso caducan?**

Se pueden rotar y revocar. Conviene una por integración, no una para todo.

**¿Consume créditos usar la API?**

Consume lo mismo que haría la acción por pantalla, ni más ni menos.

## Ejemplos

**Una constructora quiere que al dar de alta una subcontrata en su ERP se lance solo el proceso de documentación.**

- El ERP llama a la API al crear la subcontrata
- Recibe un aviso automático cuando el expediente se completa
- Marca la subcontrata como apta en su sistema

→ Nadie teclea dos veces, y el ERP sabe quién puede entrar a obra sin que se lo digan.

**Una asesoría con cuatrocientos clientes quiere que el alta en su software de gestión dispare la petición de documentos.**

- Su software llama a la API al crear la ficha del cliente
- Se lanza la plantilla de alta con los datos que ya tenía
- El estado vuelve a su software cuando el cliente entrega

→ El alta deja de ser un trabajo doble y la asesoría ve el avance sin salir de su herramienta.

**Cada área quiere su propia conexión y se montan cuatro que hacen casi lo mismo.**

- Define un solo flujo y los casos particulares como variantes

→ Hay una integración que mantener en lugar de cuatro que se pisan.

**La conexión se monta contra una versión del sistema que va a cambiar.**

- Pregunta a informática el calendario de actualizaciones antes de empezar

→ La integración no nace obsoleta.

**Se integra un proceso que se ejecuta tres veces al año.**

- Valora si compensa frente a hacerlo a mano

→ El esfuerzo va donde hay repetición de verdad.

**Se conecta y no se prueba con datos reales hasta el día del arranque.**

- Prueba con un caso real en un entorno aparte
- Comprueba qué pasa cuando el dato viene mal

→ El arranque no es también la primera prueba.