Documentación XML

Beetween puede configurar un feed XML para la distribución de las ofertas de empleo del cliente en su espacio profesional.

Beetween puede configurar un feed XML para la distribución de las ofertas de empleo del cliente en su espacio profesional. A continuación, las ofertas de empleo se publican y retiran a través de Beetween y las candidaturas se centralizan automáticamente por expediente de contratación en Beetween. 

Requisitos previos

1- Un sitio preexistente

La implementación de un conector por flujo XML requiere que el cliente disponga ya de un espacio de carrera y de una herramienta/script para leer el flujo XML que permita alimentar las ofertas de este espacio de carrera (o que el cliente disponga de una desarrollada por su cuenta).

2- Información previa de su proveedor de servicios digitales

Antes de cualquier desarrollo del flujo XML por parte de Beetween, la persona encargada del desarrollo de su sitio profesional debe haber leído este documento. En efecto, la implementación del flujo XML puede generar costes y tiempo de desarrollo significativos que pueden ser facturados por su proveedor de servicios encargado del desarrollo de su sitio profesional.

3- Un formulario de solicitud

El espacio carrera debe incluir un formulario de candidatura para cada oferta de empleo que permita a los candidatos presentar su candidatura: se asociará una dirección de correo electrónico específica a cada oferta de empleo para enviar las candidaturas a través de este formulario (o redirigir a la Url presente para cada oferta en el flujo XML, como se indica a continuación).

Especifidad del Feed XML

Beetween le proporciona la URL https del flujo XML, que puede consultarse en cualquier momento y sin necesidad de autenticación especial.

  • Codificación : UTF-8
  • Actualización de datos de flujo: en tiempo real
  • Frecuencia de consulta recomendada: entre cada hora y cada día. Más allá de 1 vez por hora, puede cobrarse una tarifa específica.

La URL contiene un número de identificación pseudoaleatorio para que no se pueda adivinar.

Composición del feed

Por defecto, los siguientes campos del anuncio (presentes en el ejemplo aquí) se incluyen en el feed XML si han sido rellenados por el reclutador:

Tag Descripción Tipo Específico Valores
id Campo alfanumérico de 10 caracteres impuesto por Beetween, utilizado como referencia y generado automáticamente Text Autogenerated
clientId Identificador del cliente en la bolsa de trabajo de destino Text Optionnel
title Título de la oferta de empleo Text Required
recruiter Nombre de la empresa que contrata Text Required
creation_date Fecha de la primera publicación Datetime Autogenerated
last_modification_date Fecha de la última publicación (modificación, republicación, etc.) Datetime Autogenerated
application_email Dirección de correo electrónico a la que deben enviarse las candidaturas Text Autogenerated
application_url Url de una página de solicitud Beetween para el anuncio con formulario de solicitud integrado Text Autogenerated
job_description Incluye las etiquetas de contenido del puesto
― company Descripción de la empresa HTML Required
― mission Descripción del puesto HTML Required
― profile Descripción del perfil buscado HTML Required
location Incluye etiquetas de localización geográfica del puesto a cubrir, generadas a partir de la dirección seleccionada por el usuario
― city Ciudad Text Required
― post_code Código postal Text Required
― region2_code Código del departamento Text Required
― region2 Nombre del condado Text Required
― region1 Nombre de la región Text Required
― country_code Código del país Text Required
― country_name_fr Nombre del país en francés Text Required
― longitude Coordenadas GPS: longitud Number Required
― latitude Coordenadas GPS: latitud Number Required
logo_url URL del logotipo vinculado al nombre de la empresa registrado y configurado en Beetween Text Autogenerated
contract Incluye etiquetas vinculadas al contrato de trabajo propuesto
― type Tipo de contrato propuesto, valores fijos propuestos en una lista desplegable Text Required
― duration Duración del contrato para contratos de duración determinada
Contiene atributos de valor (tipo Number) y unidad (tipo Text)
Text Required para prácticas, contratos de duración determinada y temporales
― rythm Número de horas por semana seleccionadas
Contiene atributos hours_per_week (tipo Number) y display_value (tipo Text)
Text
― starting_date Fecha de inicio de la misión Date Indica también un atributo "asap" con la fecha de publicación para los puestos que deban cubrirse lo antes posible.
job_language Idioma del anuncio (lista desplegable) Text
salary Salario propuesto - 2 tipos de visualización: salario y rango salarial
Contiene atributos de value, currency, unit; y para visualización de rango mín. y máx.
Text
skills Habilidades requeridas para el puesto (texto libre)
Se añade 1 subetiqueta "skill" por cada habilidad introducida
Text Valores múltiples
job_title Ámbito de actividad correspondiente al puesto (lista deoratoria) Text
main_activity_area Sector de actividad principal Text Required
secondary_activity_area Sector de actividad secundario Text
qualification Nivel de cualificación Text
experience Experiencia requerida: número de años de experiencia requeridos y número de años en la dirección Number
study_levels Nivel de cualificación aceptado
Se añade 1 subetiqueta "study_level" por cada nivel de cualificación introducido
Text Valores múltiples
school_types Tipo de escuela Se añade 1 subetiqueta school_type por cada tipo de escuela introducido. Text Valores múltiples
education_domain Campo de estudio Text

