> ## Documentation Index > Fetch the complete documentation index at: https://docs.pruff.com/llms.txt > Use this file to discover all available pages before exploring further. # Asociar usuario a cliente > Agrega un cliente a la cartera de un usuario de tu empresa en Pruff, a partir del email del usuario y el RUT del cliente. El usuario debe existir en tu cuenta de Pruff y el cliente debe haber sido enrolado alguna vez en tu empresa (`hasBeenEnrolled: true` en `GET /datahub/isEnrolled/{identifier}`); no se exige que esté activo ni que no esté pausado. Envía `businessIdentifier` y `email` como texto (`string`). Si el usuario y el cliente no tenían una asociación, se crea. Si existía pero estaba inactiva, se reactiva. En ambos casos responde `200` con `User associated successfully`. Si ya existía una asociación activa, no se modifica nada y responde `200` con `User already associated with this business`. ## OpenAPI ````yaml openapi/clients.yaml POST /datahub/associateUser openapi: 3.1.0 info: title: API de clientes de Pruff version: '1' description: >- Endpoints que tus sistemas llaman para leer y operar los datos de tu empresa en Pruff. Todas las solicitudes van por HTTPS y se autentican con el header `x-api-key`. Las convenciones de formato, paginación y errores se describen en https://docs.pruff.com/api/introduccion. servers: - url: https://api.pruff.com/api/clients security: - ApiKeyAuth: [] tags: - name: Facturas description: Consulta de facturas electrónicas, facturas transables y cesiones. - name: Documentos description: Consulta y creación de documentos asociados a tus clientes. - name: Archivos description: Carga de archivos a operaciones y a los requerimientos de tus documentos. - name: Financiamiento description: >- Simula créditos, crea solicitudes de factoring y consulta las prórrogas de tu empresa. - name: Comité description: >- Consulta las aprobaciones de una solicitud en los comités de riesgo y de operaciones, y registra nuevas firmas. - name: Chat description: Exporta y envía mensajes del chat de una solicitud. - name: Reportes description: >- Reportes de operaciones, cartera, recaudaciones, cuentas pendientes y flujos de tu empresa. - name: Datahub description: >- Consulta de la información tributaria, financiera y de riesgo que Pruff tiene de tus clientes y deudores. - name: Mercado Público description: >- Licitaciones y órdenes de compra de Mercado Público (ChileCompra) cargadas en Pruff. - name: CRM description: >- Datos comerciales de tu CRM en Pruff: empresas con su ficha, pipeline, prospectos, gestiones y simulaciones. - name: SGR description: Operaciones SGR (garantías) de tu empresa. - name: Sincronizador description: >- Pide sincronizar a un cliente con el SII o la TGR para obtener su información más actualizada, y consulta el estado de esas sincronizaciones. - name: Usuarios description: >- Administra los usuarios de tu empresa en Pruff (crear, editar, eliminar, consultar su perfil y asignar subordinados) y consulta las cuentas (empresas conectadas) a las que cada usuario tiene acceso. - name: Contactos description: Crea contactos asociados a las empresas de tu cartera. paths: /datahub/associateUser: post: tags: - Datahub summary: Asociar usuario a cliente description: >- Agrega un cliente a la cartera de un usuario de tu empresa en Pruff, a partir del email del usuario y el RUT del cliente. El usuario debe existir en tu cuenta de Pruff y el cliente debe haber sido enrolado alguna vez en tu empresa (`hasBeenEnrolled: true` en `GET /datahub/isEnrolled/{identifier}`); no se exige que esté activo ni que no esté pausado. Envía `businessIdentifier` y `email` como texto (`string`). Si el usuario y el cliente no tenían una asociación, se crea. Si existía pero estaba inactiva, se reactiva. En ambos casos responde `200` con `User associated successfully`. Si ya existía una asociación activa, no se modifica nada y responde `200` con `User already associated with this business`. operationId: associateDatahubUser requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/DatahubAssociateUserBody' example: businessIdentifier: 11111111-1 email: ana.perez@example.com responses: '200': description: >- Usuario asociado (la asociación se creó, o existía inactiva y se reactivó), o ya existía una asociación activa entre el usuario y el cliente. content: application/json: schema: $ref: '#/components/schemas/DatahubMessage' examples: associated: summary: Usuario asociado value: message: User associated successfully alreadyAssociated: summary: Ya existía una asociación activa value: message: User already associated with this business '400': description: >- `businessIdentifier` o `email` faltan, no son texto o vienen vacíos. Es el formato estándar de validación: `data.errors` lista cada campo con su `path`. content: application/json: schema: $ref: '#/components/schemas/ValidationError' examples: missingBusinessIdentifier: summary: Falta businessIdentifier value: message: invalid_type displayMessage: El identificador del negocio es requerido data: errors: - path: businessIdentifier message: El identificador del negocio es requerido code: invalid_type missingEmail: summary: Falta email, o no es texto value: message: invalid_type displayMessage: El email es requerido data: errors: - path: email message: El email es requerido code: invalid_type '401': $ref: '#/components/responses/Unauthorized' '404': description: >- No se encontró el usuario o el cliente, o el cliente nunca fue enrolado en tu empresa. content: application/json: schema: $ref: '#/components/schemas/Error' examples: userNotFound: summary: Usuario no encontrado value: message: User not found businessNotFound: summary: Cliente no encontrado value: message: Business not found businessNotEnrolled: summary: Cliente no enrolado value: message: Business not enrolled '429': description: >- Superaste el límite general de la API de clientes: **500 solicitudes por minuto por empresa** (todas las API keys de tu empresa suman en el mismo contador). El body y el header `Retry-After` indican cuándo puedes reintentar. headers: Retry-After: description: Segundos que debes esperar antes de reintentar. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/DatahubRateLimitError' example: message: >- Rate limit exceeded: 501 requests in the current 60s window, limit is 500. Retry in 25s. displayMessage: >- Superaste el límite de 500 solicitudes cada 60 segundos. Vuelve a intentarlo en 25 segundos. data: code: RATE_LIMIT_EXCEEDED scope: All API keys of your company share this budget. limit: 500 used: 501 windowSeconds: 60 retryAfterSeconds: 25 resetAt: '2026-03-10T15:00:25.000Z' hint: >- Wait until resetAt (or honor the Retry-After header) before retrying. Avoid repeating identical requests: reuse responses you already fetched, use filters and larger pageSize values instead of one request per item, and cap your client concurrency. '500': $ref: '#/components/responses/InternalError' '504': $ref: '#/components/responses/Timeout' components: schemas: DatahubAssociateUserBody: type: object required: - businessIdentifier - email properties: businessIdentifier: type: string example: 11111111-1 description: >- RUT del cliente, sin puntos y con guion. Debe ser un texto no vacío. El cliente debe haber sido enrolado alguna vez en tu empresa. email: type: string format: email example: ana.perez@example.com description: >- Email del usuario de Pruff al que quieres asociar el cliente. Debe ser un texto no vacío. DatahubMessage: type: object required: - message properties: message: type: string description: Resultado de la operación. ValidationError: type: object required: - message - displayMessage - data description: Error de validación del body, de los query params o de los path params. properties: message: type: string description: >- Código del primer error de validación (por ejemplo `custom`, `invalid_type`, `invalid_format`, `invalid_value`, `invalid_union`). displayMessage: type: string description: >- Mensaje del primer error de validación, pensado para mostrarlo a una persona. Normalmente en español; algunos mensajes de validación vienen en inglés. data: type: object required: - errors properties: errors: type: array description: Todos los errores de validación encontrados. items: type: object required: - path - message - code properties: path: type: string description: >- Campo con el error. Para listas incluye la posición, por ejemplo `types.0`. `(root)` si el error es del body completo. message: type: string description: Descripción del error en español. code: type: string description: Código del tipo de error. Error: type: object required: - message properties: message: type: string description: >- Identifica el error. En algunos casos es un texto en inglés con valores variables. Para tu lógica, usa el código HTTP y, cuando exista, `data.code`. displayMessage: type: string description: >- Mensaje pensado para mostrarlo a una persona. Normalmente en español; algunos mensajes de validación vienen en inglés. data: description: Detalle adicional del error, cuando existe. DatahubRateLimitError: type: object required: - message - displayMessage - data description: Respuesta cuando superas el límite de solicitudes. properties: message: type: string description: Detalle del límite superado, en inglés. displayMessage: type: string description: >- Mensaje pensado para mostrarlo a una persona. Normalmente en español; algunos mensajes de validación vienen en inglés. data: type: object properties: code: type: string enum: - RATE_LIMIT_EXCEEDED description: Código estable del error. scope: type: string description: A quién aplica el límite. limit: type: integer description: Máximo de solicitudes permitidas en la ventana. used: type: integer description: Solicitudes contadas en la ventana actual. windowSeconds: type: integer description: Duración de la ventana, en segundos. retryAfterSeconds: type: integer description: Segundos que debes esperar antes de reintentar. resetAt: type: - string - 'null' format: date-time description: >- Instante (ISO 8601, UTC) en que se reinicia el contador. Puede ser `null`. hint: type: string description: Recomendación para evitar el límite. responses: Unauthorized: description: >- Falta el header `x-api-key`, su valor no es válido o la cuenta de API de tu empresa no está habilitada. content: application/json: schema: type: object required: - message properties: message: type: string example: message: 'Unauthorized: Invalid API Key' InternalError: description: >- Error inesperado en Pruff. El texto de `message` puede variar (por ejemplo en mayúsculas); no dependas de él. content: application/json: schema: $ref: '#/components/schemas/Error' example: message: Internal server error Timeout: description: >- La solicitud superó el tiempo máximo de 55 segundos. La operación puede haberse completado igual: antes de reintentar una solicitud que crea o modifica datos, verifica su estado. content: application/json: schema: $ref: '#/components/schemas/Error' example: message: request_timeout displayMessage: La solicitud excedió el tiempo máximo permitido securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: API key que Pruff entrega a tu empresa. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.