Dayforce HCM (versión preliminar)

Se conecta a dayforce HCM API para recuperar la información personal de los empleados (contactos, direcciones, nombres) por código de referencia de empleado. Diseñado para administradores de RR. HH. y desarrolladores de poco código. Requiere un inquilino de Dayforce, credenciales de API (autenticación básica) y permisos adecuados. Solo lectura; Los códigos de referencia no válidos devuelven errores.

Este conector está disponible en los siguientes productos y regiones:

Service	Class	Regions
Copilot Studio	Premium	Todas las regiones de Power Automate excepto las siguientes:      - Gobierno de EE. UU. (GCC)      - Gobierno de EE. UU. (GCC High)      - China Cloud operado por 21Vianet      - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas	Estándar	Todas las regiones de Logic Apps excepto las siguientes:      - Regiones de Azure Government      - Regiones de Azure China      - Departamento de Defensa de EE. UU. (DoD)
Power Apps	Premium	Todas las regiones de Power Apps excepto las siguientes:      - Gobierno de EE. UU. (GCC)      - Gobierno de EE. UU. (GCC High)      - China Cloud operado por 21Vianet      - Departamento de Defensa de EE. UU. (DoD)
Power Automate	Premium	Todas las regiones de Power Automate excepto las siguientes:      - Gobierno de EE. UU. (GCC)      - Gobierno de EE. UU. (GCC High)      - China Cloud operado por 21Vianet      - Departamento de Defensa de EE. UU. (DoD)

Contacto
Nombre	Compatibilidad con Dayforce
URL	https://www.dayforce.com/resources/help-center#support-for-employers
Correo electrónico	MicrosoftPartnership@dayforce.com

Metadatos del conector
Publicador	Dayforce AI
Sitio web	https://www.dayforce.com/
Directiva de privacidad	https://www.dayforce.com/privacy
Categorías	IA; Recursos humanos

Dayforce HCM

Dayforce HCM es una plataforma de gestión de capital humano.
Este conector expone una operación de Dayforce API que le permite recuperar la información personal de un empleado (nombre, direcciones y detalles de contacto) mediante su código de referencia externo (XRefCode). Puede usar estos datos como una herramienta en los agentes de inteligencia artificial de Copilot Studio, así como en otros escenarios de Power Platform.

Publicador: Dayforce

---

Prerrequisitos

Para usar este conector, necesita lo siguiente:

• Un entorno de Microsoft Power Platform (por ejemplo, para usar el conector en Copilot Studio).
• Un entorno activo de Dayforce HCM (QA, UAT o Producción).
• Un usuario de Dayforce API (cuenta de servicio) con permiso para leer información personal del empleado.
• Espacio de nombres de cliente para el entorno de Dayforce.
  • Este valor aparece como el segmento de espacio de nombres en las direcciones URL de Dayforce API, por ejemplo:
    https://{environmentHost}/{clientNamespace}/V1/...

---

Operaciones admitidas

Actualmente, el conector expone la siguiente operación.

Obtener información personal del empleado

Identificador de la operación:Get_Employee_Personal_Info
Método:GET

Recupera una vista filtrada y simplificada de la información personal de un solo empleado en función de su XRefCode.

Solicitud

• Parámetro path
  • xRefCode (string, required)
    Código de referencia externo del empleado que se va a recuperar. El valor debe coincidir exactamente con el XRefCode de un empleado existente; de lo contrario, el servicio devuelve una solicitud incorrecta 400.

Internamente, el conector enruta la llamada al punto de conexión de Dayforce Employees para el espacio de nombres de cliente y expande la información personal pertinente, que luego transforma el script del conector en un objeto JSON simplificado.

Respuesta

Si se ejecuta correctamente (HTTP 200), el conector no devuelve la carga completa de los empleados de Dayforce.
En su lugar, devuelve un objeto transformado con esta estructura:

{
  "firstName": "string",
  "lastName": "string",
  "addresses": [
    {
      "address1": "string",
      "address2": "string",
      "address3": "string",
      "city": "string",
      "postalCode": "string",
      "country": "string",
      "state": "string",
      "contactInformationType": "string"
    }
  ],
  "contacts": [
    {
      "personContactId": 0,
      "contactInformationType": "string",
      "electronicAddress": "string",
      "contactNumber": "string",
      "country": "string",
      "effectiveStart": "2024-01-01T00:00:00Z"
    }
  ]
}

