Saltar al contenido principal

Proceso de integración paso a paso

Para empezar el proceso de integración, te invitamos a seguir las instrucciones paso a paso detalladas a continuación.

El diagrama adjunto señala el flujo de trabajo e identifica los pasos necesarios para llevar a cabo una integración exitosa.

Para la integración, tendrás que utilizar nuestro Dashboard, Management API, y SIGN ES API. El siguiente diagrama detalla las herramientas específicas que usarás en cada paso.

SIGN ES flujo de trabajo

Paso 1: Registro

Empieza por registrarte en el Dashboard. La creación de una cuenta es el primer paso, tras el cual puedes proceder a configurar la estructura organizativa de tu empresa dentro de nuestro sistema.

Paso 2: Crear la organización principal

Continúa con la creación de tu organización principal utilizando el Dashboard. Esta organización representa al proveedor de TPV o al minorista con su propio sistema de TPV. Es necesario incluir la dirección de facturación en esta fase. Esta dirección se utilizará únicamente a efectos de facturación de fiskaly.

Paso 3: Organizaciones gestionadas

Después de establecer tu organización principal, podrás proceder a crear organizaciones gestionadas. Cada organización gestionada representa la ubicación de cada cliente o tienda, lo que te permite administrarlas individualmente. Si estás considerando automatizar tu proceso, recomendamos usar el endpoint createOrganization de la Management API.

Paso 4: Crear claves API

El siguiente paso es generar una clave API para cada organización gestionada. Esto se puede hacer a través del Dashboard o del endpoint createApiKey de la Management API. Esta clave API y el secreto son necesarios para generar un token de acceso, que se utiliza para todas las llamadas posteriores a la API.

Ten en cuenta que las claves API generadas en el entorno TEST crearán recursos TEST, mientras que las del entorno LIVE (PRODUCCIÓN) crearán recursos LIVE. Para más información, consulta nuestro artículo sobre el entorno TEST y LIVE.

A partir del siguiente paso, utilizarás nuestra API de SIGN ES. Puedes descargar nuestra colección de Postman para SIGN ES, lo cual podría facilitar tu integración al avanzar con los siguientes pasos.

Paso 5: Información del contribuyente

Es necesario añadir la información del contribuyente al sistema a través del endpoint createTaxpayer de la API de SIGN ES.

Asegúrate de indicar correctamente el campo territory de acuerdo con el domicilio fiscal del contribuyente. La API SIGN ES aplicará la legislación correspondiente basada en esto:

  • Verifactu para SPAIN_OTHER (España Peninsular), CANARY_ISLANDS, CEUTA y MELILLA
  • TicketBAI para ARABA, BIZKAIA y GIPUZKOA
  • Actualmente, no se aplica ninguna normativa fiscal a NAVARRA

Este es un paso obligatorio para garantizar que todas las facturas generadas cumplan con la normativa fiscal e incluyan todos los datos necesarios del contribuyente.

Paso 6: Crear un Firmante

A continuación, debes crear un Firmante a través del endpoint createSigner para cada organización gestionada. El firmante es responsable de la firma digital de las facturas.

Cada dispositivo de firma requiere un certificado:

  • Para el cumplimiento de Verifactu, un certificado electrónico gestionado por fiskaly se asigna automáticamente durante la creación de un firmante. Si tus clientes están ubicados en territorios donde se aplica Verifactu, asegúrate de compartir con ellos el proceso para la colaboración social con fiskaly.
  • Para el cumplimiento de TicketBAI, un certificado de dispositivo se asigna automáticamente durante la creación de un firmante, a menos que desees proporcionar tu propio certificado de dispositivo externo. Este certificado se puede obtener de la respuesta de la llamada a la API. Si tus clientes están ubicados en el País Vasco, asegúrate de enviarles la guía de registro que proporcionamos desde fiskaly. Esto les ayudará a registrar correctamente los certificados de dispositivo con la autoridad fiscal correspondiente.

Paso 7: Crear Clientes

El flujo de trabajo incluye la creación de createClient a través del endpoint createClient. Debes crear un Cliente para cada dispositivo POS u otros dispositivos de facturación utilizados en tu organización.

Paso 8: Crear facturas

Una vez completados todos los pasos anteriores, estás listo para crear facturas. Este es el paso final en el que se generan y firman las facturas. SIGN ES asegura que todas las facturas cumplen con TicketBAI en el País Vasco and with Verifactu in the rest of the Spanish territory. The compliant information is provided in the successful response of the invoice creation process.

Consulta la normativa de facturación en España para obtener información adicional sobre la creación de facturas.