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

# Imposta le organizzazioni di fatturazione degli utenti

> Imposta l'organizzazione di fatturazione per un massimo di 100 utenti.

Vengono modificati solo gli utenti indicati nella richiesta. Le assegnazioni valide vengono salvate insieme anche
se altre non sono valide, quindi una risposta `200` può includere errori: verifica sempre `failed`.
Una risposta di errore indica che non è stato salvato nulla. Il reinvio di un'assegnazione sovrascrive
l'organizzazione di fatturazione attuale dell'utente e aggiunge una nuova voce al registro di audit.

Imposta l'[organizzazione di fatturazione](https://docs.devinenterprise.com/it/admin/billing/org-acu-limits#billing-organization-attribution) per un massimo di 100 utenti con un'unica richiesta. Vengono modificati solo gli utenti inviati, mentre il resto dell'azienda rimane invariato. Per aggiornare un solo utente alla volta, puoi usare anche l'[endpoint delle impostazioni utente](https://docs.devinenterprise.com/it/admin/billing/legacy-user-acu-limits#user-endpoints), in beta, che accetta `billing_org_id`.

## Esito parziale

Le assegnazioni valide vengono salvate comunque, anche se altre righe della stessa richiesta non sono valide: una risposta `200` può quindi contenere errori. Controlla sempre `failed`: ogni voce indica l'utente, l'organizzazione richiesta e un `reason`. Per questi utenti l'organizzazione di fatturazione non è stata modificata; correggi le righe e inviale di nuovo.

| `reason` | Significato |
| - | - |
| `user_not_found` | L'utente non è membro dell'azienda, né direttamente né tramite un gruppo del provider di identità. |
| `org_not_found` | L'organizzazione non appartiene all'azienda. |
| `user_not_org_member` | L'organizzazione non è l'organizzazione principale dell'azienda e l'utente non ne è membro. |

In futuro potrebbero essere aggiunti nuovi motivi: tratta quindi i valori sconosciuti come un'assegnazione non riuscita e non come un errore della richiesta.

Una risposta di errore (`4xx` o `5xx`) indica che nessun elemento della richiesta è stato salvato. Le richieste senza assegnazioni, con più di 100 assegnazioni o con lo stesso `user_id` ripetuto più volte vengono rifiutate con `422`.

Inviare di nuovo un'assegnazione sovrascrive l'organizzazione di fatturazione attuale dell'utente e aggiunge un'ulteriore voce al registro di audit: le chiamate ripetute sono quindi sicure, ma non prive di effetti.

## Autorizzazioni

Richiede un [utente di servizio](https://docs.devinenterprise.com/it/api-reference/v3/service-users/members-service-users.md) o un [token di accesso personale](https://docs.devinenterprise.com/it/api-reference/personal-access-tokens.md) con entrambe le autorizzazioni `ManageBilling` e `ViewOrganizations` a livello aziendale. Anche `ManageOrganizations` soddisfa il requisito di `ViewOrganizations`, poiché lo include.


## OpenAPI

````yaml it/v3-openapi.yaml PUT /v3/enterprise/members/users/billing-orgs
openapi: 3.1.0
info:
  description: API Devin v3 con autenticazione utente di servizio 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: Imposta le organizzazioni di fatturazione degli utenti
      description: >-
        Imposta l'organizzazione di fatturazione per un massimo di 100 utenti.


        Vengono modificati solo gli utenti indicati nella richiesta. Le
        assegnazioni valide vengono salvate insieme anche

        se altre non sono valide, quindi una risposta `200` può includere
        errori: verifica sempre `failed`.

        Una risposta di errore indica che non è stato salvato nulla. Il reinvio
        di un'assegnazione sovrascrive

        l'organizzazione di fatturazione attuale dell'utente e aggiunge una
        nuova voce al registro di audit.
      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: Risposta riuscita
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Non autorizzato
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Vietato
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Non trovato
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Conflitto
        '410':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Non più disponibile
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Contenuto non elaborabile
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Troppe Richieste
components:
  schemas:
    UserBillingOrgsUpdateRequest:
      properties:
        assignments:
          description: >-
            Organizzazione di fatturazione da impostare per ciascun utente. Un
            utente può comparire una sola volta.
          items:
            $ref: '#/components/schemas/UserBillingOrgAssignmentRequest'
          maxItems: 100
          minItems: 1
          title: Assignments
          type: array
      required:
        - assignments
      title: UserBillingOrgsUpdateRequest
      type: object
    UserBillingOrgsUpdateResponse:
      properties:
        assigned:
          description: Assegnazioni applicate.
          items:
            $ref: '#/components/schemas/UserBillingOrgAssignmentResponse'
          title: Assigned
          type: array
        failed:
          description: >-
            Assegnazioni saltate, con il relativo motivo. Le organizzazioni di
            fatturazione di questi utenti non sono cambiate.
          items:
            $ref: '#/components/schemas/UserBillingOrgFailureResponse'
          title: Failed
          type: array
      required:
        - assigned
        - failed
      title: UserBillingOrgsUpdateResponse
      type: object
    ProblemDetail:
      description: >-
        Corpo dell'errore application/problem+json RFC 9457 per l'API v3.


        detail è mantenuto dal corpo legacy {"detail": ...} per
        retrocompatibilità; gli

        altri membri sono aggiuntivi. errors contiene gli errori di validazione
        a livello di campo

        (solo 422).
      properties:
        detail:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Una spiegazione leggibile dall'utente, specifica per questa
            occorrenza.
          title: Detail
        error_code:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Codice elaborabile automaticamente che indica il rifiuto di
            un'azione bloccata (ad es. "user_frozen", "migrated_session").
          title: Error Code
        errors:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          description: Errori di convalida a livello di campo (solo per le risposte 422).
          title: Errors
        instance:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Un riferimento URI (il percorso della richiesta) per questa
            occorrenza.
          title: Instance
        status:
          description: Il codice di stato HTTP.
          title: Status
          type: integer
        title:
          description: Un breve riepilogo del tipo di problema, leggibile dall'utente.
          title: Title
          type: string
        type:
          default: about:blank
          description: Un riferimento URI che identifica il tipo di problema.
          title: Type
          type: string
      required:
        - title
        - status
      title: ProblemDetail
      type: object
    UserBillingOrgAssignmentRequest:
      properties:
        billing_org_id:
          description: >-
            Organizzazione a cui addebitare l'utilizzo di Devin Desktop e della
            CLI da parte dell'utente.
          title: Billing Org Id
          type: string
        user_id:
          description: ID dell'utente dell'azienda.
          title: User Id
          type: string
      required:
        - user_id
        - billing_org_id
      title: UserBillingOrgAssignmentRequest
      type: object
    UserBillingOrgAssignmentResponse:
      properties:
        billing_org_id:
          description: >-
            Organizzazione a cui viene ora addebitato l'utilizzo di Devin
            Desktop e della CLI da parte dell'utente.
          title: Billing Org Id
          type: string
        user_id:
          description: ID dell'utente dell'azienda.
          title: User Id
          type: string
      required:
        - user_id
        - billing_org_id
      title: UserBillingOrgAssignmentResponse
      type: object
    UserBillingOrgFailureResponse:
      properties:
        billing_org_id:
          description: ID dell'organizzazione di fatturazione richiesta.
          title: Billing Org Id
          type: string
        reason:
          $ref: '#/components/schemas/UserBillingOrgFailureReason'
          description: >-
            Motivo per cui l'assegnazione è stata saltata. Se l'organizzazione è
            diversa da quella principale dell'azienda, l'utente deve esserne
            membro. Potrebbero essere aggiunti nuovi motivi, pertanto occorre
            gestire i valori sconosciuti.
        user_id:
          description: ID dell'utente che non è stato aggiornato.
          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: 'Credenziale dell''utente del servizio (prefisso: cog_)'
      scheme: bearer
      type: http

````

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