ApivomApivom
Demander une démo

API de recherche des contribuables e-Facture GİB

Trouvez les contribuables turcs inscrits à l'e-Facture par raison sociale ou numéro fiscal et résolvez la correspondance en VKN/TCKN et boîtes e-facture — recherche en deux étapes sur la liste des utilisateurs enregistrés GİB¹, via Apivom Atlas.

Disponible via Apivom Atlas1 routes d’API · 1 lecture seule

¹ GİB: Administration fiscale turque

Ce que vous pouvez faire

  • Recherche par raison sociale avec préfixe ou contenu (penta teknoloji%, %penta%) renvoyant une liste de contribuables candidats
  • L'étape détail résout un candidat en numéro fiscal, raison sociale exacte et alias de boîtes e-Facture (urn:mail:…)
  • Consultation directe par VKN (10 chiffres) ou TCKN (11 chiffres) renvoyant la ligne complète en un appel
  • Couverture : contribuables inscrits à l'e-Facture — idéal pour valider un destinataire avant l'envoi
  • Identifiants détenus par Apivom ; chaque requête journalisée avec sa charge utile complète dans le portail Atlas

Cas d'usage

  • Valider les destinataires e-facture avant l'envoi — Résolvez la raison sociale d'un client en VKN et alias de boîte e-Facture pour que les factures sortantes arrivent dans la bonne boîte du premier coup.
  • Qualification des prospects dans le CRM — Saisissez les premières lettres du nom d'un prospect, choisissez le contribuable enregistré exact, puis stockez la raison sociale officielle et le numéro fiscal sur le compte.
  • Contrôle des contreparties en achats — Vérifiez si un fournisseur est contribuable e-Facture et sur quelle boîte il reçoit, avant le premier bon de commande.

Apivom Atlas expose la recherche des utilisateurs e-Facture de l'administration fiscale turque (GİB), fournie par le prestataire Ozay, sous la forme d'une API REST en deux étapes. La première recherche les raisons sociales — un motif préfixe (penta teknoloji%) ou contenu (%penta%) renvoie les contribuables correspondants sous forme de liste d'identifiants et de raisons sociales. La seconde transmet un identifiant à la route détail et renvoie le numéro fiscal (VKN ou TCKN), la raison sociale exacte et les boîtes e-Facture sur lesquelles le contribuable accepte les factures. Un numéro fiscal peut aussi être interrogé directement pour obtenir la ligne complète. La couverture étant le registre e-Facture, une absence de résultat signifie que la contrepartie n'est pas un contribuable e-facture, pas qu'elle n'existe pas.

Exemple de code

Remplacez YOUR_KEY par la clé API délivrée dans Apivom Atlas et exécutez la commande depuis votre backend.

curl -X POST https://atlas.apivom.com/one/api/ext/gib/v1/query/taxpayer-search \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"s":"penta teknoloji%"}'
Authentification

Clé API par tenant (en-tête x-api-key) émise dans Apivom Atlas. Le code fournisseur est injecté côté serveur et n'atteint jamais vos systèmes. L'accès est organisé avec l'équipe Apivom — ce fournisseur n'est pas en libre-service dans le portail.

Questions fréquentes

Pourquoi deux étapes plutôt qu'une seule recherche ?

La recherche de liste GİB ne renvoie que des raisons sociales ; l'étape détail ajoute le numéro fiscal et les boîtes pour le seul contribuable choisi. Les recherches de liste restent économiques et les identifiants sensibles sont limités à un second appel délibéré.

Quels motifs de recherche sont pris en charge ?

Au moins trois caractères. Un % final correspond aux raisons sociales qui commencent par le texte, un % initial à celles qui le contiennent ; un simple numéro à 10 ou 11 chiffres renvoie directement la ligne complète.

Puis-je acheter cette API en libre-service ?

Non. La recherche GİB est provisionnée par tenant par l'équipe Apivom car l'identifiant fournisseur et la réserve de crédits sont partagés ; demandez l'accès et nous l'activons avec la même clé, la même journalisation et la même vue du solde que les autres API Atlas.

Autres intégrations Atlas

Guide d’intégration pour l’IA (llms.txt)

Markdown lisible par machine : donnez-le à votre assistant IA comme instructions d’intégration.

Guide d’intégration pour l’IA (llms.txt)Demander un accès