Listas de valores posibles

Contract Type

Los valores posibles para las etiquetas <contract>/<type> se muestran en la siguiente tabla. Es preferible utilizar los valores "code" para la asignación y evitar así cualquier problema de actualización.

Code Valores
PERMANENT Contrato indefinido
TEMPORARY Contrato de duración determinada
INTERIM Trabajo temporal
INTERNSHIP Contrato en prácticas
APPRENTICESHIP Contrato de aprendizaje
CONTRAT_DE_PROFESIONNALISATION Contrato de formación profesional
FRANCHISE Franquicia
FREELANCE Autónomo
COLLABORATION_AGREEMENT Contrato de colaboración
SUMMER_JOB Trabajos de verano
FAMILY Empleo familiar
INTERNATIONAL_VOLUNTEERING Voluntariado internacional
PERMANENT_PROJECT Contrato indefinido de obra

Contract Duration

Los valores posibles para las etiquetas <contract>/<duration> se muestran en la siguiente tabla. Del mismo modo, es preferible utilizar valores «unitarios» para la asignación a fin de evitar problemas de actualización.
Atributo Unit Valores
AÑO año(s)
MES mes
SEMANA semana(s)
DÍA día(s)
HORA hora(s)

Volver a la tabla

Contract Rythm

Para el feed, el tag rythm contiene dos atributos: "hours_per_week", que contiene el número de horas trabajadas por semana, y "display_value", que contiene el valor "Full-time" o "Part-time". El valor contenido en la etiqueta es de la forma xx.xh/semana.

Exemple :

<rythm hours_per_week="37.0" display_value="Temps plein">37.0h/semaine</rythm>
Volver a la tabla

Contract Starting Date

La etiqueta <contract>/<starting_date> indica la fecha de inicio del contrato. Cuando se elige una fecha para el inicio del contrato, el atributo asap="false" y el valor de la etiqueta son iguales a la fecha introducida por el usuario. Si el usuario elige "lo antes posible", el atributo asap="true" y la fecha de la etiqueta corresponden a la fecha de publicación del anuncio.

Volver a la tabla

Language

Value Significado
en Inglés
fr Francés

Salary

Valor fijo:

<salary value="100000.0" currency="EUR" unit="YEAR">100000 € (Euros) par an</salary>

Rango salarial:

<salary min="100000.0" max="150000.0" currency="EUR" unit="YEAR">De 100000 à 150000 € (Euros) par an</salary>

