跳转到主要内容

提供与Salesforce的核心同步接口。

项目描述

License: AGPL-3

销售force连接器

此模块允许在Odoo和Salesforce之间导入和导出各种模型。

它提供了创建或扩展各种同步的基础。

默认支持以下同步

  • 将账户和联系人导入Odoo合作伙伴。Salesforce是主数据库。目前不支持销售force账户的父子关系。

  • 导入或导出产品。ERP或Salesforce可以是主数据库。不支持双向同步,必须设置主数据库。

  • 将Salesforce价格簿条目导入Odoo价格表版本。Salesforce是主数据库。

  • 将赢得的机会导入Odoo。Salesforce是主数据库。

安装

要安装此模块,您需要

  • 安装simple-salesforce

    pip install simple-salesforce

  • 安装requests

    pip install requests

配置

配置与Salesforce的连接

使用Salesforce连接器访问Salesforce实例有2种支持方式

Oauth2流程
在Salesforce中

为了使用它,您必须在Salesforce管理中添加一个远程应用程序并启用Oauth2登录。应用程序最好命名为odoo_connector

创建的远程访问应用程序必须具有以下参数

允许用户 –> 所有用户均可自行授权 回调URL –> public_odoo_url/salesforce/oauth

完成后,您需要管理应用程序并确保已设置刷新令牌在撤销之前有效参数,并配置应用程序所需的授权。

在Odoo中

前往菜单 连接器 -> Salesforce -> Salesforce后端 创建一个新的后端。转到您后端的 身份验证 页面,并输入以下参数

  • 身份验证方法:选择 oauth2

  • URL:输入您的 Salesforce 实例的 URL

  • 在沙盒实例上连接:如果您在沙盒 Salesforce 实例上工作,请勾选此选项

  • OAuth2客户端密钥:输入 Salesforce 应用提供的客户端密钥

  • OAuth2密钥:输入 Salesforce 应用提供的客户端密钥

  • Odoo的公共安全URL(HTTPS):输入您在 Salesforce 中指定的回调 URL

  • OAuth2客户端授权代码:输入 Salesforce 应用提供的授权代码

导入/导出配置 页面上选择默认商店,并保存您的后端。

然后只需点击 在 Salesforce 中授权 Odoo 按钮,并按照 Salesforce 提供的说明操作。完成操作后,您的应用程序必须在 Salesforce 中获得授权,并且后端必须存在令牌。

安全警告:只有 OAuth 流程是生产就绪的。其他身份验证方法仍然是实验性的!

用户身份验证过程

此流程允许用户通过 SOAP 访问连接到 API 以获取令牌。第一步是将您的 Salesforce 实例的域和访问令牌直接传递到 Odoo 后端。

您必须拥有您实例的完整 URL(例如,https://na1.salesforce.com

您需要选择两种支持的身份验证方式之一

  • 使用用户名、密码和安全令牌

  • 使用 IP 过滤、用户名、密码和组织 ID

安全警告:这种方法比 OAuth 身份验证过程简单但安全性较低。

使用 Salesforce 配置导入/导出

一旦设置好后端,您可以在 导入/导出配置 页面上配置您的同步流程。

产品同步

第一步是选择产品同步的方向。一旦设置,就不应该再更改。

** 有可能先导入产品,然后更改方向 **

产品类型映射

Salesforce 的产品类型无法导入并映射到 Odoo。因此,您必须在 产品配置 部分手动设置映射。只需选择 Odoo 类型并将其与相应的 Salesforce 类型关联。

只需选择 Odoo 类型并输入相应的 Salesforce 类型名称。

价格簿映射

Salesforce 的货币无法导入并映射到 Odoo。您必须在 产品簿条目配置 部分手动设置映射。

只需选择一个带有所需货币的 Odoo 价格表版本,并将其与 Salesforce 中可用的货币 ISO 代码关联。

完成后,它应该看起来像这样

doc/media/config_import.png

用法

有两种方式可以使用此模块:转到后端,在 操作 页面上点击可用的操作按钮,或根据 设置/技术/自动化/计划 操作中所需的同步激活一个 cron 作业。

SF - Odoo:同步摘要

SalesForce

方向

Odoo

账户

具有复选框“是否公司”勾选的合作伙伴

联系

未勾选“是否公司”的合作伙伴,链接到父合作伙伴

州 + 国家 + 头衔

州 + 国家 + 头衔

产品

← 或 →

产品导入是为了初始导入而设计的,不应随后使用,即使它可以工作

价格簿条目

价格表项目

赢得的机会

销售订单

测试用例

在Salesforce中

创建账户
  • 向下滚动查看“联系”部分,点击“新建联系人” - 创建联系人“Marie Durand女士” - 创建联系人“Helmut”

创建机会
  • 创建“机会A” - 向下滚动查看“报价”部分,点击“新建报价”

  • 创建报价A1 - 与联系人“Helmut”相关(不属于公司A)

  • 保存

  • 向下滚动查看“报价行项目”部分,点击“添加行项目”以添加产品到报价中。

  • 勾选产品并点击选择按钮

  • 将价格改为99,设置数量=5,添加15%的折扣

  • 保存

将报价/机会设置为已赢
  • 返回报价,点击“开始同步”(并确认)

  • 重新打开机会,点击编辑并将阶段更改为“已赢”

  • 保存

在Odoo中

现在机会可以与Odoo同步。

  • 从Odoo导入已赢机会。在Odoo中导入机会将自动触发所有其他同步。例如,如果您尝试导入机会,但合作伙伴(= SF账户)在Odoo中尚未存在,连接器将自动启动此特定账户的直接导入,无需创建作业。同样适用于其他缺失的项目,如产品、价格等。

已知问题/路线图

  • 对通用代码进行清理和DRY重构

  • 扩展测试覆盖范围到产品和边缘情况

  • 改进SO变更管理

  • 在库的下一个版本中修复简单的Salesforce异常查找

  • 导入销售报价必须复制、存储并设置创建的地址为非活动状态

  • 支持删除绑定注销的使用案例

  • 测试身份验证流程并修复它

Try me on Runbot

鸣谢

图片

  • Odoo社区协会:图标

贡献者

维护者

Odoo Community Association

本模块由OCA维护。

OCA,或Odoo社区协会,是一个非营利组织,其使命是支持Odoo功能的协作开发并促进其广泛应用。

要为此模块做出贡献,请访问https://odoo-community.org

项目详情


下载文件

下载适合您平台文件的文件。如果您不确定选择哪个,请了解更多关于安装软件包的信息。

源代码分发

此版本没有可用的源代码分发文件。有关创建分发存档的教程,请参阅生成分发存档

构建分发

odoo8_addon_connector_salesforce-8.0.1.0.0-py2-none-any.whl (218.9 kB 查看哈希值)

上传时间 Python 2

由以下支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面