1С-Рарус: Проверка данных организации

Данный модуль встраивается в систему управления сайтами 1С-Битрикс.

После установки модуля через Маркетплейс API будет доступно для использования.

Чтобы использовать методы модуля нужно сначала подключить модуль:

use Bitrix\Main\Loader;

Loader::includeModule('otr.datavalidation');

для использования в php:

use Otr\Tszh\DataValidation;

для использования в js:

CJSCore::Init('tszh_data_validation');

После подключения модуля будут доступны следующие методы:

1. Проверка ИНН.

Метод:

validateInn(inn, error) : boolean;

Входящие данные:

• inn - строка с номером ИНН;

• error - переменная, в которую будет передан код и сообщение об ошибке, в процессе проверки;

Результат работы метода:

true/false;

Коды сообщения об  ошибках:

1 - ИНН пуст;

2 - ИНН может состоять только из цифр;

3 - ИНН может состоять только из 10 или 12 цифр;

4 - ИНН указан неправильного формата;

Примеры использования:

PHP:

$error = [];

$validation = DataValidation::validateInn('1234567890', $error);

if (!$validation)

{

// обработка ситуации, когда проверка завершилась с ошибкой

echo $error['message'];

}

else

{

// проверка завершилась успехом

}

JS:

var error = {

code: null,

message: null

};

var validation = BX.tszh.validateInn('1234567890', error);

if (!validation) {

// обработка ситуации, когда проверка завершилась с ошибкой

console.log(error.message);

}

else {

// проверка завершилась успехом

}

1. Проверка БИК.

Метод:

validateBik(bik, error) : boolean;

Входящие данные:

• bik - строка с номером БИК;

• error - переменная, в которую будет передан код и сообщение об ошибке, в процессе проверки;

Результат работы метода:

true/false;

Коды сообщения об  ошибках:

1 - БИК пуст;

2 - БИК может состоять только из цифр;

3 - БИК может состоять только из 9 цифр;

Примеры использования:

PHP:

$error = [];

$validation = DataValidation::validateBik('123456789', $error);

if (!$validation)

{

// обработка ситуации, когда проверка завершилась с ошибкой

echo $error['message'];

}

else

{

// проверка завершилась успехом

}

JS:

var error = {

code: null,

message: null

};

var validation = BX.tszh.validateBik('123456789', error);

if (!validation) {

// обработка ситуации, когда проверка завершилась с ошибкой

console.log(error.message);

}

else {

// проверка завершилась успехом

}

1. Проверка КПП.

Метод:

validateKpp(kpp, error) : boolean;

Входящие данные:

• kpp - строка с номером КПП;

• error - переменная, в которую будет передан код и сообщение об ошибке, в процессе проверки;

Результат работы метода:

true/false;

Коды сообщения об  ошибках:

1 - КПП пуст;

2 - КПП может состоять только из 9 знаков (цифр или заглавных букв латинского алфавита от A до Z);

3 - Неправильный формат КПП;

Примеры использования:

PHP:

$error = [];

$validation = DataValidation::validateKpp('123456789', $error);

if (!$validation)

{

// обработка ситуации, когда проверка завершилась с ошибкой

echo $error['message'];

}

else

{

// проверка завершилась успехом

}

JS:

var error = {

code: null,

message: null

};

var validation = BX.tszh.validateKpp('123456789', error);

if (!validation) {

// обработка ситуации, когда проверка завершилась с ошибкой

console.log(error.message);

}

else {

// проверка завершилась успехом

}

1. Проверка корреспондентского счета.

Метод:

validateKs(ks, bik, error) : boolean;

Входящие данные:

• ks - строка с номером корреспондентского счета;

• bik - строка с номером БИК;

• error - переменная, в которую будет передан код и сообщение об ошибке, в процессе проверки;

Результат работы метода:

true/false;

Коды сообщения об  ошибках:

1 - К/С пуст;

2 - К/С может состоять только из цифр;

3 - К/С может состоять только из 20 цифр;

4 - К/С указан неправильного формата;

Примеры использования:

PHP:

$error = [];

$validation = DataValidation::validateKs('12345678909876543210','123456789', $error);

if (!$validation)

{

// обработка ситуации, когда проверка завершилась с ошибкой

echo $error['message'];

}

else

{

// проверка завершилась успехом

}

JS:

var error = {

code: null,

message: null

};

var validation = BX.tszh.validateKs('12345678909876543210','123456789', $error);

