Envia.com 与 Odoo 集成指南：多承运商运输、标签生成与配置教程
Envia.com 集成
Envia.com 是一个在 Odoo 中连接企业与多个承运商的物流服务。主要功能包括：
- 多承运商 & 国际运输：比较各承运商的费率，选择国内或全球运输的最佳方案。
- 自动标签生成：在订单确认时生成运输标签。
- 实时费率计算：根据包裹信息和目的地获取费率。
在 Envia 中设置
要将 Envia.com 与 Odoo 集成，首先创建账号并激活所需的运输承运商。随后获取用于连接 Envia.com 与 Odoo 数据库的 API 凭证。
创建账号并激活承运商
打开 Envia.com。
登录后，在左侧边栏点击 设置 --> 打印选项和承运商。随后选择国家以设定货币并显示可用的运输承运商。
:::: important ::: title 重要 :::
注册时请确保在右上角选择了正确的语言 和 国家，这会影响账号的货币！
::::
确定所需承运商后，点击 激活，然后点击 服务 以选择该承运商提供的运输选项。
:::: tip ::: title 提示 :::
计费始终使用与主要账单地址对应的国家货币。如果公司在多个国家运营，建议为每个地点创建独立账号。 ::::
:::: note ::: title 备注 :::
Envia 会通过短信或 WhatsApp 发送验证码，以确认邮箱和电话号码。 ::::
生成 Envia.com 凭证
前往 Envia.com，在 开发者 --> API 密钥 页面左侧菜单中点击 新增，生成新密钥。
此密钥用于验证 Odoo 与 Envia.com 的连接。随时可在 API 密钥 页面查找并重新获取。
在 Odoo 中设置
安装 <general/install> Envia 物流（delivery_envia）模块后，按以下步骤在 Odoo 中配置集成。
Envia.com 运输连接器配置
激活 Envia.com 连接器后，前往 库存 --> 配置 --> 配送方式，点击 新建 创建配送方式。
填写以下表单字段：
- 运输方式：填写运输方式名称，例如 Envia.com。
- 供应商：在下拉菜单中选择 Envia。
- 配送产品：在销售订单中显示的配送费用产品。需为 Envia.com 创建专用配送产品。
- 在 Envia 配置 选项卡中，填写 Envia 生产访问令牌。
- 在 Envia 配置 选项卡中，填写 Envia 沙盒访问令牌。
- 保险比例：若需保险，填写要投保金额的百分比；不需要则保持 0。保险费用仅在标签生成后计算，LTL 发货亦如此。
:::: tip ::: title 提示 :::
生产令牌和沙盒令牌均为必填，但可以随意填写任意字符，因为此时系统并不验证其有效性。 ::::
Envia 默认包裹的其他注意事项
- 包裹尺寸使用 mm，重量使用 kg。重量指的是包装本身，而非内部货物。若无重量信息，重量填 0，最大重量若无上限也填 0。
- Envia 包裹类型：默认设为 箱子。请确保选择正确的类型，因为它会影响可用承运商和显示的选项。
设置完上述字段后，进入 Envia 配置 选项卡，在 Envia.com 服务名称 字段旁点击 fa-refresh（刷新）图标同步承运商。在弹出窗口中选择承运商及对应的服务等级。
:::: important ::: title 重要 :::
Envia 将账号的主要货币固定。为在 Odoo 中获得更精确的费用换算，请使用 Envia 账户所设的货币。如有需要，Odoo 也提供更改国家的选项，默认使用公司关联的国家。 ::::
:::: note ::: title 备注 :::
若需要多个运输选项，可在 Odoo 中创建更多配送方式，并分别修改包裹、承运商或服务等参数。 ::::
运输信息 {#inventory/shipping_receiving/envia-shipping-info}
使用 Envia.com 生成运输标签时，必须在 Odoo 中准确、完整地填写以下信息：
- 客户信息：创建报价单时，确保所选 客户 拥有有效的手机号、邮箱和收货地址。点击 客户 字段可打开其联系人页面，在 联系 中填写收货地址，并填写 手机 与 邮箱。
- 商品重量：所有交付单中的商品必须在其产品表单的 库存 选项卡中填写 重量。详细操作请参见本文档的 商品重量章节。
- 仓库地址：默认所有包裹均从仓库设置的地址发出，请确保该地址已正确填写，以生成正确的标签。
地址填写指南
不同国家对地址字段的要求各异，以下为常见国家的填写规则：
| 国家 | 街道 (Street) | 街道 2 (Street 2) | 城市 (City) | 州/省 (State_id) |
|---|---|---|---|---|
| 阿根廷 | 街道和门牌号 | 区域 | 城市 | 省份 |
| 巴西 | 例外 | 社区 | 城市 | 州 |
| 智利 | 街道和门牌号 | 城市 | 区 | 区域 |
| 哥伦比亚 | 街道和门牌号 | 不需要 | 市镇 | 部门 |
| 危地马拉 | 街道和门牌号 | 社区 | 城市 | 州 |
| 墨西哥 | 街道和门牌号 | 社区 | 城市 | 州 |
| 乌拉圭 | 街道和门牌号 | 附加信息 | 区域 | 州 |
未列出的国家请按常规方式填写。
:::: note ::: title 备注 :::
部分国家并不常要求邮编。如果留空，Odoo 将使用 Envia 的邮编近似服务自动获取。
对于哥伦比亚，若已安装本地化模块，邮编会从所选 city_id 中提取；否则使用邮编字段。
:::: note ::: title 备注 :::
哥伦比亚和墨西哥在 Odoo 中都有 city_id 列表。若设置了 city_id，系统会使用该字段作为城市；未设置时会使用普通的城市字段。
:::: note ::: title 备注 ::+
在墨西哥，部分承运商可能要求填写 Colony（社区）字段。使用 EDI for Mexico (Advanced Features) 模块时，该字段为必填。
:::: note ::: title 备注 ::+
巴西的地址需拆分以符合监管要求：street_name 只写街道名称，street_number1 写门牌号，street_number2 写补充信息。若安装了 Extended Addresses 模块，逻辑相同。
使用 Envia 生成标签
在 Odoo 中创建报价单时，添加 Envia.com 运输产品 并 验证 交付。系统会在 chatter 中自动生成运输标签，内容包括：
- 运输标签（根据包裹数量生成）。
- 退货标签（若 Envia.com 连接器已配置退货功能）。
:::: important ::: title 重要 ::+
标签生成后，Envia.com 会自动扣费，费用记录在 chatter 中。若涉及多币种，记录的金额会使用 Odoo 的汇率计算，实际费率可能有所不同。 ::::
此外，追踪号码也会随标签一起提供。
:::: note ::: title 备注 ::+
巴西海关可能要求提供与运输相关的发票（NFe），建议将订单发票与标签一起实体附上。 ::::
国际运输
国际发货时必须填写 HS 编码 与 货物原产国，两者均可在产品的 库存 选项卡中找到。
LTL（零担）发货
可通过 Envia 连接器生成 LTL 发货标签。保险费用依据配送方式表单中设定的 保险比例 计算。
:::: important ::: title 重要 ::+
针对墨西哥，需要为货物创建 提单，因此 Odoo 必须发送货物的 UNSPSC 代码，以及默认的运输计量单位 X8A - 木质托盘。 ::::
:::: note ::: title 备注 ::+
当在配送方式中选择 托盘 作为 Envia 包裹类型 时，可额外选择提升协助、周末配送等增值服务。 ::::
追踪与取消 {#inventory/shipping_receiving/setup_configuration/cancel}
在交付单上使用 追踪 智能按钮，或在 客户门户 中点击追踪链接，即可查看 Envia 注册的货运状态。
常见问题
如何测算体积重量？
许多承运商会同时使用实际重量和体积重量。体积重量指的是包裹在运输过程中占用的体积，即包装的实际尺寸。
:::: note ::: title 备注 ::+
由于体积重量的存在，标签上显示的重量有时会高于实际称重值。 ::::
有哪些打印选项？
在 Envia.com 的 设置 --> 打印选项和承运商打印选项 中，为每个显示的承运商选择合适的打印格式。
所需服务不可用怎么办？
确保在 Envia 中已启用对应的承运商。
谁支付海关关税？
如果涉及跨国出口，请使用 Envia 的承运商设置来决定关税由发件人还是收件人承担。
什么是 “Envia 错误”？
当 Envia 平台出现错误时，会弹出此信息，说明具体出错原因，以便进行处理。