Retirada de las versiones 31.0 a la 40.0 de la API de Salesforce Platform

Actualizado: 30 de abril de 2026

Fecha de publicación original: 30 de abril de 2026

¿Cuál es el estado de las versiones 31.0 a la 40.0 de las API de SOAP, REST y masiva?

• Actualmente: En estos momentos se admiten estas versiones de la API.

• Futuro: Versión Summer '27: estas versiones de API quedarán obsoletas y dejarán de ser admitidas. Puede utilizarlas, pero si encuentra problemas y registra un caso con el Servicio de asistencia de Salesforce, deberá primero actualizar la versión de la API. No habrá solución de problemas ni de fallos para estas versiones de API.

• Futuro: Versión Summer ‘28: Estas versiones de la API quedarán retiradas y se quitarán de la plataforma. Las aplicaciones que consumen las versiones quedarán interrumpidas porque las llamadas a la API fallarán y la respuesta será un error que indica que el extremo solicitado no se encuentra y la plataforma no puede procesar la solicitud. A continuación están los errores:

  • La API de REST devuelve 410: GONE.

  • La API de SOAP devuelve 500: UNSUPPORTED_API_VERSION.

  • La API masiva devuelve 400: InvalidVersion.

Nota: Las versiones 21.0 a la 30.0 de la API se retiraron y no están disponibles desde el lanzamiento de la versión Summer ’25.

¿Por qué van a retirar estas versiones de la API?

Estamos centrando nuestros esfuerzos de desarrollo en perfeccionar las versiones de la API más recientes para mejorar la experiencia general en Salesforce al crear funciones personalizadas a través de aplicaciones. Para poner las cosas en perspectiva, la versión 31.0 de la API provenía de nuestra versión Spring ‘14.

¿A qué afecta esta retirada de versiones de la API?

Esta retirada afecta a cualquier código, paquete, aplicación o integración que ejecuta una solicitud de las versiones 31.0 a la 40.0 de la API de SOAP, REST o masiva.

Nota: Esta retirada noafecta a lo siguiente:

• Versiones de API de clases de Apex, desencadenadores de Apex, páginas de Visualforce, flujos y generadores de procesos

• El producto B2B Classic/Visualforce listo para su uso

• Componentes de metadatos versionados en un paquete gestionado

• Los servicios web de REST y SOAP de Apex personalizados (un servicio web de Apex personalizado es una forma de hacer que un método de clase de Apex pueda ser llamado como una API pública. Puede aprender más sobre las servicios web de Apex aquí: Servicios web de Apex)

¿Qué acciones tengo que realizar?

1. Identifique los componentes/aplicaciones en su organización que utilizan estas versiones heredadas de la API.

2. Actualice esos componentes/aplicaciones. Antes de la versión Summer '28 debe modificar o actualizar sus aplicaciones para que funcionen con las versiones de la API admitidas y vigentes. Salesforce recomienda encarecidamente pasarse a versiones más recientes de las API ya que le proporcionan funciones avanzadas con seguridad y rendimiento mejorados.

Consulte la tabla a continuación para ver algunos lugares comunes de repercusión y qué acciones realizar para cada uno:

¿Cómo determino si se están utilizando versiones heredadas de la API en mis aplicaciones y dónde lo hacen?

Póngase en contacto con los desarrolladores de las aplicaciones que utiliza para determinar las versiones de API.

Puede revisar los eventos de API en el EventLogFile de uso total de la API que informa sobre la actividad de la API de SOAP, REST y masiva. El tipo de evento “Uso total de API” consolida información de solicitud de API entre las API de SOAP, REST y masiva, incluyendo información de versión.

Las organizaciones con capacidad para API tienen acceso a los archivos de registro de eventos de Uso total API en las últimas 24 horas.

Las organizaciones con la supervisión de eventos activada pueden acceder a este y a todos los demás tipos de archivos de registro de eventos con una retención de datos de 30 días (que se puede ampliar hasta un año a través de la configuración de Supervisión de eventos o utilizando la API de metadatos EventSettings). Para obtener más información sobre Supervisión de eventos, realice el módulo Supervisión de eventos de Trailhead.

Para revisar estos eventos de uso total de la API, primero debe descargarlos como un archivo CSV, utilizando uno de los tres métodos que se describen a continuación.

1. El primer método es utilizar el nuevo Explorador de registros de eventos incluido con la versión Summer ‘24. Así, puede explorar los archivos de registro de eventos de Uso total de la API (API Total Usage) en su organización y descargarlos como archivos CSV para ver los eventos de la API individuales.

Desde Configuración, acceda a Seguridad → Supervisor de eventos → Navegador de registros de eventos. Aquí puede ver los archivos de registros de eventos de las últimas 24 horas (o de los últimos 30 días si activó Supervisión de eventos). Puede descargar los archivos de registros de eventos individuales como archivos CSV para ver los eventos de API en ellos.

2. El segundo método consiste en usar esta herramienta, proporcionada por Salesforce, para automatizar la descarga diaria de los datos de Uso Total de API y recuperar las últimas 24 horas. Este script de Python extrae los datos del archivo EventLogFile de Uso Total de API y los descarga en archivos CSV. El script de Python utiliza la CLI de Salesforce para la autenticación y la recuperación de datos.

