## Por qué es importante

Just Join IT y RocketJobs usan una única plataforma para empresas. Por eso, tu equipo puede conectarla una vez a Kit y distribuir una oferta en cualquiera de los dos portales sin copiarla a mano. Cada publicación se revisa y confirma por separado porque los portales usan categorías, habilidades, planes y créditos distintos.

Esta es una **integración exclusiva para distribuir ofertas**. El portal anuncia el puesto y dirige a los candidatos a la página de candidatura en Kit. Allí completan el proceso habitual de Kit; Kit no importa candidaturas ni datos de candidatos desde los portales.

> [!IMPORTANT]
> **Es posible que la publicación no esté disponible al principio.** La conexión puede permanecer **Pendiente** hasta que se confirmen las credenciales de producción necesarias y el acceso 1EP o el contrato con el proveedor de tu organización. Puedes preparar la conexión, pero no enviar ofertas mientras la publicación esté desactivada.

## Cómo funciona

- **Una conexión común administrada por una persona con permisos.** Una persona administradora de la cuenta autoriza mediante OAuth la plataforma para empresas de Just Join IT y RocketJobs, y selecciona la unidad organizativa que utilizará Kit.
- **Una publicación independiente por portal.** Elige Just Join IT, RocketJobs o ambos para cada oferta. Cada portal tiene su propia asignación de campos, habilidades, plan y crédito de pago.
- **Candidaturas externas en Kit.** El anuncio enlaza con la página de candidatura del puesto en Kit. Al distribuir la oferta, no se envían datos de candidatos al portal de empleo.
- **Publicación de pago confirmada por una persona.** Kit puede preparar y validar el anuncio, pero una persona debe revisar el portal, la asignación y el crédito antes de cada publicación de pago.
- **Conciliación de estados.** La API 1EP documentada no ofrece webhooks para anuncios de empleo. Cuando Kit necesita confirmar el estado actual, consulta el anuncio remoto mediante su identificador externo.

## Antes de conectar la plataforma

Comprueba que:

- tienes permisos de **administración de la cuenta** en Kit;
- la cuenta de la empresa tiene acceso 1EP para la organización correspondiente;
- la unidad organizativa correcta tiene un código de publicación válido o saldo disponible en una suscripción;
- las ofertas que quieres distribuir ya están publicadas en Kit;
- cada oferta tiene un título, una descripción, una ubicación o condiciones de trabajo en remoto, unas condiciones laborales y un formulario de candidatura completos.

La plataforma para empresas proporciona los diccionarios admitidos de divisas, categorías, tipos de contrato, niveles de experiencia, jornadas laborales y modalidades de trabajo. Kit valida el anuncio con esos valores actualizados antes de enviarlo.

## Conectar la plataforma para empresas

1. Abre [**Integraciones**](/integrations) en tu espacio de trabajo.
2. Abre **Just Join IT + RocketJobs** y selecciona **Conectar**.
3. Inicia sesión en la plataforma común para empresas y autoriza el acceso a tus organizaciones y publicaciones de empleo.
4. De vuelta en Kit, selecciona la **unidad organizativa** que será responsable de los anuncios y de su pago.
5. Selecciona **Verificar conexión** y comprueba el estado de publicación.

Una persona administradora puede cambiar más adelante la unidad organizativa seleccionada o desconectar la plataforma. Los anuncios existentes siguen vinculados a la unidad organizativa que los pagó originalmente; la nueva selección solo se aplica a publicaciones posteriores. Al desconectarla, Kit deja de poder crear publicaciones y consultar estados remotos; los anuncios que ya estén activos no se cierran automáticamente.

> [!NOTE]
> La conexión común no combina los saldos de ambos portales. Kit consulta los códigos de pago y las suscripciones de la unidad organizativa seleccionada, pero debes elegir por separado un plan y un crédito válidos para cada publicación en Just Join IT o RocketJobs.

## Revisar y publicar una oferta

Abre una oferta publicada en Kit y busca la sección **Distribución**.

1. Elige **Just Join IT** o **RocketJobs**.
2. Revisa la asignación común: categoría, nivel de experiencia, tipo de contrato y jornada, modalidad y ubicación del trabajo, divisa y rango salarial, y texto del anuncio.
3. Revisa las habilidades específicas del portal:
   - **Just Join IT** exige entre 1 y 10 habilidades, cada una con un nivel de dominio del 1 al 5.
   - **RocketJobs** admite entre 1 y 8 habilidades obligatorias y hasta 8 habilidades deseables, sin niveles de dominio.
4. Elige un código de pago o una suscripción disponible y el plan de publicación correspondiente. Cada crédito solo se puede usar con un plan compatible.
5. Confirma que las candidaturas se dirigen a la página del puesto en Kit.
6. Revisa el plan seleccionado, el uso del derecho y el saldo restante; después, selecciona **Confirmar y publicar** en el portal elegido.

Repite la revisión para el otro portal si quieres publicar la oferta en ambos. Kit nunca consume el crédito del segundo portal por haber confirmado el primero.

> [!WARNING]
> Al crear un anuncio mediante 1EP, se crea, se paga y se publica en una única solicitud. Antes de confirmar, comprueba el portal, la unidad organizativa, el plan y el crédito seleccionados. Kit nunca publica ni consume un crédito sin esa confirmación explícita.

