intelipost/magento2-push

Intelipost Push

维护者

详细信息

github.com/intelipost/magento2-push

源代码

问题

安装次数: 9,908

依赖: 0

建议者: 0

安全: 0

星级: 2

关注者: 14

分支: 7

开放问题: 7

类型:magento2-module

1.2.0 2019-02-18 21:35 UTC

Requires

OSL-3.0 c2add45e481a907020dcadffb27d6217b711ca2c

This package is auto-updated.

Last update: 2024-09-29 05:27:46 UTC

README

N|Solid

介绍

Intelipost Push模块负责将创建于Magento的配送信息发送至Intelipost。此过程对于使用我们工具的跟踪和配送管理至关重要。

本手册分为四部分

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

安装

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

使用Composer安装模块。要下载并安装Composer，请访问https://composer.php.ac.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或何时应发货。

Magento触发状态以创建

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

N|Solid

在示例中，选择了“处理中”，这是订单在开票后不久的Magento状态。

创建后的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文档。