API d'intégration : envoyez les ventes de votre logiciel à TicketBAI et à Vectura
Votre logiciel —un point de vente d'une autre marque, une borne, une boutique en ligne, un ERP ou le programme d'un hôtel— envoie chaque vente à Vectura par un appel JSON. Vectura émet le ticket ou la facture, la signe avec TicketBAI ou Veri*Factu, l'envoie à l'administration fiscale et vous renvoie le QR à imprimer. Sans bibliothèques, sans rien installer et avec une clé par programme.
Compte de démonstration
Données fictives, aucun envoi au fisc ni par e-mail. Réinitialisé chaque nuit.
{
"seriefactura": "KIOSKO1",
"numfactura": "105",
"fechaexpedicionfactura": "2026-11-06",
"importetotalfactura": "3,50",
"baseimponible": "2,89",
"tipoimpositivo": "21",
"cuotaimpuesto": "0,61"
}
{
"error": "0",
"leyenda": "TicketBAI",
"fiscal_estado": "aceptado",
"qr_url": "https://batuz.eus/QRTBAI/?id=…"
}
Intégrer est aussi simple que cela
Générez une clé
Dans votre espace utilisateur, sous Configuration → API et intégrations, vous créez une clé pour chaque programme. Elle peut être supprimée à tout moment.
Envoyez la vente
Votre programme fait un POST avec le JSON de la vente. Sans NIF, un ticket simplifié ; avec NIF, une facture complète.
Imprimez le QR
Vectura signe et envoie à l'administration fiscale, et répond avec le QR et la mention à imprimer sur le ticket.
Ce qui est inclus
Un appel par vente
Votre programme envoie un JSON avec le NIF (facultatif), le montant et la TVA. Sans NIF, un ticket simplifié est émis ; avec NIF, une facture complète à ce client.
Signature et envoi à l'administration fiscale
Vectura signe avec votre certificat et envoie à la Hacienda Foral (TicketBAI en Biscaye, Guipuscoa et Alava) ou à l'Agence fiscale espagnole (Veri*Factu dans le reste de l'Espagne).
Le QR, prêt à imprimer
La réponse contient l'adresse du QR et sa mention (TicketBAI ou VERI*FACTU), et vous pouvez demander l'image du QR à Vectura.
Réessais sans risque et votre numérotation
Nous respectons la série et le numéro de votre programme. Si vous répétez une vente avec la même série et le même numéro, Vectura renvoie l'originale sans en créer une autre : une coupure réseau ne duplique jamais une facture.
Annuler, consulter et rectifier
Annulez un ticket, consultez l'état fiscal d'une vente ou corrigez une facture par une facture rectificative, le tout par la même API.
Factures complètes, encaissements et devis
Avec lignes, plusieurs taux de TVA, client, encaissement et envoi du PDF par e-mail ; factures en attente de paiement, devis et consultation de documents.
Pour les programmes qui ne font que déposer des fichiers
Si votre logiciel ne sait pas faire d'appels web, un script PowerShell envoie tout seul les fichiers JSON d'un dossier et écrit la réponse avec le QR. Sans programmer.
Manuel et clés dans votre espace utilisateur
Générez une clé par programme et consultez le manuel de l'API, avec des exemples en curl, PHP, C#, JavaScript et Python et la liste des erreurs.
Questions fréquentes
De quoi ai-je besoin pour commencer ?
Un compte Vectura Suite et les données fiscales de votre entreprise. Pour signer pour de bon, il faut votre certificat électronique (et, avec TicketBAI, la licence logicielle, que configure notre support). Pendant vos essais, l'entreprise est en mode test.
Fonctionne-t-elle avec TicketBAI et Veri*Factu ?
Oui. Selon le régime de votre entreprise, Vectura signe avec TicketBAI (Biscaye, Guipuscoa et Alava) ou génère l'enregistrement Veri*Factu ; le programme appelant n'a pas à les distinguer.
Puis-je tester sans rien envoyer à l'administration fiscale ?
Oui. Tant que l'entreprise est en mode test, tout est signé et envoyé à l'environnement de test de l'administration fiscale, et les QR n'ont aucune validité légale. Quand tout fonctionne, on passe en réel.
Que se passe-t-il si la connexion est coupée en pleine vente ?
Vous réessayez avec la même série et le même numéro (ou la même référence) : Vectura renvoie la vente d'origine sans la dupliquer.
Y a-t-il une limite d'appels ?
Oui : 120 requêtes par minute, largement suffisant pour un commerce. Si vous dépassez, l'API répond 429 et vous réessayez un instant plus tard.
Où se trouve la documentation ?
Dans Vectura Suite, dans votre espace utilisateur : Aide → Manuel de l'API. Il comprend un guide de démarrage, chaque point de l'API avec des exemples en curl, PHP, C#, JavaScript et Python, et la liste des erreurs. Vous pouvez le consulter avec l'essai gratuit.
Qui voit ma clé ?
Personne : elle n'est affichée qu'une fois à sa création et Vectura n'en conserve qu'une empreinte. Si vous la perdez, supprimez-la et créez-en une autre ; supprimer une clé n'affecte pas les autres.
Puis-je connecter le programme d'un hôtel ?
Oui : outre les ventes, il existe des points d'API pour les chambres occupées et les imputations à la chambre, que le programme de l'hôtel consulte et règle.
On l'essaie avec votre entreprise ?
Créez votre compte et testez-le avec vos propres données, sans carte bancaire et sans engagement.