+

README.md

@@ -1,6 +1,6 @@
 # Identification Number: Ukraine
 
-Парсер идентификационного номера налогоплательщика Украины
+Идентификационный номер налогоплательщика Украины. Парсер и генератор ИНН.
 
 [![SensioLabsInsight](https://insight.sensiolabs.com/projects/746be262-9725-4d22-9ce1-e7eb07dc4858/big.png)](https://insight.sensiolabs.com/projects/746be262-9725-4d22-9ce1-e7eb07dc4858)
 
@@ -17,19 +17,61 @@ $ composer require "iiifx-production/ukraine-identification-number:0.*"
 
 ## Использование
 
+Парсер ИНН:
+
 ``` php
 use iiifx\Identification\Ukraine\Parser;
 
-# Создаем парсер ИНН
-$parser = Parser::create( '0123456789' );
+# Номер ИНН
+$number = '2245134075';
+
+# Создаем парсер
+$parser = Parser::create( $number );
+# Или так
+$parser = new Parser( $number );
+
+# Проверяем правильность ИНН
+if ( $parser->isValidNumber() ) {
+
+    $parser->getNumber(); # 2245134075
+
+    # Определяем пол владельца ИНН
+    $parser->getPersonSex(); # Parser::SEX_MALE
+    $parser->isPersonMale(); # true
+    $parser->isPersonFemale(); # false
+
+    # Определяем возраст и дату рождения
+    $parser->getPersonAge(); # 55
+    $parser->getPersonBirth( 'Y-m-d' ); # 1961-06-20
+    $parser->getPersonBirthDatetime()->format( 'd.m.Y H:i:s' ); # 20.06.1961 00:00:00
+
+    # Контрольная сумма и число
+    $parser->getControlSumm(); # 192
+    $parser->getControlDigit(); # 5
+}
+```
+
+Генератор ИНН:
+
+``` php
+use iiifx\Identification\Ukraine\Builder;
+
+# Создаем генератор
+$builder = new Builder();
+# Или вот так
+$builder = Builder::create( Builder::SEX_MALE, new DateTime( '2010-05-12' ) );
+
+# Указывам пол
+$builder->setPersonSex( Builder::SEX_MALE );
+$builder->setPersonMale();
+$builder->setPersonFemale();
+
+# Указываем возраст
+$builder->setPersonAge( 55 );
+$builder->setPersonBirthDatetime( new DateTime( '1962-11-03' ) );
 
-# Получаем все данные
-$parser->getNumber(); # '0123456789'
-$parser->isValid(); # true
-$parser->getSex(); # 'M'
-$parser->isMale(); # true
-$parser->getAge(); # 32
-$parser->getBirthDatetime()->format( 'd.m.Y' ); # '02.05.1984'
+# Генерируем ИНН
+$builder->createNumber(); # 2295209520
 ```
 
 ## Тесты