ForHosting KIT · Outils pour développeurs

Chiffre de contrôle GSTIN Inde

Pour le corps 27AAPFU0939F1Z, le caractère de contrôle est V, ce qui donne le GSTIN complet 27AAPFU0939F1ZV. Calculez ce dernier caractère pour un formulaire ou un import, ou vérifiez le GSTIN d'un fournisseur avant de l'enregistrer. Gratuit dans votre navigateur.

  • Gratuit
  • Fonctionne dans votre navigateur
  • Sans inscription
  • Vos données restent sur votre appareil
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt
Si vous saisissez
Nombre
27AAPFU0939F1Z
Vous obtenez
Mode de calcul
Compute
Entrée
27AAPFU0939F1Z
Caractère de contrôle
V
Avec chiffre de contrôle
27AAPFU0939F1ZV

Un GSTIN indien (Goods and Services Tax Identification Number) est un identifiant fiscal alphanumérique de quinze caractères utilisé sur les factures, les e-way bills et les dossiers d’immatriculation. Le dernier caractère est un caractère de contrôle dérivé des quatorze premiers selon une règle fixe de pondération en base trente-six, de sorte qu’une lettre ou un chiffre mal saisi fait généralement échouer la validation avant l’enregistrement du numéro. Cette capacité met en œuvre cet algorithme de style officiel : chaque caractère est mappé sur un point de code de zéro à trente-cinq, multiplié par des facteurs alternés un et deux depuis la gauche, chaque produit est replié par division entière par trente-six plus reste, les hachages sont additionnés, et le résidu complémentaire est renvoyé entre zéro et neuf ou A et Z. Utilisez le mode compute lorsque vous ne disposez que du corps de quatorze caractères et avez besoin du caractère final pour un formulaire ou un import de données de référence ; utilisez validate lorsqu’un partenaire, un ERP ou un utilisateur envoie un GSTIN complet de quinze caractères et que vous avez besoin d’un indicateur valid clair plus le caractère attendu pour les messages d’erreur.

Comment le caractère de contrôle GSTIN de l’Inde est calculé

Un GSTIN comporte toujours quinze caractères lorsqu’il est écrit sans espaces ni ponctuation. Les deux premiers chiffres codent l’État ; les dix suivants sont le permanent account number (PAN) du contribuable selon le schéma habituel de cinq lettres, quatre chiffres et une lettre ; le treizième caractère distingue les entités partageant le même PAN ; le quatorzième est en général Z pour une immatriculation normale ; et le quinzième est le caractère de contrôle que vous ne devez jamais inventer à la main.

Pour le calculer, prenez uniquement les quatorze premiers caractères et convertissez chacun avec l’alphabet de zéro à neuf puis A à Z, de sorte que zéro correspond au code zéro et Z au code trente-cinq. Depuis la gauche, multipliez les points de code successifs par les facteurs alternés un, deux, un, deux, et ainsi de suite. Pour chaque produit P, ajoutez le quotient entier de P divisé par trente-six plus P modulo trente-six à une somme courante.

Après les quatorze positions, prenez la somme modulo trente-six, soustrayez ce reste de trente-six, réduisez à nouveau modulo trente-six pour qu’un reste zéro donne le code de contrôle zéro, et mappez le code résultant via le même alphabet. La chaîne complète de quinze caractères doit porter exactement ce caractère final. L’algorithme est déterministe et local : aucun appel réseau au portail GST, aucun catalogue de contribuables et aucune horloge.

Cet outil ne vérifie pas si l’immatriculation est active, n’étend pas un GSTIN en raison sociale ou nom commercial, et n’affirme pas qu’un checksum valide autorise un régime fiscal particulier—il prouve seulement que la chaîne est bien formée selon la règle de pondération en base trente-six. Par rapport aux validateurs multi-pays, l’intention de recherche est étroite : ceux qui ont besoin d’un calculateur du chiffre de contrôle GSTIN de l’Inde pour des corps de quatorze caractères, non un vérificateur générique de TVA ou d’EIN.

Où les chiffres de contrôle GSTIN s’intègrent aux flux réels

Les équipes finance et données de référence reçoivent des corps internes de quatorze caractères et doivent ajouter le caractère de contrôle officiel du GSTIN avant d’écrire l’identifiant sur des factures fiscales, des charges e-invoice ou des profils vendeur de places de marché qui rejettent les numéros GST invalides. Les portails comptes fournisseurs valident les GSTIN de quinze caractères à l’onboarding des fournisseurs pour qu’une seule transposition ne crée pas un fournisseur fantôme ni un écart de paiement en reverse charge.

Les tâches de qualité des données parcourent chaque colonne GSTIN d’un export CRM ou ERP, appellent le mode validate et mettent en quarantaine les lignes où valid est false—capturant éditions humaines et bogues de générateurs. Ne traitez pas un contrôle GSTIN réussi comme une preuve d’immatriculation active auprès de l’autorité fiscale ou d’un régime particulier ; il prouve seulement que le caractère base-36 est cohérent avec le corps de quatorze caractères sous les poids alternés standard.

Auditer les colonnes GSTIN des exports ERP et CRM

