Para clientes de SIGN DE

Guía de integración de SIGN ES para clientes de SIGN DE

Esta guía te ayuda a integrar con éxito la API de fiskaly SIGN ES y describe todos los pasos necesarios que tú y tus comerciantes deben seguir.

Configuración: creación de organizaciones

La creación y configuración de organizaciones funciona de la misma manera que en SIGN DE.

Nota: en SIGN ES, cada organización gestionada representa a un contribuyente (identificado por su NIF/número fiscal). Debes crear una organización gestionada por contribuyente, no por ubicación o tienda.

La creación de (organizaciones gestionadas) se realiza a través de la Management API de fiskaly. La adición de usuarios y la creación de claves API también se realiza a través de la Management API. Nuestra guía del proceso de integración describe con más detalle estos pasos iniciales.

SIGN ES

Como ya estás familiarizado con nuestra API de SIGN DE, implementar SIGN ES debería ser bastante sencillo. El flujo del proceso fue diseñado para ser el mismo para ambas APIs. Para facilitar aún más el proceso, las diferencias y similitudes con SIGN DE se destacan 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: Crear información del contribuyente

Utiliza este endpoint para crear el contribuyente. Este paso debe realizarse una sola vez.

Contribuyente: En SIGN ES, una organización gestionada representa a un contribuyente y su territorio fiscal (la dirección legal de la empresa). Dentro de cada organización gestionada debe crearse un contribuyente. Importante: en caso de cualquier modificación de los datos del contribuyente, debe crearse una nueva organización gestionada, ya que los datos del contribuyente no pueden modificarse posteriormente.

📘Diferencias con SIGN DE

Por el momento, no existe un endpoint equivalente en SIGN DE.

PUT: Crear un firmante

Utiliza este endpoint para crear al menos un firmante. Respecto a los campos private_key y public_key: esta información de 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 volumen de facturas especialmente elevado, pueden crearse varios firmantes. El firmante contiene un certificado que debe asociarse al contribuyente en los servidores de la autoridad fiscal.

Nota: este certificado de dispositivo es proporcionado por fiskaly o, si está disponible, también puedes utilizar uno existente.

💡Similitudes con SIGN DE

El firmante corresponde a la TSS en SIGN DE. A diferencia de SIGN DE, un firmante puede utilizarse inmediatamente, ya que no tiene estados diferentes. Por lo tanto, el proceso de implementación es aún más sencillo.

PUT: Crear un cliente

Utiliza este endpoint para crear un cliente. El cliente identifica de forma única un terminal, dispositivo POS, aplicación u otros dispositivos utilizados para emitir facturas.

Clientes: En SIGN ES, un cliente representa el dispositivo POS. Para emitir facturas necesitas un cliente por dispositivo POS y al menos un dispositivo de firma.

💡Similitudes con SIGN DE

El cliente corresponde a la entidad cliente en SIGN DE. Cada cliente está conectado a un firmante, de la misma manera que cada cliente está conectado a una 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 y no en los parámetros de ruta.

• En SIGN ES, los clientes pueden tener dos estados: ENABLED y DISABLED.
• En SIGN DE, los estados correspondientes son REGISTERED y DEREGISTERED.

Nota: a diferencia de SIGN DE, establecer el estado de un cliente en DISABLED es irreversible en SIGN ES.

PUT: Crear una factura

Utiliza este endpoint para crear una factura. client_id e invoice_id en los parámetros de ruta deben ser que tú defines.

Facturas: En SIGN ES, existen seis tipos de facturas: factura simplificada, factura completa, factura rectificativa, factura de enriquecimiento, factura externa y factura de subsanación:

1. La factura simplificada solo contiene información sobre el emisor, pero no sobre el destinatario de la factura. Esta factura solo puede emitirse 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…).
2. La factura completa incluye información tanto sobre el emisor como sobre el destinatario de la factura; es el tipo más utilizado para servicios prestados por profesionales o empresas.
3. La factura rectificativa debe emitirse cuando se ha producido un error, como en el caso de un importe incorrecto. En esta factura, los comerciantes deben indicar si se trata de una rectificación por sustitución o una rectificación por diferencias.
4. La factura de enriquecimiento puede emitirse cuando la factura original fue creada sin ningún destinatario, y la única modificación necesaria es la adición de destinatario(s).
5. La factura externa tiene como objetivo introducir los detalles de las facturas emitidas antes de la integración de la API de SIGN ES. Esto es para garantizar que puedan realizarse correcciones de conformidad con la normativa. La creación de una factura externa no desencadena una transmisión a las autoridades fiscales, ni genera un archivo XML para la factura. Una vez creada una factura externa y asignado un UUID, este UUID puede referenciarse al emitir una factura rectificativa o de enriquecimiento.
6. La factura de subsanación puede emitirse para subsanar información incorrecta de la factura que no requiera una corrección legal.

💡Similitudes con SIGN DE

Las facturas en SIGN ES corresponden a las transacciones en SIGN DE. A diferencia de SIGN DE, las facturas se envían directamente a la autoridad fiscal correspondiente. La respuesta devuelve la factura firmada e incluye también su estado de sincronización y transmisión a la autoridad fiscal correspondiente.

📘Diferencias con SIGN DE

Dado que no existe ninguna normativa que exija que las transacciones se inicien, actualizan y finalicen 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 deben colocarse de acuerdo con directrices específicas.

Los detalles pueden encontrarse aquí: Conformidad de facturas.

PATCH: Actualizar una factura

Utiliza este endpoint para actualizar una factura. Este endpoint solo debe utilizarse para cancelar una factura ya creada.

📘Diferencias con SIGN DE

En SIGN DE, no existe un endpoint específico para cancelar recibos. La gestión de cancelaciones en España es, por tanto, mucho más sencilla.

Cómo crear un recibo digital

Después de crear una factura, puede crear un recibo digital para tu factura utilizando nuestro endpoint de recibo digital. La URL devuelta puede mostrarse fácilmente como un código QR al consumidor en el proceso de pago y el recibo ya no necesita imprimirse. Esto ahorra costes, apoya el medio ambiente, aumenta la satisfacción del cliente y añade un nuevo punto de contacto con el cliente para el comerciante.

Para obtener más información sobre el recibo digital más allá de su funcionalidad básica, cómo mejorar la fidelidad del cliente y aprovechar el ecosistema de socios de fiskaly, ponte en contacto con nosotros en sales@fiskaly.com. Para la visualización de dicho recibo digital, consulta nuestra guía de recibo digital y siéntase libre de utilizar nuestra API de recibos disponible abiertamente.

¿Listo para profundizar?

Eche un vistazo a nuestro SIGN ES Quick Start: hemos creado una colección de Postman que te permite recorrer las funciones más importantes de esta API.