Integrar SAP Concur
Integre con SAP Concur para enviar solicitudes y recibir notificaciones sobre aprobaciones, gastos, itinerarios e informes.
Nota:
Ofrecemos dos plantillas para la integración de SAP Concur. Recomendamos utilizar la plantilla más reciente de la categoría Integraciones en la mayoría de los casos de uso, ya que ofrece mayor capacidad para configurar la estructura de datos en caché. Puede encontrar los detalles de la plantilla de integración antigua (retirada) en SAP Concur: Agregar la integración antigua.
Para obtener una lista completa de las microaplicaciones de SAP Concur de uso inmediato, consulte Utilizar microaplicaciones de SAP Concur.
Revisar requisitos previos
En estos requisitos previos, se asume que usted administra la instancia de SAP Concur de su organización para configurar la integración. Deberá tener estos detalles para agregar la integración en las microaplicaciones de Citrix Workspace:
-
URL base: Este es el modelo de URL base:
https://{data_center}.api.concursolutions.com. Para obtener más información, consulte SAP Concur: URI base. -
URL del token:
https://{data_center}.api.concursolutions.com/oauth2/v0/token -
URL de autorización:
https://{data_center}.api.concursolutions.com/oauth2/v0/authorize - Nombre de usuario: Este y la contraseña son las credenciales de la cuenta de servicio con acceso a SAP Concur.
- Contraseña: Esta y el nombre de usuario son las credenciales de la cuenta de servicio con acceso a SAP Concur.
- ID de cliente: Obtendrá el ID de cliente al registrar el cliente OAuth en su cuenta de SAP Concur. El ID de cliente y el secreto del cliente son los mismos tanto para Autenticación de servicio como para Autenticación de acciones de servicio. Consulte Solicitar ID de cliente y secreto de cliente.
- Secreto del cliente: Obtendrá el secreto del cliente al registrar el cliente OAuth en su cuenta de SAP Concur. El ID de cliente y el secreto del cliente son los mismos tanto para Autenticación de servicio como para Autenticación de acciones de servicio. Consulte Solicitar ID de cliente y secreto de cliente.
- Ámbito: CCARD creditcardaccount.read receipts.read COMPD USER user_read EMERG JOBLOG company.read ERECPT ITINER FISVC LIST PASSV mileage.vehicle.writeonly CONFIG FOP mileage.rate.writeonly receipts.writeonly GHOST user.read CONREQ user.write COMPANY mileage.journey.read EVS TRVPTS ATTEND INVPO NOTIF TRVREQ SUPSVC company.write EXPRPT EXTRCT PAYBAT INVPMT mileage.vehicle.read IMAGE TAXINV RCTIMG UNUTX TWS TMCSP quickexpense.writeonly BANK INVVEN openid receipts.write travelrequest.write MTNG mileage.rate.read mileage.journey.writeonly INSGHT TRVPRF INVTV MEDIC TSAI
Nota:
Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.
- Debe adquirir el componente Web Services de SAP Concur. Si su empresa no ha adquirido el componente Web Services, solicite al administrador de SAP Concur de su organización que se ponga en contacto con su administrador de cuentas en SAP Concur.
- Configure Citrix Gateway para que admita Single Sign-On para SAP Concur, de modo que, una vez que los usuarios hayan iniciado sesión, no tengan que volver a introducir sus credenciales para registrarse. Siga las instrucciones que se indican en Configuración de Single Sign-On de Concur. Para obtener más información acerca de la configuración de SSO, consulte Citrix Gateway Service.
Solicitar ID de cliente y secreto de cliente
Siga estas instrucciones para obtener un nuevo ID de cliente y secreto de cliente de OAuth2 y definir el ámbito de la aplicación del cliente.
Importante:
Cree un tíquet de asistencia con Concur para configurar la integración mediante OAuth 2.0 y registrar las URL de respuesta de autenticación correctas. Recomendamos utilizar el siguiente texto para el tíquet de asistencia:
Solicitamos credenciales de OAuth 2.0 para habilitar la integración con Citrix Workspace. Esta herramienta descarga informes de gastos recientes y detalles de artículos de línea mediante una cuenta de servicio para presentar aprobaciones pendientes a los administradores. Permite a los empleados presentar, aprobar y rechazar gastos. Las acciones realizadas por los usuarios finales se dirigen a la página de autorización de 3LO, donde introducen sus credenciales de Concur y el acceso se aprueba a través de la aplicación Workspace.
Agregue en Concur las siguientes direcciones URL de redirección autorizadas para esta integración con concesión de autorización de acceso con el objetivo de permitir el acceso a datos privados y habilitar acciones de usuarios autenticados por OAuth. La primera respuesta que aparece en la lista no cambia. La segunda respuesta depende de la aplicación de destino, y se puede encontrar en la barra de direcciones URL al crear la integración. La sección {yourmicroappserverurl} se compone de una parte de arrendatario, una parte de región y una parte de entorno: https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com:
<https://microapps_server_URL/admin/api/external-services/com.sapho.services.concur.ConcurService/auth/serverContext>
<https://microapps_server_URL/app/api/auth/serviceAction/callback>
Agregar la integración a las microaplicaciones de Citrix Workspace
Agregue la integración HTTP de SAP Concur a las microaplicaciones de Citrix Workspace para conectarse a su aplicación. Esto proporciona microaplicaciones de uso inmediato con notificaciones y acciones preconfiguradas que se pueden usar desde ya en su espacio de trabajo. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso. Se recomienda usar esta integración HTTP más reciente para la mayoría de los casos de uso. La integración HTTP ofrece mayor capacidad para configurar la estructura de datos en caché.
Siga estos pasos:
- En la página Integraciones de microaplicaciones, seleccione Agregar nueva integración y Agregar una nueva integración a partir de plantillas proporcionadas por Citrix.
- Elija el mosaico SAP Concur.
- En el campo Nombre de la integración, introduzca un nombre para la misma.
- Introduzca los parámetros del conector.
- Introduzca la URL base de la instancia. Este es el modelo de URL base:
https://{data_center}.api.concursolutions.com. Para obtener más información, consulte SAP Concur: URI base. - Seleccione un icono para la integración en la Biblioteca de iconos, o deje el icono predeterminado de Salesforce.
- Si está creando una conexión local, habilite la opción Instancia local. Para obtener más información, consulte Instancia local.
- Introduzca la URL base de la instancia. Este es el modelo de URL base:
-
En Autenticación de servicio, seleccione OAuth 2.0 en el menú Método de autenticación y complete los detalles correspondientes. Utilice el protocolo de seguridad de OAuth 2.0 para generar tokens de solicitud/autorización para el acceso delegado. Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.
- Seleccione OAuth 2.0 en el menú Método de autenticación.
- Seleccione Contraseña del propietario del recurso en el menú Flujo de tipo de concesión. Proporciona las credenciales correctas para autorizar la provisión de un token de acceso del servidor de recursos.
- Introduzca la contraseña en el menú Valor de tipo de concesión.
- Seleccione Cuerpo de la solicitud en el menú Autorización de token.
- En el menú Tipo de contenido de token, seleccione URL codificada del formulario.
- La URL del token se rellena automáticamente:
https://{data_center}.api.concursolutions.com/oauth2/v0/token - Deje la URL de token de actualización y el Ámbito en blanco.
- Introduzca el nombre de usuario y la contraseña.
- Introduzca su ID de cliente y secreto del cliente.
- Deje el Prefijo del encabezado en blanco.
-
En Autenticación de acciones de servicio, habilite la opción Usar autenticación de usuario independiente en Acciones. La autenticación de acciones de servicio autentica en el nivel de acción de servicio.
- En el menú Método de autenticación, seleccione OAuth 2.0 y complete los detalles de autenticación.
- En el menú Flujo de tipo de concesión, seleccione Código de autorización. De esta manera, se concede un código temporal que el cliente intercambia por un token de acceso. El código se obtiene del servidor de autorización, donde se puede ver la información que solicita el cliente. Solo este tipo de concesión permite la suplantación segura de usuarios. Se mostrará la URL de respuesta, que utiliza al registrar su aplicación.
- En el campo Valor de tipo de concesión, introduzca authorization_code.
- El campo URL de respuesta viene prellenado.
- Seleccione Cuerpo de la solicitud en el menú Autorización de token.
- En el menú Tipo de contenido de token, seleccione URL codificada del formulario.
- La URL de autorización se rellena automáticamente:
https://{data_center}.api.concursolutions.com/oauth2/v0/authorize - La URL del token se rellena automáticamente:
https://{data_center}.api.concursolutions.com/oauth2/v0/token - Deje el campo URL de token de actualización en blanco.
- El campo Ámbito contiene los siguientes ámbitos:
CCARD creditcardaccount.read receipts.read COMPD USER user_read EMERG JOBLOG company.read ERECPT ITINER FISVC LIST PASSV mileage.vehicle.writeonly CONFIG FOP mileage.rate.writeonly receipts.writeonly GHOST user.read CONREQ user.write COMPANY mileage.journey.read EVS TRVPTS ATTEND INVPO NOTIF TRVREQ SUPSVC company.write EXPRPT EXTRCT PAYBAT INVPMT mileage.vehicle.read IMAGE TAXINV RCTIMG UNUTX TWS TMCSP quickexpense.writeonly BANK INVVEN openid receipts.write travelrequest.write MTNG mileage.rate.read mileage.journey.writeonly INSGHT TRVPRF INVTV MEDIC TSAI - Introduzca su ID de cliente y secreto del cliente.
- Deje el Prefijo del encabezado en blanco.
- De forma predeterminada, el campo Limitación del índice de solicitudes está establecido en 50 solicitudes por segundo.
- El valor de Tiempo de espera de solicitud se establece en 120 de forma predeterminada.
- (Optativo) Habilite la opción Registro para conservar un registro de 24 horas con fines de asistencia.
- Seleccione Guardar.
Ya tiene todo listo para configurar y llevar a cabo su primera sincronización de datos. Para obtener información completa acerca de las reglas de sincronización, la sincronización que no cumple con sus reglas de programación y las reglas de veto, consulte Sincronizar datos.
Utilizar microaplicaciones de SAP Concur
Nuestra integración de SAP Concur incluye las siguientes microaplicaciones preconfiguradas de uso inmediato:
Aprobaciones: Permite aprobar informes de gastos que esté pendientes o los envía de vuelta.
| Notificación o página | Flujos de trabajo por caso de uso |
|---|---|
| Notificación de recordatorio de aprobación | Cuando un informe de gastos está pendiente de aprobación y supera un umbral definido antes de la fecha límite (por ejemplo, 3 días de forma predeterminada), el aprobador recibe un recordatorio de notificación. |
| Notificación Nueva solicitud | Cuando se asigna una nueva solicitud de aprobación a un aprobador, este recibe una notificación. |
| Notificación Nueva solicitud | Cuando se produce un cambio en una solicitud de aprobación, el aprobador recibe una notificación. |
| Página Detalles de los gastos | Proporciona una vista de solo lectura de un gasto con detalles. |
| Página Detalles del informe de gastos | Proporciona una vista detallada de un informe con una lista de gastos y opciones para Aprobar y Devolver. |
| Página Mis aprobaciones pendientes | Proporciona una lista personalizada de las aprobaciones pendientes. |
Gastos: Permite buscar y ver gastos.
| Notificación o página | Flujos de trabajo por caso de uso |
|---|---|
| Página Detalles de mis gastos | Proporciona una vista detallada de un gasto, con datos adjuntos. |
| Página Detalle de mi informe de gastos | Proporciona una vista detallada de un informe con una lista de gastos y la opción de Retirar. |
| Página Mis gastos | Proporciona una lista personalizada de gastos, en la que se pueden hacer búsquedas. |
Itinerarios: Permite buscar, ver y compartir itinerarios.
| Notificación o página | Flujos de trabajo por caso de uso |
|---|---|
| Notificación El itinerario modificado se reservó correctamente | Cuando se modifica el itinerario de un usuario, este recibe una notificación. |
| Notificación El itinerario modificado se ha compartido | Cuando un itinerario modificado se comparte con un usuario, este recibe una notificación. |
| Notificación Nuevo itinerario reservado correctamente | Cuando el nuevo itinerario de un usuario se reserva y se hace un tíquet, el usuario recibe una notificación. |
| Notificación Nuevo itinerario compartido | Cuando un itinerario se comparte con un usuario, este recibe una notificación. |
| Página Detalles del itinerario | Proporciona una vista del itinerario de un usuario y un botón para compartir accionable. |
| Página Mis itinerarios | Proporciona una lista personalizada de los itinerarios. |
Informes: Permite buscar y consultar los informes de gastos enviados.
| Notificación o página | Flujos de trabajo por caso de uso |
|---|---|
| Notificación Solicitud aprobada | Cuando se aprueba el informe de gastos de un usuario, este recibe una notificación. |
| Notificación Solicitud devuelta | Cuando se devuelve el informe de gastos de un usuario, este recibe una notificación. |
| Página Detalles de mis gastos | Proporciona una vista detallada de un gasto, con datos adjuntos. |
| Página Detalle de mi informe de gastos | Proporciona una vista detallada de un informe con una lista de gastos y la opción de Retirar. |
| Página Mis informes de gastos | Proporciona una lista de informes de gastos. |
Agregar la integración antigua
Como administrador del sistema, utilice el siguiente proceso para habilitar la integración de Concur. Compruebe que cumple los requisitos previos y, a continuación, configure la integración de Concur. Después de configurar la integración, debe proporcionar a los empleados el nombre de empleado, la dirección de correo electrónico, el ID de empleado o el ID de inicio de sesión de la cuenta dedicada y pedirles que ajusten la configuración del perfil de SAP Concur. Después de completar este proceso, el nivel existente de registros de auditoría persiste, incluidas las acciones llevadas a cabo por el uso de microaplicaciones de Citrix.
Revisar requisitos previos
En estos requisitos previos, se asume que usted administra la instancia de SAP Concur de su organización para configurar la integración. Deberá tener estos detalles para agregar la integración en las microaplicaciones de Citrix Workspace:
- URL de instancia
- Nombre de usuario
- Contraseña
Para OAuth 2.0:
- ID de cliente de OAuth
- Secreto de cliente de OAuth
- URL de autorización
Nota:
Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.
- Obtenga un nuevo ID de cliente y secreto de cliente de OAuth2 y defina el ámbito de la aplicación del cliente.
Importante:
Cree un tíquet de asistencia con Concur para configurar la integración mediante OAuth 2.0 y registrar las URL de respuesta de autenticación correctas. Recomendamos utilizar el siguiente texto para el tíquet de asistencia:
Solicitamos credenciales de OAuth 2.0 para habilitar la integración con Citrix Workspace. Esta herramienta descarga informes de gastos recientes y detalles de artículos de línea mediante una cuenta de servicio para presentar aprobaciones pendientes a los administradores. Permite a los empleados presentar, aprobar y rechazar gastos rápidamente. Las acciones realizadas por los usuarios finales se dirigen a la página de autorización de 3LO, donde introducen sus credenciales de Concur y el acceso se aprueba a través de la aplicación Workspace.
Agregue en Concur las siguientes direcciones URL de redirección autorizadas para esta integración con concesión de autorización de acceso con el objetivo de permitir el acceso a datos privados y habilitar acciones de usuarios autenticados por OAuth. La primera respuesta que aparece en la lista no cambia. La segunda respuesta depende de la aplicación de destino, y se puede encontrar en la barra de direcciones URL al crear la integración. La sección {yourmicroappserverurl} se compone de una parte de arrendatario, una parte de región y una parte de entorno: https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com:
<https://microapps_server_URL/admin/api/external-services/com.sapho.services.concur.ConcurService/auth/serverContext>
<https://microapps_server_URL/app/api/auth/serviceAction/callback>
- Debe adquirir el componente Web Services de SAP Concur. Si su empresa no ha adquirido el componente Web Services, solicite al administrador de SAP Concur de su organización que se ponga en contacto con su administrador de cuentas en SAP Concur.
- Configure Citrix Gateway para que admita Single Sign-On para SAP Concur, de modo que, una vez que los usuarios hayan iniciado sesión, no tengan que volver a introducir sus credenciales para registrarse. Siga las instrucciones que se indican en Configuración de Single Sign-On de Concur. Para obtener más información acerca de la configuración de SSO, consulte Citrix Gateway Service.
Configurar la plantilla antigua
Agregue la integración de SAP Concur a las microaplicaciones de Citrix Workspace para conectarse a su aplicación. Esto proporciona microaplicaciones de uso inmediato con notificaciones y acciones preconfiguradas que se pueden usar desde ya en su espacio de trabajo.
Siga estos pasos:
-
En la página de descripción general, seleccione Introducción.
Se abrirá la página Administrar integraciones.
- Seleccione Agregar nueva integración y Agregar una nueva integración a partir de plantillas proporcionadas por Citrix.
- Elija el mosaico SAP Concur.
-
Introduzca un nombre para la integración.
- Introduzca los parámetros del conector que recopiló como requisitos previos.
- Introduzca la URL de su instancia.
- Introduzca el nombre de usuario y la contraseña.
- Seleccione un método de autenticación. Utilice el protocolo de seguridad de OAuth 2.0 para generar tokens de solicitud/autorización para el acceso delegado.
- Introduzca una URL de autorización para definir la dirección URL del servidor de autorización proporcionada al configurar la integración de la aplicación de destino.
- Seleccione un método de autenticación OAuth 2.0.
- Credenciales Se utilizan las credenciales del cliente, en lugar de las del propietario del recurso. El token de acceso está asociado al propio cliente o cuenta con autorización delegada de un propietario de recursos.
- Concesión de autorización (3LO) El propietario del recurso permite el acceso.
- Introduzca el ID de cliente de OAuth y el secreto de cliente de OAuth que recopiló en el procedimiento de requisitos previos.
-
Seleccione los siguientes botones de opción según sea necesario:
- Módulo de gastos Proporciona acceso al seguimiento de gastos de los empleados.
- Configuración de grupo de gastos Recupera la lista de directivas de gastos, tipos de gastos y tipos de pago para el grupo de gastos al que está asignado el token de acceso OAuth.
- Detalles del informe de gastos (asignaciones y desgloses) Permite recuperar información de asignación en relación con un ID de informe, un ID de entrada o un ID de desglose.
- Módulo de viajes Proporciona acceso a datos de viajes, como itinerarios, perfiles de viaje y solicitudes de viaje.
- Delegantes de gastos Recupera una lista de usuarios que han concedido permisos delegados al usuario especificado en el token de acceso de OAuth.
-
Introduzca una cantidad para la cantidad de conexiones. Este valor determina la cantidad de cadenas que inicia la sincronización de datos.
Nota:
La cantidad predeterminada de conexiones es 1. Abrir más conexiones reduce el tiempo de sincronización de datos, pero aumenta la carga en el servidor de microaplicaciones y puede influir en el rendimiento de este. Si quiere aumentar esta cantidad, le recomendamos no más de 10.
- Seleccione Agregar.
Se abrirá la página Integraciones de microaplicaciones con la integración agregada y sus microaplicaciones. Desde aquí, puede agregar otra integración, seguir configurando sus microaplicaciones de uso inmediato o crear una nueva microaplicación para esta integración.
Ya tiene todo listo para configurar y llevar a cabo su primera sincronización de datos. Como se puede extraer una gran cantidad de datos de la aplicación integrada y transferirla a la plataforma de microaplicaciones, le recomendamos utilizar la página Tabla para filtrar entidades relacionadas con la primera sincronización de datos y, así, acelerar la sincronización. Para obtener más información, consulte Verificar las entidades necesarias. Para obtener información completa acerca de las reglas de sincronización, la sincronización que no cumple con sus reglas de programación y las reglas de veto, consulte Sincronizar datos.
Para obtener información detallada sobre los dispositivos de punto final de las API y las entidades de tabla, consulte Especificaciones del conector de Concur.
Utilizar microaplicaciones antiguas de SAP Concur
Las integraciones de las aplicaciones existentes vienen con microaplicaciones de uso inmediato. Comience con estas microaplicaciones y personalícelas conforme a sus exigencias.
Importante.
Estas microaplicaciones de SAP Concur se han retirado: Enviar gasto rápido, Crear usuario y Usuario. Los usuarios deben eliminar estas microaplicaciones, ya que se configurarán mal. Para eliminar la microaplicación, en la página Integraciones de microaplicaciones seleccione el menú situado junto a la microaplicación que quiere eliminar. Seleccione Eliminar microaplicación y confirme la operación.
Nuestra integración de SAP Concur incluye las siguientes microaplicaciones preconfiguradas de uso inmediato:
Aprobaciones: Permite aprobar informes de gastos que esté pendientes o los envía de vuelta.
| Notificación o página | Flujos de trabajo por caso de uso |
|---|---|
| Notificación de recordatorio de aprobación | Cuando un informe de gastos está pendiente de aprobación y supera un umbral definido antes de la fecha límite (por ejemplo, 3 días de forma predeterminada), el aprobador recibe un recordatorio de notificación. |
| Notificación Nueva solicitud | Cuando se asigna una nueva solicitud de aprobación a un aprobador, este recibe una notificación. |
| Notificación Nueva solicitud (modificada) | Cuando se produce un cambio en una solicitud de aprobación, el aprobador recibe una notificación. |
| Página Detalles de los gastos | Proporciona una vista de solo lectura de un gasto con detalles. |
| Página Mis aprobaciones pendientes | Proporciona una lista personalizada de las aprobaciones pendientes. |
| Página Revisar informe | Proporciona un formulario procesable con una vista detallada de un informe de gastos pendiente de aprobación. |
Gastos: Permite buscar y ver gastos.
| Notificación o página | Flujos de trabajo por caso de uso |
|---|---|
| Página Detalles de los gastos | Proporciona una vista de solo lectura de un gasto con detalles. |
| Página Mis gastos | Proporciona una lista personalizada de los gastos. |
| Página Detalles del informe | Proporciona una vista detallada de un informe de gastos con un campo para comentarios. |
Itinerarios: Permite buscar, ver y compartir itinerarios.
| Notificación o página | Flujos de trabajo por caso de uso |
|---|---|
| Notificación Nuevo itinerario reservado correctamente | Cuando el nuevo itinerario de un usuario se reserva y se hace un tíquet, el usuario recibe una notificación. |
| Notificación Nuevo itinerario compartido | Cuando un itinerario se comparte con un usuario, este recibe una notificación. |
| Página Detalles del itinerario | Proporciona una vista del itinerario de un usuario y un botón para compartir accionable. |
| Página Mis itinerarios | Proporciona una lista personalizada de los itinerarios. |
| Página Compartir itinerario | Proporciona un formulario para compartir el itinerario de un usuario. |
Informes: Permite buscar y consultar los informes de gastos enviados.
| Notificación o página | Flujos de trabajo por caso de uso |
|---|---|
| Notificación Solicitud aprobada | Cuando se aprueba el informe de gastos de un usuario, este recibe una notificación. |
| Notificación Solicitar devolución | Cuando se devuelve el informe de gastos de un usuario, este recibe una notificación. |
| Página Detalles de los gastos | Proporciona una vista de solo lectura de un gasto con detalles. |
| Página Informe de gastos | Proporciona una vista detallada de un informe de gastos con un campo para comentarios. |
| Página Mis informes de gastos pendientes | Proporciona una lista personalizada de los informes de gastos. |