Cómo integrar DocFiscal AI

El paso a paso completo de las tres formas de mandar tus facturas a DocFiscal AI. Sigue cualquiera de las tres tarjetas en orden, de arriba abajo -- no hace falta usar las tres, con una te sirve.

¿Te ha salido un error y no sabes qué significa? Búscalo aquí →

Vía 1 de 3 -- para cualquier persona

Buzón de correo entrante

No hace falta saber programar. Se reenvía la factura como se reenvía cualquier correo con un adjunto.

1
Entra en Configuración → Integraciones
Ahí está todo lo de esta guía, organizado en tres tarjetas.
2
Autoriza tu correo emisor
Escribe el email desde el que vas a mandar tus facturas y pulsa Guardar remitente. Solo se aceptan correos desde esa dirección exacta.
3
Pulsa Generar dirección de buzón
La app te da una dirección de correo nueva y única. No la escribas tú.
4
Copia esa dirección con el botón Copiar
Nunca la teclees a mano ni la copies de una foto o captura de pantalla -- tiene caracteres fáciles de confundir (una "i" minúscula y un "1" se ven casi iguales). Este es el paso que más gente se salta.
5
Reenvía o adjunta la factura a esa dirección
Desde el correo que autorizaste antes, crea un email nuevo, adjunta el PDF y pégala como destinatario.
6
Espera un minuto y revisa Mis facturas
Si todo cuadra, se declara sola a Hacienda -- no hace falta que hagas nada más. Solo si algún dato no cuadra se detiene, aparece como "Necesita tu confirmación" y te decimos exactamente qué corregir.

Límite a tener en cuenta: el PDF debe pesar menos de 512 KB. Una factura normal (no escaneada) casi siempre cumple esto sin problema.

Vía 2 de 3 -- para tu CRM/ERP/TPV

API síncrona -- mostrador / tienda

Para cuando alguien espera delante de ti y necesitas la factura sellada al momento. La configura un desarrollador o el soporte técnico de tu programa de caja, no se usa a mano.

1
Genera una API key con el permiso "Enviar facturas a Hacienda"
En Integraciones → Nueva API key. Ponle un nombre que reconozcas después.
2
Cópiala en cuanto aparezca
Solo se muestra una vez, por seguridad -- si la pierdes, genera otra.
3
Dale la key y esta dirección a quien configure tu programa
POST /api/v1/integrations/sync-invoice -- el programa manda el PDF con la key en la cabecera Authorization.
4
El programa recibe el PDF ya sellado, con su código QR
En la misma respuesta, casi siempre al instante. Si tarda más de la cuenta, la app avisa de que sigue en proceso en vez de dejar a la persona esperando.

Vía 3 de 3 -- para Zapier / automatizaciones

API asíncrona -- Zapier / automatizaciones

Para cuando nadie espera delante de una pantalla: un robot, Zapier, Make o un proceso programado manda la factura y sigue con lo suyo.

1
Usa la misma API key de la vía anterior, o genera una nueva
Mismo procedimiento: Integraciones → Nueva API key.
2
Apunta la automatización a esta dirección
POST /api/v1/integrations/async-invoice, mismo formato que la síncrona.
3
La app responde enseguida con un 202
Es solo un "recibido, lo proceso ahora" -- la factura se procesa después, con calma, en segundo plano.
4
Consulta el resultado más tarde en Mis facturas
O vuelve a pedir el PDF sellado una vez confirmes que la factura ya se declaró.

Recuerda: puedes usar más de una vía a la vez -- no hace falta elegir solo una. Las tres terminan en el mismo sitio: la factura pasa por interpretación y validación, y si todo cuadra se declara sola a Hacienda, sin que tengas que confirmar nada. Solo se detiene, y te avisa con el motivo exacto, cuando algo no cuadra.