## Estados, actualizaciones y cierre

La sección **Distribución** indica si una publicación se está preparando, necesita revisión, se está enviando, está activa, requiere atención o está cerrada. Si el portal rechaza un valor, Kit conserva el error con la publicación para que puedas corregir la asignación y volver a intentarlo.

Después de publicar:

- **Actualizaciones:** Kit puede enviar al anuncio existente los cambios admitidos en sus campos. La API documentada no permite cambiar el título, el plan, el pago ni el identificador externo. Por eso, cambiar el título o el plan comercial puede exigir cerrar el anuncio y crear una publicación de pago nueva.
- **Cierre:** al cerrar la distribución, el anuncio se retira del portal mediante la API 1EP. Después de cerrar una oferta en Kit, confirma que todas las publicaciones remotas estén cerradas.
- **Pausa o retirada de la publicación:** Kit cierra el anuncio remoto para que ninguna candidatura llegue a una página inactiva de Kit. Como 1EP no permite reabrirlo, reanudar la oferta exige otra revisión y puede consumir otro crédito.
- **Reapertura:** la API documentada no incluye una operación de reapertura. Volver a publicar un anuncio cerrado exige una revisión nueva y puede consumir otro crédito. Kit no da por hecho que reabrir una oferta en Kit pueda reactivar el antiguo anuncio de pago.
- **Tiempos de espera agotados:** un tiempo de espera de red no demuestra que la publicación haya fallado. Kit bloquea otro intento de pago y permite consultar el identificador externo original; nunca reintenta automáticamente una solicitud de pago cuyo resultado sea incierto.
- **Cambios remotos:** como 1EP no documenta webhooks para anuncios, es posible que los cambios remotos no aparezcan al instante. Kit concilia el estado cuando consulta la publicación o actúa sobre ella.

## Datos de candidatos y seguridad

- El portal de empleo recibe los datos del anuncio y una URL externa para presentar la candidatura, pero no los registros de candidatos de Kit.
- Los candidatos salen del portal para presentar su candidatura en Kit, donde se aplican el formulario, la información sobre privacidad, los permisos y el proceso de selección habituales.
- La integración no importa candidaturas nativas del portal, mensajes ni cambios en el estado de los candidatos.
- Solo las personas administradoras de la cuenta pueden gestionar la conexión común y la unidad organizativa.
- Cada publicación de pago exige la confirmación final de una persona.
- Si se agota un tiempo de espera, no crees una distribución nueva hasta que Kit haya conciliado el identificador externo existente.

## Solución de problemas

- **La publicación figura como Pendiente o está desactivada** — puede que aún no se hayan confirmado las credenciales OAuth de producción o el contrato con el proveedor y el acceso 1EP. Pide a una persona administradora de la cuenta que verifique la conexión. Para solicitar la activación al proveedor, escribe a [integration@rocketjobs.com](mailto:integration@rocketjobs.com).
- **No aparece ninguna unidad organizativa** — comprueba que hayas autorizado la cuenta de empresa correcta y que permita acceder a la organización que buscas. Vuelve a conectar la plataforma si la autorización pertenece a otra cuenta.
- **No hay ninguna opción de pago disponible** — consulta el saldo de pagos de la unidad organizativa seleccionada. Debe tener un código sin usar o una suscripción compatible con el portal y el plan elegidos.
- **El portal rechaza un valor asignado** — actualiza sus diccionarios y elige una categoría, un tipo de contrato, un nivel de experiencia, una jornada, una modalidad de trabajo, una divisa y unas habilidades admitidos.
- **Se desconoce el resultado después de publicar** — no confirmes otra publicación de pago. Vuelve a consultar la distribución existente para que Kit pueda buscarla por su identificador externo. Si el problema continúa, envía los datos del error o el identificador de seguimiento del portal a [integration@rocketjobs.com](mailto:integration@rocketjobs.com).
- **Necesitas cambiar el título, el plan o el pago** — esos valores no se pueden modificar en un anuncio 1EP existente. Ciérralo, revisa una publicación nueva y confirma cualquier cargo adicional.
- **Una oferta cerrada debe volver a estar activa** — revísala como una publicación nueva; 1EP no documenta la reapertura de un anuncio cerrado.
- **La conexión ya no se puede verificar** — una persona administradora debe volver a conectar la plataforma. Tu organización sigue siendo responsable de los anuncios activos hasta que se confirme su cierre remoto.

## Lista rápida de comprobación

- [ ] Una persona administradora de la cuenta ha conectado la plataforma común para empresas
- [ ] La unidad organizativa correcta está seleccionada y verificada
- [ ] La publicación figura como activada
- [ ] La oferta está publicada en Kit y su página de candidatura está lista
- [ ] Las categorías, los campos y las habilidades del portal elegido están asignados
- [ ] Hay un plan y un crédito de pago compatibles seleccionados
- [ ] Una persona ha revisado el portal, el plan, el uso del derecho y la URL de candidatura antes de confirmar
- [ ] La distribución figura como **Activa** después de la conciliación

Si tienes preguntas técnicas sobre la API para empresas o la activación de la cuenta, escribe a [integration@rocketjobs.com](mailto:integration@rocketjobs.com).