Más concretamente:

• campos de nivel superior

  • firstName – Nombre del empleado.
  • lastName – Apellidos del empleado.
  • addresses : lista de entradas de dirección filtradas.
  • contacts : lista de entradas de contacto filtradas.

• Objeto Address (addresses[])

  • address1 – Línea de dirección principal.
  • address2 – Línea de dirección secundaria.
  • address3 – Línea de dirección adicional.
  • city – Nombre de la ciudad.
  • postalCode – Código postal o postal.
  • country – Nombre del país (asignado a partir del nombre del país de Dayforce).
  • state – Nombre de estado o provincia (asignado a partir del nombre de Dayforce State).
  • contactInformationType – Nombre corto que describe el tipo de dirección (por ejemplo, "Inicio", "Correo"), basado en el tipo de información de contacto dayforce.

• Objeto Contact (contacts[])

  • personContactId – Identificador numérico interno del registro de contacto.
  • contactInformationType – Nombre corto que describe el tipo de contacto (por ejemplo, "Móvil", "Teléfono principal", "Correo electrónico de trabajo").
  • electronicAddress – Para contactos de estilo de "perfil en línea" (como correo electrónico u otras direcciones electrónicas).
  • contactNumber – Para los contactos de estilo telefónico (por ejemplo, números móviles o de línea fija).
  • country – Valor de país asociado al contacto (si procede).
  • effectiveStart – Fecha de inicio efectiva de esta información de contacto (si está disponible).

Nota: El script del conector filtra intencionadamente la carga de Dayforce sin procesar.
Solo los campos mostrados anteriormente se exponen a los autores de llamadas de esta operación.

En caso de error, la API devuelve:

• 400 Solicitud incorrecta : para solicitudes con formato incorrecto o no válido xRefCode.
• 500 Error interno del servidor : para errores inesperados del lado servidor.

Las respuestas de error incluyen información de diagnóstico de dayforce API subyacente.

---

Obtención de credenciales

Este conector usa la autenticación básica para conectarse a Dayforce API.

Para obtener las credenciales necesarias:

1. Creación o identificación de un usuario de API en Dayforce

   • Trabaje con su equipo de implementación o administrador de Dayforce.
   • Asegúrese de que el usuario de la API tiene acceso de lectura a la información personal del empleado para su entorno.

2. Recopilación de los siguientes valores

   • Nombre de usuario : nombre de usuario de Dayforce API.
   • Contraseña : contraseña de Dayforce API.
   • Espacio de nombres de cliente : valor de espacio de nombres usado en las direcciones URL de Dayforce API.
     • Suele ser un identificador corto para su organización o entorno, por ejemplo, el segmento que aparece en direcciones URL como:
       https://{environmentHost}/{clientNamespace}/V1/Employees/....

3. Uso de estos valores al crear una conexión de conector

   • En el cuadro de diálogo conexión de Power Platform:
     • Escriba el nombre de usuario y la contraseña del usuario de Dayforce API.
     • Escriba el espacio de nombres de cliente Dayforce en el campo "Espacio de nombres de cliente".
   • El conector usa estos valores para enrutar las solicitudes al inquilino de Dayforce correcto y autenticar la llamada.

Si no está seguro de los detalles del usuario del espacio de nombres de cliente o de la API, póngase en contacto con el soporte técnico de Dayforce o con el administrador interno de Dayforce.

---

Introducción

La manera recomendada de probar y usar este conector es agregarlo como una herramienta en un agente de INTELIGENCIA ARTIFICIAL de Copilot Studio.

1. Creación de una conexión

Antes de usar el conector en Copilot Studio, asegúrese de que existe una conexión:

1. En la experiencia de administrador o creador de Power Platform, vaya a Conexiones de datos>.
2. Seleccione + Nueva conexión.
3. Busque el conector dayforce HCM (este conector).
4. Cuando se le solicite, proporcione lo siguiente:
   • Nombre de usuario: nombre de usuario de Dayforce API.
   • Contraseña: contraseña de usuario de Dayforce API.
   • Espacio de nombres de cliente : espacio de nombres de cliente dayforce.
