README

houjin-bangou

'chanshige/houjin-bangou' 是一个帮助搜索注册在NTA（国家税务局）的企业信息的工具

houjin-bangou 是一个方便使用法人番号システム Web-API 的库

@see https://www.houjin-bangou.nta.go.jp/webapi/

※ 使用 Web-API 需要应用程序 ID。
※ 包含了在 Laravel 中使用时的 Provider 注册示例。

安装

使用 composer

$ composer require chanshige/houjin-bangou

用法

<?php
require __DIR__ . '/vendor/autoload.php';

use Chanshige\NTA\HoujinBangouFactory;
use Chanshige\NTA\Condition\Criteria\CorporateName;

$houjin = HoujinBangouFactory::newInstance('国税庁より発行されたアプリケーションID');

$condition = new CorporateName();
$condition->name('カラビナテクノロジー');
$response = $houjin($condition);

echo $response->body(); //XML(Original)
// or $response->toJson();
// or $response->toArray();

对于 Laravel

创建 ServiceProvider 类。

use Chanshige\NTA\HoujinBangouFactory;
use Chanshige\NTA\Contracts\HoujinBangouInterface;
use GuzzleHttp\Client as GuzzleClient;
use Illuminate\Support\ServiceProvider;

class HoujinBangouServiceProvider extends ServiceProvider implements DeferrableProvider
{
    public function register()
    {
        $this->app->singleton(HoujinBangouInterface::class, static function () {
            return HoujinBangouFactory::newInstance(
                config('services.houjin_bangou.application_id')
            );
        });
    }

    public function provides(): array
    {
        return [
            ClientInterface::class
        ];
    }
}

将提供者添加到 config/app.php

'providers' => [
    App\Providers\HoujinBangouServiceProvider::class    
]

添加 .env

HOUJIN_BANGOU_APPLICATION_ID='*************'

添加 config/services.php

'houjin_bangou' => [
    'application_id' => env('HOUJIN_BANGOU_APPLICATION_ID')
]