README

此Bundle提供访问 Nacex SOAP API 的客户端。

安装

1. 下载Bundle

   打开命令行控制台，进入您的项目目录，并执行以下命令以下载此bundle的最新稳定版本

   $ composer require selltag/nacex-bundle

   此命令需要您已全局安装Composer，如Composer文档的 安装章节 所述。

2. 启用Bundle

   在app/AppKernel.php文件中添加以下行以启用此bundle

   <?php
   // app/AppKernel.php
   
   class AppKernel extends Kernel
   {
       public function registerBundles()
       {
           $bundles = array(
               // ...
   
               new Selltag\NacexBundle\SelltagNacexBundle()
   
               // ...
           )
   
           return $bundles;
       }
   
       // ...
   }

3. 添加以下配置以启用nacex服务

   # app/config/config.yml
   selltag_nacex:
       nacex_password: %nacex_username%
       nacex_password: %nacex_password%
       nacex_url: %nacex_url%

4. 您可以在parameters.yml中定义这些参数

   # app/config/parameters.yml.dist
   nacex_username: MYUSERNAME
   nacex_password: MYPASSWORD
   nacex_url: http://gprs.nacex.com/nacex_ws/soap

测试

您可以使用以下命令运行测试

phpunit

由于我没有凭证，无法对NacexClient类进行测试，因此无法获取用于参考的SOAP响应。如果您发现任何错误，可以将SOAP响应发送给我，以便我也对该部分进行测试，谢谢！

Symfony上的使用示例

$nacexClient = $this->getContainer()
    ->get('selltag_nacex.nacex_client');

$data = array(
    'reco_codigo' => null,
    'Del_Sol'     => '0001',
    'Num_Rec'     => '123456',
    'ref'         => null
);

$result = $nacexClient->putRecogida($data);

$recogida = array(
    'code'        => $result[0],
    'date'        => $result[1],
    'time'        => $result[2],
    'observation' => $result[3],
    'status'      => $result[4],
    'status_code' => $result[5]
);

不使用Symfony的使用示例

use Selltag\NacexBundle\Services\NacexClientService;

$nacexClient = new NacexClientService(
    $nacexUser,
    $nacexPassword,
    $nacexUrl
);

$data = array(
    'reco_codigo' => null,
    'Del_Sol'     => '0001',
    'Num_Rec'     => '123456',
    'ref'         => null
);

$result = $nacexClient->putRecogida($data);

$recogida = array(
    'code'        => $result[0],
    'date'        => $result[1],
    'time'        => $result[2],
    'observation' => $result[3],
    'status'      => $result[4],
    'status_code' => $result[5]
);

NacexException

如果Nacex SOAP响应返回任何错误，将抛出一个NacexClientException异常，您可以根据您的项目相应地处理它。

use Selltag\NacexBundle\Exceptions\NacexClientException;