> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spott.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Timesheet Portal

> Publica colocaciones de contrato desde Spott en Timesheet Portal, para que las hojas de horas, las nóminas y la facturación se gestionen allí, y consulta las hojas de horas de vuelta en la colocación.

**Timesheet Portal** es una plataforma de nóminas y facturación para agencias de selección.
Gestiona las hojas de horas, la facturación y los pagos de tus contratistas colocados.

La integración **envía una colocación de contrato de Spott a Timesheet Portal** de una sola
vez: el cliente, el contacto que aprueba las hojas de horas, el candidato, el consultor, los
detalles de la colocación y las tarifas. Nadie vuelve a escribir la colocación. Las hojas de
horas que tus contratistas presentan después en Timesheet Portal **vuelven a la colocación en
Spott**, así que ves lo que se ha trabajado sin iniciar sesión en un segundo sistema.

Con la integración puedes:

* **Conectar tu cuenta de Timesheet Portal una sola vez** para todo el espacio de trabajo.
* **Publicar una colocación de contrato** directamente desde la ficha de la colocación, y
  **actualizarla** más tarde.
* **Revisar y completar** los datos del cliente, el contacto, el candidato, el consultor, la
  colocación y las tarifas antes de enviarlos.
* **Ver las hojas de horas** de Timesheet Portal en la pestaña **Timesheets** de la colocación.

