solicitudes-firma

Abrir una solicitud en BORRADOR

Precarga el titular desde el emisor, el correo del usuario actual y el catastro público del SRI (best-effort). Roles: owner o admin. Responde 409 si esa empresa ya tiene una solicitud viva: solo una a la vez por emisor, porque NewBest cobraría dos trámites y su API no tiene forma de anular ninguno.

post/solicitudes-firma

Request

  • Base URL: https://contadeo.com/api
  • URL: https://contadeo.com/api/solicitudes-firma
  • Auth: HTTP bearer

Request body

emisorIdstring uuid required
tipoFirma1 | 2 | 3 required

1 persona natural, 2 persona natural con RUC, 3 representante legal de empresa. El 4 (miembro de empresa) existe en NewBest pero está fuera de v1.

vigenciainteger required

id_firma_tiempo del catálogo; debe tener precio vigente para ese tipo (ver GET /solicitudes-firma/config).

esRenovacionboolean

Response

Solicitud creada con el titular precargado

idstring uuid
emisorIdstring uuid
estado'BORRADOR' | 'LISTA' | 'ENVIANDO' | 'EN_REVISION' | 'ERROR_DATOS' | 'ERROR_ENVIO' | 'CERTIFICADO_CARGADO' | 'CANCELADA'

BORRADOR → LISTA → ENVIANDO → EN_REVISION → CERTIFICADO_CARGADO, con las ramas ERROR_DATOS (NewBest rechazó los datos), ERROR_ENVIO (red agotada o catálogo pendiente) y CANCELADA.

pasoActual'firmacliente' | 'documentos' | 'firma' | 'contador' | 'null' nullable

Último paso que intentó el worker; dice a qué pantalla volver tras un ERROR_DATOS.

enviosinteger

Cuántas veces se pulsó enviar. Entra en el jobId para que un reenvío no colisione con el intento anterior.

tipoFirma1 | 2 | 3
tipoFirmaEtiquetastring
vigenciainteger

id_firma_tiempo del catálogo de NewBest (1..7).

vigenciaNombrestring
vigenciaDiasinteger nullable
esRenovacionboolean
newbestIdPersonastring nullable

Id numérico que el asistente de NewBest muestra al titular al terminar su registro. Sin GET en su API no hay forma de verificar que sea suyo.

valorOriginalCentavosinteger nullable

Snapshot del tarifario congelado AL ENVIAR. Null antes de eso: mientras la solicitud es editable el precio se lee del catálogo vivo.

descuentoPorcentajeinteger nullable

Descuento comercial del distribuidor en PORCENTAJE entero (0..100), no en centavos: es lo que espera descuento_firma en la API de NewBest.

valorRealCentavosinteger nullable
tarifarioVigenteDesdestring date nullable
consentimientoAtstring date-time nullable

Evidencia del consentimiento LOPDP con el que el titular autorizó comunicar sus datos a NewBest.

consentimientoVersionstring nullable
ultimoErrorstring nullable

Motivo del último ERROR_DATOS/ERROR_ENVIO, recortado a 500 caracteres.

enviadoAtstring date-time nullable
enRevisionAtstring date-time nullable
cerradoAtstring date-time nullable
certificadoIdstring uuid nullable

Certificado que cerró el trámite al subir el .p12 emitido por NewBest.

purgarAtstring date-time nullable

Cuándo se borrará la PII de la solicitud. Null mientras el plazo no empieza a correr.

purgadoAtstring date-time nullable
atascadaboolean

Lleva más de 10 minutos en LISTA o más de 30 en ENVIANDO: la cola o el worker no responden. Desde ENVIANDO atascada se puede volver a enviar.

editableboolean

true en BORRADOR, ERROR_DATOS y ERROR_ENVIO.

cancelableboolean

true en todo menos ENVIANDO, CERTIFICADO_CARGADO y CANCELADA.

createdAtstring date-time
updatedAtstring date-time

Changes

No recorded changes to this operation across all 2 revisions of this API.