DGT: municipal vehicle tax debtors (how to make inquiries) – VIAOBERTA

Attention: the central services of the DGT have ruled that the sending of non-payment notes through this service is subject to the following schedule:

From 08:00-18:00h 40 requests every 10 seconds so that your systems can handle the volume of concurrent requests that will occur, especially on specific dates (end of the year, etc.).

The following types of inquiries can be made:

1. Registration of IVTM defaults: this modality allows you to record the defaults associated with a vehicle / owner / municipality and year in the DGT Vehicle Registry, based on the following fields:

Registration: vehicle registration
Frame: vehicle frame number.
IdTitular: identity document of the vehicle owner (NIF, CIF, NIE).
Province: province INE code of 2 positions.
Municipality: INE code of municipality of 5 positions.
Year of Default: year in 4 digits (greater than 2007)

The data must be in the same order and all fields are mandatory except for the frame. Below is an example query:

Example_request_ATMV_ALTA.csv

NA6584AY;;00557751R;31;31201;2010 NA6584AY;;00557751R;31;31201;2009 2703GGG;MAT4640718SL00463;44299173T;31;31201;2010 2703GGG;MAT4640718SL00463;44299173T;31;31201;2009 E0009BBB;CLM0292750062;04967008C;31;31201;2010 E0009BBB;CLM0292750062;04967008C;31;31201;2009 0009BBB;KMXKNE1CPYU380148;B01152974;31;31201;2010 0009BBB;KMXKNE1CPYU380148;B01152974;31;31201;2009 VI00310;MAT4640718SL00463;44299173T;31;31201;2010 2703GGG;MAT4640??;44299173T;31;31201;2010 2703GGG;MAT4640718SL00463;M1234567F;31;31201;2010 VA9999ZZ;;30656485S;31;31201;2010

The information obtained is:

Whether the operation was performed correctly or the reason why it could not be performed

The query response file will display the following data:

The data sent in the request.
The response will provide the following information:
- Result Code: Result code of the operation.
- Description: Description of the result of the operation.

example_correct_answer_ATMV_ALTA.csv

NA6584AY;;00557751R;31;31201;2010;ATMV00000;Operation performed. NA6584AY;;00557751R;31;31201;2009;ATMV00000;Operation performed. 2703GGG;MAT4640718SL00463;44299173T;31;31201;2010;ATMV00000;Operation performed. 2703GGG;MAT4640718SL00463;44299173T;31;31201;2009;ATMV00000;Operation performed. E0009BBB;CLM0292750062;04967008C;31;31201;2010;ATMV00000;Operation performed. E0009BBB;CLM0292750062;04967008C;31;31201;2009;ATMV00000;Operation performed. 0009BBB;KMXKNE1CPYU380148;B01152974;31;31201;2010;ATMV00604;The vehicle is permanently retired. 0009BBB;KMXKNE1CPYU380148;B01152974;31;31201;2009;ATMV00604;The vehicle is permanently retired. VI00310;MAT4640718SL00463;44299173T;31;31201;2010;ATMV00500;The license plate is incorrect. 2703GGG;MAT4640??;44299173T;31;31201;2010;ATMV00501;The frame is incorrect. 2703GGG;MAT4640718SL00463;M1234567F;31;31201;2010;ATMV00502;The identification document is incorrect. VA9999ZZ;;30656485S;31;31201;2010;ATMV00601;Vehicle without antecedents.

2. Consultation of IVTM defaults: this method allows you to consult the notes of defaults associated with a vehicle / owner / municipality and year in the DGT Vehicle Registry, based on any of the following fields:

Registration number: registration number of the vehicle
Frame: vehicle frame number.
IdTitular: identity document of the vehicle owner (NIF, CIF, NIE).
Province: province INE code of 2 positions.
Municipality: INE code of municipality of 5 positions.
Year of Default: year in 4 digits (greater than 2007).
DateAlta: date of registration in the register of debtors, format DD/MM/YYYY or %/MM/YYYY)

The data must be in the same order and can be searched by any of the fields. Below is an example query:

Example_petitio_ATMV_CONSULTA.csv

;;00557751R;;;; NA6584AY;;00557751R;31;31201;2010; 2703GGG;MAT4640718SL00463;44299173T;31;31201;; E0009BBB;CLM0292750062;04967008C;31;31201;; 0009BBB;KMXKNE1CPYU380148;B01152974;31;31201;; VI00310;MAT4640718SL00463;44299173T;31;31201;2010; 2703GGG;MAT4640??;44299173T;31;31201;2010; 2703GGG;MAT4640718SL00463;M1234567F;31;31201;2010; VA9999ZZ;;30656485S;31;31201;2010;

The information obtained is:

The data sent in the request.
The response will provide the following information:
- List of defaults: the default will contain the same data as indicated in the request.
- Result Code: result code of the operation.
- Description: description of the result of the operation.

