Artículos de Importador
Configuración
Casos prácticos
GuíaNivel avanzado3 min de lecturaRevisado el
Configurar un destino de importación
Define a dónde se envía cada registro transformado: una API por HTTP con su método, URL y cabeceras, o un script interno.
Un destino es el lugar al que el Importador envía cada registro una vez transformado. Puede ser una API que recibe los datos por HTTP o un script preparado especialmente para tu cuenta. Cada importación usa un destino, y un mismo destino sirve para muchas importaciones.
En WeSyncro:ImportadorDestinos
Antes de empezar#
Para un destino de tipo API necesitas, de parte del sistema que recibirá los datos:
- La dirección completa del servicio (URL).
- El método que acepta, normalmente POST.
- Las cabeceras que exige, por ejemplo la de autorización.
Si no manejas estos datos, pídeselos a quien administra ese sistema.
Crear un destino de tipo API#
Abre el formulario
En Destinos de Importación haz clic en Nuevo Destino. Se abre un panel lateral.
Completa la información general
Escribe el Título del Destino, que es obligatorio, y una Descripción que explique para qué sirve. En Tipo de Destino deja API (HTTP Request).
Configura el endpoint
En Método elige el que acepta el servicio y en URL del Endpoint pega la dirección completa.
Agrega las cabeceras
Con Agregar Cabecera suma cada cabecera que el servicio exija, completando Clave y Valor.
Guarda
Haz clic en Guardar Configuración de Destino. Verás "Destino guardado correctamente".
Campos del destino#
- Título del DestinoTextoObligatorio
Nombre con que lo verás al ejecutar una importación. Ejemplo: "API de Sincronización ERP".
- DescripciónTexto
Propósito del destino.
- Tipo de DestinoListaObligatorio
API (HTTP Request) o Script Interno (Node.js).
- MétodoLista
GET, POST, PUT, PATCH o DELETE. El valor inicial es POST.
- URL del EndpointTextoObligatorio
Dirección del servicio. Solo en destinos de tipo API.
- Cabeceras (Headers)Lista
Pares de Clave y Valor que se envían en cada solicitud.
- Seleccionar ScriptListaObligatorio
Solo en destinos de tipo script.
Cómo se envían los datos#
- Se hace una solicitud por cada fila del archivo, con el método, la URL y las cabeceras configuradas.
- El cuerpo de la solicitud es el registro transformado, en formato JSON, tal como lo muestra Previsualizar en el transformador.
- Si el servicio responde bien, la fila queda Completado y se guarda la respuesta.
- Si el servicio responde con error, la fila queda Error con el mensaje que haya devuelto.
Lo enviado y lo recibido se revisa fila por fila en el detalle de la importación. Revisa seguir una importación.
Destinos de tipo script#
El tipo Script Interno (Node.js) ejecuta un programa instalado en el servidor para tu cuenta. No se puede subir desde la pantalla.
- La lista Seleccionar Script muestra los scripts disponibles para tu cuenta.
- Si no hay ninguno verás "No tienes scripts disponibles." junto con la indicación de que deben subirse a la carpeta de tu cuenta en el servidor.
Si necesitas un destino de este tipo, solicítalo al equipo de soporte de WeSyncro.
Listado de destinos#
| Columna | Contenido |
|---|---|
| Título | Nombre y descripción. |
| Tipo | API o script. |
| Método / Endpoint | Método y dirección configurados. |
| Actualización | Fecha del último cambio. |
| Acciones | Editar. |
Si no hay ninguno verás "No hay destinos configurados" y "Comienza creando un destino de tipo API."
Problemas frecuentes#
"El título es obligatorio"#
Falta completar Título del Destino.
"El endpoint es obligatorio"#
En un destino de tipo API falta la URL del Endpoint.
"El nombre del script es obligatorio"#
En un destino de tipo script no elegiste ninguno en Seleccionar Script.
"Error al guardar destino"#
El destino no se pudo guardar. Revisa tu conexión y vuelve a intentarlo.
Todas las filas de una importación quedan con error#
Abre el detalle de la importación y mira Mensaje / Log destino. Si todas las filas muestran el mismo error, el problema suele estar en el destino: una URL mal escrita, un método que el servicio no acepta o una cabecera de autorización vencida.