README

关于模块

创建此模块是为了使用CEP查询服务，已包含基本的ViaCep和Correios查询。

如何安装

通过Composer安装（推荐）

composer require magedev/brazilzipcode
php bin/magento module:enable MageDev_BrazilZipCode
php bin/magento setup:upgrade

配置

要配置该模块，请访问：商店 > 设置 > MageDev > 巴西邮政编码

如何使用查询

在您的javascript中（无论是要查询CEP的商店的任何区域），请使用以下端点进行GET调用，使用带或不带格式的CEP

URL_DA_LOJA/rest/V1/magedev-brazil-zipcode/search/CEP_A_SER_CONSULTADO
https://minhaloja.com.br/rest/V1/magedev-brazil-zipcode/search/08226-021
https://minhaloja.com.br/rest/V1/magedev-brazil-zipcode/search/08226021

返回的payload

{
    "zip_code": "08226021",
    "street": "Rua 18 de Abril",
    "neighborhood": "Cidade Antônio Estevão de Carvalho",
    "additional_info": "",
    "city": "São Paulo",
    "state": "SP",
    "code": "3550308",
    "data_source": "ViaCep",
    "is_valid": true
}

注意事项

• 如果数据库持久化功能已启用，则数据将被存储在数据库中，并在后续对相同CEP的查询中返回数据。
• 如果缓存功能已启用，则CEP将被存储在缓存中，并在后续对相同CEP的查询中从缓存中返回数据。

仅清除模块的缓存

php bin/magento cache:clean config_zipcode_search_api

通过外部服务使用CEP查询（其他平台、系统或Postman）

在Magento中创建一个集成密钥并使用Authorization头。

通过您的模块添加新的服务

• 创建您的模块
• 创建您的服务类，该类扩展自MageDev\BrazilZipCode\Gateway\AbstractZipCodeService
• 重写getAddressData和validate方法
• 在您的模块etc目录中声明xml文件brazil_zipcode_services.xml，内容如下

<?xml version="1.0" ?>
<services xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="brazil_zipcode_services.xsd">
   <service id="ID_UNICO_PARA_SEU_SERVICO">
       <name>NOME_DO_SEU_SERVICO</name>
       <class>VENDOR_DO_MODULO\NOME_DO_MODULO\Services\NOME_DA_CLASSE_SO_SEU_SERVICO</class>
   </service>
</services>

• 安装您的模块并清除缓存。
• 注意：如果您想优先使用服务，请访问管理员中的BrazilZipCode模块配置，并将您的服务作为列表中的第一个添加，这样当CEP未在缓存或数据库中找到时，您的服务将首先被访问。

捐赠

现在捐赠并帮助保持工作！ ;)

目前我仅通过用户@walisson-ferreira通过PicPay接收捐赠