La REST API de Salesforce permite integrar el CRM con otras aplicaciones (ERP, ecommerce, BI, sistemas de gestión, etc.) mediante un conjunto de recursos y operaciones que exponen los datos de Salesforce de forma estándar.
Mediante la API de Salesforce se puede leer, crear, actualizar y eliminar registros de objetos estándar y personalizados, ejecutar consultas, acceder a metadatos y automatizar procesos. A continuación se resumen los recursos principales y los campos más relevantes.
OBJETOS (sObjects)
Los objetos en Salesforce son estructuras que almacenan datos (similares a tablas). La REST API trabaja con objetos estándar (Account, Contact, Opportunity, Order, Product, etc.) y objetos personalizados (Custom__c).
- Id – Identificador único del registro.
- CreatedDate – Fecha de creación del registro.
- LastModifiedDate – Fecha de última modificación.
- OwnerId – ID del usuario propietario.
- Name – Nombre o referencia principal (puede variar según objeto).
- Status – Estado del registro (cuando aplica).
- Fields personalizados – Campos definidos por el cliente (terminan en
__c).
Los objetos se consultan mediante operaciones REST como GET /services/data/vXX.X/sobjects/{ObjectName}/{Id} o con SOQL por medio del endpoint /services/data/vXX.X/query?q=.
ACCOUNTS (Cuentas)
Objeto estándar que representa organizaciones o empresas con las que se interactúa comercialmente.
- Id – Identificador único de la cuenta.
- Name – Nombre de la cuenta.
- Type – Tipo de cuenta (Prospecto, Cliente, Socio, etc.).
- Industry – Sector industrial.
- Phone – Teléfono principal.
- BillingAddress – Dirección de facturación.
- ShippingAddress – Dirección de envío.
- Website – URL del sitio web.
- OwnerId – ID del usuario propietario.
CONTACTS (Contactos)
Objeto estándar que representa personas asociadas a cuentas u oportunidades.
- Id – Identificador único del contacto.
- FirstName – Nombre de pila.
- LastName – Apellidos.
- Email – Correo electrónico.
- Phone – Teléfono principal.
- AccountId – ID de la cuenta asociada.
- MailingAddress – Dirección de correspondencia.
- OwnerId – ID del usuario propietario.
OPPORTUNITIES (Oportunidades)
Objeto estándar para registrar posibles ventas u oportunidades comerciales.
- Id – Identificador de la oportunidad.
- Name – Nombre o título de la oportunidad.
- StageName – Fase del proceso de venta.
- CloseDate – Fecha esperada de cierre.
- Amount – Importe asociado.
- Probability – Probabilidad de cierre.
- AccountId – Cuenta asociada.
- OwnerId – Propietario.
ORDERS (Pedidos)
Objeto utilizado para registrar pedidos de venta u órdenes internas, dependiendo de configuración y objetos extendidos.
- Id – Identificador del pedido.
- AccountId – Cuenta (cliente) asociada.
- EffectiveDate – Fecha efectiva del pedido.
- Status – Estado del pedido.
- TotalAmount – Importe total del pedido.
- OwnerId – Responsable asignado.
- Description – Descripción o comentarios.
PRODUCTS (Productos)
Salesforce permite definir objetos de producto estándar (Product2) para representar artículos en el catálogo, con campos para descripción y precios.
- Id – Identificador del producto.
- Name – Nombre del producto.
- ProductCode – Código de producto.
- IsActive – Activo o no.
- Description – Descripción del producto.
- Family – Familia o categoría.
QUERY (SOQL)
Salesforce permite realizar consultas más complejas mediante el uso de SOQL (Salesforce Object Query Language) que se puede invocar a través del endpoint REST:
- Endpoint –
/services/data/vXX.X/query?q=SELECT+... - Retorna – Un conjunto de registros que cumplen la consulta.
- Limit – Se puede paginar usando
nextRecordsUrl.
OPERACIONES CRUD
Con la REST API de Salesforce se pueden realizar operaciones estándar:
- GET – Recupera registros (
/sobjects/ObjectName/Id). - POST – Crea nuevos registros (
/sobjects/ObjectName/). - PATCH – Actualiza registros existentes.
- DELETE – Elimina registros.
Si quieres ver cómo aprovechamos estas entidades para integrar Salesforce con ecommerce, ERP o cualquier otra aplicación mediante NubyHub, ponte en contacto con nuestro equipo y te ayudamos a diseñar la integración que necesitas.
