Sinatu, kateatu,
bidali.
Faktura elektronikoaren zentralita AEAT, SII eta TicketBAIra API bakar batetik igortzen duten aplikazioentzat. Zuk POST egiten duzu; guk XAdES sinatu, hash-ak kateatu eta SOAP bidez hitz egiten dugu Ogasunarekin.
Hau da zure aplikazioak exekutatu behar duen guztia.
SHA-256 aztarna jaulkitzaileen NIFaren arabera kateatuta dator lock indartsu batekin: bi POST aldibereko chain_index desberdina eta koherentea sortzen dute.
curl -X POST https://api-verifactu.c2developers.com/api/v1/invoices \
-H "Authorization: Bearer vf_live_a1b2c3d4e5f6g7h8" \
-H "X-Verifactu-Emisor: B12345678" \
-H "Content-Type: application/json" \
-d '{
"serie": "A", "numero": "00042",
"fecha_expedicion": "19-05-2026",
"tipo_factura": "F1",
"nif": "A15022510",
"nombre": "Acme S.L.",
"lineas": [{
"base_imponible": "1000.00",
"tipo_impositivo": "21.00",
"cuota_repercutida": "210.00"
}],
"importe_total": "1210.00"
}'{
"id": "a78e1146-4d64-42c4-b667-8a1177e41ff2",
"huella": "DC7F8C475732C3342370A7E64E93EC46529DB98F216F9BD2FFDD18BDDD36249D",
"chain_index": 1,
"qr_url": "https://www2.aeat.es/wlpl/TIKE-CONT/ValidarQR?...",
"aeat_status": "pending"
}Hiru pauso. Gainerakoa guk egiten dugu.
Zure integrazioa aste honetan bertan produkziora atera dadin diseinatua.
Faktura JSONez bidaltzen duzu
POST eskaera bakarra fakturaren datuekin. Zaintzeko ziurtagiririk gabe. Borrokatzeko XMLrik gabe. Dei mugagabeak, sandbox-ean ere bai.
QRa berehala itzultzen dizugu
Zure aplikazioak Verifactu QRa erantzun berean jasotzen du. Fakturan itsasten duzu eta inprimatzen edo bezeroari bidaltzen diozu. AEATek berdin baliozkotzen du.
Eta gainerakoa guk kudeatzen dugu
XAdES-BES sinatutako XMLa, kateatutako aztarna, SOAP TLS mutuoarekin, AEATek backoff eskatzen badu berriz saiatzeko, HMAC sinatutako callback erantzuna dagoenean.
Datak hauek dira.
Verifactu derrigorrezkoa da. Ez da aukerakoa, ez da mugagabe luzatzen, ez du onartzen "SDK kaleratzen denean egingo dut". RD-Legea 15/2025ek jaulkitzaile derrigortua atzeratu zuen — garatzailea ez.
- 2025eko uztailaren 1aFakturazio softwarea (SIF)Ekoizleak eta banatzaileak dagoeneko behartuta. Zure produktuak egokituta egon behar du.
- 2027ko urtarrilaren 1aIS-eko sozietateakNortasun juridikodun enpresak zuzenean bidaltzen hasten dira.
- 2027ko uztailaren 1aGainerako behartuakAutonomoak, ondasun-erkidegoak. Azken trena.
Zure soluzio osoa Verifactu (eta TicketBAI) izateko.
API erraz, sendoa eta merkea. Premium ordainpeko batean espero zenukeena, ordainagiriaren ezustekorik gabe.
Ahaztu XMLekin, kateatzeekin eta ziurtagiriekin borrokatzea. JSON eskaera garbiak egin eta asteak aurreztu. Dokumentazio argia, autosortutako TypeScript SDKa, stack bakoitzeko adibideak.
Integrazioa AEATekin eguneratuta mantentzen dugu. XSDren bertsio berria argitaratzen dutenean, guk hartzen dugu eskuetan zuk ezer ukitu gabe.
IZ860 ahalordetze eredua: zure bezeroak ahalordea sinatzen du sede.aeat.es-en gure alde. Inoren .p12 zaindu behar ez duzu. Guk kudeatzen dugu.
Arkitektura mistora egokitutako zirriborroa ematen dizugu eta non eta nola erakutsi Ogasunari azaltzen dizugu. Auditoriarik gabe, homologaziorik gabe.
Sinatutako XML guztiak 4 urtez gordetzen ditugu (legezko epea). Panelean edo APItik deskargatzen dituzu ikuskaritza baterako behar dituzunean.
Fakturen zerrenda, AEAT egoera eta bidalketa bakoitzeko CSVa duen xehetasuna, CSV/XLSX inportazio masiboa, PDF zaharren OCRa, jaulkitzaile NIFen kudeaketa.
XSD ofizialaren eta negozio arauen aurka baliozkotzen dugu AEAT ukitu baino lehen. Zerbait huts egiten badu, 400 erantzuten dizugu eremua eta arrazoia adieraziz. Zuzenketak aurrezten dituzu.
Postgres + worker asinkronoak. Faktura bakoitza bere testuinguruan prozesatzen da. Bolumena milioietara hazten bada, ez dugu ezer berridatzi behar.
AEATek erantzuten duenean, HMAC-SHA256 sinatutako callback bidez ohartarazten zaitugu. Berrekintza automatikoak: 60s · 5m · 30m · 2o · 12o. Erantzunik galdu gabe.
APIak integratzen dituen jendeak egindako APIa.
Diseinatuta zure ERPa, TPVa edo aplikazio mugikorra arratsalde batean konektatzeko. SOAPik gabe, ziurtagiririk gabe, gurpila berrasmatu gabe.
- OpenAPI 3 dokumentazioaSpec osoa Swagger UI-rekin. Postman, Insomnia eta abarretara inportagarria.
- Autosortutako TypeScript SDKa@verifactu/sdk paketearen bezero tipatua. JS, Node, Bun, Deno.
- Doako kontua probako NIFarekinAEAT sandbox-erako dei mugagabeak ezer ordaindu aurretik.
- Giza laguntza emailez24 orduz azpitik erantzuten dugu. Botik gabe, 7 mailatara eskalatu gabe.
Bi kasuetan berdin ondo funtzionatzen du.
Soluzio bakarra, ostalariaren bi aldeak.
Garapen erakundea zara?
Egokitu eta ziurtatu zure kudeaketa softwarea ahaleginik gabe Iruzurraren Aurkako Legea betetzeko.
- ERP fabrikatzailea
- ERP integratzailea
- Fakturazio softwarea
- TPV / POS softwarea
- PMS softwarea (hotelgintza)
- Aplikazio mugikorren garatzailea
- Teknologia aholkularitza
- SaaS birsaltzaileak
Software propioa egokitzen ari zara?
Zure enpresarentzat software bat sortu baduzu eta Verifactura egokitu behar baduzu, gure APIa aukerarik onena da — pyme nahiz talde.
- Barneko fakturazio softwarea
- Stripe edo beste pasabideekin integrazioa
- Shopify / WooCommerce egokitzea
- ERP propioa eguneratzea
- Sistema zaharren migrazioa
- Multi-tenant enpresa-taldeentzat
Lurralde fiskal osoa API bakar batetik.
Jaulkitzaile batek bere erregimena erabakitzen du sortzean. Resolver-ek gateway egokira bideratzen du zure aplikazioak zazpi sistema desberdin daudenik jakin gabe.
| Erregimena | Espezifikazioa | Egoera |
|---|---|---|
| AEAT estatala | RD 1007/2023 · Verifactu | Operatiboa |
| SII estatala | AEAT · REDEME / handiak | Operatiboa |
| SII Navarra | siihacienda.navarra.es | Operatiboa |
| TicketBAI Bizkaia | Bizkaiko Foru Aldundia | Operatiboa |
| TicketBAI Gipuzkoa | Gipuzkoako Foru Aldundia | Operatiboa |
| TicketBAI Álava | Álavako Foru Aldundia | Operatiboa |
| NaTicket Navarra | Nafarroako Foru Ogasuna | Spec zain |
Gaur funtzionatzen ez duena esaten dugu. NaTicket-ek bere spec-a argitaratzen duenean, lerro bat ere aldatu gabe aktibatuko dugu.
Ez dizugu zure bezeroaren ziurtagiririk eskatzen.
Bezero bakoitzaren .p12 eskatzea amesgaizto operatiboa eta legala da: bi urtero iraungitzen dira, biratu, zaindu eta atsedenean zifratu behar dira. AEATek mekanismo hobea du aspaldidanik eta ia inork ez du erabiltzen: IZ860 ahalordetze elektronikoa.
Zure bezeroak zure aldeko ahalordea sinatzen du (gure bitartez) sede.aeat.es-en. Une horretatik aurrera bere fakturak bere izenean bidal ditzakegu gure ziurtagiriarekin. Errebokatzen badu, berehala gelditzen da. AEATek 4112 kodearekin baztertzen badu, BBDDan auto-errebokatzen dugu.
Igo PDFa. JSONa itzultzen dugu.
PDF formatuko 800 faktura zaharrekin bezero bat iristen denean, inork ez ditu berriz teklatzen. POST /v1/invoices/import-pdf endpoint-ak dokumentua Claude Vision-era pasatzen du, Verifacti eremu normalizatuak itzultzen ditu eta atarian betetzen ditu.
Ez dugu automatikoki jaulkitzen. Pertsona batek berrikusten du sakatu aurretik. 800 fakturarako, 30 segundo berrikuspeneko vs. 10 minutu berriz teklatzeko.
- PDFapplication/pdf jatorrizkoa · OCR aurretiazkorik gabe · 10 MB geh.
- JPGMugikorreko argazkia ere balio du · image/jpeg, png, webp
- JSONseriea, zenbakia, data, BEZa motaren arabera, guztira
curl -X POST .../invoices/import-pdf \ -H "Authorization: Bearer vf_live_..." \ -F "[email protected]"
{
"serie": "A", "numero": "00031",
"fecha_expedicion": "15-11-2024",
"tipo_factura": "F1",
"nombre": "Maderas del Norte S.L.",
"lineas": [
{ "base_imponible": "4150.00", "tipo_impositivo": "21.00", "cuota_repercutida": "871.50" },
{ "base_imponible": "150.00", "tipo_impositivo": "4.00", "cuota_repercutida": "6.00" }
],
"importe_total": "5177.50"
}Aukeratu zuretzako plana.
Hasierako kosturik gabe. Iraupenik gabe. Bertan behera utzi nahi duzunean. NIF aktibo bakoitzeko ordaintzen duzu.
Probatu integrazioa ezer sinatu aurretik. Txartelik gabe.
- Doako benetako faktura 1
- AEAT sandbox-en dei mugagabeak
- Atarira eta API osora sarbidea
- OCR sartuta
- HMAC sinatutako webhook-ak
Autonomo, pyme eta jaulkitzaile bat edo gehiago dituzten garatzaileentzat.
- 3.000 faktura / NIF hileko
- IZ860 ahalordetzea kudeatua
- Ordainketa pasabide integratua (Redsys)
- Email bidezko laguntza · erantzuna < 24 h
SaaS birsaltzaileentzat eta ehunka edo milaka jaulkitzaile dituzten ERPentzat.
- Mugarik gabeko bolumena · prezioa erabileraren arabera
- SIF ziurtagiri propioa nahiago baduzu
- SLA konprometitutako erantzunarekin
- Onboarding eta laguntzadun migrazioak
BEZik gabeko prezioak · sartutako fakturak: 3.000 NIF/hileko · gehigarria 2 €/1.000
Ia denek galdetzen dutena.
Zer da Verifactu eta zergatik behar dut soluzio bat?
Verifactu fakturazio erregistroak AEATera bidaltzeko derrigorrezko sistema da (RD 1007/2023). Fakturazio softwarea duten enpresek igorritako faktura bakoitza berehala bidali behar dute, XAdES sinatuta eta hash kateekin. "Eskuz" inplementatzeak hilabeteak XML, SOAP, XSD eta ziurtagiriekin esan nahi du. Guk egiten dugu zugatik.
Zergatik ez didazu bezeroaren ziurtagiri digitala eskatzen?
IZ860 ahalordetze ereduak hori saihesten duelako: zure bezeroak ahalorde elektronikoa sinatzen du sede.aeat.es-en C2Developers (NIF J71554372) alde, eta une horretatik aurrera bere fakturak bere izenean bidal ditzakegu gure ziurtagiriarekin. Bere ziurtagiria ez da inoiz bere eskuetatik ateratzen eta nahi duenean errebokatu dezake.
Doako kontua duzue?
Bai. Erregistratzen zara, IZ860 ahalordea sinatzen duzu eta benetako faktura bat doan jaulki dezakezu. Bigarren fakturarako 1,99 €tik aurrera NIF bakoitzeko hileko harpidetza (bolumen-deskontuarekin) aktibatzen duzu. AEAT sandbox-eko deiak beti mugagabeak dira, doan ere.
Nola funtzionatzen du PDF zaharren OCRak?
Atarian, faktura berri bat sortzean, lehendik dagoen faktura baten PDF edo argazki bat igo dezakezu. Sistemak Claude (Anthropic) erabiltzen du eremu fiskalak ateratzeko — seriea, zenbakia, zenbatekoak, BEZ motak, hartzailea — eta formularioa betetzen dizu. Berrikusten duzu, behar bada doitzen duzu eta jaulkitzen duzu. Bikain historikoa duten bezeroentzat.
Zein erregimen onartzen dituzue?
AEAT Verifactu estatala (RD 1007/2023), SII estatala (REDEME / enpresa handiak), SII Nafarroako Foru Ogasuna, TicketBAI Bizkaia/Gipuzkoa/Álava. NaTicket Navarra bere espezifikazioa argitaratzen duenean.
Nola jakinarazten didazue faktura bakoitzaren egoera?
Sinatutako webhook-a: AEATek erantzun bezain laster, zure URLra deitzen dugu POSTaren bidez eta X-Verifactu-Signature: t=<unix>,v1=<sha256> headerrarekin. Zuk HMACa zure webhook_secret-arekin baliozkotzen duzu. Berrekintza automatikoak: 60s, 5m, 30m, 2o eta 12o huts egiten denean.
Eta AEATek nire faktura bat baztertzen badu?
Panelak kode eta deskribapen zehatzekin erakusten dizu (4112, 4105, 1100, etab.). Ahalordetzea errorea bada (4112) automatikoki errebokatzen dugu baieztapena atarian berriz sina dezazun. Datu errorea bada, zuzentzen duzu eta xehetasunetik berriz jaulkitzen duzu.
Nor zarete?
C2Developers S.I., Pamplonan (Navarra) eratutako informatika sozietatea. NIF J71554372. Urteak daramatzagu SaaS B2B egiten Espainiako pyme eta autonomoentzat. Verifactu da gure apustua gure bezeroek inoiz gehiago Ogasunarekin borrokatu behar ez izan dezaten.
Bost minutu kontuari,
bi ahalordetzeari.
Besterik ez.
Horren ondoren, zure hurrengo faktura AEATera bidaiatzen du baliozko QRarekin. Aste batean ezetz erabakitzen baduzu, kontua ezabatzen duzu. Txartelik gabe, deirik gabe.