跳转到主要内容

基于ASM Red API的GLS配送承运实现

项目描述

Beta License: AGPL-3 OCA/l10n-spain Translate me on Weblate Try me on Runbot

此模块将GLS西班牙API(旧版ASM API)集成到Odoo中。它不适用于其他国家GLS的集成,这些国家可能使用其他API。

目录

安装

此模块需要python suds-py3 库,并且同样依赖于OCA/delivery-carrier 模块的 delivery_package_numberdelivery_state

GLS/ASM API不提供计算价格的方法,因此为了能够计算运费,建议安装 delivery_price_method 模块。

配置

配置承运商

  1. 转到 库存 > 配置 > 配送 > 运输方式 并创建一个新的。

  2. 选择 GLS ASM 作为供应商。

  3. 配置您拥有的服务数据和您想要使用的运输产品。

如果您还没有凭证,可以输入假数据并将运输方式保留在“测试环境”。将使用GLS ASM API的测试用户。

如果GLS将来更改测试用户,可以在 系统参数 中的密钥 delivery_gls_asm.api_user_demo 中更改它。

用法

此模块可能的操作有

记录服务

  1. 在确认出入库单时,服务将在GLS中记录。

  2. 在响应中,将在chatter中记录运输参考和相应的标签。

  3. 为了管理运输包裹,可以使用添加 delivery_package_number 字段的数字(查看README获取更多信息)或Odoo的本地包裹运输流程。模块将向GLS/ASM API发送相应的数字,并可以下载带有对应编号的PDF标签。

取消服务

  1. 与其他运输方式一样,在出库单中,一旦订单确认并生成发货单,我们就可以通过“附加信息”选项卡中的相关操作取消特定服务。

  2. 如果需要,可以在取消后生成新的发货单。

获取标签

  1. 如果在服务记录中错误地删除了获得的标签附件,可以点击表单视图顶部的“GLS标签”按钮重新获取。

运输跟踪

  1. 该模块与delivery_state集成,可以直接从GLS-ASM API获取运输信息。

  2. 因此,请转到已记录GLS运输的发货单,然后在“附加信息”选项卡中,您将看到用于请求GLS API更新此发货单状态的“更新跟踪”按钮。

运输清单

  1. 要获取配送员将签署的发货单,请转到“库存 > 报表 > GLS发货单”菜单。

  2. 您还可以从运输工单表单中的智能按钮获取发货单。

  3. 在向导中,选择要获取发货单的GLS服务及其起始日期。

  4. 点击“GLS发货单”按钮,将获得所选服务的PDF发货单列表。

错误调试

  1. 请注意,这仅适用于西班牙邮政编码。

  2. 还可以通过设置Odoo为< cite>–log-level=debug来激活调试日志记录功能,以记录日志中的请求数据和响应。

已知问题/路线图

  • API不提供计算实际运输成本的函数,因此始终计算为0。如果需要运输报价,可以安装OCA的delivery_price_method模块或自定义报价方法。

错误跟踪器

错误报告在GitHub Issues中跟踪。如有问题,请检查是否已报告该问题。如果您是第一个发现的人,请通过提供详细且受欢迎的反馈来帮助我们解决问题。

请不要直接联系贡献者以获取支持或技术问题帮助。

致谢

作者

  • Tecnativa

贡献者

维护者

本模块由OCA维护。

Odoo Community Association

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

本模块是GitHub上OCA/l10n-spain项目的一部分。

欢迎您贡献。要了解如何贡献,请访问https://odoo-community.org/page/Contribute

项目详细信息


下载文件

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

源代码分发

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

构建分发

由以下支持