1. Registro Civil
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. Registro Civil

Registrar cédula de prueba

POST
https://api.dev-firmaseguraec.com/civil-registry/test-data
Última modificación:2026-10-05 16:32:41
Registra una cédula de prueba para usarla en el ambiente de pruebas de Firmasegura.
Cada cédula se registra una sola vez. No existe forma de borrarla ni de
modificarla después: si necesita cambiar los datos de una cédula que ya cargó, use
otro número.

Cómo se arma la petición#

El cuerpo es multipart/form-data con tres partes:
ParteObligatoriaContenido
dataSíLos datos de la persona, en JSON
photoSíLa fotografía, como archivo
signatureNoLa firma, como archivo
Importante. La parte data debe enviarse con el encabezado
Content-Type: application/json. Si su cliente la manda sin ese encabezado, viaja
como application/octet-stream y el servicio responde 415. En Postman se
configura en la columna Content type de la fila; en Apidog, en el selector de
tipo de la fila del formulario.

Qué se valida#

1.
dni, fingerCode, fullName, birthdate, expeditionDate y expirationDate
son obligatorios. Si falta alguno: 400 con code = VALIDATION_ERROR.
2.
expirationDate no puede ser anterior a expeditionDate. Si lo es: 400 con
code = INVALID_DATE_RANGE.
3.
La cédula debe ser nueva. Si ya la registró antes: 409 con
code = DOCUMENT_ALREADY_EXISTS.
4.
La fotografía no puede ser un archivo vacío. Si lo es: 400 con
code = EMPTY_FILE. La firma, si va vacía, se trata como no enviada y no da
error.

Límites de tamaño#

Máximo 10 MB por archivo y 20 MB por petición. Si los supera, la respuesta
es 413.

Solicitud

Parámetros del Body multipart/form-dataRequerido

Respuestas

🟢200Cédula registrada
application/json
La cédula quedó registrada y ya puede usarla en sus pruebas.
Bodyapplication/json

🟠400Datos inválidos
🟠404No disponible en este ambiente
🟠409La cédula ya existe
🟠413Archivo demasiado grande
🟠415Tipo de contenido no soportado
🔴500Error interno
🔴502Fallo de almacenamiento
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://api.dev-firmaseguraec.com/civil-registry/test-data' \
--form 'data="{
    \"dni\": \"1712345678\",
    \"fingerCode\": \"V1234I5678\",
    \"fullName\": \"PEREZ GOMEZ JUAN CARLOS\",
    \"names\": \"JUAN CARLOS\",
    \"lastNames\": \"PEREZ GOMEZ\",
    \"birthdate\": \"1990-05-14\",
    \"expeditionDate\": \"2021-03-02\",
    \"expirationDate\": \"2031-03-02\",
    \"nationality\": \"ECUATORIANA\",
    \"status\": \"CIUDADANO\"
}";type=application/json' \
--form 'photo=@"<contenido binario de foto.jpg>"' \
--form 'signature=@"<contenido binario de firma.png>"'
Respuesta Ejemplo de Respuesta
200 - Registro exitoso
{
    "message": "Cédula guardada"
}
Modificado en 2026-10-05 16:32:41
Anterior
RAIZ
Siguiente
TestDataMultipartRequest
Built with