solicitudes-firma

Cancelar la solicitud

Cierra el trámite y libera al emisor para poder abrir otro. No se puede cancelar mientras está ENVIANDO (409): el worker está a mitad de la conversación con NewBest, que no tiene idempotencia ni consulta de estado. Roles: owner o admin.

post/solicitudes-firma/{id}/cancelar

Request

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

Path parameters

idstring uuid required

Id de la solicitud.

Response

Solicitud cancelada

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.