Info > Funtzionamendua
API REST · TICKETBAI · BATUZ · VERIFACTU

Nola funtzionatzen du Ticketbai WS

Zure aplikazioak fakturaren datuak bidaltzen ditu; Ticketbai WSk sinatu, kateatu eta zure Ogasunera bidaltzen du, eta berehala itzultzen dizkizu aztarna eta QR kodea, inprimatzeko.

Hiru foru-ogasunekin (Araba, Bizkaia/Batuz eta Gipuzkoa) eta Zerga Agentziarekin (Verifactu) funtzionatzen du, zure zerbitzarian ziurtagiririk gabe eta zure fakturazio-programa aldatu gabe.

EskaeraPOST /tbai/
GoiburuakToken · Nif
Erantzunaresult: OK
aztarna · QR · egiaztapen-URLaFakturan edo tiketean inprimatzeko prest
01 / Eskema

Zure aplikaziotik Ogasunera

Ticketbai WS zure fakturazio-softwarearen eta dagokizun Ogasunaren arteko web-zerbitzu bitartekaria da.

Zure aplikazioa

Online denda, TPVa edo ERPa

Faktura bakoitzaren datuak JSON formatuan bidaltzen ditu.

Ticketbai WS

Sinatu, kateatu eta bidali

Fitxategia sortu, gure ziurtagiriarekin sinatu eta bidaltzen du.

Ogasuna

Araba, Bizkaia, Gipuzkoa edo AEAT

Faktura TicketBAI, Batuz edo Verifacturen bidez jasotzen du.

02 / Urratsez urrats

Zer gertatzen da faktura bakoitzarekin

Zure aplikazioak eskaera bakarra egiten du faktura bakoitzeko. Gainerakoaz Ticketbai WS arduratzen da.

APIak berehala erantzuten du eta Ogasunerako bidalketa atzeko planoan egiten da; horrela, zure dendak edo TPVak ez dute inoiz Ogasunaren zerbitzarien zain egon behar.

01

Faktura bidaltzen duzu

REST eskaera bat, fakturaren datuekin eta enpresaren Token eta Nif goiburuekin.

02

Balidatu, sinatu eta kateatu egiten dugu

Datuak egiaztatu, TicketBAI fitxategia edo Verifactu erregistroa sortu, sinatu eta aurreko fakturarekin kateatzen dugu.

03

Aztarna eta QR kodea jasotzen dituzu

Berehala, egiaztapen-URLarekin batera, fakturan edo tiketean inprimatzeko.

04

Ogasunak berresten du

Faktura enpresari dagokion Ogasunera bidaltzen dugu eta, webhook bat baduzu, emaitzaren berri ematen dizugu. Ogasunak erantzuten ez badu, automatikoki berriro bidaltzen dugu.

03 / Konexioa

Nola konektatu zure negozioa

Programatu gabe

Shopify eta WooCommerce

Shopifyko aplikazioarekin (Shopify POSerako ere bai) edo WooCommerceren integrazioarekin, eskaera bakoitza automatikoki fakturatzen da. Minutu gutxitan konfiguratzen da paneletik.

ShopifyShopify POSWooCommerce
Garatzaileentzat

API REST

Beste edozein programa, TPV edo ERPrentzat. Eskaera bat faktura bakoitzeko, dokumentazioarekin, OpenAPI zehaztapenarekin, kopiatzeko prest dauden adibideekin eta konturik gabe probatzeko terminal batekin.

REST + JSONOpenAPIWebhooksMCP
04 / Barne

Ticketbai WS zuregatik egiten duena

Ziurtagiririk ez zure zerbitzarian

Gure ziurtagiriarekin sinatzen dugu. Zuk behin bakarrik eman behar diguzu baimena zure Ogasunaren aurrean.

Software bermatzaile inskribatua

Araba, Bizkaia eta Gipuzkoako erregistroetan, eta Verifacturen erantzukizunpeko adierazpenarekin: ez duzu zure programa ziurtatu behar.

Proba-ingurune doakoa

Enpresa bakoitzak proba-ingurunea eta ekoizpen-ingurunea ditu. Ekoizpenera pasatzeko URLa eta tokena baino ez dira aldatzen.

Ilara eta berriro bidaltzea

Ogasunak erantzuten ez badu, zure fakturak ez dira galtzen: berriro erantzuten duenean bidaltzen dira.

Faktura zuzentzaileak eta zuzenketak

Faktura zuzentzaileak, itzulketak, zuzenketak (zuzendu) eta baliogabetzeak API berarekin.

Trazabilitatea

Bidalketa bakoitzaren erregistroa, XMLarekin eta Ogasunaren erantzunarekin, zure eremu pribatuan.

Hasi fakturak bidaltzen

Probatu doan proba-ingurunean. Integrazioa programatuko dizun inor ez baduzu, idatzi iezaguzu: Bereinen web-aplikazioak garatzen ditugu eta lagun zaitzakegu.