Documentación de API para Partners de FIRMA.DIGITAL

La API V.1 ha sido diseñada para permitir a Partners terceros poder integrar de manera más transaccional y automática los procesos de obtención de un certificado digital para firma tributaria SII.

Todas las APIS siguen el estándar de representación REST y estructuras HTTP, incluyendo verbos clásicos como POST, GET, así como códigos de respuesta y error sobre una URL de fácil comprensión, cuya base es https://api-partners.firma.digital. Todas las respuestas de los servicios son en formato estándar JSON.

En caso de requerir soporte técnico, escribir a nuestra área de ingeniería para integraciones: dev@firma.digital

Proceso de pruebas, certificación, y paso a producción

El proceso de alta de nuevos partners, se desglosa en el siguiente proceso:

  1. Firma del acuerdo de partner. Al ser aceptado por FIRMA.DIGITAL, se obtiene un API KEY, única e intransferible, para establecer la conexión al servicio, así como un set de pruebas y soporte técnico para asegurar su integración.
  2. Envío de documentación y resolución de dudas técnicas que pueda tener el partner.
  3. Acceso a API KEY del ambiente de integración/certificación de FIRMA.DIGITAL.
  4. Ejecución de test en ambiente de certificación, para VB de Paso a Producción por parte de FIRMA.DIGITAL.
  5. Paso a producción partner y FIRMA.DIGITAL (nuevo API KEY).
  6. Entrega de set de códigos de compra “p_code”, los cuales son asociados 1:1 a cada certificado digital, para activación en producción.
  7. Operación y monitoreo en régimen de operación normal.

Servicios

La secuencia de obtención de un certificado digital, se divide en dos grandes procesos, asíncronos entre sí, pero secuencial en su ejecución:

  1. /certificateRequest Enrolamiento para validación del contribuyente (suscriptor) que es el titular del certificado digital, de tipo persona natural, quien actuará como un usuario autorizado frente al SII.
    1. Se deja en claro, que los datos son siempre completados en el frontend del partner por el suscriptor o titular del certificado digital, o por el partner, quien cuenta con una autorización y mandato expresa del suscriptor o titular del certificado digital para representarlo en este trámite.
    2. Es importante en este punto destacar, que todos los antecedentes y datos del titular o suscriptor del certificado digital deben son fidedignos y tal cual están impresos en el documento de identificación (cédula de identidad), ya que son consultados en línea contra el Servicio de Registro Civil.
    3. Este servicio tendrá tolerancia a corregir datos de envío sólo con 2 (dos) intentos, es decir, puede fallar una vez, corregir datos si no fueron correctamente validados, y volver a intentar. De otro modo, y por seguridad de los interesados, la solicitud no podrá ser generada en línea, y se escalará a un procedimiento de validación semi automatizado por él área de validaciones de FIRMA.DIGITAL. (ejemplo personas extranjeras con cédula vencida)
  2. /certificate Emisión y Obtención del certificado digital asignado al suscriptor, para la firma electrónica tributaria de DTE en el SII o software propietario de terceros.

    Esta secuencia se puede resumir en el siguiente diagrama de secuencia.
    API PARA CERTIFICADO DIGITAL PARA SII
    SECUENCIA API FIRMA DIGITAL

Link documentación técnica de API detallada