> ## 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.

# Definir organizações de faturamento dos usuários

> Definir a organização de faturamento de até 100 usuários.

Apenas os usuários informados na requisição são alterados. As atribuições válidas são salvas em conjunto mesmo
que outras sejam inválidas; por isso, uma resposta `200` pode incluir falhas: sempre verifique `failed`.
Uma resposta de erro significa que nada foi salvo. Reenviar uma atribuição substitui
a organização de faturamento atual do usuário e adiciona outra entrada ao registro de auditoria.

Define a [organização de faturamento](https://docs.devinenterprise.com/pt-BR/admin/billing/org-acu-limits#billing-organization-attribution) de até 100 usuários em uma única requisição. Somente os usuários enviados são alterados; o restante da empresa não é afetado. Para atualizar um usuário por vez, o [endpoint de configurações de usuário](https://docs.devinenterprise.com/pt-BR/admin/billing/legacy-user-acu-limits#user-endpoints), em beta, também aceita `billing_org_id`.

## Sucesso parcial

As atribuições válidas são salvas em conjunto mesmo quando outras linhas da mesma requisição são inválidas, portanto uma resposta `200` pode incluir falhas. Sempre verifique `failed`: cada entrada identifica o usuário, a organização solicitada e um `reason`. As organizações de faturamento desses usuários não foram alteradas; corrija as linhas e envie-as novamente.

| `reason` | Significado |
| - | - |
| `user_not_found` | O usuário não é membro da empresa, nem diretamente nem por meio de um grupo do provedor de identidade. |
| `org_not_found` | A organização não pertence à empresa. |
| `user_not_org_member` | A organização não é a organização principal da empresa e o usuário não é membro dela. |

Novos motivos podem ser adicionados com o tempo, portanto trate valores desconhecidos como uma falha, e não como um erro.

Uma resposta de erro (`4xx` ou `5xx`) significa que nada da requisição foi salvo. Requisições sem atribuições, com mais de 100 atribuições ou com o mesmo `user_id` repetido são rejeitadas com `422`.

Reenviar uma atribuição sobrescreve a organização de faturamento atual do usuário e grava outra entrada no registro de auditoria; por isso, chamadas repetidas são seguras, mas não deixam de ter efeitos.

## Permissões

Requer um [usuário de serviço](https://docs.devinenterprise.com/pt-BR/api-reference/v3/service-users/members-service-users.md) ou um [token de acesso pessoal](https://docs.devinenterprise.com/pt-BR/api-reference/personal-access-tokens.md) com as permissões `ManageBilling` e `ViewOrganizations` no nível empresarial. A permissão `ManageOrganizations` também atende ao requisito de `ViewOrganizations`, pois já a inclui.


## OpenAPI

````yaml pt-BR/v3-openapi.yaml PUT /v3/enterprise/members/users/billing-orgs
openapi: 3.1.0
info:
  description: API Devin v3 com autenticação de usuário de serviço e 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: Definir organizações de faturamento dos usuários
      description: >-
        Definir a organização de faturamento de até 100 usuários.


        Apenas os usuários informados na requisição são alterados. As
        atribuições válidas são salvas em conjunto mesmo

        que outras sejam inválidas; por isso, uma resposta `200` pode incluir
        falhas: sempre verifique `failed`.

        Uma resposta de erro significa que nada foi salvo. Reenviar uma
        atribuição substitui

        a organização de faturamento atual do usuário e adiciona outra entrada
        ao registro de auditoria.
      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: Resposta Bem-Sucedida
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Não autorizado
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Proibido
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Não Encontrado
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Conflito
        '410':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Removido
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Conteúdo Não Processável
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Excesso de requisições
components:
  schemas:
    UserBillingOrgsUpdateRequest:
      properties:
        assignments:
          description: >-
            Organização de faturamento a definir para cada usuário. Cada usuário
            só pode aparecer uma vez.
          items:
            $ref: '#/components/schemas/UserBillingOrgAssignmentRequest'
          maxItems: 100
          minItems: 1
          title: Assignments
          type: array
      required:
        - assignments
      title: UserBillingOrgsUpdateRequest
      type: object
    UserBillingOrgsUpdateResponse:
      properties:
        assigned:
          description: Atribuições que foram aplicadas.
          items:
            $ref: '#/components/schemas/UserBillingOrgAssignmentResponse'
          title: Assigned
          type: array
        failed:
          description: >-
            Atribuições que foram ignoradas, com o respectivo motivo. As
            organizações de faturamento desses usuários não foram alteradas.
          items:
            $ref: '#/components/schemas/UserBillingOrgFailureResponse'
          title: Failed
          type: array
      required:
        - assigned
        - failed
      title: UserBillingOrgsUpdateResponse
      type: object
    ProblemDetail:
      description: >-
        Corpo de erro RFC 9457 application/problem+json da API v3.


        detail é mantido do corpo legado {"detail": ...} por
        retrocompatibilidade; os

        outros membros são aditivos. errors contém falhas de validação em nível
        de campo

        (apenas 422).
      properties:
        detail:
          anyOf:
            - type: string
            - type: 'null'
          description: Uma explicação legível por humanos específica para esta ocorrência.
          title: Detail
        error_code:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Código legível por máquina para recusas de ações bloqueadas (por
            exemplo, "user_frozen", "migrated_session").
          title: Error Code
        errors:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          description: Erros de validação no nível do campo (apenas respostas 422).
          title: Errors
        instance:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Uma referência de URI (o caminho da requisição) para esta
            ocorrência.
          title: Instance
        status:
          description: O código de status HTTP.
          title: Status
          type: integer
        title:
          description: Um breve resumo do tipo de problema, legível para humanos.
          title: Title
          type: string
        type:
          default: about:blank
          description: Uma referência de URI que identifica o tipo de problema.
          title: Type
          type: string
      required:
        - title
        - status
      title: ProblemDetail
      type: object
    UserBillingOrgAssignmentRequest:
      properties:
        billing_org_id:
          description: >-
            Organização responsável pelo pagamento do uso do Devin Desktop e da
            CLI pelo usuário.
          title: Billing Org Id
          type: string
        user_id:
          description: ID do usuário da empresa.
          title: User Id
          type: string
      required:
        - user_id
        - billing_org_id
      title: UserBillingOrgAssignmentRequest
      type: object
    UserBillingOrgAssignmentResponse:
      properties:
        billing_org_id:
          description: >-
            Organização que passa a ser responsável pelo pagamento do uso do
            Devin Desktop e da CLI pelo usuário.
          title: Billing Org Id
          type: string
        user_id:
          description: ID do usuário da empresa.
          title: User Id
          type: string
      required:
        - user_id
        - billing_org_id
      title: UserBillingOrgAssignmentResponse
      type: object
    UserBillingOrgFailureResponse:
      properties:
        billing_org_id:
          description: ID da organização de faturamento solicitada.
          title: Billing Org Id
          type: string
        reason:
          $ref: '#/components/schemas/UserBillingOrgFailureReason'
          description: >-
            Motivo pelo qual a atribuição foi ignorada. Para atribuir uma
            organização diferente da organização principal da empresa, o usuário
            deve ser membro dela. Novos motivos podem ser adicionados, portanto,
            trate valores desconhecidos.
        user_id:
          description: ID do usuário que não foi atualizado.
          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 usuário de serviço (prefixo: cog_)'
      scheme: bearer
      type: http

````

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