Manual Tecnico WS Calidad Datos Identificativos

Departamento de Informtica Tributaria
Subdireccin General de Aplicaciones

Web Service de Calidad de datos identificativos Versin: 1.0
Web Service
de Calidad de datos identificativos
Autor: AEAT Fecha: 27/11/2015 Versin: 1.0
Revisiones
Edi. Rev. Fecha Descripcin A(*) Pginas
1 0 27/11/2015 Versin inicial A Todas
1 1 23/02/2017 Correccin de los endpoints de los R 7
mensajes de ejemplo
(*) Accin: A= Aadir; R= Reemplazar
ndice:
1. INTRODUCCIN. 3
2. UTILIZACIN DEL WEB SERVICE. 3
3. CONTROL DE VERSIONES. 3
3.1 Versin 1.0. 3
4. SERVICIO WEB VNIFV1.WSDL. 3
5. MENSAJE DE PETICIN DE DATOS. 4

5.1 NIF. 4
5.2 Apellidos y Nombre o Razn Social. 4
6. MENSAJE DE RESPUESTA. 4
Impreso: 23/02/2017 Pgina: 1/7

6.1. NIF. 4
6.2. Apellidos y Nombre o Razn Social. 4
7. MENSAJE DE ERROR. 4
8. DEFINICIN DEL SERVICIO Y ESQUEMAS. 5

8.1 Definicin del servicio VNifV1.wsdl 5
8.2 Mensaje de entrada VNifV1Ent.xsd 5
8.3 Mensaje de salida correcta VNifV1Sal.xsd 6
8.4 URL de acceso al servicio 6
9. EJEMPLOS. 7
9.1 Mensaje de entrada 7
9.2 Mensaje de respuesta 7
9.3 Mensaje de respuesta con error 7

1. Introduccin.
Este servicio web se ofrece con la finalidad de ayudar a los declarantes de declaraciones informativas a
identificar y comprobar el alta en el censo de la AEAT de los declarados en dichas declaraciones.
2. Utilizacin del web service.

El posible uso para otras finalidades o el abuso de este servicio podr suponer el bloqueo del acceso al
mismo, de forma temporal o permanente.
La informacin proporcionada por este servicio web se realiza consultando los datos identificativos
disponibles en el momento. Esta informacin podra variar si se producen posteriores cambios en los datos
identificativos.
3. Control de versiones.
3.1 Versin 1.0.
Versin inicial.
4. Servicio web VNifV1.wsdl.

Este Servicio requiere tener instalado un certificado de usuario admitido por la AEAT en el ordenador
desde el que se produzca el envo de la informacin.
La representacin grfica del servicio web es la siguiente:
En la definicin de este servicio se describe que el mensaje de entrada se basa en el esquema

VNifV1Ent.xsd y que la respuesta cuando no se detectan errores en la entrada y el contribuyente se
encuentra censado en la AEAT se basa en el esquema VNifV1Sal.xsd. En caso contrario, la respuesta
consistir en un mensaje SOAP Fault.
La representacin grfica de los datos del mensaje de entrada es la siguiente:

La representacin grfica de los datos del mensaje de salida es la siguiente:
5. Mensaje de Peticin de datos.

El mensaje de peticin no requerir firma digital.
5.1 NIF.
Descripcin: NIF de la persona fsica o jurdica sobre la que se quiere efectuar la consulta de verificacin.
Formato: Alfanumrico de 9 caracteres.
Obligatorio: S
5.2 Apellidos y Nombre o Razn Social.

Descripcin: Apellidos y Nombre de la persona fsica o Razn Social de la persona jurdica sobre la que se
quiere efectuar la consulta de verificacin.
Formato: Alfanumrico.
Obligatorio: Obligatorio para personas fsicas. Opcional en personas jurdicas.
6. Mensaje de Respuesta.
El mensaje de respuesta no tendr firma digital.
6.1. NIF.
Descripcin: NIF de la persona fsica o jurdica, validado y ajustado a 9 posiciones con ceros no
significativos si fuera necesario.
6.2. Apellidos y Nombre o Razn Social.