5. Guarde la conexión.

2. Creación de un agente de IA en Copilot Studio y adición del conector como herramienta

1. Abra Copilot Studio.
2. Cree un nuevo agente de IA (o abra un agente existente en el que quiera usar los datos de Dayforce).
3. Vaya a la sección Herramientas/complementos (o Conectores) del agente.
4. Agregue el conector Dayforce HCM como herramienta.
5. Asegúrese de que el conector usa la conexión que creó anteriormente.

3. Llamada al conector desde el agente de IA

1. En la experiencia de creación del agente de IA:
   • Cree o edite un tema, una acción o una llamada de complemento donde quiera que el agente recupere la información de los empleados.
2. Configure una llamada de herramienta que use la operación Obtener información personal del empleado :
   • Asigne la entrada del usuario (por ejemplo, "código de empleado") al xRefCode parámetro .
3. Use los campos devueltos:
   • firstName y lastName se pueden usar en las respuestas del agente de IA (por ejemplo, "Aquí está la dirección y la información de contacto de John Smith).
   • Use addresses y contacts en la lógica del agente para mostrar o motivo sobre la dirección del empleado y los detalles de contacto.

Esta configuración permite que el agente de IA llame de forma segura al conector Dayforce HCM como una herramienta, recupere solo los campos filtrados e incorpore esos resultados en respuestas o toma de decisiones.

---

Problemas conocidos y limitaciones

• Solo búsqueda de un solo empleado
  La operación recupera los datos de un empleado a la vez, en función de XRefCode. Esta definición de conector no admite consultas o búsquedas masivas por otros atributos (como el nombre o el correo electrónico).

• Coincidencia exacta de XRefCode requerida
  El xRefCode parámetro debe coincidir exactamente con el código de referencia externo de un empleado existente. Si el valor no es válido o no existe, el servicio devuelve una respuesta 400 Solicitud incorrecta.

• Operaciones de solo lectura
  Esta versión del conector es de solo lectura. No admite la creación, actualización ni eliminación de información de los empleados.

• Configuración específica del entorno
  La directiva de enrutamiento y definición de API espera un entorno de Dayforce válido y un espacio de nombres de cliente. Si no coinciden con la configuración real del entorno de Dayforce, las llamadas producirán errores de conexión o enrutamiento.

• Carga filtrada
  La API de Dayforce subyacente devuelve muchos más campos de los que se exponen aquí. El script del conector filtra intencionadamente y vuelve a dar forma a estos datos solo en firstName, lastName, addresses[]y contacts[] .

• La visibilidad de los datos depende de la configuración de Dayforce
  Los campos y valores devueltos para un empleado dependen de cómo se configura el entorno de Dayforce (roles, seguridad y qué elementos de datos están habilitados o rellenados).

---

Preguntas más frecuentes

P1: ¿Para qué se usa el campo "Espacio de nombres de cliente"?
El espacio de nombres de cliente identifica el inquilino de Dayforce dentro de la dirección URL de Dayforce API. El conector lo usa para enrutar las solicitudes al espacio de nombres de cliente correcto, por ejemplo:
https://{environmentHost}/{clientNamespace}/V1/Employees/{xRefCode}
Si no conoce este valor, póngase en contacto con el administrador de Dayforce o el equipo de implementación.

P2: ¿Qué ocurre si proporciono un valor no válido xRefCode?
xRefCode Si no coincide con un empleado existente, el servicio devuelve una respuesta 400 Solicitud incorrecta. El error subyacente de Dayforce API se muestra a través del conector.

P3: ¿Puedo recuperar varios empleados en una sola llamada?
No con esta definición de conector. La operación actual recupera la información personal de un solo empleado por llamada, en función del proporcionado xRefCode.

---

Instrucciones de implementación (CLI – paconn)

Puede implementar este conector como un conector personalizado mediante la CLI de Power Platform Connectors (paconn).

1. Preparar artefactos del conector

Asegúrese de que tiene los siguientes archivos en una carpeta local (por ejemplo, ./dayforce-hcm-connector):

• apiDefinition.swagger.json
• apiProperties.json
• script.csx

Deben coincidir con la estructura esperada por el marco de conector personalizado de Power Platform.

2. Instalación y configuración de la CLI

1. Instale la CLI de Power Platform Connectors (paconn) si aún no lo ha hecho.
2. Inicie sesión en el entorno o inquilino de destino mediante paconn según la documentación de Microsoft (por ejemplo, mediante paconn login).

3. Creación del conector

Ejecute un comando similar al siguiente:

paconn create   --api-def apiDefinition.swagger.json   --api-prop apiProperties.json --icon icon.png   --script script.csx

• Asegúrese de ejecutar este comando en la carpeta que contiene los archivos del conector o proporcione rutas de acceso completas a cada archivo.
• Después de la creación, el conector aparecerá como un conector personalizado en el entorno de destino.

4. Actualice el conector (si es necesario)

Si posteriormente realiza cambios en apiDefinition.swagger.json, apiProperties.jsono script.csx, puede actualizar el conector existente con:

paconn update   --api-def apiDefinition.swagger.json   --api-prop apiProperties.json   --script script.csx   --connector-id <your-connector-id>

Reemplace <your-connector-id> por el identificador del conector que se creó.

5. Crear una conexión y usarla en Copilot Studio

Una vez implementado el conector:

1. Vaya a Conexiones de datos> y cree una nueva conexión para el conector Dayforce HCM mediante las credenciales de Dayforce y el espacio de nombres de cliente.
2. En Copilot Studio, agregue este conector como una herramienta al agente de IA y llame a la operación Obtener información personal del empleado , como se describe en la sección Introducción .

6. Seguridad y uso compartido de conexiones

Pretendemos que este conector siga un modelo de conexión no compartible: cuando se comparte un agente de Power App o Copilot Studio que usa este conector, solo se comparte la definición del conector y cada usuario individual debe crear explícitamente su propia conexión dayforce con sus propias credenciales en el primer uso. El conector no debe permitir el uso compartido de conexiones de forma que permita que otro usuario reutilice los permisos dayforce de un usuario (es decir, ningún escenario en el que una aplicación o agente se ejecute en la identidad de Dayforce del propietario de la aplicación o del propietario de la conexión). Como parte de la certificación, asegúrese de que todos los tipos de autenticación de este conector están configurados como No compartibles, de modo que el uso compartido de conexiones se bloquee en el nivel de plataforma y que todos los usuarios siempre sean necesarios para establecer su propia conexión dayforce.

Incluya esta declinación de responsabilidades: esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Una vez certificado y publicado por Microsoft, el conector dayforce HCM estará disponible como conector certificado y normalmente solo tendrá que crear una conexión (sin necesidad de implementación de la CLI para los usuarios finales).

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado	Parámetros para crear una conexión.	Todas las regiones	No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre	Tipo	Descripción	Obligatorio
nombre de usuario	securestring	El nombre de usuario de esta API	Cierto
contraseña	securestring	La contraseña de esta API	Cierto
Tipo de autenticación	cuerda / cadena	Tipo de autenticación para conectarse a la API	Cierto
Espacio de nombres de cliente	cuerda / cadena	espacio de nombres de cliente	Cierto

Limitaciones

Nombre	Llamadas	Período de renovación
Llamadas API por conexión	100	60 segundos

Acciones

Obtener información personal del empleado

Esta operación recupera datos relacionados con un empleado y su información personal (por ejemplo, nombre, direcciones y contactos) por código XRef

Obtener información personal del empleado

Id. de la operación:

Get_Employee_Personal_Info

Esta operación recupera datos relacionados con un empleado y su información personal (por ejemplo, nombre, direcciones y contactos) por código XRef

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Código de referencia de empleado	xRefCode	True	string	Identificador único (código de referencia externo) del empleado que se va a recuperar. El valor proporcionado debe ser la coincidencia exacta para un empleado; De lo contrario, se devolverá un error de solicitud incorrecta (400).

Devoluciones

Body

Payload_Employee

Definiciones

ProcessResult

Nombre	Ruta de acceso	Tipo	Description
Código	Code	string
Context	Context	string
Level	Level	string
Mensaje	Message	string

Empleado

Nombre	Ruta de acceso	Tipo	Description
Identificación de empleado	EmployeeId	integer
Contactos	Contacts	PersonContactCollection
Direcciones	Addresses	PersonAddressCollection
GlobalPersonId	GlobalPersonId	string
XRefCode	XRefCode	string
NewXRefCode	NewXRefCode	string
Nombre Común	CommonName	string
DisplayName (Nombre para mostrar)	DisplayName	string
Primer Nombre	FirstName	string
LastName	LastName	string
Initials	Initials	string
MaidenName	MaidenName	string
Segundo nombre	MiddleName	string
Título	Title	string
LastModifiedTimestamp	LastModifiedTimestamp	date-time

PersonContactCollection

Nombre	Ruta de acceso	Tipo	Description
Productos	Items	array of PersonContact

PersonAddressCollection

Nombre	Ruta de acceso	Tipo	Description
Productos	Items	array of PersonAddress

PersonContact

Nombre	Ruta de acceso	Tipo	Description
PersonContactId	PersonContactId	integer
ContactInformationType	ContactInformationType	ContactInformationType
ContactNumber	ContactNumber	string
País	Country	Country
EffectiveEnd	EffectiveEnd	date-time
EffectiveStart	EffectiveStart	date-time
ElectronicAddress	ElectronicAddress	string
Extension	Extension	string
IsForSystemCommunications	IsForSystemCommunications	boolean
IsPreferredContactMethod	IsPreferredContactMethod	boolean
IsUnlistedNumber	IsUnlistedNumber	boolean
FormattedNumber	FormattedNumber	string
IsVerified	IsVerified	boolean
IsRejected	IsRejected	boolean
ShowRejectedWarning	ShowRejectedWarning	boolean
NumberOfVerificationRequests	NumberOfVerificationRequests	integer
LastModifiedTimestamp	LastModifiedTimestamp	date-time

PersonAddress

Nombre	Ruta de acceso	Tipo	Description
PersonAddressId	PersonAddressId	integer
Address1	Address1	string
Address2	Address2	string
Address3	Address3	string
Address4	Address4	string
Address5	Address5	string
Address6	Address6	string
Ciudad	City	string
Código postal	PostalCode	string
País	Country	Country
Estado	State	State
ContactInformationType	ContactInformationType	ContactInformationType
IsPayrollMailing	IsPayrollMailing	boolean
DisplayOnTaxForm	DisplayOnTaxForm	boolean
DisplayOnEarningStatement	DisplayOnEarningStatement	boolean
EffectiveStart	EffectiveStart	date-time
EffectiveEnd	EffectiveEnd	date-time
Condado	County	string
LastModifiedTimestamp	LastModifiedTimestamp	date-time

País

Nombre	Ruta de acceso	Tipo	Description
Nombre	Name	string
XRefCode	XRefCode	string
Nombre corto	ShortName	string
LongName	LongName	string
LastModifiedTimestamp	LastModifiedTimestamp	date-time

ContactInformationType

Nombre	Ruta de acceso	Tipo	Description
ContactInformationTypeGroup	ContactInformationTypeGroup	ContactInformationTypeGroup
XRefCode	XRefCode	string
Nombre corto	ShortName	string
LongName	LongName	string
LastModifiedTimestamp	LastModifiedTimestamp	date-time

Estado

Nombre	Ruta de acceso	Tipo	Description
Nombre	Name	string
XRefCode	XRefCode	string
Nombre corto	ShortName	string
LongName	LongName	string
LastModifiedTimestamp	LastModifiedTimestamp	date-time

ContactInformationTypeGroup

Nombre	Ruta de acceso	Tipo	Description
XRefCode	XRefCode	string
Nombre corto	ShortName	string
LongName	LongName	string
LastModifiedTimestamp	LastModifiedTimestamp	date-time

Payload_Employee

Nombre	Ruta de acceso	Tipo	Description
Datos	Data	Employee
ProcessResults	ProcessResults	array of ProcessResult