1. Firmas Regulares
Firmasegura
  • Inicio
    • Introducción
    • Autenticación
  • Firmas Regulares
    • Firmas Regulares
    • Registrar solicitud
      POST
    • Consulta de estado de solicitud
      GET
    • Corrección de código dactilar y/o adjuntos
      PATCH
    • Schemas
      • SignatureReportItem
      • RequestTimesReportItem
      • RequestResult
      • RequestStatusValidation
      • RevocationRequest
  • Firmas Transaccionales
    • Firmas Transaccionales
    • Eventos webhook
    • Registrar solicitud
      POST
    • Consulta estado de validación
      GET
    • Obtención de certificado y resultados
      GET
    • Schemas
      • TransactionalSignatureValidationStatus
      • TransactionalSignatureProcessResult
  • Tercero Vinculado
    • Tercero Vinculado
    • Eventos webhook
    • Info
      • Evidencias de Tercero Vinculado
    • Registrar solicitud
      POST
    • Reintentar proceso de generación
      POST
    • Cancelación de solicitud
      POST
    • Reenviar correo para reclamar certificado
      POST
    • Consultar estado de solicitud
      GET
    • Reenviar correo del certificado
      POST
    • Obtener certificado .p12 y contraseña
      GET
    • Schemas
      • LinkedPartnerReportItem
      • LinkedPartnerTransactionalResult
      • LinkedPartnerRequest
      • ErrorResponse
      • LinkedPartnerResult
      • linkedPartnerRequest
      • RAIZ
  • Registro Civil
    • Registrar cédula de prueba
      POST
    • Schemas
      • TestDataMultipartRequest
      • TestDataDocumentRequest
      • TestDataDocumentResponse
      • ProblemDetail
      • GatewayErrorResponse
  • Flujo simplificado
    • Introducción
    • Eventos Webhook
    • Registrar solicitud
    • Consultar estado
    • Cancelar solicitud
  • Flujo por API
    • Flujo Por API
    • Consulta de TyC
    • Solicitud de Firma
    • Validación de Identidad
    • Solicitud de FaceLiveness
    • FaceLiveness
    • Emisión
    • Schemas
      • ApiError
  • Recursos Adicionales
    • Lista de ciudades y provincias
    • Lista de periodos de firmas
    • Lista de estados de revocación
    • Lista de estados de solicitud FR
    • Lista de tipos de solicitud FR
    • Estados de validación de solicitudes FR
    • Tipos de validación de solicitudes FR
    • Códigos de error de validación FR
    • Lista de razones de cancelación automática FR
    • Lista de estados de solicitud FT
    • Lista de estados de validacion FT
    • Lista de tipos de validación FT
    • Lista de tipos de Certificado TV
    • Lista de estados de solicitud TV
    • Tipo de Evidencias TV
    • Lista de Estados/Etapas de Sesión de FS
    • Tipos de Solicitudes
  • Flujo POS
    • Flujo POS
    • Flujo POS
      • Vigencias que el aliado puede vender
      • Cobrar y emitir un cupón
    • Schemas
      • VoucherResponse
      • ProductResponse
      • GatewayError
      • CreatePosPurchaseRequest
      • ApiValidationError
      • ApiProblem
  1. Firmas Regulares

Registrar solicitud

POST
https://api.dev-firmaseguraec.com/collector/request
Última modificación:2026-10-27 17:00:24
Endpoint para el registro de una solicitud de firma regular con la información del solicitante requerida.

Caso especial de campos requeridos#

Personas naturales con RUC#

NATURAL_PERSON puede ser para personas naturales con y sin RUC. En caso que sea con ruc se deberán llenar obligatoriamente los campos: companyRuc y pdfCompanyRuc.

Representante legal#

En caso de que la solicitud sea de tipo LEGAL_REPRESENTATIVE, se deberan incluir los campos: positionCompany, companyRuc, companySocialReason, appointmentExpirationDate, pdfRepresentativeAppointment, pdfCompanyRuc y pdfCompanyConstitution.

Personas con 65 o mas años#

En caso de que en la solicitud la edad del solicitante sea mayor o igual a 65 años se deberá incluir el video de autorización en el campo authorizationVideo.

Certificado de identidad y estado civil#

En caso de que en las imágenes frontal (identificationFront) y/o posterior (identificationBack) se encuentre un certificado de identidad como imágen, se debe especificar el campo isIdentityCertificate en true.

Términos y condiciones#

El campo termsAndConditionsId pasará a ser obligatorio.
Antes de registrar la solicitud se debe consultar GET /collector/terms-and-conditions/traditional-signature (permiso read:collector:terms_and_conditions), que devuelve la versión vigente de los términos y condiciones de firma regular. Se debe mostrar su contenido (content, en HTML) al solicitante y, una vez aceptado, enviar su id en el campo termsAndConditionsId.
Se recomienda consultar el endpoint en cada solicitud y no almacenar el id: al publicarse una nueva versión, la anterior deja de estar vigente.
Si el campo no cumple, la solicitud se rechaza con 412 Precondition Failed:
CasoMensaje
No se envía termsAndConditionsIdNo se aceptaron los términos y condiciones
El identificador no existeEl ID de términos y condiciones no existe en la base de datos
El identificador corresponde a otro tipo de firmaLos términos y condiciones no corresponden al tipo de solicitud
La versión ya no está vigenteLa versión de términos y condiciones ya no está vigente

Solicitud

Autorización
Proporciona tu token bearer en el encabezado
Authorization
al realizar solicitudes a recursos protegidos.
Ejemplo:
Authorization: Bearer ********************
Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200Éxito
application/json
Respuesta en caso de crearse la solicitud exitosamente
Bodyapplication/json

🟠409Conflict
🟠412Precondición fallida
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.dev-firmaseguraec.com/collector/request' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "identificationNumber": "1700000000",
    "fingerCode": "E4333V2422",
    "emailAddress": "john.doe@gmail.com",
    "cellphoneNumber": "+593998765432",
    "province": "PICHINCHA",
    "city": "QUITO",
    "address": "Villaflora, Calle ficita N01 y calle 2",
    "countryCode": "ECU",
    "documentType": "CI",
    "applicationType": "NATURAL_PERSON",
    "period": "ONE_YEAR",
    "referenceTransaction": "firma-regular-001",
    "termsAndConditionsId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f9a6c13",
    "identificationFront": [
        137,
        80,
        78,
        71,
        13,
        10,
        26,
        10,
        0,
        0,
        0,
        13,
        73,
        72
    ],
    "identificationBack": [
        137,
        80,
        78,
        71,
        13,
        10,
        26,
        10,
        0,
        0,
        0,
        13,
        73,
        72
    ],
    "identificationSelfie": [
        137,
        80,
        78,
        71,
        13,
        10,
        26,
        10,
        0,
        0,
        0,
        13,
        73,
        72
    ]
}'
Respuesta Ejemplo de Respuesta
200 - Ejemplo 1
{
    "requestId": "57d56177-abae-4981-82c9-93fa04bd43b0",
    "referenceTransaction": "firma-001",
    "createdAt": "2025-12-04 22:02:30"
}
Modificado en 2026-10-27 17:00:24
Anterior
Firmas Regulares
Siguiente
Consulta de estado de solicitud
Built with