Salesforce

Sincronización bidireccional entre OmniBuy y Salesforce CRM.

Configuración

POST /api/v1/integrations/salesforce

{
  "enabled": true,
  "instance_url": "https://myorg.my.salesforce.com",
  "client_id": "3MVG9...",
  "client_secret": "...",
  "sync_contacts": true,
  "sync_opportunities": true,
  "sync_products": true
}

Campo	Tipo	Requerido	Descripción
enabled	bool	No	Activar/desactivar
instance_url	string	Sí	URL de instancia de Salesforce
client_id	string	Sí	Consumer Key (Connected App)
client_secret	string	Sí	Consumer Secret
sync_contacts	bool	No	Sincronizar contactos
sync_opportunities	bool	No	Sincronizar oportunidades (órdenes)
sync_products	bool	No	Sincronizar productos

Endpoints de sincronización

Sync individual

POST /api/v1/integrations/salesforce/sync/contacts/:customer_id
POST /api/v1/integrations/salesforce/sync/opportunities/:order_id
POST /api/v1/integrations/salesforce/sync/products/:product_id

Sync masivo

POST /api/v1/integrations/salesforce/sync/contacts/all
POST /api/v1/integrations/salesforce/sync/products/all

Consultar registros y reintentar

GET /api/v1/integrations/salesforce/sync/records
POST /api/v1/integrations/salesforce/sync/retry

Mapeo de campos

OmniBuy	Salesforce	Dirección
Customer	Contact	Bidireccional
Order	Opportunity	OmniBuy → Salesforce
Product	Product	Bidireccional

Errores

Código	Descripción
NOT_CONFIGURED	Salesforce no configurado
CONNECTION_FAILED	No se pudo conectar
SYNC_FAILED	Error durante la sincronización