3. El tercer método consiste en usar manualmente un cliente como la CLI de Salesforce para ejecutar una consulta SOQL en el objeto EventLogFile, proporcionando los archivos de registro de eventos de las últimas 24 horas (o de los últimos 30 días*, si ha activado la función Supervisión de eventos).

sf data query -q "SELECT Id, LogFile, EventType, CreatedDate FROM EventLogFile WHERE EventType IN ('ApiTotalUsage')" -o <su-usuario>

Para cada resultado, realice una solicitud de la API de REST a los extremos del resultado de la consulta para recuperar los datos de registro de evento en ese archivo de registro de eventos.*

/services/data/v66.0/sobjects/EventLogFile/0AT3i000005vXpWGAU/LogFile

Pegue el cuerpo de la respuesta en una aplicación para inspeccionar fácilmente los datos del registro de eventos como un archivo .CSV.

*Para obtener información introductoria sobre la realización de una solicitud de API de REST, consulte este módulo de Trailhead Utilizar la API de REST8.

Una vez que los eventos de la API del archivo EventLogFile de uso total de la API se hayan descargado en archivos CSV, revise cada archivo CSV e identifique todas las solicitudes con una API_VERSION de 40 o inferior.

Para solicitudes de versiones 40.0 de la API y anteriores, siga las pistas proporcionadas por los campos clave siguientes en los datos del registro de eventos para ayudar a identificar el origen de la llamada de la API:

• CONNECTED_APP_ID y CONNECTED_APP_NAME indican la aplicación conectada o la aplicación cliente externa que realizó la llamada a la API.

  • Un CONNECTED_APP_ID que comience por 0H4 indica una aplicación conectada.

  • Un CONNECTED_APP_ID que comience por 0xI indica una aplicación de cliente externa.

• CLIENT_NAME es un encabezado opcional proporcionado por los clientes para ayudar a identificar las aplicaciones que realizan las llamadas a la API.

• USER_NAME identifica al usuario de su organización que se utiliza para autenticar las llamadas a la API. Aunque esto puede resultar útil para identificar el cliente de origen, tenga en cuenta que la misma cuenta de usuario del sistema puede colaborar con varios clientes.

• CLIENT_IP es la dirección IP del cliente solicitante, pero tenga cuidado si varios clientes de la misma ubicación física colaboran en la misma dirección IP.

Los socios pueden aprovechar los registros de uso de paquetes para obtener perspectivas sobre su consumo de API obsoletas.

¿Cómo puedo averiguar dónde se utilizan estas versiones de API heredadas en mi código?

Puede utilizar Salesforce Code Analyzer (Analizador de código) para averiguar dónde se utilizan estas versiones de API heredadas en su código. Consulte esta documentación.

Salesforce para Outlook

Las llamadas a la API procedentes de Salesforce para Outlook tendrán un CLIENT_NAME de "SfdcApplication/" en el archivo EventLogFile de uso total de la API. Actualizar a la última versión de Salesforce para Outlook, que utiliza una versión de la API admitida.

Microsoft Power Query

Si las llamadas a la API desde Microsoft Power Query utilizan estas versiones de API obsoletas, siga estas instrucciones para actualizar la versión de la API que utiliza Microsoft Power Query.

¿Cómo puedo obtener más información?

Para conocer las últimas versiones de API admitidas, visite el sitio de desarrolladores de Salesforce.

Acerca de las API y la mensajería saliente:

• Conceptos básicos de la API de la plataforma (Trailhead)

• Introducción a la API SOAP (Guía del desarrollador)

• Mensajería saliente (Guía del desarrollador)

• Introducción a la API Bulk 2.0 y a la API Bulk (Guía del desarrollador)

• Introducción a la API REST (Guía del desarrollador)

  • "REST" cubre todas las API con los URI de extremo bajo /services/data/vXX.Y/ y /services/metadata/vXX.Y/ donde XX.Y es la versión de la API. Esto incluye la API de REST de Salesforce Platform "estándar" para que funcione con sObjects y registros, pero también con los siguientes recursos:

    • Desarrollador de API de metadatos

    • API de herramientas

    • API de Chatter/Connect

    • API de Consultar y Consultar todo

    • API de búsquedas

    • API de límites

    • API de inicio de sesión (también denominada como "Identity")

  • Observe los resultados de una solicitud de REST a GET /services/data/v40.0 o GET /services/metadata/v40.0 para comprender los recursos de nivel superior afectados cuando se retiren los extremos de v40.0 e inferiores.

Aún necesito ayuda. ¿Qué puedo hacer a continuación?

• Revise los recursos anteriores.

• Publique en Trailblazer Community.

• Consulte el Servicio de asistencia de Salesforce a través de la Ayuda de Salesforce. Recuerde lo que ya intentó y dónde se atascó de manera que el Servicio de asistencia pueda ayudarle con la mayor eficiencia posible. Tenga en cuenta que el Servicio de asistencia no puede actualizar las API heredadas en su organización.

Puede consultar las Retiradas de productos y funciones de Salesforce para ver todas las retiradas vigentes y pasadas. Para leer sobre el enfoque de Salesforce sobre la retirada, lea nuestra Filosofía de la retirada de productos y funciones.