Registrar solicitud

Este método permite crear una solicitud de firma tanto transaccional como tradicional, dentro del flujo de solicitudes de terceros vinculados.

Observaciones

El envío del campo password, NO es OBLIGATORIO solo sí se ha comunicado que se utilizará la configuración de OTP de FirmaSeguraEC, en caso de tener su propio proceso de recepción de firma, debe comunicarlo a FirmaSeguraEC, para que se use la configuración normal, recibiendo el password en la solicitud.

Casos Especiales

En el caso de que se emita una Firma Tradicional para Representante Legal, los campos companyRuc, positionCompany, companySocialReason y expirationDateAppointment son OBLIGATORIOS.

Si el campo certificateType es TRANSACTIONAL_SIGNATURE, el campo applicationType solo puede ser NATURAL_PERSON y además no es necesario enviar el campo Period.

Si el certificateType es TRANSACTIONAL_SIGNATURE el campo period solo puede ser ONE_DAY, por lo que por defecto este campo ya viene listo, no es necesario enviarlo en el JSON de la solicitud.

El campo password es OBLIGATORIO, solo cuando el campo certificateType es TRADITIONAL_SIGNATURE, y cuando se cumple con la configuración.

Evidencias

Para una mayor idea de como estructruar el archivo de evidencias, puede visualizar este documento que le brindará información de como hacerlo, esto es solo un ejemplo y en base a esto podrían estructurar los aliados su propio formato de evidencias. Ejemplo Evidencias

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

Authorization: Bearer ********************

Respuestas

🟠409Error de solicitud existente

application/json

Indica que la solicitud no pudo completarse debido a un conflicto con el estado actual del recurso, esto suele pasar cuando se envía una solicitud con referenceTransaction repetida.

Bodyapplication/json

🟢200Solicitud Correcta

🟢200Solicitud con errores

curl --location 'https://api.dev-firmaseguraec.com/collector/linked-partner/request' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "identificationNumber": "1023456101", "applicantName": "John", "applicantLastName": "Doe", "applicantSecondLastName": "Doe", "fingerCode": "V4444V4448", "email": "example@example.com", "secondEmail": "backup.mail@example.com", "cellphoneNumber": "+593998598514", "city": "Salcedo", "address": "Av. Amazonas 123 y Colón, Edif. Torre Azul", "documentType": "CI", "applicationType": "NATURAL_PERSON", "referenceTransaction": "TRADI-TEST-00003", "period": "FOUR_YEARS", "certificateType": "TRADITIONAL_SIGNATURE", "evidences": [ { "evidenceFile": "ewogICJpZGVudGlmaWNhdGlvbk51bWJlciI6ICIxMjM0NTY3ODkwIiwKICAiYXBwbGljYW50TmFtZSI6ICJKb3N1ZSIsCiAgImFwcGxpY2FudExhc3ROYW1lIjogIk1vcmFsZXMiLAogICJhcHBsaWNhbnRTZWNvbmRMYXN0TmFtZSI6ICJMbGFuZ2FuYXRlIiwKICAiZmluZ2VyQ29kZSI6ICJGSU5HRVItMDAxIiwKICAiZW1haWwiOiAiam9zdWUubW9yYWxlc0BleGFtcGxlLmNvbSIsCiAgImNvbXBhbnlSdWMiOiAiMDU5MDAxMjM0NTAwMSIsCiAgInBvc2l0aW9uQ29tcGFueSI6ICJEZXNhcnJvbGxhZG9yIGRlIFNvZnR3YXJlIiwKICAiY29tcGFueVNvY2lhbFJlYXNvbiI6ICJNaSBlbXByZXNhIFMuQS4iCn0K", "validatorUrl": "link-validacion.com" } ], "password": "test123", "callbackUrl": "https://play.svix.com/in/e_msAhdrcE7oslKrfJ1YoHB5shn4d/" }'

{ "timestamp": "2025-12-11 09:24:42", "status": 409, "error": "Conflict", "message": "Ya existe una solicitud con id de transacción: TRADI-LEGAL-10000", "path": "/linked-partner/request" }

Observaciones#

Casos Especiales#

Evidencias#

Solicitud

Respuestas

Observaciones

Casos Especiales

Evidencias