Attention: the central services of the DGT have ruled that the sending of notes for non-payment through this service is subject to the following schedule:
  • From 08:00-18:00h 40 requests every 10 seconds so that your systems can take on the volume of concurrent requests that will occur, especially on specific dates (end of year, etc.).

Inquiries can be made in the following ways:

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

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

The data must be put in the same order and all fields are mandatory with the exception of the frame. Below is an example query:

Example_petitio_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 carried out correctly or the reason why it could not be carried out

The query response file will display the following data:

  • The data sent in the request.
  • The response will report the following data:
    • 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. IVTM arrears query: this modality allows you to consult the entries of arrears associated with a vehicle / owner / municipality and year in the DGT Vehicle Register, from one of the following fields:

  • Registration number: registration number of the vehicle
  • Frame: vehicle frame number.
  • IdTitular: identity document of the owner of the vehicle (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 put 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 report the following data:
    • 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 response to the query:

example_correct_answer_ATMV_CONSULTA.csv
;;00557751R;;;;;ATMV999999;Error communicating with end 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 sender E0009BBB;CLM0292750062;04967008C;31;31201;;;ATMV999YU999;Error in communication with the final sender 0009BBB;31K18K18K1K1BCP; 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 defaults from the IVTM: this operation allows the deletion of entries of defaults associated with a vehicle / owner / municipality and year in the DGT Vehicle Register, from the following fields:

  • Registration number: registration number of the vehicle
  • Frame: vehicle frame number.
  • IdTitular: identity document of the owner of the vehicle (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 (since 2007)

The data must be put in the same order and all fields are mandatory with the exception of the frame. Below is an example query:

Example_petitio_ATMV_ELIMINAR.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:

  • The data sent in the request.
  • The response will report the following data:
    • Result Code: result code of the operation.
    • Description: description of the result of the operation.

Below is an example of a response to the query:

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 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;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 invalid service.
  • ATMV00202: The identifier of the requesting user 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 entity of the requesting user has no municipality assigned.
  • ATMV00500: Invalid license plate.
  • ATMV00501: Invalid rack.
  • ATMV00502: Invalid Holder ID.
  • ATMV00503: Incorrect default year.
  • ATMV00504: The requesting entity does not have jurisdiction over the reported province.
  • ATMV00505: the requesting body does not have powers over the informed municipality.
  • ATMV00506: Date of default is not correct.
  • ATMV00600: ATMV platform technical error.
  • ATMV00601: The vehicle to be registered has no associated information.
  • ATMV00602: The vehicle to be registered has associated information but the specified frame 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 to be registered already exists.
  • ATMV00802: Search returned no results.
  • ATMV00803: The search returns no more than 75 results and the search needs to be narrowed.
  • ATMV00804: The default to be canceled does not exist.
  • ATMV99999: ATMV platform technical error.