Identificador fiscal en Stripe Billing

En Stripe Billing, Finseed reúne el identificador fiscal disponible en la factura de Stripe y en los datos del cliente. Después lo incluye al generar la factura Verifactu. Los tipos de identificador fiscal que admite Stripe son limitados y no cubren todos los casos. No hay tipos pensados para el DNI de un particular ni para documentos extranjeros como el pasaporte. Para estos casos, puedes indicar el identificador fiscal mediante metadatos 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, Stripe también utiliza el tipo eu_vat. El valor incluye el prefijo del país, por ejemplo DE para Alemania o FR para Francia.

await stripe.customers.createTaxId('cus_123', {
  type: 'es_cif',
  value: 'B12345678'
})

Cuando Stripe finaliza la factura con un identificador fiscal del cliente, Finseed lo incluye automáticamente en la factura Verifactu.

Proporcionar el identificador fiscal mediante metadatos

Puedes añadir el campo ev_recipient_tax_id al objeto metadata de la factura de Stripe o al objeto metadata del cliente de Stripe. Su valor puede ser un NIF, DNI, NIE, CIF, un número de IVA intracomunitario o el número de un documento extranjero, como un pasaporte. Para una factura concreta, añade el metadato a la factura:

const invoice = await stripe.invoices.create({
  customer: 'cus_123',
  metadata: {
    ev_recipient_tax_id: '46766201W'
  }
})

Para que se aplique a todas las facturas que genere un cliente, añade el metadato al cliente:

await stripe.customers.update('cus_123', {
  metadata: {
    ev_recipient_tax_id: '46766201W'
  }
})

Configurarlo en el cliente es especialmente útil con suscripciones y facturación recurrente: lo defines una sola vez y se aplica a todas las facturas que el cliente genere, incluidas las renovaciones que Stripe crea automáticamente, sin tener que indicarlo en cada factura. 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).

Indicar el tipo y el país del documento

Cuando Finseed no puede reconocer automáticamente un identificador extranjero, necesita saber qué tipo de documento es y de qué país. El caso más habitual es un cliente extranjero sin NIF ni NIE al que identificas mediante su pasaporte. Junto a ev_recipient_tax_id puedes añadir dos metadatos que declaran el tipo y el país del documento:

ev_recipient_tax_id_type: tipo de documento. Los valores no distinguen mayúsculas de minúsculas.
ev_recipient_tax_id_country: país del documento, en código de dos letras ISO 3166-1 (por ejemplo, FR para Francia).

Los valores admitidos para ev_recipient_tax_id_type son los mismos que en la API de Finseed:

es_nif: NIF español, incluidos DNI y NIE.
eu_vat: número de IVA intracomunitario.
passport: pasaporte.
official_document: documento oficial de identificación expedido por el país de residencia.
residence_certificate: certificado de residencia.
other: otro documento acreditativo.
not_registered: cliente no censado en la Agencia Tributaria.

Por ejemplo, para un cliente con dirección de facturación en España identificado con un pasaporte francés:

const invoice = await stripe.invoices.create({
  customer: 'cus_123',
  metadata: {
    ev_recipient_tax_id: '18AB12345',
    ev_recipient_tax_id_type: 'passport',
    ev_recipient_tax_id_country: 'FR'
  }
})

Igual que con ev_recipient_tax_id, también puedes definir estos metadatos en el cliente de Stripe para que se apliquen a todas sus facturas. La validación censal (la comprobación del NIF contra el censo de la Agencia Tributaria) solo se aplica a los NIF españoles, así que no interviene con el tipo passport. Estos metadatos siguen estas reglas:

El identificador, el tipo y el país se leen del mismo objeto. Solo leemos ev_recipient_tax_id_type y ev_recipient_tax_id_country del mismo objeto metadata que aporta ev_recipient_tax_id. Un tipo o país declarado sin ev_recipient_tax_id a su lado se ignora.
El tipo puede permitirnos deducir el país. Si indicas el país sin el tipo, Finseed bloquea el procesado de la factura. Si indicas solo el tipo, Finseed puede deducir el país para un NIF español, not_registered o un NIF-IVA europeo con prefijo. Los demás tipos necesitan el país.
Si omites los dos, Finseed detecta automáticamente el tipo y el país a partir del formato del identificador y del país del cliente. Si no puede determinarlos, bloquea el procesado con un mensaje que explica el problema.
Si ev_recipient_tax_id_type contiene un valor no reconocido, lo tratamos como si no estuviera presente. Si además indicaste el país, se aplica la regla anterior y el procesado queda bloqueado.

Estos metadatos funcionan igual en Stripe Payments: se leen del objeto metadata del PaymentIntent y, en su defecto, del cliente. Consulta la referencia de metadatos de la ruta que uses: Checkout y Payment Links o pagos directos de Stripe.

Cómo se determina el identificador fiscal

Al generar la factura Verifactu resolvemos el identificador fiscal en este orden, y usamos el primer valor no vacío que encontramos:

Metadato ev_recipient_tax_id de la factura de Stripe, si está presente y no está vacío.
Metadato ev_recipient_tax_id del cliente de Stripe, en caso contrario.
Identificador fiscal de la factura de Stripe (customer_tax_ids, la copia de los identificadores del cliente que Stripe guarda en la factura al finalizarla), si no hay ninguno de los metadatos anteriores.

Si un metadato está vacío o solo contiene espacios, lo ignoramos y pasamos a la siguiente fuente. Si no hay ninguna de las tres, la factura se emite sin identificador fiscal. El tipo y el país declarados (ev_recipient_tax_id_type y ev_recipient_tax_id_country) acompañan a la fuente que gana: solo los leemos del mismo objeto metadata que aporta el identificador. Si el identificador procede de customer_tax_ids, el tipo y el país se detectan automáticamente. En Stripe Billing, el resto de los datos del destinatario (nombre, dirección, país) se toman automáticamente de la factura de Stripe. Los metadatos ev_recipient_tax_id* solo afectan al identificador fiscal. Para entender cuándo es obligatorio incluir el identificador fiscal, consulta cuándo puedes emitir una factura simplificada.

Solución de problemas

Si el identificador o el tipo declarado no llegan a la factura Verifactu:

Para suscripciones y renovaciones, define los metadatos en el cliente. Stripe finaliza las facturas de renovación automáticamente, sin intervención manual, por lo que es fácil que la factura se finalice antes de que llegues a editarla. Los metadatos del cliente se aplican a todas las facturas que genere.

​Proporcionar el identificador fiscal mediante los campos predeterminados

​Proporcionar el identificador fiscal mediante metadatos

​Indicar el tipo y el país del documento

​Cómo se determina el identificador fiscal

​Solución de problemas

Proporcionar el identificador fiscal mediante los campos predeterminados

Proporcionar el identificador fiscal mediante metadatos

Indicar el tipo y el país del documento

Cómo se determina el identificador fiscal

Solución de problemas