The check is carried out to ensure that the invoice and subsequent payment can be processed correctly on the Project side.
With simplified integration, the user ID and order are checked twice: when going to the payment form and when choosing a payment method.
The project needs:
- User ID or order verification URL(specify in Technical Settings in your Personal Account);
- A handler capable of accepting and recognizing request parameters from the System and responding as the System expects.
If the ID verification after issuing an invoice fails, then the invoice will not be issued, and the user will be redirected to the payment error page specified by the project using the parameter return_url_fail or in the Technical Settings (if the page is not specified, a similar one on the System side is used). A parameter is automatically sent to the payment error page using the GET method err_msg with meaning "Such a character does not exist".
Request parameters from the System to the Project
The system sends the Project a request to the URL for checking the user ID or order specified in the Technical Settings in the Personal Account.
- transfer method - POST;
- encoding - UTF-8.
Parameter |
Parameter description |
Parameter format |
Required parameter |
|---|---|---|---|
| userid | User or order ID (equal to the parameter value nickname V ) | string(256) | Yes |
| userid_extra | Additional information required to make a payment or collect statistics on the Project side (equal to the parameter value nick_extra ) | string(500) | No |
| key |
Verification signature of the request. It is formed as a hash using the md5 algorithm from the concatenation of the following parameters:
|
md5(0userid0project secret) | Yes |
| amount | 0 | Yes | |
| paymentid | Checking the check request. Only accepts a zero value (amount = 0) | 0 | Yes |
| orderid | Payment ID in the Project accounting system (equal to the parameter value order_id V ) | varchar(64) | No |
Project Response Options
The System's request from the Project must receive a response.
The following rules are used to pass request parameters:
- format - XML;
- encoding - UTF-8.
Parameter |
Parameter description |
Parameter format |
Required parameter |
|---|---|---|---|
| code |
Request response code.
|
(case sensitive) |
Yes |
| comment | Decoding the response code to the request. Text examples:
|
string(400) | No |
Example response to a user ID or order verification request
YES
An example of a minimal System request handler when checking a user ID or order
//Generating a response function sendResponse($status, $message = "")( $response = ""."\n"; $response .= " ".$status.""."\n"; $response .= "
Unique payment identifier - what is it? What is it for? This is the most frequently asked questions questions that entrepreneurs ask when paying taxes at the bank, when a bank employee asks to indicate this, is puzzling. Where can I find it, how can I get it, and can I do without it? Thus, a tool created to simplify the procedure resulted in new issues that needed to be clarified.
What is a unique identifier?
A unique payment identifier is a 20-digit code that must be specified when paying off tax debts. This makes it possible to easily and quickly pay taxes from your personal account on the website tax service. This approach greatly simplifies and speeds up the operation procedure. Payment occurs quickly and therefore on time, which avoids delays and therefore penalties and interest.
The use of a unique identifier allows entrepreneurs, legal and individuals pay taxes in a way convenient for you. But receiving and filling out tax documentation forms in this case has its own characteristics that must be taken into account. The problem also lies in the fact that the state itself information service has a complex, confusing structure that even an experienced user cannot always understand.
What is it for?
It is needed so that the Federal Tax Service knows when and from which person the money was received into the account. There are millions of users registered in GIS; it is difficult to determine from whom and for what purposes money is transferred. That is why, by order of the Ministry of Finance No. 107n dated November 12, 2013, the rules were changed, according to which a unique identifier for accrual payments appeared separately for taxes.
The tax service needs it in order to more effectively implement fiscal policy and identify persistent defaulters. Legal entities and individuals need the most convenient and fast way pay taxes. As a result, the government can control the actions of tax officials and stop cases when their actions exceed the powers delegated to them, which often happened in the past. Businessmen are less dependent on the will of the individual and suffer from illegal extortions. The number of inspections carried out has been reduced.
Who should indicate it?
Both ordinary citizens, entrepreneurs (individuals), and legal entities can indicate a unique payment identifier. This can be done when paying taxes directly in the information system account or through a bank. When transferring, you should take into account that payment through Sberbank has its own characteristics. They have their own special form, when filling it out, a unique identifier does not need to be specified. The UIN is indicated when paying taxes and state duties through the State Services service or a bank branch.
If an individual or legal entity fills out payment documents for the payment of taxes and fees, the payment deadline for which has not yet expired, then he may not enter a unique identifier, but insert a zero in the due date for entering the details. Although this method of filling out the line is permitted by law, when paying through a bank, the employee may require filling out the line with a 20-digit payment number and has the right to refuse to accept the payment. Therefore, it is important to know in which cases it must be indicated, and in which it is not necessary.
In what cases is it necessary to indicate it?
It should be noted that the identifier does not always need to be specified, but only in certain cases, which are described in the rules and regulations of the Bank of Russia (in particular, regulation No. 383-P). UIN - a unique identifier is indicated in two cases:
- If it was indicated by the recipient of funds and provided to an individual or legal entity obligated to pay them in accordance with the terms of the contract. In this case, the identifier is assigned automatically.
- When transferring funds to the tax authorities. An entrepreneur or individual fills out special fields (lines) of the payment in paper or electronic form. In this case, filling causes some difficulties. After all, an entrepreneur does not always know his unique payment identifier number or where to get it.
In the second case, most taxpayers experience difficulties because they do not know where to get it and where to indicate it in the document. And incorrectly specified data leads to delays in payment, penalties and fines.
Where and how can I get an ID?
How can I find out information about the unique payment identifier, as well as whether the payment was accepted? You can check this as in personal account GIS after registration in the system, and upon receipt of a payment order in case of late payments. But this is an extreme case. The entrepreneur will know the number from the documents indicating the presence of a debt or fine to the tax authorities.
If there were no overdue payments, but you need to indicate the UIN, then you just need to send a request to the tax service to get a number.
How to fill it out correctly?
When taxpayers make payments to budget system RF fill out the payment order. In addition to the unique identifier, the entrepreneur must indicate:
- BIC of the institution through which the payment will be made;
- name of the bank, its legal address;
- the current account from which the transfer will be made;
- type of payment (code);
- date of the operation.
The number is entered into the line of the unique payment identifier - 22 (field code). Do not fill out only if payment occurs on time. In this case, enter “0” (zero) in this line.
What to do if the document already contains a UIN?
Sometimes, especially when making payments through specialized information systems, when filling out an order electronically in the line (its code is 22), a unique payment identifier appears on its own. How should we feel about this? Is this considered an error if cash are they paid on time? In fact, there is no error. You can pay either by indicating the ID number or by entering “0” in the line. They just require you to indicate the identifier when payment is late, that is, at the request of the tax office.
Although it is possible to pay without restrictions, this approach is undesirable. An enterprise must distinguish between regular tax payments and those paid at the request of the tax authorities. This will help avoid confusion in reporting.
But even if it was not possible to find out and indicate the identifier in the order, this does not give the banks the right to refuse to accept it. The bank is obliged to accept and transfer funds, even if the UIP (unique payment identifier) is not specified. This rule is spelled out in official documents of the tax service. It clearly states that an individual or legal entity only needs to indicate their TIN and enter “0” in the line (code 22) of the unique payment identifier. In this case, the bank does not have the right to refuse to transfer the payment. But the entrepreneur must take into account that in the event of an error or delay, the bank is not responsible.
What does the code mean: decoding the identifier
The identifier is decrypted as follows:
- Numbers 1 to 3 indicate the code of the tax department to which the funds will be received.
- The number 4 indicates the type of payment. This place is always zero.
- Numbers from 5 to 19. Indicate the document code in the tax system. Each payer is assigned its own special code based on previous version document index.
- Digit 20. Its number determines which government agency is verifying the payment. Calculated taking into account the remaining 19 digits of the code.
The unique payment identifier is identical to the document index only if the index consists of 20 digits.
What happens if you don't specify it?
Using the UIN number, taxes and other payments to the budget are automatically recorded. Information about payments to the budget is transferred to a single database. If you enter the wrong code or do not specify it, the system will not recognize the payment and the money will not be transferred. This is fraught with such troubles as:
- the company will incur debt to the budget and funds;
- penalties will continue to accrue;
- you will need to clarify the payment and find out its fate;
- the money will arrive to the budget or funds with a delay.
If a businessman does not have or does not know a unique payment identifier where to get it, he can use the support service in GIS at any time, rather than wait for the tax authorities to take action. If an entrepreneur does not have access to the Internet and electronic system"Government services", he can send a regular letter to the nearest tax office or appear in person to receive an identifier.
What documents are needed to obtain an ID?
It all depends on the form in which the document will be drawn up and how to pay. If this is a paper document, then you must send a written request to the tax authority. In the letter, indicate your passport details, INN and SNILS number. A unique payment identifier will be sent in a response letter. If a legal entity or individual comes to the department in person to receive this information, then these documents must be with him. They are required to fill out forms.
To receive details electronically, you must first register in a single information system on the State Services website, indicating the same data as in the written request. After this, a letter will be sent to your place of residence with an access key. And only after this can you make a request to obtain a unique identifier. Usually this service is provided within a few hours after the application. No documents are required.
As you can see, there is nothing complicated when using the identifier. It won't be difficult to recognize him. To do this, you don’t need to collect a bunch of documents or certificates. But taxes can be paid in a convenient form and at any time. If previously legal entities and individuals had to spend time and money to make tax payments, then with its help they can be paid without leaving home or office, without interrupting work.
General information
Description of input parameters
Description of output parameters
or
Output: XML document according to the scheme WS_ULIPOTVID_2_311_09_04_02_01.XSD
Complex type parameters are described in the Appendix “Description of General Data Structures” (in paragraphs 10, 6, 9).
Return codes
| № | Return code | Return code description | Conditions of occurrence | Comment |
| 1 | 01 | The requested information was not found | Occurs provided that information about the legal entity is not found in the Unified State Register of Legal Entities | |
| 2 | 51 | Request accepted for processing | Occurs when a request is successfully accepted for processing | |
| 3 | 52 | The answer is not ready | Occurs when a response to a request successfully accepted for processing is not ready | Used for asynchronous request |
| 4 | 53 | Information regarding a legal entity/individual entrepreneur cannot be provided electronically | Occurs when it is impossible to generate a response to a request in electronic form. | |
| 5 | 82 | Format-logical control error | Occurs when the document (request) does not match the xsd schema | Reserve, may not be used |
| 6 | 83 | There is no request with the specified request ID and type of information requested from this authority | Occurs in a situation where the request for a result of a request for an extract from a legal entity indicates an incorrect (unknown) request identifier and (or) a request with such an identifier was not received from this authority | Used for an asynchronous request (when receiving the result of a request for an extract from a legal entity) |
| 9 | 99 | System error | Occurs when there is internal errors in IS software of the Federal Tax Service of Russia |
Test cases
Response to a request to receive the result of a request to obtain an extract from a legal entity, in case the request has not yet been processed
Response to a request to receive the result of a request to obtain an extract from a legal entity with return code 53
Response to a request to receive the result of a request to obtain an extract from a legal entity with an error (the processing code for which is not reserved)
(attribute values change and)
| |
Note: The conditions for this error to occur in the test environment were artificially triggered. This example describes the general logic and structure of the error response. When testing on a production environment, returning exactly the same response without providing the necessary conditions is not possible.