Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://www.easyverifactu.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

En Stripe Billing, EasyVerifactu obtiene el identificador fiscal del destinatario directamente de la factura de Stripe y lo incluye automáticamente al generar la factura Verifactu. Los tipos de identificador fiscal que admite Stripe son limitados y no cubren todos los casos españoles. Por ejemplo, el DNI de un particular no tiene un tipo equivalente en Stripe. Para estos casos, puedes indicar el identificador fiscal mediante un metadato en la factura de Stripe.

Proporcionar el identificador fiscal mediante los campos predeterminados

Stripe admite los siguientes tipos de identificador fiscal para clientes españoles a través de customer_tax_ids:
  • es_cif — NIF o CIF español. Úsalo para empresas y autónomos españoles con número de identificación fiscal español.
  • eu_vat — Número de IVA intracomunitario con prefijo de país (por ejemplo, ESB12345678). Úsalo para clientes con número de operador intracomunitario, incluidos los españoles.
Para clientes de otros países de la UE, el tipo de identificador sigue el patrón XXVAT, donde XX es el código de país ISO en minúsculas (por ejemplo, de_vat para Alemania, fr_vat para Francia).
await stripe.customers.createTaxId('cus_123', {
  type: 'es_cif',
  value: 'B12345678'
})
Cuando el cliente tiene un identificador asignado en Stripe, EasyVerifactu lo incluye automáticamente en la factura Verifactu sin necesidad de configuración adicional.

Proporcionar el identificador fiscal mediante metadatos

Añade el campo ev_recipient_tax_id al objeto metadata de la factura de Stripe. Su valor puede ser un NIF, DNI, NIE, CIF o número de IVA intracomunitario.
const invoice = await stripe.invoices.create({
  customer: 'cus_123',
  metadata: {
    ev_recipient_tax_id: '46766201W'
  }
})
Cuando este metadato está presente, lo usamos como identificador fiscal del destinatario en la factura Verifactu, con prioridad sobre el identificador que Stripe guarda en la factura (customer_tax_ids).

Cómo se determina el identificador fiscal

Al generar la factura Verifactu resolvemos el identificador fiscal en este orden:
  1. Metadato ev_recipient_tax_id de la factura de Stripe, si está presente y no está vacío.
  2. Identificador fiscal de la factura de Stripe (customer_tax_ids), en caso contrario.
Si el metadato está vacío o solo contiene espacios, lo ignoramos y usamos el identificador fiscal que Stripe guarda en la factura. Si no hay ninguno de los dos, la factura se emite sin identificador fiscal. En Stripe Billing, el resto de los datos del destinatario (nombre, dirección, país) se toman automáticamente de la factura de Stripe. El metadato ev_recipient_tax_id solo afecta al identificador fiscal. Para entender cuándo es obligatorio incluir el identificador fiscal y cuándo puedes emitir una factura simplificada, consulta Facturas simplificadas y completas.