Saltar al contenido
Empezar gratis
Índice de la documentación

Empezar con Weldra

Weldra mueve datos entre sistemas (un ERP, una tienda en línea, un marketplace, una logística) con horarios y avisos entrantes, y deja constancia de todo lo que escribe. Esta página explica los conceptos y el camino de la primera sincronización. Para ver los detalles de cada llamada, mira la API; para usar la cuenta desde un asistente, Conectar Weldra a Claude; y si tu sistema no está, Hacer un conector propio.

Lo que necesitas

  • Una cuenta de Weldra. Si no la tienes, escribe a hello@weldra.ai.
  • Entrar a la app en app.weldra.ai. No hay contraseña: escribes tu correo y te llega un código.
  • Las credenciales de los dos sistemas que vas a conectar (una URL base y un token, o el usuario y la contraseña que pida su conector). Se escriben en la app y se guardan cifradas.

Los conceptos

Concepto Qué es
Conector El código que habla con un sistema (PrestaShop, Shopify, LogiCommerce, un ERP…). Weldra lo publica; sirve siempre de origen y de destino.
Conexión La configuración de un conector contra tu sistema concreto: la URL y las credenciales. Pertenece a la cuenta, no a un proyecto. Los campos secretos se guardan cifrados y la app y la API los enseñan siempre tapados.
Entorno Cada conexión tiene un entorno: production, staging o sandbox. Una tarea que escribe en una conexión de producción no se lanza a mano sin confirmarlo.
Proyecto Agrupa mapeos y tareas. Ata un nombre de rol (por ejemplo erp y shop) a una conexión, de modo que el mismo proyecto se puede exportar y re-atar a otras conexiones.
Mapeo La plantilla que dice cómo se transforma cada registro del origen en uno del destino. Se puede probar con datos de ejemplo antes de guardarlo.
Tarea Un grafo de pasos: leer, transformar, escribir. Tiene un horario (cada tantos segundos, o una expresión cron) y recuerda hasta dónde leyó (la marca de agua), de modo que cada pasada lee lo nuevo.
Run Una ejecución de una tarea, con su estado por paso y sus contadores: leídos, transformados, creados, actualizados, omitidos y fallidos.
Ledger El vínculo entre cada registro del origen y su gemelo en el destino. Con él Weldra no duplica altas ni reescribe lo que no ha cambiado.
Incidencia (dead letter) Un registro que no se pudo escribir. Se guarda con su motivo y se puede reintentar, descartar o enlazar a mano.

Las pantallas

El menú de la app agrupa lo que vas a usar en cuatro bloques.

  • Integrar: Proyectos, Conexiones y Explorador (para ver unos registros de un sistema, sin mapear ni escribir nada).
  • Operar: Runs, Flujo, Incidencias, Ledger y Logs.
  • Avisos: Webhooks y Alertas.
  • Cuenta: Plan y uso, Facturación (solo con el permiso de facturación), Organización (solo para quien administra) y Ajustes.

El camino de la primera sincronización

  1. Crea las dos conexiones. En Conexiones, una por sistema: elige el conector, escribe la URL y las credenciales y pon el entorno. Después pulsa comprobar: Weldra llama al sistema, actualiza el estado de la conexión y lista los recursos que ofrece (productos, stock, clientes, pedidos…). Un conector que no esté en la lista no se puede subir a mano: lo publica Weldra, mira Hacer un conector propio.
  2. Crea un proyecto y ata cada rol a su conexión.
  3. Elige una receta o escribe el mapeo. Weldra trae tareas prehechas, por pareja de origen y destino y por recurso: crean en el proyecto la tarea con su mapeo y puedes crearla apagada, para revisarla antes de que corra. Si prefieres hacerlo tú, escribe el mapeo y pruébalo con unas filas de ejemplo antes de guardarlo.
  4. Valida la tarea. Antes de guardar, Weldra la comprueba sin guardar nada y te dice qué paso o campo no vale.
  5. Lánzala a mano la primera vez. Si escribe en una conexión de producción, Weldra te pedirá confirmar. Mira el run: cuántos registros se leyeron, cuántos se crearon, cuántos se omitieron.
  6. Revisa el resultado. En Ledger ves qué dejó escrito el run y, en Incidencias, lo que no se pudo escribir. Lánzala otra vez sin tocar nada: lo que no ha cambiado se omite y no se reescribe.
  7. Ponle horario y enciéndela. Con el horario puesto, la tarea corre sola. Si el origen puede avisar de los cambios, un aviso entrante (un webhook) puede lanzar la pasada en el momento.

Qué hace Weldra por ti

  • No duplica. El ledger sabe qué registro del origen es cuál del destino; repetir una pasada no crea otra alta.
  • No reescribe lo que no cambió. Cada registro lleva una huella y, si coincide, se omite.
  • Lo que falla no para lo demás. Un registro que no se puede escribir va a Incidencias con su motivo y la pasada sigue; desde ahí se reintenta.
  • Te avisa. Alertas recoge lo que necesita tu atención (una tarea que falla, unas credenciales que ya no valen, una tarea que deja muchas incidencias), y las suscripciones de avisos mandan a una URL tuya un aviso firmado cuando termina un run o falla un registro: mira la API.
  • Cuida tus topes. Tu plan fija un tope de tareas, una frecuencia mínima y un volumen de operaciones al mes; Plan y uso enseña tu consumo frente a esos topes.

Siguientes pasos