Integraciones
Conectarlo con vuestros sistemas
Las tres formas de conectar, y cuál elegir según lo que necesites.
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.
Ojo con esto
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.
Un caso real
La situación
Una constructora quiere que al dar de alta una subcontrata en su ERP se lance solo el proceso de documentación.
Qué haces
- 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
Qué consigues
Nadie teclea dos veces, y el ERP sabe quién puede entrar a obra sin que se lo digan.
La situación
Una asesoría con cuatrocientos clientes quiere que el alta en su software de gestión dispare la petición de documentos.
Qué haces
- 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
Qué consigues
El alta deja de ser un trabajo doble y la asesoría ve el avance sin salir de su herramienta.
La situación
Cada área quiere su propia conexión y se montan cuatro que hacen casi lo mismo.
Qué haces
- Define un solo flujo y los casos particulares como variantes
Qué consigues
Hay una integración que mantener en lugar de cuatro que se pisan.
La situación
La conexión se monta contra una versión del sistema que va a cambiar.
Qué haces
- Pregunta a informática el calendario de actualizaciones antes de empezar
Qué consigues
La integración no nace obsoleta.
La situación
Se integra un proceso que se ejecuta tres veces al año.
Qué haces
- Valora si compensa frente a hacerlo a mano
Qué consigues
El esfuerzo va donde hay repetición de verdad.
La situación
Se conecta y no se prueba con datos reales hasta el día del arranque.
Qué haces
- Prueba con un caso real en un entorno aparte
- Comprueba qué pasa cuando el dato viene mal
Qué consigues
El arranque no es también la primera prueba.
Este artículo responde a
- integrar code contract con nuestro erp
- api para crear procesos automáticamente
- recibir avisos cuando alguien firma
- conectar con sharepoint