Timesheet Portal convive con [RSM InTime](https://docs.spott.io/es/docs/integrations/rsm-intime.md). Un espacio de
trabajo puede conectar los dos, y publicar una colocación en uno de ellos o en ambos.

## Conectar Timesheet Portal

Un administrador conecta Timesheet Portal una sola vez para todo el espacio de trabajo. Antes
necesitas credenciales de API de Timesheet Portal, creadas con un usuario **System
Administrator** de allí.

### Crear las credenciales de API en Timesheet Portal

1. En Timesheet Portal, ve a **Settings → Account → API**.
2. En la pestaña **Private applications**, haz clic en **+ New application**.
3. Ponle un nombre, por ejemplo *Spott*, elige un System Administrator como **API user**,
   comprueba que esté **Enabled** y haz clic en **Save**.
4. Copia el **Client ID**. Después haz clic en **Click to show secret** y copia el **Client
   secret**.

![Una aplicación privada en los ajustes de API de Timesheet Portal, con el API user, el interruptor Enabled, el Client ID y el botón Click to show secret](https://mintcdn.com/spott-docs/l6JwVI3-rQeuJzjF/images/integrations/timesheet-portal-api-application.webp?fit=max\&auto=format\&n=l6JwVI3-rQeuJzjF\&q=85\&s=a8ced29a5d5bf9e129de925fadd161d7)

### Conectar en Spott

1. Ve a **Settings → Integrations** y selecciona **Timesheet Portal**.
2. Haz clic en **Enable**. Se abre el cuadro de diálogo **Connect Timesheet Portal**.
3. Rellena:
   * **Account name**: el subdominio de tu URL de Timesheet Portal. Si inicias sesión en
     `acme.timesheetportal.com`, es `acme`. Solo letras, números y guiones.
   * **Client ID** y **Client Secret**: las credenciales que acabas de copiar.
4. Haz clic en **Connect**.

![El cuadro de diálogo Connect Timesheet Portal con los campos Account name, Client ID y Client Secret](https://mintcdn.com/spott-docs/l6JwVI3-rQeuJzjF/images/integrations/timesheet-portal-connect.webp?fit=max\&auto=format\&n=l6JwVI3-rQeuJzjF\&q=85\&s=b3fd18961f99a1bb2607867ad8f38060)

Spott comprueba las credenciales con tu cuenta y las guarda para el espacio de trabajo. La
fila **Workspace** muestra entonces **Connected**. Si los datos son incorrectos, ves "Could not
connect Timesheet Portal. Check the account name and credentials and try again."

Un espacio de trabajo conecta una sola cuenta de Timesheet Portal. Para cambiar de cuenta,
elige **Disconnect Timesheet Portal** en el menú de la fila **Workspace** y vuelve a conectar.

> [!NOTE]
>
> Solo los administradores del espacio de trabajo pueden conectar o desconectar esta
> integración. Publicar colocaciones está abierto a cualquiera que pueda editar colocaciones.

## Publicar una colocación

Solo se pueden publicar colocaciones **de contrato**, incluidas sus prórrogas. Las
colocaciones contingent y retained no tienen hojas de horas, así que la opción no aparece en
ellas.

Comprueba antes dos cosas en la colocación:

* **Tiene un tarifario.** Sin él, **Publish to Timesheet Portal** aparece en gris. Elige
  **Create rate card** en el mismo menú, consulta [configurar un tarifario](https://docs.spott.io/es/docs/placements/timesheets.md#1-configurar-un-tarifario).
* **Cada tarifa tiene un código de pago que existe en Timesheet Portal.** Los códigos están en
  Timesheet Portal en **Settings → Timesheets → Rates & Units**, por ejemplo `STD` u `OT1`.
  Elige el **Pay code** correspondiente en cada tarifa con **Edit rate card**.

### Iniciar la publicación

1. Abre la colocación de contrato.
2. Haz clic en el menú **⋮** arriba a la derecha del bloque **Placement**.
3. Elige **Publish to Timesheet Portal**.

![El menú de la colocación con Publish to Timesheet Portal debajo de Publish to RSM InTime](https://mintcdn.com/spott-docs/l6JwVI3-rQeuJzjF/images/integrations/timesheet-portal-publish-menu.webp?fit=max\&auto=format\&n=l6JwVI3-rQeuJzjF\&q=85\&s=e73d634d1c6c74744ad2e518aa5eddf3)

### Completar el formulario

El formulario tiene seis pestañas. Spott rellena todo lo que ya sabe. Recórrelas con **Review
next tab** y **Previous tab**, o haz clic en una pestaña para ir directamente a ella. Cuando un
campo obligatorio está vacío, el formulario muestra **Field is required** y te lleva a la
primera pestaña con un hueco.

| Pestaña | Qué incluye |
| - | - |
| **Company** | El cliente: nombre, número de registro mercantil, número fiscal, correo de facturación, código contable, moneda y dirección de facturación |
| **Contact** | La persona del cliente que **aprueba las hojas de horas** de esta colocación. Timesheet Portal la guarda como aprobador |
| **Candidate** | El contratista: nombre, correo, tipo de empleo, puesto, móvil, fecha de alta, fecha de nacimiento, dirección y moneda. Los datos de empresa solo hacen falta cuando el contratista factura a través de su propia empresa |
| **Consultant** | El consultor de la colocación |
| **Placement** | La descripción, la fecha de inicio, la fecha de fin u **Ongoing**, el número de orden de compra y el código de centro de coste, además de la frecuencia de las hojas de horas, la frecuencia de facturación y el estado IR35 |
| **Rates** | Las tarifas del tarifario de la colocación: nombre, código de tarifa, tarifa pagada y tarifa facturada |

Un contacto y un consultor son siempre obligatorios, igual que la descripción y la fecha de
inicio de la colocación. Para la frecuencia de las hojas de horas, la frecuencia de
facturación y el estado IR35, deja **Use the Timesheet Portal default** salvo que esta
colocación sea distinta.

La pestaña **Rates** es de solo lectura: "These rates come from the placement's rate card. Edit
the rate card to change what is published." Un tarifario puede enviar como máximo **20**
tarifas, y cada código de tarifa solo puede aparecer una vez en él.

![La pestaña Rates del formulario Publish to Timesheet Portal, con el nombre de la tarifa, el código de tarifa, la tarifa pagada y la tarifa facturada](https://mintcdn.com/spott-docs/l6JwVI3-rQeuJzjF/images/integrations/timesheet-portal-rates-tab.webp?fit=max\&auto=format\&n=l6JwVI3-rQeuJzjF\&q=85\&s=66a2f494f5500cd89dea38c40ec8ae8b)

### Registros nuevos y vinculados

La primera vez que publicas, Spott **crea** el cliente, el contacto, el candidato y el
consultor en Timesheet Portal y vincula cada uno a su registro de Spott. Las colocaciones
posteriores de las mismas personas reutilizan ese vínculo, así que no se crean dos veces.

Spott **no** hace coincidir los registros que ya existen en Timesheet Portal, ni por nombre, ni
por correo, ni de ninguna otra forma. Cada cliente, contacto, candidato y consultor que publicas
por primera vez se crea como un **registro nuevo** en Timesheet Portal, aunque la misma empresa
o persona ya esté allí. Para reutilizar un registro de Timesheet Portal que ya existe, contacta
con soporte antes de publicar.

Un registro que ya está vinculado **no se actualiza** desde Spott. Su pestaña lo indica y te
pide que lo edites en Timesheet Portal.

### Publicar

Haz clic en **Publish** en la pestaña **Rates**. Spott lo confirma con "Placement published to
Timesheet Portal", y la colocación existe en Timesheet Portal, vinculada a su cliente,
aprobador, contratista y consultor.

A partir de ahí, el menú muestra **Update in Timesheet Portal** en su lugar. Úsalo para enviar
cambios posteriores, por ejemplo tarifas nuevas. Actualiza la misma colocación en Timesheet
Portal en lugar de crear otra. La colocación en sí no muestra ninguna insignia ni enlace a
Timesheet Portal; la opción del menú es lo que te indica que se ha publicado.

## Qué pasa después

* **Las hojas de horas** se rellenan y se aprueban en Timesheet Portal. Más o menos una vez por
  hora, Spott las recoge y las muestra en la pestaña **Timesheets** de la colocación, con su
  estado: **Draft**, **Submitted**, **Approved**, **Rejected** o **Void**. Solo se pueden cambiar en Timesheet
  Portal. Spott no las marca como de solo lectura, pero rechaza cualquier cambio: al guardar
  verás un mensaje de error general.
* **La facturación** se gestiona en Timesheet Portal. Las hojas de horas que vienen de
  Timesheet Portal no se pueden facturar desde Spott, así que las mismas horas nunca se
  facturan dos veces. Las facturas que creas en Timesheet Portal no aparecen en Spott.

## Solución de problemas

| Mensaje | Qué hacer |
| - | - |
| **The Rate Code … could not be found** | Un código de pago del tarifario no existe en Timesheet Portal. Revisa allí **Settings → Timesheets → Rates & Units**, corrige el código con **Edit rate card** y vuelve a publicar |
| **This placement needs a rate card before it can be published to Timesheet Portal** | Crea primero un tarifario en la colocación |
| **The rate card uses the code … more than once** | Dale a cada línea de tarifa su propio código |
| **The rate card has … rates, but Timesheet Portal accepts at most 20** | Quita tarifas hasta que queden 20 o menos |
| **The … linked to Timesheet Portal no longer exists there** | El registro vinculado se eliminó en Timesheet Portal. Contacta con soporte para quitar o sustituir el vínculo |
| **That Timesheet Portal … is already linked to another Spott record** | Dos registros de Spott apuntan al mismo registro de Timesheet Portal. Contacta con soporte para corregir el vínculo |
| **Timesheet Portal rejected the stored connection** | Las credenciales guardadas ya no funcionan. Desconecta y vuelve a conectar con credenciales nuevas |
| **Timesheet Portal is temporarily unavailable** o **is rate limiting requests** | Espera un momento y vuelve a intentarlo |
| **Another Timesheet Portal publish is already in progress** | Alguien está publicando al mismo tiempo. Vuelve a intentarlo cuando termine |

## Preguntas frecuentes

* **¿Quién puede conectar la integración?** Un administrador del espacio de trabajo, desde
  **Settings → Integrations**.
* **¿Cuál es mi account name?** El subdominio de tu URL de Timesheet Portal: `acme` para
  `acme.timesheetportal.com`.
* **¿Por qué Publish to Timesheet Portal aparece en gris?** La colocación aún no tiene un
  tarifario.
* **¿Por qué no aparece Publish to Timesheet Portal en absoluto?** La colocación no es de
  contrato, o Timesheet Portal no está conectado en el espacio de trabajo.
* **¿Tengo que publicar cada colocación?** Sí. Solo se envían las colocaciones que publicas.
  Nada llega a Timesheet Portal de forma automática.
* **¿Puedo facturar desde Spott las hojas de horas de Timesheet Portal?** No. Factúralas en
  Timesheet Portal, lo que evita que las mismas horas se facturen dos veces.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.