Descripcin: En caso de persona fsica, Apellidos y Nombre recibidos en el mensaje de peticin. En caso
de persona jurdica, Razn Social tal como se encuentra en el censo de contribuyentes de la AEAT.
7. Mensaje de error.
Cualquier error producir un mensaje SOAP FAULT como respuesta. El faultstring contendr el motivo del
rechazo.
Codigo[-1].No identificado

8. Definicin del servicio y Esquemas.

8.1 Definicin del servicio VNifV1.wsdl
La definicin del servicio se puede consultar en la direccin
http://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/burt/jdit/
ws/VNifV1.wsdl
y su contenido es el siguiente:
<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions
xmlns:VNifV1="http://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/burt/jd
it/ws/VNifV1.wsdl"
xmlns:VNifV1Ent="http://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/burt
/jdit/ws/VNifV1Ent.xsd"
xmlns:VNifV1Sal="http://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/burt
/jdit/ws/VNifV1Sal.xsd" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/burt
/jdit/ws/VNifV1.wsdl">
<wsdl:types>
<schema elementFormDefault="qualified"
/jdit/ws/VNifV1.wsdl"
/jdit/ws/VNifV1Sal.xsd" xmlns="http://www.w3.org/2001/XMLSchema">
<xsd:import
namespace="http://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/burt/jdit/
ws/VNifV1Ent.xsd" schemaLocation="VNifV1Ent.xsd"/>
<xsd:import
namespace="http://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/burt/jdit/
ws/VNifV1Sal.xsd" schemaLocation="VNifV1Sal.xsd"/>
</schema>
</wsdl:types>
<wsdl:message name="Entrada">
<wsdl:part name="VNifV1Ent" element="VNifV1Ent:VNifV1Ent"/>
</wsdl:message>
<wsdl:message name="Salida">
<wsdl:part name="VNifV1Sal" element="VNifV1Sal:VNifV1Sal"/>
</wsdl:message>
<wsdl:portType name="VNifV1">
<wsdl:operation name="VNifV1">
<wsdl:input name="Entrada" message="VNifV1:Entrada"/>
<wsdl:output name="Salida" message="VNifV1:Salida"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="VNifV1SoapBinding" type="VNifV1:VNifV1">
<wsdlsoap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="VNifV1">
<wsdlsoap:operation soapAction="" style="document"/>
<wsdl:input name="Entrada">
<wsdlsoap:body use="encoded"/>
</wsdl:input>
<wsdl:output name="Salida">
<wsdlsoap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="VNifV1Service">

<wsdl:port name="VNifPort1" binding="VNifV1:VNifV1SoapBinding">
<wsdlsoap:address location="https://www1.agenciatributaria.gob.es/wlpl/BURTJDIT/
ws/VNifV1SOAP"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
8.2 Mensaje de entrada VNifV1Ent.xsd

El diseo del esquema de entrada se puede consultar en la direccin
http://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/burt/jdit/w
s/VNifV1Ent.xsd


<schema xmlns="http://www.w3.org/2001/XMLSchema"
/jdit/ws/VNifV1Ent.xsd" elementFormDefault="qualified">
<annotation>
<documentation>
Esquema para solicitar la verificacin de un NIF
</documentation>
</annotation>
<element name="VNifV1Ent" type="VNifV1Ent:VNifV1Ent"/>
<complexType name="VNifV1Ent">
<annotation>
<documentation>
Nif : Nif a verificar
Nombre: Nombre o Razn Social
</documentation>
</annotation>
<sequence>
<element name="Nif" type="string"/>
<element name="Nombre" type="string"/>
</sequence>
</complexType>
</schema>
8.3 Mensaje de salida correcta VNifV1Sal.xsd

El diseo del esquema de salida se puede consultar en la direccin
http://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/burt/jdit/ws/VN
ifV1Sal.xsd

