Com utilitzar l’API de Verifactu

Aquesta documentació correspon al mòdul Verifactu. Comprova si el tens activat des del menú d’administrador, mòduls. El mòdul Verifactu inclou una API per enviar factures a l’AEAT i fer altres accions relacionades. A continuació t’explico els exemples més comuns i com utilitzar l’endpoint. El mòdul afegeix un endpoint anomenat “verifactu”, que sempre requereix que passis l’idfactura i un action.

📤 Enviar factura

Hi ha dues maneres d’enviar factures a l’AEAT: configurar un estat de factura perquè, quan la factura assoleixi aquest estat, s’enviï automàticament. S’explica com fer-ho aquí. En aquest flux s’utilitza l’endpoint crearFacturaCliente; després només has d’actualitzar la factura i canviar l’idestado pel que dispara l’enviament. Cridar directament l’endpoint verifactu, passant l’idfactura i action = alta. Amb això indiques explícitament quina factura vols enviar a Hisenda.

🛠️ Esmenar factura

Funciona igual que l’opció 2 d‘“Enviar factura”, però utilitzant action = subsanacion.

🗑️ Anul·lar factura

Funciona igual que l’opció 2 d‘“Enviar factura”, però utilitzant action = anulacion.

📷 Obtenir QR

Si la factura ja es va enviar, pots obtenir el seu QR cridant l’endpoint verifactu amb action = qr. Rebràs la imatge del QR codificada en base64. Accions admeses (resum): alta — enviar factura; subsanacion — esmenar factura; anulacion — anul·lar factura; qr — obtenir QR en base64. Si necessites exemples de crides a l’endpoint o respostes esperades, digues-m’ho i te’ls preparo.