Una API en una analogía
Pensá en la ventanilla de un banco. No entrás a la bóveda a buscar tu plata: vas a la ventanilla, pedís lo que necesitás con un formulario claro y te lo dan. Una API es esa ventanilla entre dos sistemas. Uno le pide algo al otro de una forma definida, por ejemplo "dame el stock de este producto" o "creá este pedido", y recibe una respuesta ordenada, sin que una persona esté copiando y pegando datos en el medio.
La sigla significa Application Programming Interface, o interfaz de programación de aplicaciones. Detrás del nombre intimidante hay algo simple: un conjunto de reglas para pedir y entregar información entre programas. No es un lugar al que entrás a mano; es el acuerdo sobre cómo se piden las cosas.
En una frase: una API es el mostrador por el que dos sistemas se piden cosas, sin que nadie tenga que copiar datos a mano.
Ejemplos que ya usás sin saberlo
Vivís rodeado de APIs aunque no las veas. Cuando pagás con MercadoPago en una tienda online, la tienda le pregunta a MercadoPago, por su API, si el pago se acreditó antes de despachar. Cuando iniciás sesión "con Google" en un sitio, ese sitio le pide a Google que confirme quién sos. Cuando ves un mapa con la ubicación de un local, ese mapa viene de una API. Cuando se actualiza el seguimiento de un envío, el sistema recibió el estado nuevo desde la API del correo.
En tu empresa pasa lo mismo cada vez que dos herramientas se pasan datos. Si hoy eso lo hace una persona, copiando de una pantalla a otra, ahí hay una API esperando reemplazar ese trabajo manual.
Hay algo importante: una API no es magia ni un acceso libre a todo. Define qué se puede pedir y qué no, y con qué permisos. Es como la ventanilla del banco, que atiende ciertas operaciones y no otras, y solo a quien tiene la cuenta. Esa limitación es justamente lo que la hace segura y ordenada.
Qué permite hacer en tu empresa
Con una integración por API, dos sistemas que hoy viven separados empiezan a compartir información solos. Algunos ejemplos concretos:
- Mantener el stock sincronizado entre el sistema de gestión y la tienda online: una venta en la web descuenta stock en el sistema, sin cargarlo dos veces.
- Actualizar precios en un solo lugar y que se reflejen en todos lados.
- Que un pedido que entra por la web caiga directo en el sistema, listo para preparar.
- Emitir la factura electrónica desde el propio sistema, sin tipear los datos de nuevo.
- Enviar avisos por WhatsApp o notificaciones automáticas desde el sistema.
- Alimentar un tablero o reporte sin exportar planillas a mano.
Siempre es la misma idea: un dato se carga una vez y viaja solo. Eso es lo que evita el copiar y pegar entre sistemas, que es justo donde aparecen los errores y se pierde el tiempo. A esto me dedico en integraciones y APIs.
Qué hacer si tu sistema no tiene API
No todos los sistemas ofrecen una API. Los más viejos, los programas de escritorio y muchas planillas no la tienen, y ahí la integración se complica. Antes de frustrarte, hay caminos:
- Exportar e importar archivos. Muchos sistemas permiten bajar un CSV o un Excel y subir otro. No es en tiempo real, pero sirve para procesos diarios o semanales.
- Preguntar al proveedor. A veces la API existe pero no está documentada o es solo para clientes grandes. Vale la pena preguntar antes de descartar el sistema.
- Usar una herramienta intermedia. Plataformas de automatización (Zapier, n8n) o un pequeño servicio propio que traduzca entre los dos sistemas.
- Automatizar la pantalla, como última opción. Se puede hacer que un robot use el sistema como lo haría una persona, pero es frágil: cualquier cambio en la pantalla lo rompe.
Si el sistema no tiene API y es central para tu negocio, a veces la decisión de fondo es otra: evaluar migrar a uno que sí la tenga. En CertiCarga, por ejemplo, la plataforma ofrece API y webhooks justamente para conectarse con el ERP de cada empresa de transporte, sin obligarlas a cambiar de sistema.
Webhooks: cuando el sistema avisa solo
Hay dos maneras de enterarse de que algo pasó. La primera es preguntar todo el tiempo: "¿llegó el pago? ¿llegó? ¿llegó?". Eso se llama polling, y es como llamar al banco cada cinco minutos para ver si te transfirieron.
La segunda es que el sistema te avise. Eso es un webhook: en vez de que vos preguntes, el otro sistema te manda un mensaje en el momento exacto en que ocurre algo, como cuando se acredita un pago, cambia el estado de un envío o se crea un pedido.
La combinación de API y webhooks es la que hace que las integraciones se sientan instantáneas. Es lo que usa CertiCarga para avisar al ERP de la empresa cuando hay un envío nuevo, y lo que hace que el seguimiento se actualice solo.
La diferencia: con una API preguntás; con un webhook te avisan. Las integraciones buenas suelen usar las dos.
Cómo mantener sana una integración
Una integración no es algo que se hace una vez y se olvida. Las APIs cambian, los sistemas se actualizan y, tarde o temprano, algo deja de funcionar. Para que no se rompa en silencio, conviene que tenga tres cosas:
- Errores visibles. Si una conexión falla, alguien se entera. Nada de integraciones que dejan de pasar datos sin que nadie lo note.
- Registro de lo que pasó. Qué datos se movieron y cuándo, para poder reconstruir un problema.
- Documentación y control. Saber cómo está armada y dónde vive, para que no dependa de una sola persona.
Con eso, el mantenimiento es más barato y el sistema no se cae por sorpresa.
Qué preguntar antes de contratar un software
Si estás por contratar un sistema (de gestión, de facturación, un CRM, una tienda), la API debería pesar en la decisión. Estas preguntas te ordenan:
- ¿Tiene API? Y si la tiene, ¿es pública y está documentada?
- ¿Qué puedo hacer con ella? ¿Leer datos, crear registros, ambos? ¿Qué no permite?
- ¿Tiene webhooks? ¿Avisa cuando algo cambia, o solo puedo consultar?
- ¿Cómo se autentica? Con claves, tokens, permisos por usuario.
- ¿Tiene límites de uso? Cuántas consultas por minuto y qué pasa si los supero.
- ¿Cuánto cuesta? Algunas APIs se cobran aparte o por volumen.
- ¿Puedo exportar todos mis datos? Aunque no haya API, quedarte con tus datos es no quedar atado.
- ¿Qué pasa si cambio o cierro la cuenta? Si puedo llevarme la información y qué se pierde.
No hace falta que sepas de tecnología para hacer estas preguntas; solo necesitás las respuestas antes de firmar. Un proveedor serio las tiene a mano.
Cómo lo encaro yo
En un proyecto de integración empiezo por mapear qué datos necesita cada sistema y quién manda en cada uno: por ejemplo, el stock vive en el sistema de gestión y la tienda lo consulta. Con eso armo la conexión por API y webhooks, con registro de cada movimiento y avisos cuando algo falla, para que no dependa de que alguien esté mirando. Si querés, te lo explico en una primera charla sin costo.