En esta sección encontrarás tanto preguntas frecuentes elaboradas por el equipo de VeriFacti como las FAQs publicadas por la propia AEAT en su web.
Idempotency-Key permite reintentar un envío sin riesgo de duplicarlo, por ejemplo tras un timeout o un corte de conexión. La admiten /verifactu/create, /verifactu/create_bulk, /verifactu/modify y /verifactu/cancel, y en TicketBai /ticketbai/create, /ticketbai/modify y /ticketbai/cancel.Genera una clave única por operación (una cadena ASCII imprimible de 1 a 255 caracteres; un UUID sirve) y guárdala junto a la factura antes de enviarla. Así funciona:Idempotent-Replayed: true, y no crea un registro nuevo.incidencia con el valor S.serie, numero y fecha_expedicion (y fecha_operacion si la informaste). La API consulta la AEAT y te devuelve el registro con su uuid, su estado y su huella.Idempotency-Key, también puedes repetir la misma petición con la misma clave y el mismo cuerpo: recibirás la respuesta original, con el uuid, sin crear un registro nuevo.En TicketBai, POST /ticketbai/status admite los mismos campos.bilbabit, IdSistemaInformatico A1 y la versión declarada.Si tu software es el que expide las facturas e invoca nuestra API, puedes hacer que los registros lleven su identidad. La nota del bloque SistemaInformatico del anexo de la Orden HAC/1177/2024 indica que, cuando el sistema consta de componentes de varios productores, se consignan los datos del productor del componente principal, y en una integración por API ese componente suele ser tu software. Se configura por cada NIF de Verifactu:sistema_informatico de POST /nifs, o después con PUT /nifs/{entorno}/{nif}/sistema_informatico: razón social y NIF del productor, nombre del sistema, IdSistemaInformatico (exactamente 2 caracteres, letras mayúsculas o dígitos), TipoUsoPosibleSoloVerifactu y TipoUsoPosibleMultiOT.sistema_informatico.version y sistema_informatico.indicador_multiples_ot, que calcula para cada uno de tus usuarios (FAQ 4 de la AEAT para desarrolladores). Mientras el NIF use la identidad de Verifacti se ignoran, así que conviene desplegar primero su envío y cambiar después los NIFs.S. Con tu identidad, los dos primeros son los que configuras y el tercero, el que envías en cada petición.NombreSistemaInformatico, IdSistemaInformatico 77, versión 1.0.03), por eso su XML de test no coincide con el de producción.GET /representacion/estado/:nif devuelve el enlace de firma y su fecha de caducidad (fecha_expiracion), y el firmante puede retomar el proceso en cualquier momento desde el email o desde ese enlace. Si el proceso caduca, se puede iniciar uno nuevo, que se cobra como una firma nueva.GET /representacion/estado/:nif o desde la interfaz web, en Configuración → Representación.idioma (es o en) de POST /representacion/firma_remota/:nif se pueden mostrar en inglés. Además, el objeto opcional notificacion permite personalizar el email que recibe el firmante: el nombre del remitente, el asunto y el mensaje.email es obligatorio, pero no tiene por qué ser el del titular del NIF: basta con indicar una dirección interna tuya para que tu cliente final no reciba ningún email de Verifacti. La respuesta de POST /representacion/firma_remota/:nif incluye el enlace de firma (url), así que puedes hacérselo llegar tú mismo por el canal que prefieras (tu propia aplicación, tu email, WhatsApp…). Si pierdes el enlace, GET /representacion/estado/:nif lo devuelve mientras el proceso está en estado Pendiente.PUT /representacion/cancelar/:nif o desde la interfaz web. Ten en cuenta que el coste de 2,90 € + IVA se aplica al crear el proceso, por lo que no se devuelve al cancelar; si después se inicia otro proceso, se cobra como una firma nueva.