Exponer Apex como REST

Hasta ahora el puente tenía un solo sentido: Salesforce llama al ERP. Ahora el ERP quiere preguntar: «¿en qué etapa está la renovación de ERP-100?». Podría usar la API estándar de Salesforce, pero tendría que conocer tus objetos y tus campos. Mejor una puerta sencilla, hecha a medida.

@RestResource(urlMapping='/renewals/*')      // la dirección: /services/apexrest/renewals/…
global with sharing class RenewalApi {
    @HttpGet                                 // responde a las peticiones GET
    global static RenewalStatus getRenewal() {
        String erpCode = RestContext.request.requestURI.substringAfterLast('/');
        // … consultar y devolver
    }
}

• @RestResource(urlMapping='/renewals/*') publica la clase en /services/apexrest/renewals/. El asterisco deja pasar lo que venga detrás, como el código ERP.
• La clase y sus métodos son global: tienen que verse desde fuera de la org. Cada verbo tiene su anotación (@HttpGet, @HttpPost, @HttpPatch, @HttpDelete), y solo un método por verbo en cada clase.
• RestContext.request trae la petición (la URL, los parámetros, el cuerpo) y RestContext.response te deja elegir el código de estado.
• Lo que devuelve el método se convierte solo en JSON: basta con devolver un objeto con sus atributos.

La nutria: La misma API que usa Data Loader, a tu medida

Cuando Data Loader o Workbench leen cuentas, llaman a la API estándar de Salesforce, que ya existe para todos los objetos. Apex REST es añadir tu propia dirección a esa API: en vez de «dame el objeto Opportunity con estos filtros», el ERP pregunta «dame la renovación de ERP-100» y tú decides qué contestar.

La nutria: ¿Y por qué no un Flow? Porque la puerta no sería la tuya

Un flow autolanzado sí se puede llamar desde fuera, por la API REST de Salesforce: una petición POST a /services/data/vXX.X/actions/custom/flow/NombreDelFlow. Funciona, pero con las reglas de Salesforce: esa URL, siempre POST y la forma de respuesta de las acciones. No puedes ofrecer un GET /renewals/ERP-100, ni contestar con un 404 cuando no existe. Con Apex REST, la URL, el verbo y el código de estado los diseñas tú.