Los valores posibles para los atributos <salary> se muestran en la siguiente tabla:

 
Atributo Unit Valor
YEAR año(s)
MONTH mes
WEEK semana(s)
DAY día(s)
HOUR hora(s)
Atributo Currency Valor
EUR € (Euros)
GBP £ (libra esterlina)
MAD DH (dirham marroquí)
USD $ (dólar estadounidense)
CAD $ (dólar canadiense)
JPY ¥ (yen japonés)
CHF CHF (franco suizo)

Job title

Code Value
Craft / Worker Artesano/Trabajador
Craft / Shop Artesano / Tienda local
Worker Trabajador de la construcción
Technician Técnico
Hospitality / Travel Hoteles / Restaurantes / Turismo / Ocio
Sales Comercio / Ventas
MLM Commission VDI
Computer TI/Internet/Telecomunicaciones
Marketing / Communication Marketing / Comunicación
House help Servicios a domicilio
Cleaning / Help Limpieza / Mantenimiento
Nurse / Babysitting / School help Servicios personales
Management Gestión
Entity management Dirección general / Director de centro de beneficios
Project management Gestión de proyectos
Engineering Estudios / Investigación / Ingeniería
HR / Formation / Teaching RRHH / Formación / Educación
HR Recursos Humanos / Formación
Formation / Teaching Educación / Enseñanza
Health Care Salud / Medicina / Social
Multi services Servicios generales
Administration Administración
Assistant Secretariado / Recepción
Accounting / Finance Contabilidad / Gestión / Finanzas
Legal / Tax Legal / Fiscal
Security / Help Seguridad / Defensa / Vigilancia
Logistic Transporte / Logística / Compras

Volver a la tabla

Activity area

Code Value
Bank Banco
Finance Finanzas
Assurance Seguros
Accounting Contabilidad
Gestion Gestión
Legal Legal
Tax Fiscal
Agriculture Agricultura / Pesca
Agri Industria alimentaria
Building Construcción e ingeniería civil
Building / infrastucture Edificación e ingeniería civil Plantas / Carreteras / Oleoductos
Installation / Maintenance / Repair Instalación / Mantenimiento / Reparación
Architecture Arquitectura
Design Diseño
Town planning Urbanismo
Real estate Inmobiliario
Craft Comercio / Artesanía
Retail Comercio minorista / Ventas
Distribution Venta al por menor
Export Comercio internacional / Exportación
Customer service Atención al cliente / postventa
Call center Centro de llamadas
Hostelry Hoteles
Food Catering
Tourism Turismo
Hobbies Ocio
Sport Deporte
Equipment manufacturer Automoción / Aeroespacial / Transporte
Metallurgy Metalurgia
Mechanical / Robotics Mecánica / Automatización / Robótica
Materials processing Transformación de materiales
Electrical and electronic equipment Material eléctrico y electrónico
Quality Calidad / Inspección
High technologies Alta tecnología
Raw materials Extracción y transformación de materias primas
Chemicals Productos químicos – Caucho – Plásticos
Pharmaceutical Farmacéutica / Biotecnología
Manufacturing / Production Industria / Manufactura, otros (muebles, textil, imprenta)
Health Salud
Social Social
Veterinary Veterinario
Web Sitios web / SEO / Diseño web
Software Desarrollo de software
Telecom Telecomunicaciones
E-business Comercio electrónico
IT Services Empresa de servicios de ingeniería informática
ConsultingProject management ConsultoríaGestión de proyectos
Cleaning Limpieza / mantenimiento
Other company services Otros servicios a las empresas
Individual services Servicios personales
Public service Servicios públicos / Administraciones
Fashion Modo
Luxury Lujo
Beauty Belleza
Transport Transporte
Logistic Logística
Handling Manejo de
HR RRHH
Recruitment firm Agencia de contratación
Interim firm Empresa de trabajo temporal
Marketing Marketing
Communication Comunicación / Medios / Prensa
Advertising Publicidad
Journalism Periodismo
Edition Publicar y escribir
Engineering Ingeniería
RnD I+D / Alta tecnología
Consultancy Oficina de diseño
Private research Búsqueda privada
Public research Investigación pública
Security Seguridad / Defensa
Art Arte / Entretenimiento / Cultura
Teaching Enseñanza
Public teaching Educación pública
Private teaching Enseñanza privada
Formation Formación profesional
Apprenticeship Formation Formación en alternancia
Water Agua
Electricity Electricidad
Oil and gas Petróleo / Gas
Nuclear Nuclear
Environment Medio ambiente / Naturaleza
Waste Gestión de residuos
Humanitarian Humanitario

