Saltar al contenido
weSyncroAyuda
Artículos de Importador

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#

  1. Abre el formulario

    En Destinos de Importación haz clic en Nuevo Destino. Se abre un panel lateral.

  2. 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).

  3. Configura el endpoint

    En Método elige el que acepta el servicio y en URL del Endpoint pega la dirección completa.

  4. Agrega las cabeceras

    Con Agregar Cabecera suma cada cabecera que el servicio exija, completando Clave y Valor.

  5. 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#

ColumnaContenido
TítuloNombre y descripción.
TipoAPI o script.
Método / EndpointMétodo y dirección configurados.
ActualizaciónFecha del último cambio.
AccionesEditar.

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.