Guía técnica de alimentación de trabajos
Updated at August 20th, 2026
Table of Contents
Esta guía explica los detalles técnicos y los requisitos para las fuentes de trabajo.
Mejores prácticas para la implementación
- Al solicitar a su administrador Paradox que procese un feed de empleo o rastree su sitio de carreras, considere al menos dos semanas de margen . Esto debería ocurrir dos semanas antes de la fecha prevista con el cliente para configurar un entorno de demostración.
- Confirme con el cliente si proporcionarán feeds de trabajos de preparación y producción o si será solo producción .
Tipos de archivos de fuentes de origen admitidos
Aceptamos archivos de fuentes de clientes en los siguientes formatos:
- XML : la forma más fácil y confiable para que los clientes compartan sus trabajos desde un ATS externo con Paradox es a través de una fuente XML, ya que es menos probable que se vea afectado por actualizaciones de software en el lado ATS .
- JSON
- CS V – No se recomienda enfáticamente utilizar CS V como tipo de archivo para feeds de trabajos, ya que es incompatible con nuestra herramienta de raspado y es propenso a inconsistencias, además de presentar limitaciones significativas en el formato y procesamiento de datos.
Métodos de transmisión de archivos
Método de transmisión |
Notas |
|---|---|
| URL pública / RSS |
Este es el método más común que utilizan los clientes para compartir datos de trabajos, ya que es solo una URL que la mayoría de los ATS pueden generar y que contiene todos los datos de solicitud de trabajo del cliente. Ejemplo de URL anonimizada:
Ejemplo de fuente web RSS: Nota: Asegúrese de que el cliente proporcione las credenciales adecuadas si es necesario y que incluya en la lista blanca las IP de nuestro entorno Scrape para evitar demoras futuras. |
| Publicación sFTP |
sFTP , o Protocolo de transferencia segura de archivos, significa que esta opción es un método para compartir archivos y el archivo real deberá venir en formato XML, JSON o CS . Los recursos técnicos del cliente deben conocer este protocolo de transferencia. Deben configurar un proceso en su sistema para generar y enviar automáticamente los archivos. A partir de ahí, los recuperamos de las carpetas y procesamos los trabajos. Aquí hay más información sobre sFTP aquí: ¿Qué es el Protocolo de transferencia segura de archivos? Notas:
|
| Obtener o publicar trabajos a través de API |
Este método requiere que interactuemos con las API del cliente para recuperar datos del trabajo, lo que nos permite extraer el archivo de fuente directamente desde su sistema. Nota: Asegúrese de que el cliente incluya en la lista blanca las IP de nuestro entorno Scrape para evitar demoras futuras. Los clientes deberán compartir:
|
| Sitio de empleo Scrape |
Este método de transmisión debería ser el último recurso . Si ninguna de las opciones anteriores funciona, podemos extraer los datos de empleo del portal de empleo del cliente, aunque recomendamos evitarlo a menos que sea absolutamente necesario. Se recomienda recibir los datos directamente de la fuente en lugar de hacerlo de un tercero, como un portal de empleo.
Notas:
|
Requisitos mínimos de campo
Estos son los campos que absolutamente necesitamos que nos proporcionen a través del Feed de trabajo del cliente, de lo contrario, la búsqueda de trabajo no puede funcionar correctamente:
Campos obligatorios |
Notas |
|---|---|
| Título del puesto: Título del puesto | |
| ID de solicitud de trabajo: identificador único para trabajos. |
El ID de solicitud de cada trabajo debe ser único . Si hay dos trabajos en la fuente de origen del cliente que comparten el mismo ID de solicitud, nuestra herramienta de scraping identificará el duplicado y descartará uno de ellos. Nota: Si el cliente no puede asignar identificaciones de solicitud únicas (a menudo debido al manejo de trabajos multilingües o la adaptación de listados internos y externos), podemos configurar múltiples fuentes para garantizar un procesamiento de datos adecuado. |
| Ubicación del trabajo: Ubicación donde se publica la solicitud de trabajo. |
Requerido: Requerimos información del país. Recomendado:
Nota: Si el cliente está cargando y usando una fuente de ubicación, el campo ID de ubicación puede ayudar a hacer coincidir las ubicaciones de la fuente de ubicación del cliente con las requisiciones en su fuente de trabajo. Varias ubicaciones: Podemos admitir varias ubicaciones por solicitud. Si conoce esta información al enviar una solicitud de ticket de trabajo, indíquela en el ticket. Para una mejor práctica, recomendamos a los clientes que utilicen el mismo campo de ubicación para incluir varias ubicaciones en una solicitud o como un campo de ubicación adicional para mayor claridad. |
| Descripción del puesto: Descripción del trabajo (es decir, responsabilidades, objetivos, etc.) |
Recomendado: Los clientes pueden proporcionar los datos de descripción del trabajo en un solo campo, o pueden dividirlos en varios campos, como Encabezado del trabajo , Descripción del trabajo , Pago del trabajo , etc. Nota: Recomendamos a los clientes enviar todos los datos de descripción del trabajo en un solo campo , pero admitimos recibirlos en campos separados y podemos combinarlos si es necesario. |
| URL de solicitud de empleo: enlace al sitio de carrera o página de solicitud para el empleo. |
Este campo puede:
Notas:
|
Campos altamente recomendados
Estos campos no son obligatorios, pero son muy recomendables para crear una experiencia de búsqueda de empleo más sólida para el candidato:
Campos recomendados |
Notas |
|---|---|
| Tipo de empleo: Naturaleza del acuerdo de empleo y el horario o duración de trabajo previsto. |
Si los clientes desean que los candidatos puedan buscar trabajo por tipo de empleo (es decir, tiempo completo, tiempo parcial, etc.) o utilizar estos datos para cualquier configuración única en el proceso de reclutamiento, deben enviar información del tipo de empleo. A continuación se muestran los tipos de valores que aceptamos para este campo:
Nota: Estos son los campos definidos en nuestro servicio de Gestión de Trabajos. La convención de nomenclatura de estos valores dentro de la organización del cliente se puede compartir a través del feed de trabajos y se asignarán a los campos definidos durante el procesamiento del feed.
Nota: Si los clientes tienen trabajos de “pasante” o “estudiante”, se requiere el tipo de empleo. |
| Situación laboral: La estructura de compensación para el puesto. |
Si el cliente desea que los candidatos puedan buscar empleos por estado laboral o utilizar estos datos para cualquier configuración única en el proceso de reclutamiento, debe enviar información del tipo de empleo. A continuación se muestran los tipos de valores que aceptamos para este campo:
Nota: Estos son los campos definidos en nuestro servicio de Gestión de Trabajos. La convención de nomenclatura de estos valores dentro de la organización del cliente se puede compartir a través del feed de trabajos y se asignarán a los campos definidos durante el procesamiento del feed. |
| Categoría de trabajo: una clasificación más amplia de tipos de trabajo (es decir, categoría de trabajo) |
Este campo no es necesario para que la búsqueda de empleo funcione, pero la experiencia del candidato se vería afectada sin él. Ejemplo:
Sin una categoría de trabajo, si un candidato busca "trabajos de almacén", es posible que no aparezcan puestos relevantes, como "Supervisor de montacargas". |
| Campos de usuario: Información de empleados utilizada para asignar personas a solicitudes de trabajo |
Estos campos se utilizan para asignar roles de usuario específicos a ciertas requisiciones, lo que permite la programación automática de candidatos y la asignación de permisos basados en requisiciones. A continuación se muestran los valores que aceptamos para este campo:
Los clientes deben proporcionar un identificador único para cada campo de usuario agregado (correo electrónico, ID de empleado, ID de usuario o número de teléfono)
|
Campos adicionales
Estos campos no son obligatorios, pero nuestro Servicio de Búsqueda de Empleo puede respaldarlos:
| Campos adicionales | Notas |
|---|---|
| Marca laboral: nombre de la organización | Este campo se utiliza comúnmente para organizaciones que reclutan para varias marcas y desean brindar experiencias distintivas a los candidatos. |
| Salario del trabajo: tasa de pago del trabajo | Este campo especifica el salario o tasa de pago esperado para el trabajo (es decir, “$12 por hora”, “10,00”, etc.). |
| Trabajo interno/externo: si el trabajo es externo o interno |
Este campo es útil para los clientes que ofrecen oportunidades laborales internas y externas y desean delinear qué trabajos deberían estar disponibles externamente (para solicitantes externos) e internamente (para empleados actuales). Nota: Si el cliente tiene trabajos internos y externos y desea delinear qué trabajos deben estar disponibles externa e internamente, podemos usar este campo para hacer esa distinción. |
| Remoto: Si el trabajo es un puesto remoto o no |
Este campo se puede especificar de diversas maneras, por lo que solicita a los clientes que aclaren cómo se indican sus posiciones remotas. A continuación se muestran los tipos de valores que aceptamos para este campo:
Nota: No podemos adaptarnos a ubicaciones remotas específicas (por ejemplo, un puesto remoto en California). En su lugar, ofrecemos una única ubicación remota para todas las solicitudes remotas. |
| Campos personalizados: Otros datos del trabajo |
Si los clientes desean enviarnos datos laborales que no encajan en nuestros campos predefinidos que se utilizan para potenciar nuestro servicio de gestión de trabajos, podemos crear y asignar campos personalizados según sea necesario para manejar los datos adecuadamente. Nota: Admitimos todos los campos personalizados sin ninguna restricción. |
Fuentes de muestra
NOTA IMPORTANTE: Este es un EJEMPLO. Por favor, no comparta estos recursos con sus clientes. Es solo para referencia interna.
Fuente de alimentación del cliente de muestra
- Fuente de origen XML
- Ejemplo: Fragmento de fuente de fuente XML
- Fuente de origen JSON
- Ejemplo: Fragmento de fuente de fuente JSON
- Fuente de origen CS V
- Ejemplo: Fragmento de fuente de CS V
Ejemplo de feed mapeado Paradox
Hemos preparado un fragmento de muestra del feed mapeado Paradox , que transforma el feed de origen del cliente en un formato más fácil de leer para nuestro servicio de gestión de trabajos.
- Nota: Esta muestra se proporciona en formato PDF e incluye solo un trabajo con fines ilustrativos. No representa el archivo real utilizado para nuestro servicio de Gestión de Trabajos. Toda la información extraída del trabajo se incluirá en la fuente mapeada Paradox .
- Ejemplo: Fragmento de feed asignado Paradox
Tiempos de actualización del feed de trabajos
Los programas de actualización de fuentes de trabajo se configuran mediante nuestra herramienta de raspado Paradox .
- Nuestra práctica habitual es configurar el feed de trabajos para que se ejecute 4 veces al día, con 6 horas de diferencia, SOLO entre semana . Razones para este enfoque:
- Eficiencia: Los raspados frecuentes pueden sobrecargar nuestros sistemas y afectar el rendimiento.
- Integridad de los datos: Conservamos los registros históricos para auditar y solucionar cualquier problema que pueda surgir con el feed de trabajos. Limitar el número de registros nos permite mantener estos registros y consultarlos fácilmente en tales casos.
Nota: Si bien estamos dispuestos a considerar ajustes al cronograma de actualización, reducir la frecuencia de actualización por debajo de 2 horas no es recomendable, pero es factible.
A continuación se muestran las horas en que se actualizarán nuestros feeds de trabajos (la zona horaria es UTC). El trabajo cron se ejecutará en el minuto 20 para evitar la hora punta del servidor.
| Nombre del feed | Horario (zona horaria UTC) |
|---|---|
| De hecho, postularse | 0, 3, 6, 9, 12, 15, 18, 21 |
| En efecto | 1, 5, 9, 13, 17, 21 |
| Google, LinkedIn, integrado | 2, 6, 10, 14, 18, 22 |
| Talento, Caso de empleo | 3, 7, 11, 15, 19, 23 |
| Estándar | 1, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23 |
| NAS, EY, RSC, MGMT, PANDO_LOGIC, SYMPHONY | 0, 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22 |
Programaciones de actualización de feeds maestros
La fuente maestra solo se actualizará automáticamente si se detecta al menos un cambio de trabajo (adición, actualización o eliminación) en las fuentes de trabajo de origen. Si no hay cambios, la fuente maestra no se actualizará, incluso si se cumple la hora de actualización programada. Esto tiene como objetivo reducir el procesamiento innecesario y garantizar que la fuente solo se actualice cuando haya datos nuevos o modificados.
Nuestro proceso de sincronización automática garantiza que los datos de trabajo más actualizados de sus feeds de trabajo, seleccionados para crear nuestro feed maestro, se reflejen con precisión en el feed maestro.
- Horario de actualización: el proceso de actualización del feed maestro comienza en la parte superior de cada hora (es decir, 8:00 a. m., 9:00 a. m., etc.).
- Nota importante: El proceso de sincronización no siempre se completa en un momento constante.
Proceso de sincronización
El proceso de sincronización comienza cada hora, momento en el que el ID de su cuenta se envía a una cola para su procesamiento. La velocidad de sincronización depende del tamaño de la cola (la cantidad de cuentas de clientes con feeds maestros que requieren una actualización). Una cola más corta acelera la sincronización, mientras que una más larga puede retrasar el proceso.
Si su administrador Paradox actualiza manualmente una fuente maestra (por ejemplo, a las 8:40 a. m.), su ID de cuenta se agregará inmediatamente a la cola. Si la cola está libre, el proceso de sincronización comenzará de inmediato. Nota: El tiempo necesario para que el proceso se complete puede variar según el momento en que se realice la actualización manual.
Por ejemplo, si un feed maestro se actualiza manualmente a las 8:05 a. m., el proceso puede tardar más porque coincide con la sincronización automática de otras cuentas de clientes, que comienza a las 8:00 a. m. Esta variabilidad se refleja en el cajón "Historial de vistas" . Cada versión almacenada en el Historial de vistas indica que el feed se actualizó a esa hora, ya sea mediante una actualización automática o manual.
Proceso de creación de archivos
Una vez completada la sincronización, el sistema genera y almacena un archivo de feed maestro que los usuarios pueden descargar a través del menú Ver historial . El tiempo de creación del archivo depende de la instancia de su cuenta. Para las cuentas de la instancia de producción general de Olivia, el proceso de creación del archivo se ejecuta cada 15 minutos.
- Nota: Aunque el proceso de creación de archivos comienza en estos momentos, no necesariamente finaliza en el mismo minuto.
Mejores prácticas en etiquetas HTML
Las siguientes son las mejores prácticas en torno a las etiquetas HTML:
- Reemplace los caracteres codificados “menor que”
<con caracteres menores que reales:< - Eliminar todos los caracteres codificados de nueva línea

 - Reemplace todas las nuevas líneas
