solicitudes-firma

Guardar el ID de persona y/o los datos del titular

Solo en BORRADOR, ERROR_DATOS o ERROR_ENVIO (409 en el resto: lo que ya se envió a NewBest no se puede cambiar por este lado, su API no tiene PUT). El titular se valida entero: cédula y RUC pasan por el validador fiscal del SRI y el celular se normaliza a 09XXXXXXXX. Roles: owner o admin.

patch/solicitudes-firma/{id}

Request

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

Path parameters

idstring uuid required

Id de la solicitud.

Request body

newbestIdPersonastring

Número que el asistente de NewBest muestra al titular al terminar su registro.

Response

Solicitud actualizada

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.