{"id":554,"date":"2026-10-12T03:51:22","date_gmt":"2026-10-12T01:51:22","guid":{"rendered":"https:\/\/itcons.app\/conector-stripe\/2026\/10\/12\/enviar-xml-ticketbai-desde-stripe\/"},"modified":"2026-10-12T03:51:22","modified_gmt":"2026-10-12T01:51:22","slug":"enviar-xml-ticketbai-desde-stripe","status":"publish","type":"post","link":"https:\/\/itcons.app\/conector-stripe\/2026\/10\/12\/enviar-xml-ticketbai-desde-stripe\/","title":{"rendered":"Enviar XML TicketBAI desde Stripe"},"content":{"rendered":"\n

Para enviar el XML TicketBAI<\/a> desde Stripe<\/a>, necesito un conector que lo genere<\/a>, lo firme y lo presente ante la Hacienda Foral correspondiente.<\/strong> Cobrar en Stripe no basta: tambi\u00e9n debo emitir la factura con su identificador TicketBAI y su QR.<\/p>\n

Lo organizo en 3 pasos<\/strong>:<\/p>\n

    \n
  1. Reviso la factura y los datos fiscales.<\/strong> Uso invoice.finalized<\/code> si facturo en Stripe o payment_intent.succeeded<\/code> si solo gestiono el cobro, evitando duplicados.<\/li>\n
  2. Genero, firmo y env\u00edo el XML.<\/strong> Compruebo los requisitos de \u00c1lava, Bizkaia o Gipuzkoa; en Bizkaia, tambi\u00e9n los de Batuz<\/a> y el LROE<\/a>. Reviso la respuesta fiscal: un HTTP 200 no confirma la aceptaci\u00f3n<\/em>.<\/li>\n
  3. Entrego el PDF con QR y guardo los registros.<\/strong> Desactivo el env\u00edo autom\u00e1tico de Stripe para evitar copias sin QR y conservo el XML firmado, la respuesta y la factura.<\/li>\n<\/ol>\n

    Antes de empezar, compruebo el certificado y pruebo el flujo<\/a>. Si hay rechazos o devoluciones, sigo el procedimiento correspondiente: <u>no sobrescribo una factura emitida<\/u>.<\/p>\n

    \"De
    \n

    De Stripe a TicketBAI: flujo de env\u00edo del XML<\/p>\n<\/figcaption><\/figure>\n

    Paso 1: comprueba la factura en Stripe<\/a><\/h2>\n

    Finaliza la factura y revisa los datos fiscales<\/h3>\n

    Revisa el borrador antes de finalizarlo.<\/strong> Mientras la factura est\u00e9 en estado draft<\/code>, comprueba las l\u00edneas, cantidades, descuentos e IVA. La serie y el n\u00famero deben coincidir con los gestionados en Stripe: el registro TicketBAI debe conservar ambos datos. <\/p>\n

    Una vez validada, la factura pasa del panel de Stripe al flujo TicketBAI sin cambiar tu trabajo diario. El webhook debe usar esa factura validada como \u00fanica entrada del flujo<\/strong>.<\/p>\n

    Facturar y cobrar son procesos distintos. Aunque el pago falle, la factura finalizada sigue siendo v\u00e1lida. Si solo usas Stripe para cobrar, genera la factura fiscal en el conector y desactiva el env\u00edo autom\u00e1tico de Stripe. As\u00ed, el cliente recibir\u00e1 el PDF de la factura con QR. <\/p>\n

    Procesa los eventos de Stripe sin duplicados<\/h3>\n

    Da una funci\u00f3n distinta a cada evento.<\/strong> Usa invoice.finalized<\/code> para iniciar el proceso e invoice.paid<\/code> solo para confirmar el cobro. En los pagos directos, payment_intent.succeeded<\/code> activa la generaci\u00f3n de la factura correspondiente. <\/p>\n

    Valida el webhook con Stripe-Signature<\/code> y la clave secreta del endpoint. Guarda el Event ID<\/code> y el Invoice ID<\/code> para evitar que se procese de nuevo la misma factura. La cola del conector gestiona los eventos pendientes o que llegan fuera de orden. Con ambos identificadores registrados, el conector puede generar el XML una sola vez. <\/p>\n

    sbb-itb-b01fb3c<\/h6>\n

    Paso 2: genera, firma y env\u00eda el XML<\/h2>\n

    Una vez registrados la factura o el cobro, el conector genera, firma y env\u00eda el XML sin cambiar tu flujo en Stripe<\/strong>.<\/p>\n

    Mapea los datos de Stripe al XML TicketBAI<\/a><\/h3>\n

    Con la factura validada, el conector convierte los datos de Stripe al XML TicketBAI y comprueba el archivo contra el esquema foral antes de firmarlo. <\/p>\n\n\n\n\n\n\n\n\n\n
    Origen del dato<\/th>\nDestino en TicketBAI<\/th>\nValidaci\u00f3n<\/th>\nSi falta<\/th>\n<\/tr>\n<\/thead>\n
    N\u00famero de factura y serie de Stripe<\/td>\nNumSerieFactura<\/code><\/td>\nNumeraci\u00f3n correlativa y coincidente con la factura<\/td>\nDetener la generaci\u00f3n; no inventar una numeraci\u00f3n<\/td>\n<\/tr>\n
    Datos fiscales del negocio y del cliente<\/td>\nCampos de identificaci\u00f3n fiscal<\/td>\nNIF y datos obligatorios correctos<\/td>\nCompletar los datos<\/td>\n<\/tr>\n
    Desglose fiscal de Stripe<\/td>\nDesgloseIVA<\/code><\/td>\nCoherencia entre tipos, bases y cuotas<\/td>\nRevisar Stripe Tax<\/a> o la configuraci\u00f3n fiscal<\/td>\n<\/tr>\n
    Total, moneda y fecha de expedici\u00f3n<\/td>\nImporteTotal<\/code> y FechaExpedicionFactura<\/code><\/td>\nImportes que cuadren y formato del esquema foral<\/td>\nResolver las diferencias antes de firmar<\/td>\n<\/tr>\n
    Huella y encadenamiento<\/td>\nEnlace con el registro anterior<\/td>\nContinuidad del historial<\/td>\nNo generar una nueva cadena<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Si Stripe cobra en otra moneda, el conector debe convertirla al formato fiscal exigido. <\/p>\n

    Una vez validado el XML, el siguiente paso es firmarlo y presentarlo. Puedes ver c\u00f3mo funciona este proceso en la demo del conector Stripe\u2013VeriFactu<\/a>.<\/p>\n

    Firma y env\u00eda el XML<\/h3>\n

    Comprueba que el certificado est\u00e9 vigente y que exista habilitaci\u00f3n como colaborador social. Si el proveedor act\u00faa como colaborador social, debe firmar y presentar el XML con su certificado, siguiendo la norma foral. Firmar no equivale a obtener la aceptaci\u00f3n.<\/strong> <\/p>\n

    Env\u00eda el XML a la Hacienda Foral correspondiente. En Bizkaia, int\u00e9gralo en Batuz<\/strong> mediante el LROE<\/strong>. Guarda el XML firmado, el identificador de factura, la fecha y hora de env\u00edo, la referencia de integridad y la respuesta completa. <\/p>\n

    Resuelve rechazos y fallos de env\u00edo<\/h3>\n

    Si Hacienda rechaza el XML, localiza la fase en la que se ha producido el fallo:<\/p>\n\n\n\n\n\n\n\n\n\n
    Etapa<\/th>\nResultado esperado<\/th>\nQu\u00e9 significa el fallo<\/th>\nAcci\u00f3n<\/th>\n<\/tr>\n<\/thead>\n
    Generaci\u00f3n<\/td>\nXML completo<\/td>\nFaltan datos fiscales o est\u00e1n mal mapeados<\/td>\nCorregir el origen del dato<\/td>\n<\/tr>\n
    Validaci\u00f3n<\/td>\nEsquema y reglas correctos<\/td>\nEl formato o el contenido no son compatibles<\/td>\nRevisar los campos y la documentaci\u00f3n foral<\/td>\n<\/tr>\n
    Firma<\/td>\nXML firmado<\/td>\nEl certificado ha caducado o falta habilitaci\u00f3n<\/td>\nResolver el problema del certificado o de la representaci\u00f3n<\/td>\n<\/tr>\n
    Transmisi\u00f3n<\/td>\nRespuesta del servicio<\/td>\nHay un error de conexi\u00f3n o el destino es incorrecto<\/td>\nVerificar el canal y gestionar el reintento<\/td>\n<\/tr>\n
    Aceptaci\u00f3n<\/td>\nConfirmaci\u00f3n de Hacienda<\/td>\nHay un rechazo fiscal; un HTTP 200 no basta<\/td>\nLeer el c\u00f3digo y seguir el procedimiento indicado<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Si se produce un timeout, comprueba primero si la Hacienda Foral ha recibido el registro. Despu\u00e9s, reintenta desde la cola con el mismo ID<\/strong> y registra tanto la respuesta como el estado de comunicaci\u00f3n. Si el fallo est\u00e1 en otra fase, corr\u00edgelo antes de reintentar, tambi\u00e9n sin cambiar el ID. <\/p>\n

    Los reembolsos y las notas de cr\u00e9dito deben activar una factura rectificativa o el proceso de cancelaci\u00f3n que corresponda. Nunca sobrescribas un registro emitido.<\/strong> <\/p>\n

    Paso 3: entrega la factura con QR y automatiza el flujo<\/h2>\n

    A\u00f1ade el identificador TicketBAI y el c\u00f3digo QR<\/h3>\n

    Una vez aceptado el XML, el conector a\u00f1ade el identificador TicketBAI y el c\u00f3digo QR<\/strong> al PDF final de Stripe. Antes de enviarlo al cliente, comprueba que el QR lleva al entorno de verificaci\u00f3n de la Hacienda correspondiente. <\/p>\n

    Desactiva el env\u00edo autom\u00e1tico de correos de facturas de Stripe. As\u00ed evitas que el cliente reciba una copia sin QR o dos correos. Cuando el PDF final est\u00e9 generado, el conector se encarga del env\u00edo y del registro en Stripe. <\/p>\n

    Configura el conector de Stripe de ITCONS<\/a><\/h3>\n

    El Stripe Verifactu Connector<\/a><\/em> de Stripe invoicing and tax compliance in Spain<\/a> recoge los datos de facturas y cobros para generar el PDF final. No necesitas programar ni configurar la API manualmente.<\/strong> Puedes consultar el estado, los c\u00f3digos y el PDF final desde Stripe. <\/p>\n

    Antes de activarlo, comprueba que el IVA y los impuestos est\u00e9n bien desglosados en Stripe. Personaliza tambi\u00e9n la plantilla desde Branding<\/strong>: el conector usar\u00e1 ese dise\u00f1o. <\/p>\n

    Guarda los registros y prueba antes de empezar<\/h3>\n

    Guarda en Stripe la factura, el XML firmado, la respuesta y el PDF con QR. Antes de pasar a producci\u00f3n, comprueba en el entorno de pruebas<\/strong> la configuraci\u00f3n del emisor y el manejo del certificado. <\/p>\n

    Conclusi\u00f3n: comprueba el registro TicketBAI completo<\/h2>\n

    Comprueba el estado del env\u00edo en Stripe y la respuesta de la Hacienda foral para confirmar que el registro se ha recibido y aceptado. Un pago completado no significa que el tr\u00e1mite est\u00e9 resuelto<\/strong>: si el env\u00edo sigue pendiente o ha sido rechazado, el ciclo TicketBAI en Stripe a\u00fan no est\u00e1 cerrado.<\/p>\n

    Cuando se acepte, guarda todas las evidencias del expediente: el XML v\u00e1lido, la firma, la respuesta del env\u00edo y el identificador TicketBAI del PDF con QR. Revisa que los datos de la factura emitida coincidan con el XML, sobre todo el desglose del IVA.<\/p>\n

    Repite esta comprobaci\u00f3n en los movimientos rectificativos y de devoluci\u00f3n para mantener la coherencia del registro y su sincronizaci\u00f3n con Hacienda.<\/p>\n

    FAQs<\/h2>\n

    \u00bfC\u00f3mo s\u00e9 qu\u00e9 Hacienda Foral me corresponde?<\/h3>\n

    Identifica el territorio hist\u00f3rico en el que tu empresa tiene su domicilio fiscal<\/strong> o donde desarrollas tu actividad econ\u00f3mica. Las diputaciones de \u00c1lava, Bizkaia y Gipuzkoa gestionan TicketBAI de forma independiente.<\/p>\n

    Si tu empresa opera en el Pa\u00eds Vasco, tu sistema de facturaci\u00f3n debe ajustarse a la normativa de la Hacienda Foral que te corresponda<\/strong> e integrarse con ella para enviar correctamente los registros de facturaci\u00f3n.<\/p>\n

    \u00bfC\u00f3mo gestiono TicketBAI en las suscripciones de Stripe?<\/h3>\n

    Un conector especializado automatiza TicketBAI en las suscripciones de Stripe<\/strong> sin que tengas que cambiar tu forma de trabajar ni el c\u00f3digo. Detecta cada renovaci\u00f3n en tiempo real y recoge los datos de la factura y del pago.<\/p>\n

    El conector firma digitalmente el registro, lo env\u00eda a la Hacienda correspondiente y entrega al cliente un PDF con el QR obligatorio. Puedes consultar el estado del env\u00edo y el c\u00f3digo TicketBAI<\/strong> directamente en la factura o en el pago de Stripe.<\/p>\n

    \u00bfPuedo emitir facturas si Hacienda no responde?<\/h3>\n

    S\u00ed, puedes emitir facturas aunque Hacienda no responda de inmediato<\/strong>. Si el registro no se valida o procesa correctamente por falta de respuesta o por errores, Stripe Verifactu Connector registra la incidencia y reintenta el env\u00edo autom\u00e1ticamente.<\/p>\n

    Si no recibes el CSV al emitir una factura, revisa el estado del env\u00edo<\/strong> para descartar fallos de conexi\u00f3n o errores en los datos. Comprueba tambi\u00e9n que tu certificado digital est\u00e9 vigente.<\/p>\n

    Publicaciones de blog relacionadas<\/h2>\n