# Immatriculations fiscales

Comment permettre aux comptes connectés de gérer leurs immatriculations fiscales pour Stripe Tax.

Le composant des immatriculations fiscales permet à vos comptes connectés de contrôler leur conformité fiscale. Vos comptes connectés interagissent avec ce composant en gérant leurs immatriculations fiscales directement dans votre plateforme. Ce composant est adapté aux [plateformes logicielles](https://docs.stripe.com/tax/tax-for-platforms.md), ce qui signifie que vos comptes connectés sont susceptibles de collecter des taxes.

Si vous êtes une plateforme intégrant Stripe Tax, vous devez collecter des informations sur les [immatriculations auprès des autorités fiscales](https://docs.stripe.com/tax/registering.md) de vos comptes connectés dans les juridictions applicables. Vos comptes connectés doivent s’immatriculer auprès de leurs autorités fiscales avant d’ajouter leurs immatriculations fiscales dans votre plateforme. Pour calculer et collecter correctement les taxes pour votre plateforme, vous devez collecter les immatriculations fiscales de vos comptes connectés.

Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production.

Le composant des immatriculations fiscales utilise l’[API Tax Registrations](https://docs.stripe.com/tax/registrations-api.md) pour afficher la liste des immatriculations fiscales de vos comptes connectés. Pour calculer la taxe sur leurs paiements dans un lieu donné, les comptes connectés doivent ajouter leur immatriculation fiscale avec le composant des immatriculations fiscales. Si le compte connecté souhaite mettre fin au calcul des taxes dans un lieu donné, il peut supprimer l’immatriculation fiscale dans le composant.

## Exigences

- Votre intégration doit suivre le [guide des plateformes logicielles](https://docs.stripe.com/tax/tax-for-platforms.md) pour [Tax sur Connect](https://docs.stripe.com/tax/connect.md). Cela signifie que vos comptes connectés sont susceptibles de collecter des taxes.
- Si vous ne l’avez pas encore fait, affichez le [composant de paramètres fiscaux](https://docs.stripe.com/connect/supported-embedded-components/tax-settings.md). Vous avez besoin à la fois du composant de paramètres fiscaux et du composant des immatriculations fiscales pour assurer le contrôle de la conformité fiscale de vos comptes connectés.

## Intégrer le composant des immatriculations fiscales

Lorsque vous [créez une session de compte](https://docs.stripe.com/api/account_sessions/create.md), activez les immatriculations fiscales en indiquant `tax_registrations` dans le paramètre `components`.

```curl
curl https://api.stripe.com/v1/account_sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "account={{CONNECTEDACCOUNT_ID}}" \
  -d "components[tax_registrations][enabled]=true"
```

Après avoir créé la session de compte et [initialisé ConnectJS](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), vous pouvez générer le rendu du composant des immatriculations fiscales dans le front-end&nbsp;:

#### React

```jsx
// Include this React component
import {
  ConnectTaxRegistrations,
  ConnectComponentsProvider,
} from "@stripe/react-connect-js";

return (
  <ConnectComponentsProvider connectInstance={stripeConnectInstance}>
    <div>
      <h2>Tax Registrations</h2>
      <ConnectTaxRegistrations
        // Optional
        // displayCountries={["US", "CA", "DE"]}
        // onAfterTaxRegistrationAdded={({id: registrationId}) => console.log({registrationId})}
        // onAfterTaxRegistrationExpired={({id: registrationId}) => console.log({registrationId})}
       />
    </div>
  </ConnectComponentsProvider>
);
```

#### HTML + JS

| Méthode                            | Type                     | Description                                                                                                                                                                                                                                                                       | Par défaut                          |
| ---------------------------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
| `setDisplayCountries`              | `string[]`               | Tableau des [codes pays à deux lettres](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) que le compte connecté peut [sélectionnner pour une nouvelle immatriculation fiscale](https://docs.stripe.com/api/tax/registrations/object.md#tax_registration_object-country_options). | undefined (tous les pays autorisés) |
| `setOnAfterTaxRegistrationAdded`   | `({id: string}) => void` | Rappel exécuté avec un objet contenant le numéro fiscal récemment ajouté                                                                                                                                                                                                          | undefined (méthode non obligatoire) |
| `setOnAfterTaxRegistrationExpired` | `({id: string}) => void` | Rappel exécuté avec un objet contenant l’identifiant d’enregistrement fiscal fourni par l’utilisateur                                                                                                                                                                             | undefined (méthode non obligatoire) |

#### React

| Propriété React                 | Type                     | Description                                                                                                                                                                                                                                                                       | Par défaut                          | Obligatoire ou facultatif |
| ------------------------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | ------------------------- |
| `displayCountries`              | `string[]`               | Tableau des [codes pays à deux lettres](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) que le compte connecté peut [sélectionnner pour une nouvelle immatriculation fiscale](https://docs.stripe.com/api/tax/registrations/object.md#tax_registration_object-country_options). | undefined (tous les pays autorisés) | facultatif                |
| `onAfterTaxRegistrationAdded`   | `({id: string}) => void` | Rappel exécuté avec un le numéro fiscal récemment ajouté                                                                                                                                                                                                                          | undefined (méthode non obligatoire) | facultatif                |
| `onAfterTaxRegistrationExpired` | `({id: string}) => void` | Rappel exécuté avec un objet contenant l’identifiant d’enregistrement fiscal fourni par l’utilisateur                                                                                                                                                                             | undefined (méthode non obligatoire) | facultatif                |

## Limitations

Les fonctionnalités suivantes sont disponibles dans le Dashboard et l’API, mais ne sont actuellement pas prises en charge par le composant Tax registrations&nbsp;:

- Planification des dates de début ou de fin des immatriculations. Vous pouvez uniquement créer ou mettre fin à des immatriculations immédiatement.
- Spécification des choix relatifs à la taxe sur les ventes dans les États américains lors de la création d’immatriculations fiscales.

## See also

- [Tax sur Connect](https://docs.stripe.com/tax/connect.md)
- [Tax pour les plateformes logicielles](https://docs.stripe.com/tax/tax-for-platforms.md)
- [Composant des paramètres fiscaux](https://docs.stripe.com/connect/supported-embedded-components/tax-settings.md)