if (!validation) {

// обработка ситуации, когда проверка завершилась с ошибкой

console.log(error.message);

}

else {

// проверка завершилась успехом

}

1. Проверка ОГРН.

Метод:

validateOgrn(ogrn, error) : boolean;

Входящие данные:

• ogrn - строка с номером ОГРН;

• error - переменная, в которую будет передан код и сообщение об ошибке, в процессе проверки;

Результат работы метода:

true/false;

Коды сообщения об  ошибках:

1 - ОГРН пуст;

2 - ОГРН может состоять только из цифр;

3 - ОГРН может состоять только из 13 цифр;

4 - ОГРН указан неправильного формата;

Примеры использования:

PHP:

$error = [];

$validation = DataValidation::validateOgrn('1234567890123', $error);

if (!$validation)

{

// обработка ситуации, когда проверка завершилась с ошибкой

echo $error['message'];

}

else

{

// проверка завершилась успехом

}

JS:

var error = {

code: null,

message: null

};

var validation = BX.tszh.validateOgrn('1234567890123', error);

if (!validation) {

// обработка ситуации, когда проверка завершилась с ошибкой

console.log(error.message);

}

else {

// проверка завершилась успехом

}

1. Проверка ОГРНИП.

Метод:

validateOgrnip(ogrnip, error) : boolean;

Входящие данные:

• ogrn - строка с номером ОГРНИП;

• error - переменная, в которую будет передан код и сообщение об ошибке, в процессе проверки;

Результат работы метода:

true/false;

Коды сообщения об  ошибках:

1 - ОГРНИП пуст;

2 - ОГРНИП может состоять только из цифр;

3 - ОГРНИП может состоять только из 15 цифр;

4 - ОГРНИП указан неправильного формата;

Примеры использования:

PHP:

$error = [];

$validation = DataValidation::validateOgrnip('123456789012345', $error);

if (!$validation)

{

// обработка ситуации, когда проверка завершилась с ошибкой

echo $error['message'];

}

else

{

// проверка завершилась успехом

}

JS:

var error = {

code: null,

message: null

};

var validation = BX.tszh.validateOgrnip('123456789012345', error);

if (!validation) {

// обработка ситуации, когда проверка завершилась с ошибкой

console.log(error.message);

}

else {

// проверка завершилась успехом

}

1. Проверка расчетного счета.

Метод:

validateRs(rs, bik, error) : boolean;

Входящие данные:

• ks - строка с номером расчетного счета;

• bik - строка с номером БИК;

• error - переменная, в которую будет передан код и сообщение об ошибке, в процессе проверки;

Результат работы метода:

true/false;

Коды сообщения об  ошибках:

1 - Р/С пуст;

2 - Р/С может состоять только из цифр;

3 - Р/С может состоять только из 20 цифр;

4 - Р/С указан неправильного формата;

Примеры использования:

PHP:

$error = [];

$validation = DataValidation::validateRs('12345678909876543210','123456789', $error);

if (!$validation)

{

// обработка ситуации, когда проверка завершилась с ошибкой

echo $error['message'];

}

else

{

// проверка завершилась успехом

}

JS:

var error = {

code: null,

message: null

};

var validation = BX.tszh.validateRs('12345678909876543210','123456789', $error);

if (!validation) {

// обработка ситуации, когда проверка завершилась с ошибкой

console.log(error.message);

}

else {

// проверка завершилась успехом

}

1. validateSnils(snils, error) : boolean;

Метод:

validateRs(rs, bik, error) : boolean;

Входящие данные:

• snils - строка с номером СНИЛС;

• error - переменная, в которую будет передан код и сообщение об ошибке, в процессе проверки;

Результат работы метода:

true/false;

Коды сообщения об  ошибках:

1 - СНИЛС пуст;

2 - СНИЛС может состоять только из цифр;

3 - СНИЛС может состоять только из 11 цифр;

4 - СНИЛС указан неправильного формата;

Примеры использования:

PHP:

$error = [];

$validation = DataValidation::validateSnils('12345678901', $error);

if (!$validation)

{

// обработка ситуации, когда проверка завершилась с ошибкой

echo $error['message'];

}

else

{

// проверка завершилась успехом

}

JS:

var error = {

code: null,

message: null

};

var validation = BX.tszh.validateSnils('12345678901', error);

if (!validation) {

// обработка ситуации, когда проверка завершилась с ошибкой

console.log(error.message);

}

else {

// проверка завершилась успехом

}