PHP code example of ex3mm / kontur-focus

1. Go to this page and download the library: Download ex3mm/kontur-focus library. Choose the download type require.

2. Extract the ZIP file and open the index.php.

3. Add this code to the index.php.
    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

ex3mm / kontur-focus example snippets




declare(strict_types=1);

use Ex3mm\KonturFocus\Config\KonturFocusConfig;
use Ex3mm\KonturFocus\KonturFocusManager;

$config = KonturFocusConfig::fromArray(
    

use Ex3mm\KonturFocus\Laravel\Facades\KonturFocus;

// Вариант 1: Упрощённый синтаксис (рекомендуется)
$result = KonturFocus::getReq(inn: '7707083893');

// Вариант 2: Fluent API для гибкой настройки
$result = KonturFocus::req()
    ->inn('7707083893')
    ->asArray()
    ->get();

return [
    'key' => env('KONTUR_FOCUS_API_KEY', ''),
    'base_url' => env('KONTUR_FOCUS_BASE_URL', 'https://focus-api.kontur.ru'),

    'http' => [
        'timeout' => (float) env('KONTUR_FOCUS_TIMEOUT', 30),
        'connect_timeout' => (float) env('KONTUR_FOCUS_CONNECT_TIMEOUT', 10),
        'verify_ssl' => (bool) env('KONTUR_FOCUS_VERIFY_SSL', true),
    ],

    'retry' => [
        'enabled' => (bool) env('KONTUR_FOCUS_RETRY_ENABLED', true),
        'max_attempts' => (int) env('KONTUR_FOCUS_RETRY_ATTEMPTS', 3),
        'delay_ms' => (int) env('KONTUR_FOCUS_RETRY_DELAY', 500),
        'multiplier' => (float) env('KONTUR_FOCUS_RETRY_MULTIPLIER', 2),
        'max_delay_ms' => (int) env('KONTUR_FOCUS_RETRY_MAX_DELAY', 30000),
    ],

    'cache' => [
        'enabled' => (bool) env('KONTUR_FOCUS_CACHE_ENABLED', true),
        'ttl' => (int) env('KONTUR_FOCUS_CACHE_TTL', 3600),
        'store' => env('KONTUR_FOCUS_CACHE_STORE', 'default'),
        'namespace' => env('KONTUR_FOCUS_CACHE_NAMESPACE', 'kontur-focus'),
    ],

    'logging' => [
        'enabled' => (bool) env('KONTUR_FOCUS_LOG_ENABLED', true),
        'level' => env('KONTUR_FOCUS_LOG_LEVEL', 'basic'),
        'channel' => env('KONTUR_FOCUS_LOG_CHANNEL', 'default'),
        'max_body_size' => (int) env('KONTUR_FOCUS_LOG_MAX_BODY_SIZE', 10000),
    ],
];

use Ex3mm\KonturFocus\Laravel\Facades\KonturFocus;

// Получить данные по ИНН
$result = KonturFocus::getReq(inn: '7707083893');

// Получить данные по ОГРН
$result = KonturFocus::getEgrDetails(ogrn: '1027700132195');

// Можно передать оба параметра
$result = KonturFocus::getLegalAnalytics(
    inn: '7707083893',
    ogrn: '1027700132195'
);

// Все методы возвращают CollectionResponse
$result->items;      // array<DTO>
$result->first();    // DTO|null
$result->isEmpty();  // bool

$result = KonturFocus::getCompanyAffiliationsTypes(
    inn: '6663003127',
    skip: 0,
    take: 100,
    affiliationType: 2,
);

$affiliate = $result->first();
$affiliate->inn;         // ИНН связанной организации или ИП
$affiliate->name;       // Наименование организации или ФИО ИП
$affiliate->status;     // Статус организации или ИП
$affiliate->connections; // Типы связей и роли участников

$result = KonturFocus::getFssp(
    inn: '7707083893',
    skip: 1000,
);

$company = $result->first();
$company->updateDate; // Дата актуальности данных
$company->fssp;       // array<FsspDataDto>|null

$result = KonturFocus::getPurchasesOfParticipant(
    inn: '7707083893',
    skip: 0,
    take: 100,
);

$company = $result->first();
$company->purchasesOfParticipant; // array<PurchaseDto>

$result = KonturFocus::getPetitionersOfArbitration(
    inn: '7707083893',
    skip: 0,
    take: 100,
);

$company = $result->first();
$company->petitioners; // array<PetitionerDto>|null

// По ИННФЛ
$result = $focus->getPersonBankruptcy(
    inn: '123456789012',
    fio: 'Иванов Иван Иванович',
    birthDate: '1980-01-15',
);

// Fluent API по ФИО
$result = $focus->personBankruptcy()
    ->param('innfl', '123456789012')
    ->param('fio', 'Иванов Иван Иванович')
    ->param('birthDate', '1980-01-15')
    ->asDto()
    ->get();

$person = $result->first();
$person->stage;                    // Текущая стадия банкротства
$person->caseNumber;              // Номер арбитражного дела
$person->extrajudicialBankruptcy; // Внесудебное банкротство
$person->arbitrationManager;      // Арбитражный управляющий
$person->stages;                  // История стадий
$person->messages;                // Сообщения ЕФРСБ

$data = $focus->req()
    ->inn('7707083893')
    ->asArray()
    ->get();

$result = $focus->req()
    ->inn('7707083893')
    ->asDto()
    ->get();

// $result - это CollectionResponse с полями:
// - items: array<DTO> - массив DTO объектов
// - raw: string - сырой JSON ответ
// - total: int - количество элементов

// Получить первый элемент
$dto = $result->first();

// Проверить пустоту
if ($result->isEmpty()) {
    // нет данных
}

// Получить массив DTO
$items = $result->toArray();

use Ex3mm\KonturFocus\Exceptions\EmptyResponseException;

try {
    $result = $focus->req()
        ->inn('7707083893')
        ->asDto()
        ->throwOnEmpty() // выбросит EmptyResponseException если total === 0
        ->get();
} catch (EmptyResponseException $e) {
    // обработка пустого результата
}

$result = $focus->custom('/api3/someEndpoint')
    ->param('foo', 'bar')
    ->param('limit', 10)
    ->asArray()
    ->get();

$result = $focus->req()->inn('7707083893')->asDto()->get();

// Доступные методы:
$result->items;      // array<DTO> - массив DTO объектов
$result->raw;        // string - сырой JSON ответ
$result->total;      // int - количество элементов
$result->first();    // DTO|null - первый элемент или null
$result->toArray();  // array<DTO> - массив DTO
$result->count();    // int - количество элементов
$result->isEmpty();  // bool - проверка на пустоту
$result->isNotEmpty(); // bool - проверка на наличие данных

use Ex3mm\KonturFocus\DTOs\Attributes\ArrayOf;

final readonly class ParentDto
{
    /**
     * @param array<ChildDto> $children
     */
    public function __construct(
        #[ArrayOf(ChildDto::class)]
        public array $children,
    ) {
    }
}
bash
php artisan vendor:publish --tag=kontur-focus-config