Verifactu para Shopify: configuración, pedidos y reembolsos

Respuesta rápida

Una integración de Shopify con Verifactu debe decidir qué evento confirma la operación fiscal, validar el webhook, obtener los datos necesarios para la factura y tratar los reembolsos como un flujo separado. Shopify documenta eventos de Order payment y Refund create, además de reintentos y la posible eliminación de una suscripción que responde repetidamente con códigos no satisfactorios. La documentación oficial de webhooks de Shopify es la fuente para el contrato de la plataforma; la AEAT define por separado qué datos lleva el registro de facturación.

VeriFactu Fácil está en prelanzamiento. Este artículo describe el recorrido previsto, no una app pública ni un listing disponible todavía en Shopify App Store.

Qué preparar antes de instalar

Si ya utilizas otra herramienta, revisa primero cómo organizar el cambio de app de facturación en Shopify: histórico, operaciones pendientes y devoluciones necesitan un reparto claro entre sistemas.

Cuando la app esté aprobada, la instalación comenzará desde Shopify App Store: el comercio autorizará los permisos y quedará conectado con VeriFactu Fácil sin copiar código ni programar webhooks. Ese clic inicia la integración, pero no sustituye la configuración fiscal.

Antes de automatizar facturas habrá que confirmar:

1. NIF y razón social del obligado;
2. serie y reglas de numeración;
3. datos fiscales que recoge el checkout;
4. momento del pedido que genera la factura;
5. entorno de pruebas o producción;
6. certificado y autorización necesarios para la remisión.

La promesa correcta es instalación sin desarrollo, no “cumplimiento fiscal sin configuración”. La app deberá mostrar un checklist y bloquear la emisión hasta que los datos obligatorios estén completos.

El pedido no es todavía la factura

¿Ya tienes un pedido cobrado y no encuentras el documento? Consulta el checklist para un pedido pagado en Shopify sin factura antes de repetir la operación.

Shopify es el sistema de comercio: contiene pedido, líneas, cliente, impuestos, pagos, fulfilment y devoluciones. El SIF debe transformar los datos fiscales necesarios en una factura y en su registro asociado. No basta con copiar el total del pedido. La AEAT resume el contenido del registro de alta, que incluye identificación del emisor y, cuando proceda, del destinatario, número y serie, fechas, tipo de factura, importes y desglose. La integración debe conservar también el ID del pedido y del evento para reconciliar, pero no confundirlos con la numeración fiscal.

Elegir el evento de alta

Shopify permite suscribirse a eventos como creación de pedido, pago de pedido, actualización y refund. El evento de negocio que dispara la factura debe quedar escrito en la configuración. Por ejemplo:

Decisión	Ventaja	Riesgo
Crear pedido	Detecta antes la operación	Puede facturar antes del pago o de la confirmación requerida por el negocio.
Order payment	Se acerca al momento de cobro	Hay que resolver autorizaciones, capturas y pagos manuales.
Fulfilment	Alinea factura y expedición	Puede ser demasiado tarde para el proceso de facturación elegido.

No existe un evento universalmente correcto. La decisión depende del momento en que la empresa debe expedir la factura y de su política comercial y fiscal. Documenta la regla y evita generar una factura por cada evento que Shopify repita.

Validar y responder al webhook

El endpoint debe:

1. recibir la petición en una URL HTTPS pública;
2. comprobar autenticación y firma según el mecanismo configurado;
3. guardar el identificador del webhook y el payload mínimo necesario;
4. responder rápidamente;
5. procesar de forma idempotente en una cola;
6. enviar el estado de factura a la capa de integración.

La documentación oficial advierte que un destino que devuelve repetidamente un estado distinto de éxito puede hacer que Shopify elimine la suscripción. Un endpoint que realiza toda la generación fiscal antes de responder puede provocar reintentos, duplicados y la pérdida del webhook. La remisión a la AEAT debe tener su propia cola y reconciliación. La guía de API de VeriFactu Fácil explica el patrón de idempotencia por canal e identificador externo.

Datos de cliente y F1/F2

Hay que distinguir un campo nativo de Shopify de una extensión añadida por una app. Que una de esas vías esté disponible no demuestra que el programa de facturación lea correctamente el dato.

Shopify documenta un campo adicional NIF/DNI para pedidos con destino España, en acceso anticipado y disponible por solicitud a su soporte. No debe darse por activado en todas las tiendas.

La documentación sitúa estos campos en la tienda online, tras introducir una dirección de envío completa y válida. No los presenta como campos de Shopify POS ni de su app móvil.

Consulta los requisitos y solicita acceso en la guía oficial de campos fiscales adicionales.

Por separado, las extensiones en los pasos de información, envío y pago requieren Shopify Plus. La documentación de extensiones de checkout describe esa restricción.

