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.
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. 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. La cantidad de Firmantes necesarios variará en función del volumen de facturas que maneje tu organización. Cada dispositivo de firma requiere un certificado. Para el cumplimiento de la normativa TicketBAI, se asigna automáticamente un certificado de dispositivo durante la creación de un Firmante, a menos que quieras proporcionar tu propio certificado de dispositivo externo. El certificado puede obtenerse a través de la respuesta a la llamada de la API.
Si vuestros clientes tienen su domicilio en el País Vasco, recuerda enviarles la guía para el registro que proporcionamos desde fiskaly, para que puedan registrar fácilmente el certificado en la hacienda foral 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 (y asegurará Verifactu en el resto del territorio español). Consulta la normativa de facturación en España para obtener información adicional sobre la creación de facturas.