luanet/magento2-push

Fork Intelipost Push

维护者

详细信息

github.com/lua-net/magento2-push

源代码

安装: 693

依赖: 0

建议: 0

安全: 0

星标: 0

关注者: 0

Fork: 7

类型:magento2-module

1.0.6 2018-07-04 16:09 UTC

Requires

OSL-3.0 67fd5a90c2145de8a7c2b9d361980f52ed74fb41

This package is auto-updated.

Last update: 2024-09-28 10:05:24 UTC

README

N|Solid

介绍

Intelipost Push模块负责将Magento中创建的配送信息发送到Intelipost。此过程对于使用我们的工具的跟踪和配送管理是必不可少的。

本手册分为四个部分

  • 安装：您将在此找到安装我们的模块的说明。
  • 配置：您将在此找到进行配置的路径和每个配置的解释。
  • 使用：您将在此找到使用每个功能的方法。
  • 发票：本节专门描述由模块创建的发票表，以及如何通过API填充它。

安装

建议您在更新生产环境中的商店之前，在一个测试环境中验证更改和更新。

使用Composer安装模块。要下载并安装Composer到您的环境中，请访问https://getcomposer.org.cn/download/，如果对如何使用它有疑问，请参考Composer官方文档。

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

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

配置

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

在左侧菜单中，选择商店 -> 配置

N|Solid

从配置菜单中，点击Intelipost -> Push

N|Solid

模块的配置分为三个步骤

  • 属性
  • 订单状态
  • 定时任务配置

以下将详细介绍每个步骤。

属性

在此部分，我们为客户端提供了空间来定义他们为信息创建的参数，这些信息在默认情况下不存在于Magento中。

联邦纳税人识别号

在此属性中应选择用于CPA的属性。

N|Solid

请注意，示例中选择的字段不是正确的。您应与商店代表交谈，以确定客户最终用户的CPA是在哪个属性中注册的。

订单状态

在此部分，应进行订单移动的配置。也就是说，何时将订单发送到Intelipost，何时发货。

创建触发状态

在此配置中应选择在Intelipost中创建的订单的Magento状态。在此列表中，将显示所有可用状态，包括自定义状态。

N|Solid

在示例中，选择了“处理中”，这是订单结账后Magento的状态。

创建后状态

在此配置中应选择在发送到Intelipost后订单应接收的Magento状态。

N|Solid

在示例中，选择了“在Intelipost中创建”，这是我在我们的Magento环境中自定义的状态。

创建和发货

如果此配置被标记为“是”，则当订单发送到Intelipost时，它将收到与发送时间相同的发货日期。现在，如果此配置被标记为“否”，则将提供一个新的配置： Magento触发发货状态。类似于“创建时触发Magento状态”，您必须选择订单在Intelipost中被标记为已发货的Magento状态。

N|Solid

例如，已选择“完成”，这是在Magento中创建交货后的Magento状态。

定时任务配置

在本节中，我们将配置模块的时序事件。也就是说，我们将决定在什么条件下自动将订单发送到Intelipost。

使用cron创建订单

此配置允许从可安排的过程发送交货到Intelipost。如果此配置被标记为“是”，将提供另外三个配置

  • 创建时cron状态：应配置将订单发送到Intelipost的Magento状态。
  • 创建时订单数量：应确定发送到Intelipost的订单所需数量。
  • 创建时频率：应选择进程执行的时间间隔，以分钟为单位。

N|solid

使用cron发货订单

与前面的配置非常相似，此配置允许从可安排的过程发货订单。如果此配置被标记为“是”，将提供另外三个配置

  • 发货时cron状态：应配置将订单标记为在Intelipost中已发货的Magento状态。
  • 发货时订单数量：应确定在Intelipost中发货所需的订单数量。
  • 发货时频率：应选择进程执行的时间间隔，以分钟为单位。

使用

安装模块后，将提供一个新的订单表。该表可在菜单Intelipost -> 订单中查询。

N|solid

新的订单屏幕将显示来自Intelipost报价生成的所有交货数据。它还将显示每个订单的Magento状态和Intelipost状态。

N|Solid

如果客户使用Intelipost的发货管理，则可以直接从Magento查询跟踪代码。要启用此列，只需点击列 -> 跟踪代码。

N|Solid

Push模块还允许客户手动操作，即从Magento的命令发送或发货订单。这些命令也可以批量提供。

要执行这些操作之一，您必须选择所需的订单，并在操作中，选择创建订单（创建交货）或发货订单（发货交货）。

N|Solid

执行操作后，错误或成功消息将显示在页面顶部。此外，它将保存在列Intelipost消息中。

注意：请注意，所有创建或发货尝试，无论是手动还是自动，都会保存一个Intelipost消息。

N|Solid

发票

模块包括一个发票表（intelipost_invoice）。此表的字段包括

要使用API通过该表查询和插入数据，您可以使用以下方法

GET - http://{{url_da_loja}}/rest/v1/push/list
将返回一个包含所有保存发票的列表。

POST - http://{{url_da_loja}}/rest/v1/push/save
将发票添加到表中。

请求体

{
    "invoice": [
        {
            "invoice_number": "10",
            "order_number": "000000006",
            "invoice_series": "1",
            "invoice_key": "01234567890123456789012345678901234567891234",
            "invoice_date": "2017-11-28 19:47:35",
            "invoice_total_value": "10.20",
            "invoice_products_value": "10.00",
            "invoice_cfop": "1612"
        }
    ]
}

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