Descarga la factura VeriFactu en PDF con tu logo

El registro VeriFactu es un XML que se remite a la AEAT, pero tu cliente quiere un PDF. Factuneo lo genera por ti a partir de la factura ya emitida, con el QR de cotejo, la mención VeriFactu y —si lo subes— tu logo.

Descargar el PDF

Una llamada a GET /api/v1/invoices/:id/pdf devuelve el documento listo para imprimir o adjuntar. No recalcula nada ni vuelve a hablar con la AEAT: pinta lo que ya consta en el registro.

curl https://factuneo.es/api/v1/invoices/INVOICE_ID/pdf \
  -H "x-api-key: vsk_tu_clave" \
  -o factura.pdf

El PDF incluye:

• Datos fiscales del emisor y del destinatario.
• Concepto y desglose de IVA por tipo.
• Totales (base, cuota, total).
• QR que permite verificar la factura contra la Sede electrónica de la AEAT.
• La mención VeriFactu y la huella SHA-256 del registro.

Sube el logo del emisor

Si el emisor tiene logo, aparece impreso bajo el nombre de la empresa en la cabecera. Se sube una vez por emisor, en base64:

BASE64=$(base64 -w0 logo.png)
curl -X POST https://factuneo.es/api/v1/emisores/EMISOR_ID/logo \
  -H "x-api-key: vsk_tu_clave" \
  -H "Content-Type: application/json" \
  -d "{\"logoBase64\": \"$BASE64\"}"

Detalles a tener en cuenta:

• Formato: PNG o JPG. El tipo se valida por el contenido real del fichero (magic bytes), no por lo que declares.
• Tamaño máximo: 2 MB. Un PNG con fondo transparente queda mejor.
• Se escala automáticamente (máx. ~46 px de alto) respetando la proporción.
• Puedes cambiarlo (vuelve a subir) o quitarlo con DELETE /api/v1/emisores/:id/logo.

Desde el panel, sin código

Si prefieres no tocar la API, en el panel (sección Emisores) cada emisor tiene un botón para subir o cambiar su logo. Panel y API operan sobre el mismo dato: lo que subas por un lado se ve por el otro.

En resumen

El XML es para Hacienda; el PDF es para tu cliente. Con un endpoint tienes el documento con QR y mención VeriFactu, y con otro le pones tu marca. Todo en la documentación.