Validez par lot chaque GSTIN de quinze caractères dans un fichier fournisseurs ou clients et mettez en quarantaine les lignes dont le caractère de contrôle ne correspond plus à la valeur attendue recalculée.

Qu’est-ce que le chiffre de contrôle GSTIN de l’Inde ?

C’est le quinzième caractère d’un GSTIN, calculé avec des points de code base-36 et des facteurs alternés sur les quatorze premiers caractères, afin que les erreurs de saisie et d’import soient généralement détectées avant le stockage ou l’impression de l’identifiant sur une facture fiscale.

Que se passe-t-il en cas de mauvaise longueur, de symboles ou de forme invalide ?

Un GSTIN complet dont le caractère de contrôle ne correspond pas renvoie valid false. Les tâches de validation en échec ne sont pas facturées.

L’outil de chiffre de contrôle GSTIN de l’Inde est-il gratuit ?

L’outil navigateur est gratuit et s’exécute en local.

Que signifie chaque partie d'un GSTIN ?

Les deux premiers chiffres sont le code de l'État, les dix suivants le PAN du contribuable, le treizième distingue les entités qui partagent ce PAN, le quatorzième vaut en général Z et le dernier est le caractère de contrôle.

Quand faut-il calculer et quand faut-il vérifier un GSTIN ?

Calculez lorsque vous n'avez que les 14 premiers caractères et qu'il vous manque le dernier. Vérifiez lorsqu'on vous remet un GSTIN complet de 15 caractères et que vous voulez savoir si son caractère final concorde.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/enc/gstin-india

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

curl -X POST https://api.kit.forhosting.com/enc/gstin-india \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"27AAPFU0939F1Z"}'
{
  "number": "27AAPFU0939F1Z"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.gstin_india",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Les entrées non alphanumériques, les longueurs incorrectes et les corps qui ne respectent pas la forme standard état plus PAN échouent avec invalid_input au lieu d’un nettoyage silencieux, afin de ne jamais stocker un identifiant fiscal à demi nettoyé. La même arithmétique pure s’exécute gratuitement dans le navigateur et au prix API publié.

Contrat d’entrée, modes et comportement d’erreur

Envoyez un champ number ne contenant que des caractères de A à Z et de zéro à neuf ; les minuscules sont converties automatiquement en majuscules. Une mauvaise longueur est une erreur explicite qui nomme le mode et la longueur envoyée—quatorze pour compute, quinze pour validate—afin que les formulaires affichent un message précis sans deviner. Chaînes vides, number manquant, valeurs de mode invalides et corps qui échouent à la forme État plus PAN échouent avant toute confiance dans la somme pondérée et ne sont pas facturés. Préférez compute pour émettre ou compléter des identifiants ; préférez validate pour conditionner une recherche ou un import à un GSTIN complet d’un utilisateur ou d’un fichier partenaire. Espaces, points, tirets, barres et autres symboles sont rejetés comme entrée non alphanumérique avec invalid_input afin qu’une valeur silencieusement tronquée n’atteigne jamais le stockage. Le mode compute est le défaut : le moteur exige exactement quatorze caractères respectant la forme standard du corps GSTIN (État à deux chiffres, segment PAN de cinq lettres, quatre chiffres et une lettre, puis deux caractères de corps pour l’entité et la valeur par défaut), renvoie check_character comme un seul caractère et with_check comme le GSTIN de quinze caractères que vous pouvez imprimer ou persister. Le mode validate exige exactement quinze caractères ; la réponse indique valid true lorsque le caractère final correspond au expected_check_character recalculé et inclut payload (les quatorze premiers), les caractères donnés et attendus, et length quinze. Les alias gstin, code et text sont acceptés pour le même champ de charge utile afin que les intégrations qui parlent déjà de « gstin » n’aient pas à renommer. Comme le chemin est pure parse sans horloge, source aléatoire ni réseau, le même corps JSON produit toujours le même résultat sur l’outil gratuit du navigateur et sur l’API à $0.002 par requête réussie.

Où les chiffres de contrôle GSTIN s’intègrent aux flux réels

Les formulaires d’inscription e-commerce et B2B peuvent recalculer expected_check_character et afficher une correction claire lorsqu’une entreprise indienne colle un numéro dont le dernier caractère est erroné.

Compléter un corps GSTIN de 14 caractères pour les factures

Appelez le mode compute avec le corps de quatorze caractères, stockez with_check et injectez le GSTIN de quinze caractères dans votre e-invoice, e-way bill ou profil vendeur de marketplace.

Valider les GSTIN complets saisis ou importés à l’entrée

Lorsqu’un formulaire ou un CSV envoie quinze caractères, appelez le mode validate et bloquez l’enregistrement si valid est false, en affichant expected_check_character pour corriger une seule faute de frappe.

Comment calculer un caractère de contrôle GSTIN avec cette API ?

Envoyez un POST avec number exact de quatorze caractères alphanumériques et mode compute (ou omettez mode). La réponse inclut check_character et with_check (le GSTIN complet de quinze caractères).

Comment valider un GSTIN complet de quinze caractères ?

Envoyez un POST avec la chaîne de quinze caractères et mode validate. La réponse inclut valid, check_character, expected_check_character et payload (caractères sans le dernier contrôle).

Consulter la documentation complète du KIT →