Volver a la tabla

Qualification

Code Value
MANOEUVRE Peón
OUVRIER_SPECIALISE Trabajador cualificado
P1_P2 Trabajador cualificado (P1,P2)
P3_P4_OHQ Trabajador cualificado (P3,P4,OHQ)
ENQ Empleado no cualificado
EQ Empleado cualificado
TECHNICIEN Técnico
AGENT_DE_MAITRISE Supervisor
CADRE_PRIVE Ejecutivo del sector privado
CADRE_PUBLIC Ejecutivo del sector público / Fuerzas armadas

Volver a la tabla

Experience

Para un feed, la etiqueta <experience> devuelve uno de los siguientes valores:

  • Todos los niveles de experiencia
  • Principiante / Prácticas
  • Junior (1-2 años)
  • Avanzado (3-5 años)
  • Senior (6-10 años)
  • Experto (10 años o más)

La etiqueta <experience> tiene 2 atributos:

  • "experience_year" años de experiencia: indica el número de años de experiencia requeridos para el puesto. Un valor negativo indica que se aceptan todos los niveles de experiencia.
  • "including_management_years" años: indica el número de años de experiencia exigidos como directivo.

Ejemplo:

<experience experience_year="-2" including_management_years="10.0">Tous niveaux d'expérience</experience>

Study Levels

Code Value
ALL No
BEP_CAP BEP/CAP
BAC Papeleras
BAC_1_2 Bachillerato+1/Bachillerato+2
BAC_3 Bac+3
BAC_4 Bac+4
BAC_5 Bac+5
BAC_6_PLUS Bac+6 y superior

Volver a la tabla

School Types

Code Value
ALL No importa
UNI Universidad
RESEARCH_LAB Laboratorio de investigación
BUSINESS_SCHOOL Escuela de negocios
ENGINEER_SCHOOL Escuela de ingeniería
A A
A_PLUS A+

Volver a la tabla

Mapeo e interpretación del feed XML

En términos generales, el mapeo debe hacerse en el lado de la bolsa de trabajo (o sitio de carrera).

Los valores de la fuente XML por defecto no son modificables a menos que se acuerde en los intercambios: por lo tanto, será necesario asignar los datos para que los valores se muestren como desee en su espacio de trabajo.

Los campos de la lista desplegable específicos de su bolsa de trabajo se basarán en la nomenclatura que haya solicitado.

Por ejemplo, para una lista de especialidades específica de su bolsa de empleo que desee integrar en el feed XML, la nomenclatura será :

  • Nombre del campo: Especialidad
  • Tipo de campo: Menú desplegable
  • Obligatorio: Sí
  • Valores posibles (con su código a insertar en el flujo) :
    • Código: seguridad
    • Código: hardware | Etiqueta: Hardware
    • Código: red | Etiqueta: Red
    • Código: software | Redacción: Software
    • Código : web | Etiqueta : Web
  • Número de valores seleccionables: 3
  • Etiqueta: <job_speciality>
  • Por ejemplo: <job_speciality code="security">Sécurité</job_speciality>

Es importante contar con una red de seguridad en el lado de la interpretación del feed XML, de modo que si se encuentra un feed vacío o erróneo, las ofertas no se eliminen del sitio web. Como este escenario puede ocurrir, es importante tenerlo en cuenta para evitar borrados masivos por error, por ejemplo.