← Volver a proyectos

Proyecto personal · Salesforce

API de candidaturas en Salesforce

Recibe candidaturas por REST, valida sus cambios de estado y avisa a un sistema externo cuando una candidatura pasa a entrevista.

Problema

Las candidaturas llegan desde fuera por API. Cuando una pasa a Entrevista, otro sistema tiene que enterarse. Hay que evitar duplicados y cambios de estado que no tengan sentido.

Arquitectura

Diagrama del flujo: entrada REST, upsert por IdExterno, trigger de transiciones, Queueable de notificación con reintento, sistema externo, LWC de estado y batch de retención
Flujo según el código del repositorio, versión auditada el 29/10/2026. Cada caja es una clase u objeto del repo. Si el código cambia, el diagrama se regenera.

Decisiones y alternativas descartadas

API REST propia, no la API estándar. Descartada: API estándar. Motivo: hace falta idempotencia por idExterno y códigos 400 y 409 concretos. Con la API estándar, esa lógica quedaría en el sistema que llama.

Reglas de transición en el trigger, no en el endpoint. Descartada: validar en el endpoint. Motivo: la regla también se aplica a la edición desde la ficha y a cualquier otro origen.

Validar en before update, notificar en after update. Descartada: notificar en before. Motivo: after tiene el registro ya guardado. El callout no puede ir desde el trigger, así que va en un Queueable.

Un callout por lote. Descartada: un callout por registro. Motivo: con 200 registros, una sola petición. Coste: si falla, el lote entero se reintenta junto.

Finalizer para el reintento, no Schedulable. Descartada: Schedulable. Motivo: el reintento depende del resultado del job, no de un calendario. Coste: el reintento es inmediato (ver límites).

  1. Crear por API

    Postman envía un POST a /services/apexrest/candidaturas con el identificador externo, el nombre y el estado. La API responde 201.

    Petición POST en Postman con respuesta 201 y test en verde
    Creación desde Postman con el test de código 201 en verde.
  2. Comprobar en el registro

    La ficha muestra el estado actual y solo los botones de las transiciones permitidas. Desde Recibida se puede pasar a En revisión o a Descartada.

    Ficha de Candidatura de prueba 5 en estado Recibida con botones de transición
    Componente de estado en la ficha.
  3. Leer por identificador externo

    Un GET con IdExterno__c devuelve el estado actual. Los tests comprueban el código de respuesta y el estado.

    Petición GET en Postman con dos tests en verde
    Lectura del registro con los dos tests en verde.
  4. Pasar a Entrevista

    El trigger valida la transición y encola un Queueable con las candidaturas que acaban de entrar en Entrevista. La llamada externa se hace en el job, no en el trigger.

    Apex Jobs con CandidaturaNotificacionQueueable en estado Completed y cero fallos
    El job termina en Completed, sin fallos.
  5. Enviar el lote

    Un único POST lleva todo el lote. Cada elemento tiene idExterno, nombre y estado.

    Cuerpo JSON de la petición con estado Entrevista, nombre e identificador externo
    Cuerpo JSON recibido en el destino.

Límites conocidos

Cada límite está en la auditoría del repositorio con su estado.

Documentación

Código

github.com/Kairveth/sf-candidaturas-api