README

简介

自提模块是 Intelipost Quote 模块的扩展，它添加了在运费计算时刻的 门店自提 功能。运费查询是通过 Intelipost API 进行的，而地图和门店位置的查询是通过 Google API 进行的。因此，在两种情况下都需要一个认证密钥和权限。

本手册分为三个部分

• 安装：您将在这里找到安装我们模块的说明。
• 配置：您将在这里找到配置路径和每个配置的解释。
• 使用：您将在这里找到如何使用每个功能的方法。

安装

建议您在测试环境中验证更改和更新，然后再在生产环境中更新您的商店。

使用 Composer 安装模块。要下载和安装 Composer，请访问 https://composer.php.ac.cn/download/，如果您对其使用有疑问，请参阅 Composer 的官方文档。

导航到您的 Magento 2 安装根目录并执行以下命令

bin/composer require intelipost/magento2-pickup  // Faz a requisição do módulo da Intelipost
bin/magento module:enable Intelipost_Pickup      // Ativa o módulo
bin/magento setup:upgrade                        // Registra a extensão
bin/magento setup:di:compile                     // Recompila o projeto Magento

配置

如简介中所述，自提模块是 Quote 模块的扩展。因此，您需要确保后者在您的环境中配置正确。如果您对 Intelipost Quote 模块的配置有任何疑问，请参阅 我们的手册。

要访问配置菜单，请按照以下步骤操作

在左侧菜单中，转到 Stores -> Configuration -> Intelipost -> Shipping Methods -> Intelipost - Retira em Loja

Intelipost - Retira em Loja

• 启用：如果模块处于激活状态并且应在商店前端显示。
• 名称：将在 Magento 订单中记录的名称。
• 标题：将在 Intelipost 每个方法旁边显示的名称。

• 显示方式：有两种可能的配置
  • "到达日期" 将显示订单可取货的时间。
  • "运营时间" 将显示订单可取货所需的天数。
• 附加 SLA：您可以输入更多天数，以便产品可供取货。
• Google Maps API：输入您的 Google Maps 认证密钥，以便执行地图查询。
• 显示所有商店:
  • 如果设置为“是”，则将显示所有可用的商店地址。
  • 如果设置为“否”，则仅显示客户最近的商店地址。
• 按距离排序：如果选择是，则将根据客户的邮政编码按距离对商店进行排序。
• 日期格式：显示日期的格式。

• 适用国家的配送：该报价应涵盖的国家。
• 排序：如果存在其他激活的发货方法，则此配置允许选择Intelipost运费模块在报价后应位于哪个顺序。

用途

安装和配置完成后，需要注册可用于取货的商店以及取货窗口。
为了管理商店和取货窗口，在模块内构建了一个包含以下服务的API

商店

POST - http://{{url_da_loja}}/rest/V1/istores/save 将将一个新商店添加到系统中。

Request_body

{
 "stores": [
 {
 "id_loja": "L1100",
 "name": "Loja Teste 1100",
 "address": "Rua dr amancio de carvalho",
 "number": "182",
 "complement": "Vila Mariana",
 "zipcode": "04012-080",
 "city": "São Paulo",
 "state": "SP",
 "store_neighborhood": "Vila Mariana",
 "opening": "09:00 as 21:00",
 "begin_zipcode": "01000-000",
 "end_zipcode": "19999-999",
 "observations": null,
 "delivered_cdg": "1",
 "is_active": "1"
 }]
}

GET - http://{{url_da_loja}}/rest/V1/istores/list
将返回一个包含截至当前时刻注册的所有商店的列表。

GET - http://{{url_da_loja}}/rest/V1/istores/info/{{entityId}}
通过其注册Id查询一个特定的商店。

DELETE - http://{{url_da_loja}}/rest/V1/istores/delete/{{id}}
通过其注册Id删除一个特定的商店。

配送窗口

POST - http://{{url_da_loja}}/rest/V1/pickup/save
注册配送窗口。

Request_body

{
 "items": [
 {
 "id_loja": "L1100",
 "departure_date": "05/04/2017",
 "arrival_date": "06/04/2017",
 "operation_time": "1"
 }]
}

GET - http://{{url_da_loja}}/rest/V1/pickup/list
将返回一个包含截至当前时刻注册的所有窗口的列表。

GET - http://{{url_da_loja}}/rest/V1/pickup/info/{{entityId}}
通过其注册Id查询一个特定的窗口。

DELETE - http://{{url_da_loja}}/rest/V1/pickup/delete/{{id}}
通过其注册Id删除一个特定的窗口。

注意：进行调用时，需要传递用户的认证令牌。有关详细信息，请参阅Magento文档。