README

Пакет работы с сервисом DaData.ru.

Dadata - сервис автоматической проверки и исправления контактных данных: ФИО, адреса, телефоны, email, паспорта и реквизиты компаний.

Установка

Запустить:

composer require "coolycow/laravel-dadata"

Для Laravel < 5.5: Зарегистрировать service-provider в config/app.php:

  Coolycow\Dadata\DadataServiceProvider::class,

Для Lumen добавить в bootstrap/app.php:

$app->withFacades();

Опубликовать конфиг:

php artisan vendor:publish --provider="Coolycow\Dadata\DadataServiceProvider"

Задать токен (и ключ для API стандартизации) в config/dadata.php или .env

    'token' => env('DADATA_TOKEN', ''),
    'secret' => env('DADATA_SECRET', ''),

Использование

Сервис подсказок (https://dadata.ru/api/suggest/)

API подсказок помогает человеку быстро ввести корректные данные. Подсказывает ФИО, email, почтовые адреса, реквизиты компаний и банков, и другие справочники.

Добавить в необходимый клас фасад:

use Coolycow\Dadata\Facades\DadataSuggest;

Пример использование метода с параметрами:

$result = DadataSuggest::suggest("address", ["query"=>"Москва", "count"=>2]);
print_r($result);

Первым параметром может быть: fio, address, party, email, bank

Пример использование поиска по ИНН или ОГРН с параметрами:

$result = DadataSuggest::partyById('5077746329876', ["branch_type"=>"MAIN"]);
print_r($result);

Первым параметром может быть ИНН, ОГРН или Dadata HID

Сервис стандартизации (https://dadata.ru/api/clean/)

API стандартизации приводит в порядок и обогащает дополнительной информацией почтовые адреса, телефоны, паспорта, ФИО и email.

Добавить в клас фасад:

use Coolycow\Dadata\Facades\DadataClean;

Использовать методы:

$response = DadataClean::cleanAddress('мск сухонска 11/-89');
$response = DadataClean::cleanPhone('тел 7165219 доб139');
$response = DadataClean::cleanPassport('4509 235857');
$response = DadataClean::cleanName('Срегей владимерович иванов');
$response = DadataClean::cleanEmail('serega@yandex/ru');
$response = DadataClean::cleanDate('24/3/12');
$response = DadataClean::cleanVehicle('форд фокус');
$response = DadataClean::getStatistics();
$response = DadataClean::getStatistics(now()->subDays(6));
print_r($response);

Проверка баланса системы

$response = DadataClean::getBalance();

Получение статистики использования сервиса

На текущий день

$response = DadataClean::getStatistics();

На любую другую дату

$response = DadataClean::getStatistics(now()->subDays(6));
// or
$response = DadataClean::getStatistics('2022-12-01');

coolycow / laravel-dadata

Maintainers

Details