Clientes de SIGN DE
SIGN ES Guía de implementación para clientes de SIGN DE
Esta guía proporciona una visión general de los pasos necesarios para implementar SIGN ES, mientras se aclaran las similitudes y diferencias con nuestra API SIGN DE.
Setup - Crear organizaciones
La creación y configuración de la organización funciona de la misma manera que en SIGN DE.
Nota: a diferencia de SIGN DE, en SIGN ES es fundamental crear una organización gestionada separada para cada ubicación (tienda).
La creación de organizaciones (gestionadas) se realiza a través de la API de gestión de fiskaly. La adición de usuarios y la creación de claves de API también se realizan a través de la API de gestión. Nuestra Guía para nuevos clientes describe con más detalle estos primeros pasos.
SIGN ES
Como ya estás familiarizado con nuestra API SIGN DE, la implementación de SIGN ES debería ser sencilla. El flujo de integración es el mismo para ambas APIs. Con el fin de facilitar el proceso aún más, las diferencias y similitudes con SIGN DE se describen en los endpoints individuales.
SIGN ES vs. SIGN DE
Una vez creada la estructura organizativa, puedes continuar paso a paso utilizando los siguientes endpoints de la API de SIGN ES:
PUT: Create taxpayer information (Crear información del contribuyente)
Utiliza este endpoint para crear información del contribuyente. Este paso sólo se realiza una vez.
Contribuyente: En SIGN ES, una organización gestionada representa a un contribuyente y su territorio fiscal (según la dirección fiscal de la empresa). Dentro de cada organización gestionada, debe crearse un contribuyente. Importante: en caso de modificación de los datos del contribuyente, deberá crearse una nueva organización gestionada, ya que los datos del contribuyente no podrán modificarse posteriormente.
Por el momento, no existe un endpoint equivalente en SIGN DE.
PUT: Create a signer (Crear un firmante)
Utiliza este endpoint para crear al menos un firmante.
Respecto a los campos private_key y public_key: esta información del certificado será proporcionada por fiskaly.
Firmantes: En SIGN ES, un firmante representa el dispositivo de firma. Debe crearse al menos un firmante, pero en escenarios con un alto volumen de facturas, pueden crearse múltiples firmantes. El firmante contiene un certificado que debe asociarse al contribuyente en el sitio web de la autoridad tributaria.
Nota: este certificado de dispositivo es proporcionado por fiskaly, pero también se puede utilizar uno existente.
El firmante se corresponde con el TSS (Sistema técnico de seguridad) en SIGN DE. A diferencia de SIGN DE, un firmante puede utilizarse inmediatamente, ya que no tiene diversos estados. Por lo tanto, el proceso de implementación es aún más sencillo.
PUT: Create a client (Crear un cliente)
Utiliza este endpoint para crear un cliente. El cliente identifica de forma única un dispositivo TPV o POS, una aplicación u otros dispositivos utilizados para emitir facturas.
Clientes: En SIGN ES, un cliente representa el dispositivo POS. Para emitir facturas se necesita un cliente por TPV y al menos un dispositivo de firma.
El cliente en SIGN ES corresponde a la entidad cliente en SIGN DE. Cada cliente está conectado a un firmante, del mismo modo que cada cliente está conectado a un TSS en SIGN DE, con la única diferencia de que la conexión entre cliente y firmante en SIGN ES se realiza en el cuerpo de la solicitud (Request body) y no en los parámetros de ruta (Path parameters).
- En SIGN ES, los clientes pueden tener dos estados:
ENABLED (HABILITADO)yDISABLED (DESHABILITADO). - En SIGN DE, los estados correspondientes son
REGISTERED (REGISTRADO)yDEREGISTERED (DESREGISTRADO).
Nota: a diferencia de SIGN DE, en SIGN ES el estado DESHABILITADO de un cliente es irreversible.
PUT: Create an invoice (Crear una factura)
Utiliza este endpoint para crear una factura.
client_id y invoice_id son establecidos como parámetros de ruta (Path parameters)
Facturas: En SIGN ES, existen tres tipos de facturas: factura simplificada, factura completa y factura rectificativa:
- La factura simplificada sólo contiene información sobre el emisor, pero no información sobre el destinatario de la factura. Esta factura sólo puede expedirse hasta un importe de 400 € y, en algunos casos específicos, hasta un importe de 3.000 € (ventas al por menor, restaurantes, servicios de aparcamiento, entre otros).
- La factura completa incluye información tanto del emisor como del receptor de la factura y es el tipo más utilizado para servicios prestados por profesionales o empresas.
- La factura rectificativa debe emitirse siempre que se haya producido un error, por ejemplo, en caso de importes incorrectos. Dentro de esta factura, los comerciantes deben elegir si se trata de una rectificación por sustitución, o de una rectificación por diferencias.
Facturas corresponde a transacciones en SIGN DE. A diferencia de SIGN DE, las facturas se envían directamente a la agencia tributaria pertinente. La respuesta devuelve la factura firmada y también incluye su estado de sincronización y transmisión.
Dado que no existe una normativa que obligue a iniciar, actualizar y finalizar las transacciones en España, esta parte de SIGN ES es mucho más sencilla que SIGN DE. A diferencia de SIGN DE, las facturas entregadas al consumidor deben incluir un código identificador y un código QR, que han de colocarse siguiendo unas directrices específicas.
Los detalles pueden encontrarse aquí:: Invoice Compliance.
PATCH: Update an invoice (Actualizar una factura)
Utiliza este endpoint para actualizar una factura. Este endpoint sólo debe utilizarse para anular una factura ya creada
En SIGN DE no existe un endpoint específico para cancelar una factura. Por tanto, la gestión de las anulaciones en España es mucho más sencilla.
Cómo crear un recibo digital
Después de crear una factura, puedes crear un recibo digital utilizando nuestro endpoint del ticket digital. La URL devuelta se muestra fácilmente como un código QR al consumidor durante el proceso de pago y así el recibo o ticket ya no debe imprimirse en papel. Esto ahorra costes, protege el medio ambiente, aumenta la satisfacción del cliente y añade un nuevo punto de contacto entre el comerciante y el cliente.
Para obtener más información sobre el recibo digital, cómo mejorar la fidelidad del cliente y aprovechar el ecosistema de partners de fiskaly, puedes ponerte en contacto con nosotros a través de sales@fiskaly.com. Para visualizar un ticket digital de este tipo, echa un vistazo a nuestra guía del recibo digital y no dudes en utilizar nuestra receipt API sin coste.
¿Listo para comenzar?
Echa un vistazo a nuestro Inicio rápido de SIGN ES - hemos creado una colección de Postman que te permite recorrer las funciones más importantes de esta API.