SIGN ES - ¿Cómo utilizar los endpoints para el acuerdo de colaboración social?

Proporcionamos todos los endpoints que necesitas para una solución conforme a la normativa.
La API de SIGN ES requerirá toda la información necesaria para completar el anexo de colaboración social, siguiendo el modelo proporcionado por las autoridades en la Resolución del 18 de diciembre de 2024.

El Anexo 1 es el modelo de representación entre los contribuyentes y los proveedores de software, mediante el cual el contribuyente autoriza a fiskaly a transmitir los registros de facturación Verifactu a la Agencia Tributaria. La información requerida varía dependiendo de si el contribuyente es una EMPRESA (COMPANY) o una PERSONA FÍSICA (INDIVIDUAL).

Paso a paso con la API de SIGN ES

1. Asegúrate de haber proporcionado toda la información en el endpoint Crear contribuyente:
   • Nombre legal del contribuyente (legal_name)
   • NIF del contribuyente (tax_number)
   • Dirección legal del contribuyente (address). Si falta la dirección, puedes usar el endpoint Actualizar contribuyente para añadirla.
2. Usa el endpoint Generar acuerdo para generar el documento. Si falta información, lo verás reflejado en la respuesta de la API.
   • Para contribuyentes del tipo PERSONA FÍSICA, no se requiere información adicional.
   • Para contribuyentes del tipo EMPRESA, se necesita la información del representante legal:
     1. Nombre del representante (full_name)
     2. NIF del representante (tax_number)
     3. Dirección del representante (address)
3. Obtén el PDF completado del acuerdo en la respuesta exitosa del endpoint Generar acuerdo.
4. El contribuyente debe firmar electrónicamente el PDF (por ejemplo, a través de la plataforma online VALIDe o con la aplicación de escritorio AutoFirma).
5. Sube el acuerdo firmado electrónicamente usando el endpoint Subir acuerdo firmado.

Si se modifica la información del contribuyente y/o del representante legal, será necesario subir un nuevo acuerdo.

La API de SIGN ES siempre devolverá el acuerdo válido más reciente a través del endpoint Obtener acuerdo.

¿Qué información valida fiskaly en un acuerdo subido?

Cuando se envía un PDF a través del endpoint Subir acuerdo firmado, fiskaly verifica lo siguiente: 

1. Coincidencia de los datos del contribuyente
   El acuerdo debe contener el mismo nombre y número de identificación fiscal que el Contribuyente que lo presenta.
2. Presencia de la firma de fiskaly
   El PDF debe incluir la firma electrónica de fiskaly, tal como se proporcionó en el acuerdo generado originalmente.
3. Presencia de la segunda firma
   El documento también debe contener una segunda firma electrónica, asociada con el NIF de la persona que firma el acuerdo. 

Si alguna de estas condiciones no se cumple, la carga fallará y se devolverá un error:

cannot be recognized as a valid agreement

• El archivo subido no es un PDF (por ejemplo, una imagen o vídeo), o
• El archivo sí es un PDF, pero no es el generado por fiskaly. 

too few signatures

Como se requieren al menos 2 firmas en el acuerdo, este error aparece si: 

• El archivo se subió sin firmar, o
• La firma electrónica de fiskaly fue eliminada, dejando solo tu firma.

missing fiskaly seal

• La primera firma del documento no corresponde a fiskaly. 

signature does not match representative NIF

• La firma no perteneciente a fiskaly no coincide con el NIF del representante indicado en el acuerdo. 

cannot parse document

• El documento no es un PDF válido.

signature {n} is invalid

• La firma en la posición n del documento no superó la validación del servicio DSS.