Below is an example of a query response:

example_correct_answer_ATMV_QUERY.csv

;;00557751R;;;;;ATMV999999;Error in communication with the final sender NA6584AY;;00557751R;31;31201;2010;;prNA6584AY;;00557751R;31;31201;2010;08/04/2010 10:42:24;ATMV00000;Operation performed. 2703GGG;MAT4640718SL00463;44299173T;31;31201;;;ATMV999999;Error in communication with the final issuer E0009BBB;CLM0292750062;04967008C;31;31201;;;ATMV999999;Error in communication with the final issuer 0009BBB;KMXKNE1CPYU380148;B01152974;31;31201;;;ATMV999999;Error in communication with the final issuer VI00310;MAT4640718SL00463;44299173T;31;31201;2010;;ATMV00500;The registration is incorrect. 2703GGG;MAT4640??;44299173T;31;31201;2010;;ATMV00501;The frame is incorrect. 2703GGG;MAT4640718SL00463;M1234567F;31;31201;2010;;ATMV00502;The identification document is incorrect. VA9999ZZ;;30656485S;31;31201;2010;;ATMV00802;The search did not produce results.

3. Elimination of IVTM defaults: this operation allows you to eliminate the entries of defaults associated with a vehicle / owner / municipality and year in the DGT Vehicle Registry, based on the following fields:

Registration number: registration number of the vehicle
Frame: vehicle frame number.
IdTitular: identity document of the vehicle owner (NIF, CIF, NIE).
Province: province INE code of 2 positions.
Municipality: INE code of municipality of 5 positions.
Year of Default: year in 4 digits (greater than 2007)

The data must be in the same order and all fields are mandatory except for the frame. Below is an example query:

Example_petitio_ATMV_ELIMINAR.csv

The information obtained is:

The data sent in the request.
The response will provide the following information:
- Result Code: result code of the operation.
- Description: description of the result of the operation.

Below is an example of a query response:

example_correct_answer_ATMV_DELETE.csv

NA6584AY;;00557751R;31;31201;2010;ATMV00000;Operation performed. NA6584AY;;00557751R;31;31201;2009;ATMV00000;Operation performed. 2703GGG;MAT4640718SL00463;44299173T;31;31201;2010;ATMV00000;Operation performed. 2703GGG;MAT4640718SL00463;44299173T;31;31201;2009;ATMV00000;Operation performed. E0009BBB;CLM0292750062;04967008C;31;31201;2010;ATMV00000;Operation performed. E0009BBB;CLM0292750062;04967008C;31;31201;2009;ATMV00000;Operation performed. 0009BBB;KMXKNE1CPYU380148;B01152974;31;31201;2010;ATMV00804;The IVTM does not exist. 0009BBB;KMXKNE1CPYU380148;B01152974;31;31201;2009;ATMV999999;Error communicating with end sender VI00310;MAT4640718SL00463;44299173T;31;31201;2010;ATMV00500;The license plate is incorrect. 2703GGG;MAT4640??;44299173T;31;31201;2010;ATMV00501;The frame is incorrect. 2703GGG;MAT4640718SL00463;M1234567F;31;31201;2010;ATMV00502;The identification document is incorrect. VA9999ZZ;;30656485S;31;31201;2010;ATMV00804;The IVTM does not exist.

Summary table of Result Codes

Result codes

ATMV00000: operation completed successfully
ATMV00101: access to the service outside the hours established by the service.
ATMV00200: ATMV platform technical error.
ATMV00201: certificate used to access the service is invalid.
ATMV00202: The requesting user identifier does not match that of the digital certificate used to sign the message.
ATMV00300: ATMV platform technical error.
ATMV00301: The requesting user is not authorized to access the service.
ATMV00400: ATMV platform technical error.
ATMV00401: The requesting user's entity does not have any municipality assigned.
ATMV00500: Invalid license plate.
ATMV00501: Incorrect frame.
ATMV00502: Incorrect holder identifier.
ATMV00503: Incorrect default year.
ATMV00504: the requesting entity does not have jurisdiction over the reported province.
ATMV00505: the requesting entity does not have jurisdiction over the municipality reported.
ATMV00506: Default registration date is incorrect.
ATMV00600: ATMV platform technical error.
ATMV00601: The vehicle you want to register has no associated information.
ATMV00602: The vehicle you want to register has associated information but the indicated chassis does not match the vehicle data.
ATMV00604: the vehicle is permanently deregistered and the operation cannot be carried out.
ATMV00800: ATMV platform technical error.
ATMV00801: The default you want to register already exists.
ATMV00802: Search returned no results.
ATMV00803: The search does not return more than 75 results and the search must be narrowed down.
ATMV00804: The default you want to cancel does not exist.
ATMV99999: ATMV platform technical error.