Cuando conectas Stripe con Facturaz, dos sistemas pueden acabar generando documentos para el mismo pago: Stripe genera sus propios recibos y facturas, y Facturaz genera la factura oficial Veri*Factu. Los documentos de Stripe no tienen validez fiscal en España, así que un cliente podría recibir dos papeles y no saber cuál vale.
El arreglo lleva unos cinco minutos y solo se hace una vez en tu propia cuenta de Stripe: marca las facturas de Stripe como proforma y deja que Facturaz emita las oficiales.
1. Añade el prefijo "PROFORMA" a las facturas de Stripe
En el Dashboard de Stripe, abre Settings > Billing > Invoice template. En el campo Prefix, escribe PROFORMA- y guarda. Las facturas de Stripe se numerarán PROFORMA-0001, PROFORMA-0002, dejando claro que no son documentos fiscales.
2. Añade una nota informativa
En la misma sección Invoice template, busca el campo Footer o Memo y añade una línea como: "Este documento es solo informativo y no tiene validez fiscal. La factura oficial la emite Facturaz conforme a Veri*Factu." Guarda los cambios.
3. Desactiva los correos de facturas de Stripe
Abre Settings > Billing > Emails y desactiva Email invoices and receipts to customers, para que tus clientes solo reciban la factura oficial de Facturaz. Si quieres que Stripe siga enviando una confirmación de pago sencilla, deja los recibos activados y desactiva solo las facturas.
4. Oculta las facturas en el Customer Portal
Si usas el Customer Portal de Stripe, abre Settings > Billing > Customer portal y desactiva la visibilidad de Invoice history. De lo contrario, los clientes seguirían viendo ahí los documentos proforma.
5. Pide el NIF del comprador en ventas de más de 400 €
Una venta de más de 400 €, IVA incluido, necesita una factura completa con el NIF del comprador (Real Decreto 1619/2012, artículos 4 y 6.1.d). Si falta el NIF, Facturaz guarda la venta como borrador y lo añades ahí. Para que estas facturas salgan solas, pide el NIF cuando tu cliente paga. Elige cómo vendes:
Vendo con Stripe Checkout o Payment Links
Para empresas, activa en Stripe la recogida de identificadores fiscales. El comprador marca que compra como empresa y escribe su NIF o su número de IVA europeo.
Para particulares y compradores de fuera, añade un campo personalizado de texto con la etiqueta NIF / NIE / Pasaporte. Facturaz lo reconoce por su etiqueta.
Mi tienda online cobra con un plugin de Stripe, como WooCommerce
Añade un campo llamado NIF / NIE / Pasaporte a la página de pago de tu tienda. Después pide a tu desarrollador o al soporte del plugin de Stripe que lo envíe a Stripe como metadata con el nombre facturazTaxId. WooCommerce explica cómo en su guía de Stripe.
Tengo una página de pago propia (desarrolladores)Añade el identificador fiscal del comprador a mis pagos de Stripe para que Facturaz emita facturas completas. Lee todo este encargo antes de cambiar código. Cómo funciona Facturaz Facturaz (facturaz.es) está conectado a mi cuenta de Stripe y convierte cada venta cobrada en una factura española. Una venta de más de 400 € (lo que paga el comprador: IVA, envío y propinas incluidos) necesita una factura completa con el NIF, NIE, pasaporte o número de IVA europeo del comprador (Real Decreto 1619/2012, artículos 4 y 6.1.d). Sin identificador, Facturaz guarda esa venta como borrador hasta que lo añado a mano. Una venta de 400 € o menos puede ir sin él, pero si el comprador da un identificador, la factura lo lleva. Facturaz lee cada venta de un evento de Stripe, según cómo se cobró: - Una sesión de Checkout en modo payment, Payment Links incluidos: checkout.session.completed, o checkout.session.async_payment_succeeded en los métodos de pago diferidos. - Una factura de Stripe, suscripciones incluidas: invoice.paid. - Cualquier otro PaymentIntent (tu propio formulario, Stripe Terminal, el Dashboard): payment_intent.succeeded. Dónde busca Facturaz el identificador, gana el primero que encuentra: 1. Los identificadores fiscales de Stripe: el formulario de identificador fiscal de Checkout (customer_details.tax_ids), los guardados en el Customer o los de la factura. 2. Un campo personalizado de Checkout con la clave facturazTaxId. En un Payment Link creado en el Dashboard, un campo de texto cuya etiqueta nombra el identificador, como "NIF / NIE / Pasaporte". 3. Metadata con la clave facturazTaxId. Checkout: la sesión, después su PaymentIntent, después el Customer. Factura de Stripe: la factura, después la suscripción, después la sesión de Checkout que empezó la suscripción, después el Customer. Otros PaymentIntents: el PaymentIntent, después su Customer. Dónde busca Facturaz el nombre, la dirección y el país del comprador: - Checkout: customer_details. El nombre es business_name, si no individual_name, si no name. - Factura de Stripe: customer_name y customer_address de la factura. Stripe los copia del Customer al finalizar la factura y no los vuelve a cambiar. - Otros PaymentIntents: con Customer, el nombre y la dirección del Customer (los billing_details no se leen). Sin Customer, los billing_details del cargo. Un pago con tarjeta presencial sin Customer no nombra a nadie. Qué construir 1. Encuentra cada sitio de este código que cobra con Stripe y dime cuál de los casos de abajo es cada uno. Cámbialos todos. 2. Sesiones de Checkout con ui_mode hosted_page o embedded_page, y Payment Links creados con la API: - Empresas: tax_id_collection: { enabled: true }. Nunca pongas tax_id_collection.required: obliga a todo comprador de un país admitido a dar un identificador de empresa, así que los particulares no podrían pagar. - Los demás, este campo personalizado: custom_fields: [{ key: 'facturazTaxId', label: { type: 'custom', custom: 'NIF / NIE / Pasaporte' }, type: 'text', optional: !idRequired, }] idRequired es true cuando lo que paga el comprador puede pasar de 400 € (40000 céntimos en EUR). Si el total es fijo al crear la sesión, compáralo. Si el comprador aún puede cambiarlo en la página (cantidades ajustables, códigos promocionales, artículos opcionales, tarifas de envío, Stripe Tax sumando el impuesto al precio), el campo no puede seguir al total final. Pregúntame si lo hago obligatorio siempre que el total pueda pasar de 400 €, o lo dejo opcional y esas ventas esperan como borrador. - Checkout admite tres campos personalizados. Si una sesión ya tiene tres, avísame en vez de quitar uno. - billing_address_collection: 'required', para que la factura lleve la dirección y el país del comprador. - name_collection: { individual: { enabled: true, optional: true } }, para que la factura lleve el nombre del comprador y no el del titular de la tarjeta. La razón social de una empresa sale del formulario de identificador fiscal. - Una empresa que indica que compra como empresa ve el formulario de identificador fiscal y el campo personalizado. Por encima de 400 € rellena los dos, y se usa el de Stripe. 3. Sesiones de Checkout con ui_mode elements: ahí no se admiten campos personalizados. - Añade tu propio campo de texto con la etiqueta "NIF / NIE / Pasaporte", obligatorio mientras el total en vivo de la sesión pase de 400 €. - Antes de que el comprador confirme, envía el valor a tu servidor y llama a checkout.sessions.update(sessionId, { metadata: { facturazTaxId: value } }). - Empresas: tax_id_collection en la sesión y el Tax ID Element de Stripe. Activa name_collection.business para que el elemento pida la razón social. - Recoge el nombre del comprador con name_collection.individual y checkout.updateIndividualName. 4. Formulario propio con el Payment Element y PaymentIntents, sin sesión de Checkout: - Añade el mismo campo, obligatorio cuando el importe pase de 400 €. - Pon metadata: { facturazTaxId: value } en el PaymentIntent antes de confirmarlo: al crearlo, o con paymentIntents.update antes de confirmPayment. Facturaz lee el PaymentIntent tal como estaba al cobrarse, así que la metadata añadida después nunca se ve. - Si el PaymentIntent tiene Customer, pon el nombre y la dirección en el Customer antes del cobro (customers.update). Sin Customer, pasa billing_details con nombre y dirección. El Payment Element no pide el nombre en los pagos con tarjeta por defecto: pon fields.billingDetails.name en 'always' o recógelo tú. - Stripe Terminal: asocia un Customer con el nombre y la dirección del comprador y pon el identificador en la metadata del PaymentIntent. 5. Suscripciones y otras facturas de Stripe: - Empezadas en Checkout: el paso 2 las cubre. Facturaz lee el campo personalizado de la sesión que empezó la suscripción en cada renovación. Calcula idRequired con la factura más alta que vaya a generar, renovaciones incluidas. - Creadas con la API, y facturas hechas en Stripe: pon metadata: { facturazTaxId: value } en el Customer. Facturaz lee el Customer al cobrarse cada factura, así que un cambio llega a las siguientes. La metadata en la suscripción también sirve, pero solo para las facturas finalizadas después de ponerla. - Pon el nombre y la dirección del Customer antes de que se finalice la primera factura. Reglas - Escribe la clave facturazTaxId igual en todas partes. Facturaz acepta también otras mayúsculas y separadores, pero usa una sola forma. - Envía lo que escribió el comprador, sin espacios al principio ni al final. Comprueba solo que no esté vacío: Facturaz comprueba el carácter de control de NIF, NIE y CIF españoles y los números de IVA europeos en VIES. Una venta con un identificador que no cuadra espera como borrador mostrando lo que escribió el comprador. - Una venta con identificador necesita el nombre del comprador, sea cual sea el importe, y un pasaporte u otro identificador extranjero necesita su país. Sin ellos la venta espera como borrador. - Un número de IVA europeo en el campo facturazTaxId no cambia lo que cobra Stripe Tax. Para la inversión del sujeto pasivo, la empresa debe usar el formulario de identificador fiscal de Stripe. - No pongas en ningún pago una metadata llamada source con un valor que empiece por facturaz_: Facturaz los salta como suyos. - En otra moneda, el límite de 400 € es en euros al tipo del BCE de la fecha de la venta, y Facturaz deja esas ventas para que yo las revise. - El identificador es un dato personal: no lo guardes en logs ni lo envíes a analítica. Prueba Facturaz solo lee pagos reales, así que un pago en modo de prueba nunca se convierte en factura. Comprueba en el modo de prueba de Stripe que el identificador llega a donde lo lee Facturaz: paga más de 400 € con un DNI (12345678Z), mira el campo o la metadata en el evento, la sesión, el PaymentIntent o el Customer, y comprueba que están el nombre y el país. Haz lo mismo con un identificador de empresa en el formulario de Stripe. Cuando termines, dime qué caminos de pago cambiaste y cómo los probaste.
Empresas: tax_id_collection en la sesión de Checkout, nunca con required (los particulares no podrían pagar). Un identificador dado ahí siempre tiene prioridad, y es el único que cambia lo que cobra Stripe Tax.
Los demás: un solo nombre, facturazTaxId. En Checkout alojado o integrado, un campo personalizado de texto con esa clave, obligatorio cuando lo que paga el comprador puede pasar de 400 €:
custom_fields: [{
key: 'facturazTaxId',
label: { type: 'custom', custom: 'NIF / NIE / Pasaporte' },
type: 'text',
optional: !idRequired,
}]Checkout en modo elements no tiene campos personalizados: envía el identificador de tu propio campo como metadata de la sesión de Checkout (checkout.sessions.update) antes de que el comprador pague. Con el Payment Element y tus propios PaymentIntents, ponlo en la metadata del PaymentIntent antes de confirmarlo. En una suscripción creada con la API, ponlo en el Customer. Una suscripción que empezó en Checkout conserva su campo personalizado.
metadata: { facturazTaxId: 'X1234567L' }Una venta con identificador necesita el nombre del comprador, sea cual sea el importe, y un pasaporte necesita su país. Facturaz solo lee pagos reales, así que un pago de prueba nunca se convierte en factura.
Qué comprueba Facturaz
Un NIF, NIE o CIF español debe cuadrar con su carácter de control y un número de IVA europeo se comprueba en VIES. Un identificador que no cuadra nunca llega a una factura: la venta espera como borrador, su aviso muestra lo que escribió el comprador y lo corriges ahí. Una venta de más de 400 € sin ningún identificador, como un cobro con lector de tarjetas, espera igual.
El resultado
- Tus clientes reciben solo la factura oficial Veri*Factu de Facturaz.
- Los documentos de Stripe quedan marcados como PROFORMA para tus registros.
- Sin duplicados ni confusión sobre qué factura es válida.
Una limitación actual: con las facturas de Stripe ocultas, los clientes ya no pueden verlas en el Customer Portal de Stripe. Hoy por hoy es la forma más limpia de evitar duplicados.
