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

# Establecer las organizaciones de facturación de los usuarios

> Establecer la organización de facturación de hasta 100 usuarios.

Solo se modifican los usuarios incluidos en la solicitud. Las asignaciones válidas se guardan juntas aunque
otras no sean válidas, por lo que una respuesta `200` puede incluir fallos: compruebe siempre `failed`.
Una respuesta de error significa que no se ha guardado nada. Reenviar una asignación sobrescribe
la organización de facturación actual del usuario y añade otra entrada al registro de auditoría.

Establece la [organización de facturación](https://docs.devinenterprise.com/es/admin/billing/org-acu-limits#billing-organization-attribution) de hasta 100 usuarios en una sola solicitud. Solo se modifican los usuarios que envíes; el resto de la empresa no se ve afectado. Para actualizar los usuarios de uno en uno, el [endpoint de configuración de usuario](https://docs.devinenterprise.com/es/admin/billing/legacy-user-acu-limits#user-endpoints), en beta, también acepta `billing_org_id`.

## Éxito parcial

Las asignaciones válidas se guardan en conjunto aunque otras filas de la misma solicitud no sean válidas, por lo que una respuesta `200` puede incluir fallos. Revisa siempre `failed`: cada entrada indica el usuario, la organización solicitada y un `reason`. La organización de facturación de esos usuarios no cambió; corrige las filas y vuelve a enviarlas.

| `reason` | Significado |
| - | - |
| `user_not_found` | El usuario no es miembro de la empresa, ni directamente ni a través de un grupo del proveedor de identidad. |
| `org_not_found` | La organización no pertenece a la empresa. |
| `user_not_org_member` | La organización no es la organización principal de la empresa y el usuario no es miembro de ella. |

Es posible que se agreguen nuevos motivos con el tiempo, así que trata los valores desconocidos como un fallo y no como un error.

Una respuesta de error (`4xx` o `5xx`) significa que no se guardó nada de la solicitud. Las solicitudes sin asignaciones, con más de 100 asignaciones o con el mismo `user_id` repetido se rechazan con `422`.

Volver a enviar una asignación sobrescribe la organización de facturación actual del usuario y agrega otra entrada al registro de auditoría, por lo que repetir las llamadas es seguro, pero no gratuito.

## Permisos

Requiere un [usuario de servicio](https://docs.devinenterprise.com/es/api-reference/v3/service-users/members-service-users.md) o un [token de acceso personal](https://docs.devinenterprise.com/es/api-reference/personal-access-tokens.md) con los permisos `ManageBilling` y `ViewOrganizations` a nivel empresarial. `ManageOrganizations` también cumple el requisito de `ViewOrganizations`, ya que lo incluye.


## OpenAPI

````yaml es/v3-openapi.yaml PUT /v3/enterprise/members/users/billing-orgs
openapi: 3.1.0
info:
  description: API de Devin v3 con autenticación mediante usuario de servicio y RBAC
  title: Devin API v3
  version: 3.0.0
servers: []
security:
  - bearerAuth: []
paths:
  /v3/enterprise/members/users/billing-orgs:
    put:
      tags:
        - user-billing-orgs
      summary: Establecer las organizaciones de facturación de los usuarios
      description: >-
        Establecer la organización de facturación de hasta 100 usuarios.


        Solo se modifican los usuarios incluidos en la solicitud. Las
        asignaciones válidas se guardan juntas aunque

        otras no sean válidas, por lo que una respuesta `200` puede incluir
        fallos: compruebe siempre `failed`.

        Una respuesta de error significa que no se ha guardado nada. Reenviar
        una asignación sobrescribe

        la organización de facturación actual del usuario y añade otra entrada
        al registro de auditoría.
      operationId: >-
        handle_update_user_billing_orgs_v3_enterprise_members_users_billing_orgs_put
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserBillingOrgsUpdateRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserBillingOrgsUpdateResponse'
          description: Respuesta satisfactoria
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: No autorizado
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Prohibido
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: No Encontrado
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Conflicto
        '410':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Ya no disponible
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Contenido no procesable
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Demasiadas solicitudes
components:
  schemas:
    UserBillingOrgsUpdateRequest:
      properties:
        assignments:
          description: >-
            Organización de facturación que se establecerá para cada usuario.
            Cada usuario solo puede aparecer una vez.
          items:
            $ref: '#/components/schemas/UserBillingOrgAssignmentRequest'
          maxItems: 100
          minItems: 1
          title: Assignments
          type: array
      required:
        - assignments
      title: UserBillingOrgsUpdateRequest
      type: object
    UserBillingOrgsUpdateResponse:
      properties:
        assigned:
          description: Asignaciones aplicadas.
          items:
            $ref: '#/components/schemas/UserBillingOrgAssignmentResponse'
          title: Assigned
          type: array
        failed:
          description: >-
            Asignaciones omitidas, con sus motivos. Las organizaciones de
            facturación de estos usuarios no cambiaron.
          items:
            $ref: '#/components/schemas/UserBillingOrgFailureResponse'
          title: Failed
          type: array
      required:
        - assigned
        - failed
      title: UserBillingOrgsUpdateResponse
      type: object
    ProblemDetail:
      description: >-
        Cuerpo de error RFC 9457 application/problem+json para la API v3.


        detail se conserva del cuerpo heredado {"detail": ...} por
        compatibilidad con versiones anteriores; los

        otros miembros son adicionales. errors contiene errores de validación

        a nivel de campo (solo 422).
      properties:
        detail:
          anyOf:
            - type: string
            - type: 'null'
          description: Explicación legible para humanos específica de esta ocurrencia.
          title: Detail
        error_code:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Código legible por máquina que indica el rechazo de una acción
            bloqueada (p. ej., "user_frozen", "migrated_session").
          title: Error Code
        errors:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          description: Errores de validación por campo (solo en respuestas 422).
          title: Errors
        instance:
          anyOf:
            - type: string
            - type: 'null'
          description: Una referencia URI (la ruta de la solicitud) para esta ocurrencia.
          title: Instance
        status:
          description: El código de estado HTTP.
          title: Status
          type: integer
        title:
          description: Un breve resumen del tipo de problema, legible para humanos.
          title: Title
          type: string
        type:
          default: about:blank
          description: Una referencia URI que identifica el tipo de problema.
          title: Type
          type: string
      required:
        - title
        - status
      title: ProblemDetail
      type: object
    UserBillingOrgAssignmentRequest:
      properties:
        billing_org_id:
          description: >-
            Organización a la que se facturará el consumo del usuario en Devin
            Desktop y la CLI.
          title: Billing Org Id
          type: string
        user_id:
          description: ID del usuario de la empresa.
          title: User Id
          type: string
      required:
        - user_id
        - billing_org_id
      title: UserBillingOrgAssignmentRequest
      type: object
    UserBillingOrgAssignmentResponse:
      properties:
        billing_org_id:
          description: >-
            Organización a la que se factura ahora el consumo del usuario en
            Devin Desktop y la CLI.
          title: Billing Org Id
          type: string
        user_id:
          description: ID del usuario de la empresa.
          title: User Id
          type: string
      required:
        - user_id
        - billing_org_id
      title: UserBillingOrgAssignmentResponse
      type: object
    UserBillingOrgFailureResponse:
      properties:
        billing_org_id:
          description: ID de la organización de facturación solicitada.
          title: Billing Org Id
          type: string
        reason:
          $ref: '#/components/schemas/UserBillingOrgFailureReason'
          description: >-
            Motivo por el que se omitió la asignación. Si la organización no es
            la principal de la empresa, el usuario debe ser miembro de ella.
            Pueden añadirse nuevos motivos, por lo que se deben gestionar los
            valores desconocidos.
        user_id:
          description: ID del usuario que no se actualizó.
          title: User Id
          type: string
      required:
        - user_id
        - billing_org_id
        - reason
      title: UserBillingOrgFailureResponse
      type: object
    UserBillingOrgFailureReason:
      enum:
        - user_not_found
        - org_not_found
        - user_not_org_member
      title: UserBillingOrgFailureReason
      type: string
  securitySchemes:
    bearerAuth:
      description: 'Credencial de usuario de servicio (prefijo: cog_)'
      scheme: bearer
      type: http

````

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