\ncon etiquetas de párrafo alrededor del contenido<p>...</p> - Incluya etiquetas
<html>para indicar que el texto contiene HTML
Pon a prueba tus etiquetas HTML y obtén más orientación aquí .
Mecanismo de respaldo de búsqueda de empleo
Cuando la sesión de rastreo de trabajos no encuentra ningún trabajo, devolverá 0. Por lo tanto, la fuente de datos CEM (trabajo) mostrará 0 trabajos. Si la sesión de rastreo no encuentra ningún trabajo, se activará el mecanismo de copia de seguridad. Este obtendrá los datos de la sesión correcta más cercana y los guardará en la base de datos de ElasticSearch en el servicio de trabajos.
¿Por qué nos configuramos de esa manera?
Durante la sesión de rastreo, pueden surgir problemas (errores humanos, fallos técnicos, fallos del servidor, etc.) que afecten los resultados de búsqueda. Para solucionar estos problemas, el servicio de búsqueda de empleo contará con un mecanismo de copia de seguridad que conserva la sesión de datos más reciente cuando la sesión de rastreo no arroja resultados.
Esto puede provocar que, si el valor de retorno es 0 porque no se encuentran trabajos después de la sesión de rastreo, el mecanismo de copia de seguridad se active, ya que no distingue si el valor de retorno es correcto. Esto provoca asincronía de datos.
¿Cómo abordamos la asincronía de datos cuando ocurre?
Cuando esto ocurra, se investigará el caso. Una vez confirmado que no se trata de un error, se tomarán las siguientes medidas:
- Si el cliente entiende el escenario y quiere tomar acción por sí mismo → No es necesaria ninguna acción por nuestra parte.
- Si el cliente desea que estas bases de datos ( CEM Data Feed y Job Service) se sincronicen, realizará una solicitud y nuestro desarrollador eliminará manualmente los datos de respaldo.
Preguntas frecuentes
¿Cómo puedo saber si un feed de trabajo es un feed en vivo o un feed estático?
La regla general es que si se puede descargar el archivo, es estático , lo que significa que no se actualizará con nuevos trabajos. Necesitamos una fuente en vivo que actualice los trabajos para obtener nuevos trabajos y eliminar los antiguos.
¿Cómo pueden CS y/o las Implementaciones validar que una fuente de trabajos es correcta?
CS o las implementaciones pueden validar si un feed tiene el formato correcto, incluye todos los campos obligatorios, etc., si se transmite mediante una URL pública. Si se transmite mediante una URL pública, cualquiera puede abrirla y ver los trabajos.
Nota: Después de abrir el feed, espere unos segundos y se formateará automáticamente en un formato legible. A partir de ahí, puede ajustar los parámetros y verificar que elementos como el puesto, la ubicación, la descripción, etc., estén disponibles en ellos. Utilice el ejemplo de feed/solicitud de empleo XML anterior como guía para leer un feed de empleo.
¿El feed de trabajo debe tener datos del usuario, como el gerente de contratación o el reclutador?
Esto no es obligatorio; sin embargo, se pueden desbloquear algunas funciones avanzadas si el cliente nos las transfiere. Algunos ejemplos incluyen:
- Automatizar la programación mediante la gestión de grupos y la gestión de candidatos (para una solución que no sea de contratación)
- Permisos basados en requisitos de trabajo
- Copiar a usuarios en invitaciones a entrevistas o programaciones
¿Con qué frecuencia necesitamos/podemos actualizar los feeds de trabajos?
Esto depende en gran medida del cliente y se impulsa en función del volumen de cambios que se realizan en las publicaciones de trabajo del cliente durante el día/la semana (es decir, nuevos trabajos agregados o trabajos antiguos eliminados).
Algunas reglas generales:
- Los clientes de restaurantes y tiendas minoristas deberían tener actualizaciones más frecuentes debido al gran volumen de cambios que se realizan en muchas ubicaciones (es decir, de 2 a 4 actualizaciones al día).
- Por lo general, las PYMES pueden contentarse con una actualización diaria, debido al menor volumen de solicitudes abiertas y, por lo tanto, a cambios menos frecuentes.
- Actualizar durante horas de baja participación de los candidatos podría permitir que los trabajos estén listos a tiempo para los momentos de mayor participación de los candidatos, que normalmente ocurre a media mañana y temprano en la noche.
Use su criterio al asesorar a un cliente , teniendo en cuenta que cuantas más actualizaciones realizamos a diario, mayor es la carga para nuestros servidores. En la mayoría de los casos, menos es más, ya que los clientes suelen exagerar la frecuencia con la que se realizan los cambios en su ATS .
¿Cómo podemos identificar si una solicitud de empleo está disponible en varias ubicaciones?
Normalmente, esto se identificará en algún tipo de campo de Ubicación adicional dentro del feed de trabajos.
Por ejemplo , la ubicación principal de las requisiciones podría aparecer bajo el parámetro <ubicación> , mientras que las ubicaciones adicionales se enumerarán bajo un parámetro <ubicación secundaria> o <ubicaciones adicionales> .
¿Cómo podemos configurar el seguimiento de fuentes para la búsqueda de empleo?
La única forma de seguimiento de fuentes que ofrecemos hoy para la búsqueda de empleo es el seguimiento de fuentes a través de la etiqueta de fuente URL .
Una etiqueta de origen URL es un valor añadido a cada URL de solicitud de empleo que permite a los clientes rastrear el tráfico de candidatos. En esencia, esta etiqueta indica al cliente, en su backend, si un candidato llegó a través de un clic en "Solicitar ahora" para buscar empleo.
Esa etiqueta de origen se parece a esto : “&Source= Paradox _Olivia”
El cliente debe proporcionar esto a Paradox . Una vez hecho esto, un miembro de nuestro equipo de ingeniería mostrará la etiqueta en todas las URL del feed de trabajos del cliente, para que este pueda realizar pruebas desde allí.
Mi cliente está publicando un feed de trabajo a través de SFTP: ¿cuáles son los pasos de configuración para esto?
- Comuníquese con su administrador Paradox para enviar un ticket para crear una carpeta sFTP para el cliente.
- Envíe las credenciales sFTP que le proporcionó su administrador Paradox al cliente para que puedan publicar fuentes de trabajos en la carpeta.
- Una vez que el cliente haya confirmado que ha enviado con éxito un archivo de suministro de trabajo al sFTP, comuníquese con su administrador Paradox para que envíe una solicitud de recopilación de datos de búsqueda de trabajo.