Skip to content

Information on Arrears in Payments Administered by the FNS

This information type (VS) is designed to enable the FNS to transmit information on arrears in payments administered by the Federal Tax Service of Russia. The VS contains:

  • Request information:
    • Request identifier generated by the requesting party
    • Taxpayer information for an individual or sole proprietor (INN, full name)
    • Taxpayer information for an organization (INN, KPP, full name)
  • Response information:
    • Request identifier generated by the requesting party
    • Information date
    • Arrears information:
      • ENS (Единый налоговый счёт / Unified Tax Account) balance (including arrears suspended due to bankruptcy proceedings, and arrears under the due dates of a settlement agreement schedule)
      • Arrears suspended from collection and enforcement
      • Overdue arrears
      • Arrears on non-tax payments (including arrears suspended due to bankruptcy proceedings, and arrears under the due dates of a settlement agreement schedule)
    • Request processing information (processing code, processing error description)

The following HTTP headers must be passed in all requests:

Name Type Required Description
X-Api-Key string Yes Unique shop identifier
X-Signature string Yes Request signature

The signature is generated using secret_key — the secret key found in the merchant's shop settings.

Request

Method: POST

  • Production: https://api.baas.kvell.group/v1/smev3/fns/svdplgplat
  • Stage: https://api.baas.stage.kvell.group/v1/smev3/fns/svdplgplat

Request parameters (JSON)

Name
 Data type Required Description
id_request string (format ^[a-zA-Z0-9-]{32,36}$) No Unique request identifier (sent to the FNS)
info_date string (YYYY-MM-DD format) Yes Information date
individual dict (see format below) No Individual/sole proprietor information
legal dict (see format below) No Legal entity information

The request must specify either individual (information about an individual or sole proprietor) or legal (information about a legal entity).
individual format:

Name
 Data type Required Description
inn string Yes Individual's INN
first_name string (up to 60 characters) Yes First name
last_name string (up to 60 characters) Yes Last name
middle_name string (up to 60 characters) Yes, if present Middle name (patronymic)

legal format:

Name
 Data type Required Description
inn string Yes Legal entity's INN
kpp string No Legal entity's KPP
org_name string (up to 1000 characters) No Legal entity's full name 
{
  "info_date": "2022-01-01",
  "id_request": "df48392ecc724309be85a0817c153ae9",
  "individual":
  {
    "inn": "010000000000",
    "last_name": "Иванов",
    "first_name": "Иван",
    "middle_name": "Иванович"
  }
}

Building the signature

The X-Signature signature is generated by concatenating X-Api-Key, json <request body>, and secret_key. sha256 is computed from the resulting string:

sha256({x-api-key}{json <request body>}{secret_key})

Response

{
  "request_id": "b48c09bc-6efb-4da4-95aa-4a85ff923425"
}

request_id — the request identifier, used to retrieve the result.

Retrieving the check result

Method: GET

  • Production: https://api.baas.kvell.group/v1/smev3/fns/svdplgplat/{request_id}
  • Stage: https://api.baas.stage.kvell.group/v1/smev3/fns/svdplgplat/{request_id}

URL request parameters

Name Data type Required Description
request_id string Yes Request identifier 
GET /v1/smev3/fns/svdplgplat/b48c09bc-6efb-4da4-95aa-4a85ff923425

Building the signature

The X-Signature signature is generated by concatenating X-Api-Key, request_id, and secret_key. sha256 is computed from the resulting string:

sha256({x-api-key}{request_id}{secret_key})

Response

{
  "state": "in_progress",
  "request_id": "befe8815-24b0-446b-925c-ea128f39667c",
  "response_id": null
}

{
  "state": "finished",
  "request_id": "befe8815-24b0-446b-925c-ea128f39667c",
  "response_id": "df65dc1c-fc66-41cd-abbd-87218127fbeb",
  "result":
  {
    "balance_ens":
    {
      "debt_sign": "1", "tax": "40", "fees": "1", "insurance": "10", "penalty": "5", "fines": "600", "percents": "0", "enp": "50"
    },
    "debt_suspended":
    {
      "debt_sign": "1", "tax": "30", "fees": "0", "insurance": "0", "penalty": "20", "fines":"450", "percents": "40", "enp": "0"
    },
    "debt_overdue":
    {
      "debt_sign": "1", "tax": "120", "fees": "0", "insurance": "0", "penalty": "0", "fines": "30", "percents": "300", "enp": "0"
    },
    "debt_non_tax":
    {
      "debt_sign": "1", "total": "50", "regular_subsoil": "100"
    }
  }
}

{
  "state": "finished",
  "request_id": "6ed9f77b-c150-4cdb-adcf-9d70d167f6ab",
  "response_id": null,
  "error": {
    "code": "internal",
    "desc": "SMEV connection error"
  }
}

{
  "error": "request not found"
}
  • state — request status
    • in_progress — in progress
    • finished — completed
  • request_id — the request identifier assigned for SMEV3 (optional)
  • response_id — the response identifier in the SMEV3 system, if a response was received from the department's information system (FNS)
  • error — an error from the internal service, SMEV, or the department's information system (required if state = finished and result = null)
    • code — error code (required)
    • desc — error description (required)
    • status_code — HTTP status code from SMEV3 (optional)
    • destname — request field containing the error from SMEV (optional)
  • result — processing result (required if state = finished and error = null)
    • balance_ens — ENS (Unified Tax Account) balance (including arrears suspended due to bankruptcy proceedings, and arrears under the due dates of a settlement agreement schedule):
      • debt_sign — arrears flag: 0 — none, 1 — present (required)
      • tax — tax arrears (optional)
      • fees — fee arrears (including state duty) (optional)
      • insurance — insurance contribution arrears (optional)
      • penalty — late-payment penalty (пени) arrears (optional)
      • fines — fine (штраф) arrears (optional)
      • percents — interest arrears (optional)
      • enp — Unified Tax Payment (ENP) arrears (optional)
    • debt_suspended — arrears suspended from collection and enforcement (structure identical to balance_ens)
    • debt_overdue — overdue arrears (structure identical to balance_ens)
    • debt_non_tax — arrears on non-tax payments (including arrears suspended due to bankruptcy proceedings, and arrears under the due dates of a settlement agreement schedule)
      • debt_sign — arrears flag: 0 — none, 1 — present (required)
      • total — total non-tax payment arrears (optional)
      • regular_subsoil — including arrears on regular subsoil use payments (optional)