No afirmamos que VeriFactu Fácil ya lea el campo nativo ni que haya una alternativa validada para cada plan. Antes de elegir la integración, confirma la pantalla de captura y el recorrido del dato hasta la factura.

Este checklist es una propuesta de prueba para el comercio, no una lista de capacidades ya verificadas de nuestra app:

Comprobación	Evidencia que conviene guardar
¿Está habilitada la vía de recogida en tu tienda?	Confirmación del proveedor y pantalla donde aparece
¿Cuándo ve el cliente el campo?	Recorrido completo con el destino y método de compra utilizados
¿El dato queda vinculado al pedido correcto?	Referencia de pedido y ubicación del dato en Shopify
¿Llega al programa de facturación antes de emitir?	Resultado de una prueba, con datos sintéticos y entorno separado
¿Qué sucede si falta o es incorrecto?	Mensaje visible y procedimiento de revisión, sin valores inventados

Ejemplo: una tienda ve el NIF en Shopify, pero su conector no lo recibe. El campo visible solo prueba la captura; aún falta comprobar la transferencia y el uso del dato antes de emitir.

Haz estas comprobaciones en un entorno de pruebas separado. No publiques capturas con identificadores personales de clientes reales.

El NIF que Shopify tenga en un campo, tax ID o metafield es un dato de entrada. No decide por sí solo el tipo de factura. La guía F1/F2 existente recuerda que la clave depende del documento emitido y del supuesto de factura simplificada, no de una única casilla del checkout.

Antes de emitir, valida:

• nombre o razón social;
• NIF y país cuando proceda;
• dirección exigida;
• líneas, cantidades, descuentos y portes;
• tipo de IVA, exención o inversión cuando correspondan;
• moneda, fechas y serie;
• regla de factura completa o simplificada.

Si los datos son insuficientes, el sistema debe detener o marcar la operación para revisión. Rellenar el NIF con un valor ficticio o inferir F1 por la presencia de una cadena no es una solución.

Reembolsos totales y parciales

Para comprobar cantidades con un caso concreto, utiliza el ejemplo de reembolso parcial de producto y portes. Distingue el dinero devuelto del desglose de la corrección fiscal.

La documentación de Shopify sobre reembolsos indica que se puede reembolsar un pedido completo o solo una parte y que el reembolso no se revierte desde el administrador una vez iniciado. Para Verifactu, el adaptador debe:

1. verificar que existe factura original;
2. registrar el refund ID y sus líneas;
3. calcular el importe rectificable por tipo impositivo;
4. evitar procesar el mismo refund dos veces;
5. generar la rectificativa que corresponda;
6. mantener el vínculo con la factura original.

No conviertas automáticamente una cancelación de pedido en un registro de anulación: la decisión depende de si la factura llegó a expedirse y de la naturaleza de la corrección. Consulta anulaciones y rectificativas.

Pruebas que sí merecen la pena

Antes de empezar, sigue el recorrido de un pedido de prueba en Shopify y Verifactu: poner el pago en modo test no confirma el entorno fiscal del conector.

Descarga la hoja de pruebas para comercios y agencias (CSV). Registra el resultado observado y su evidencia; la lista no acredita que una integración haya superado las pruebas ni certifica cumplimiento fiscal.

• pago aprobado y webhook duplicado;
• pedido con dos tipos de IVA;
• reembolso parcial de una línea;
• reembolso de gastos de envío;
• pago fallido seguido de pago aprobado;
• evento recibido fuera de orden;
• error de datos del cliente;
• caída de red después de guardar el registro;
• sandbox separado de una tienda real.

Una respuesta HTTP satisfactoria del endpoint no demuestra que el registro fiscal tenga estado correcto. Muestra el estado de la AEAT en el panel o cola de la integración, como se describe en errores y respuestas.

Estado de la integración

¿Necesito Shopify Plus para cualquier recogida de NIF? No confundas la restricción de las extensiones de checkout con el campo nativo en acceso anticipado. Confirma con Shopify y con el conector la vía aplicable a tu tienda.

¿Ver un NIF garantiza una factura F1 correcta? No. La recogida del dato, su validación, el tipo de documento y la emisión son comprobaciones distintas. Revisa la guía F1/F2.

¿Dónde puedo consultar mi caso? Cuéntanos tu plan de Shopify y cómo recoges los datos fiscales. La consulta sirve para revisar el encaje, no confirma una funcionalidad disponible o un resultado fiscal.

La página pública de Shopify está marcada como prelanzamiento y el marketplace no se declara publicado. VeriFactu Fácil no ofrece todavía una descarga o alta pública; cualquier fecha, compatibilidad de versión o alcance de reembolsos queda pendiente de validación cuando se abra el servicio.