<schema xmlns="http://www.w3.org/2001/XMLSchema"
/jdit/ws/VNifV1Sal.xsd"
/jdit/ws/VNifV1Sal.xsd" elementFormDefault="qualified">
<annotation>
<documentation>
Esquema de respuesta del servico de verificacin de NIF.
</documentation>
</annotation>
<element name="VNifV1Sal" type="VNifV1Sal:VNifV1Sal"/>
<complexType name="VNifV1Sal">
<annotation>
<documentation>
Nif : Nif verificado
Nombre: Razn Social en caso de Persona Jurdica. En caso de Persona
Fsica se responde un eco de los datos de entrada
por temas de Proteccin de Datos Personales
</documentation>
</annotation>
<sequence>
<element name="Nif" type="string"/>
<element name="Nombre" type="string"/>
</sequence>
</complexType>
</schema>
8.4 URL de acceso al servicio

La URL es la siguiente:
https://www1.agenciatributaria.gob.es/wlpl/BURT-JDIT/ws/VNifV1SOAP

9. Ejemplos.
9.1 Mensaje de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:vnif="http://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/burt/jdit
/ws/VNifV1Ent.xsd">
<soapenv:Header/>
<soapenv:Body>
<vnif:VNifV1Ent>
<vnif:Nif>99999999R</vnif:Nif>
<vnif:Nombre> ESPAOL ESPAOL JUAN </vnif:Nombre>
</vnif:VNifV1Ent>
</soapenv:Body>
</soapenv:Envelope>
9.2 Mensaje de respuesta

<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<env:Body>
<VNifV1Sal:VNifV1Sal
xmlns:VNifV1Sal="http://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/bu
rt/jdit/ws/VNifV1Sal.xsd">
<VNifV1Sal:Nif>99999999R</VNifV1Sal:Nif>
<VNifV1Sal:Nombre>ESPAOL ESPAOL JUAN</VNifV1Sal:Nombre>
</VNifV1Sal:VNifV1Sal>
</env:Body>
</env:Envelope>
9.3 Mensaje de respuesta con error

<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Body>
<env:Fault>
<faultcode>env:Client</faultcode>
<faultstring>Codigo[-1].No identificado</faultstring>
</env:Fault>
</env:Body>
</env:Envelope>

Manual Tecnico WS Calidad Datos Identificativos

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Manual Tecnico WS Calidad Datos Identificativos

Uploaded by

Copyright:

Available Formats

Departamento de Informtica Tributaria

Subdireccin General de Aplicaciones

Autor: AEAT Fecha: 27/11/2015 Versin: 1.0

(*) Accin: A= Aadir; R= Reemplazar

2. UTILIZACIN DEL WEB SERVICE. 3

4. SERVICIO WEB VNIFV1.WSDL. 3

5. MENSAJE DE PETICIN DE DATOS. 4

Impreso: 23/02/2017 Pgina: 1/7

8. DEFINICIN DEL SERVICIO Y ESQUEMAS. 5

Impreso: 23/02/2017 Pgina: 2/7

2. Utilizacin del web service.

4. Servicio web VNifV1.wsdl.

La representacin grfica del servicio web es la siguiente:

En la definicin de este servicio se describe que el mensaje de entrada se basa en el esquema

La representacin grfica de los datos del mensaje de entrada es la siguiente:

Impreso: 23/02/2017 Pgina: 3/7

La representacin grfica de los datos del mensaje de salida es la siguiente:

5. Mensaje de Peticin de datos.

5.2 Apellidos y Nombre o Razn Social.

6.2. Apellidos y Nombre o Razn Social.

Impreso: 23/02/2017 Pgina: 4/7

8. Definicin del servicio y Esquemas.

<?xml version="1.0" encoding="UTF-8"?>

8.2 Mensaje de entrada VNifV1Ent.xsd

Impreso: 23/02/2017 Pgina: 5/7

<?xml version="1.0" encoding="UTF-8"?>

8.3 Mensaje de salida correcta VNifV1Sal.xsd

<?xml version="1.0" encoding="UTF-8"?>

8.4 URL de acceso al servicio

Impreso: 23/02/2017 Pgina: 6/7

9.2 Mensaje de respuesta

9.3 Mensaje de respuesta con error

Impreso: 23/02/2017 Pgina: 7/7

You might also like