Preloader

Firmas electrónicas

En esta sección, se describirán las funcionalidades clave relacionadas con las firmas electrónicas: subir, listar y eliminar. Estas acciones no solo definen la versatilidad de nuestra plataforma, sino que también ofrecen un control total sobre tus comprobantes electrónicos digitales firmados.

Subida

Esta sección detalla el proceso para cargar firmas electrónicas, enfocándose especialmente en archivos .p12. Antes de la carga, realiza la codificación en Base64 del archivo .p12. Algunos sitios en línea que se pueden usar para codificar son:

  1. https://emn178.github.io/online-tools/base64_encode_file.html
  2. https://base64.guru/converter/encode/file
Precaución: Lo más recomendado es codificar la firma electrónica en Base64 con librerías propias del lenguaje de programación utilizado, evitando el uso de páginas externas.

A continuación se describen los campos requeridos en la petición para dar de alta un archivo de firma electrónica:

Campo Tipo Obligatorio Descripción
numero-ruc PATH PARAM SÍ Empresa a la que se asociará el archivo de firma electrónica.
certificado REQUEST BODY SÍ Codificación en Base64 del archivo de firma electrónica.
descripcion REQUEST BODY SÍ Descripción del uso que se dará al archivo.
password REQUEST BODY SÍ Contraseña del archivo de firma electrónica .p12. 
curl --location 'https://api-sbox.veronica.ec/api/v1.0/empresas/:numero-ruc/firmas-electronicas' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: [INSERTE API KEY AQUÍ]' \
--data '{
  "certificado": "",
  "descripcion": "FIRMA ELECTRÓNICA DE PRUEBA",
  "password": ""
}'
curl --location 'https://api.veronica.ec/api/v1.0/empresas/:numero-ruc/firmas-electronicas' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: [INSERTE API KEY AQUÍ]' \
--data '{
  "certificado": "",
  "descripcion": "FIRMA ELECTRÓNICA",
  "password": ""
}'

Listado

Esta opción le permitirá visualizar los IDs y fechas de vencimiento de los archivos de firma electrónica cargados a la plataforma y que se encuentran asociados sólo a las empresas a las que su usuario tiene acceso.

A continuación se describen los campos requeridos en la petición para consultar los archivos de firma electrónica disponibles:

Campo Tipo Obligatorio Descripción
numeroRuc REQUEST PARAM NO Número de R.U.C. de la empresa de la cual se quiere consultar el ID y la fecha de vencimiento de su archivo de firma electrónica asociado.
razonSocial REQUEST PARAM NO Razón social (O parte de ella) de la empresa de la cual se quiere consultar el ID y la fecha de vencimiento de su archivo de firma electrónica asociado. 
curl --location 'https://api-sbox.veronica.ec/api/v1.0/empresas/firmas-electronicas?numeroRuc=0000000000000&razonSocial=VERONICA' \
--header 'X-API-KEY: [INSERTE API KEY AQUÍ]'
curl --location 'https://api.veronica.ec/api/v1.0/empresas/firmas-electronicas?numeroRuc=0000000000000&razonSocial=VERONICA' \
--header 'X-API-KEY: [INSERTE API KEY AQUÍ]'

Eliminación

A través de este servicio, usted podrá eliminar una firma electrónica de manera física. Una vez eliminada, la firma electrónica no podrá ser recuperada de ninguna manera. A continuación se describen los campos requeridos en la petición para eliminar una firma electrónica asociada a una empresa:

Campo Tipo Obligatorio Descripción
numero-ruc PATH PARAM SÍ Número de R.U.C. de la empresa de la cual se quiere eliminar el archivo de firma electrónica asociado.
firma-id PATH PARAM SÍ ID del archivo de firma electrónica. 
curl --location --request DELETE 'https://api-sbox.veronica.ec/api/v1.0/empresas/:numero-ruc/firmas-electronicas/:firma-id' \
--header 'X-API-KEY: [INSERTE API KEY AQUÍ]'
curl --location --request DELETE 'https://api.veronica.ec/api/v1.0/empresas/:numero-ruc/firmas-electronicas/:firma-id' \
--header 'X-API-KEY: [INSERTE API KEY AQUÍ]'
Ver tutorial