Embed Size (px)
Citation preview
1
Manual de integración del Punto Neutro de
Embargos
Versión 1.0
Punto Neutro de Embargos Departamento de Informática Tributaria
2
Tabla de contenido Introducción ........................................................................................................................3
Entes Pagadores ...................................................................................................................4
Escenario de funcionamiento de un Ente pagador ..............................................................4
Operaciones disponibles para entes pagadores ..................................................................4
Envío de pagos ..............................................................................................................4
Recuperar actuaciones de embargo ...............................................................................6
Entes embargantes...............................................................................................................8
Escenario de funcionamiento de un Ente embargante ........................................................8
Operaciones disponibles para entes embargantes ..............................................................8
Envío de información de deudores .................................................................................8
Recuperación de pagos susceptibles de embargo .......................................................... 10
Envío de diligencias de embargo .................................................................................. 12
ANEXO I: Servicio web de recogida de información del punto neutro de embargos: bandeja de
entrada.............................................................................................................................. 14
ANEXO II: Configuración de los certificados para la conexión vía web service ......................... 15
ANEXO III: Formato de los ficheros de pagos ........................................................................ 15
ANEXO IV: Formato de los ficheros de deudores................................................................... 16
ANEXO V: Formato de las diligencias de embargo................................................................. 17
ANEXO VI: Entorno de PREPRODUCCION para realizar las pruebas de integración .................. 20
Certificado electrónico para las pruebas .......................................................................... 20
Configuración previa a las pruebas .................................................................................. 20
Pruebas de un ente pagador............................................................................................ 21
Pruebas de un ente embargante...................................................................................... 24
3
Introducción El punto neutro de embargos tiene un portal web desde el que los entes adheridos pueden
realizar todas las operaciones y consultas que deseen.
https://www2.agenciatributaria.gob.es/wlpl/SREM-PNEM/PuntoNeutroEmbargosSV
Pero además, ofrece una interfaz de programación de aplicaciones (API) para que los entes
que así lo deseen puedan automatizar sus interacciones con él.
Toda esta API está implementada mediante dos servicios web
1. Uno propio del punto neutro de embargos que se usa para el envío y recuperación de
información al punto neutro. Las informaciones que tienen que enviar los entes son
pagos, deudores, actuaciones de embargo, etc.
2. Otro propio de la AEAT y denominado “Bandeja de Entrada” que se usa de forma
genérica para la notificación de eventos relacionados con el sistema. Las notificaciones
que realizan a través de este sistema son, por ejemplo, el aviso de pagos susceptibles
de embargar, el aviso de actuaciones de embargo recibidas, etc.
La definición de ambos servicios web está publicada en la AEAT.
https://www2.agenciatributaria.gob.es/ADUA/internet/es/aeat/dit/adu/srem/pne/PuntoNeut
roEmbV1.wsdl
https://www2.agenciatributaria.gob.es/ADUA/internet/es/aeat/dit/adu/adws/banent/ListaDe
cV4.wsdl
Los endpoints del servicio web del punto neutro son:
https://www1.agenciatributaria.gob.es/wlpl/inwinvoc/es.aeat.dit.adu.srem.pne.ws.PuntoNeutroEmbV1SOAP (en Intenet)
https://ws.ia.aeat.es/wlpl/iniinvoc/es.aeat.dit.adu.srem.pne.ws.PuntoNeutroEmbV1SOAP (en Red SARA)
Los endpoints de la bandeja de entrada ver ANEXO I: Servicio web de recogida de información
del punto neutro de embargos: bandeja de entrada
Las operaciones que se pueden realizar con el punto neutro de embargos se pueden dividir
funcionalmente dependiendo de si el ente actúa como ente pagador o de si actúa como ente
embargante.
La dirección de correo para consultas y dudas es: [email protected]
4
Entes Pagadores Antes de entrar a describir la API disponible para los entes pagadores vamos a ver el escenario
típico de funcionamiento para un ente pagador.
Escenario de funcionamiento de un Ente pagador
Un ente pagador deberá realizar los siguientes pasos:
Paso 1: Envío de pagos
El pagador previo a ejecutar los pagos que tenga pendientes (diariamente, semanalmente…)
debe generar un fichero de texto con los pagos que va a realizar y enviarlo al Punto Neutro .
Como respuesta, el Punto Neutro le indicará qué pagos pertenecen a deudores de alguna
administración y la fecha límite hasta la que los entes embargantes pueden realizar acciones
contra dichos pagos. El ente pagador deberá retener estos pagos hasta esa fecha límite de
envío de actuaciones de embargo. El resto de pagos contenidos en el fichero podrán ser
liberados en ese momento.
Paso 2: Recuperar actuaciones de embargo contra sus pagos vencidos.
Cada vez que venza la fecha límite de envío de actuaciones de embargo de los pagos que tiene
retenidos, el ente pagador deberá comprobar si algún embargante ha realizado actuaciones de
embargo contra el pago.
Si para un pago en concreto no ha llegado ninguna actuación, el pagador podrá liberar el pago.
Si sí han llegado actuaciones de embargo, el pagador deberá repartir el dinero del pago entre
los embargantes que han enviado actuaciones de embargo y pagar el dinero restante al
receptor del pago.
Operaciones disponibles para entes pagadores
Envío de pagos
Un ente pagador debe poner en conocimiento del Punto Neutro los pagos que va a real i zar a
través del método EnviarPagosV1 del servicio web. El punto neutro responde de forma
síncrona con la información de los pagos que el ente tendrá que retener. Este método puede
ser invocado en cualquier momento (24x7).
EnviarPagosV1
Punto Neutro
Ente Servicio
web PNE
Pagos
Pagos a
retener
5
Método: EnviarPagosV1 (servicio web del PNE)
Este método permite enviar un fichero de pagos al punto neutro para ser procesado de forma
síncrona. El servicio web responde con el resultado del procesado.
Parámetros de entrada:
EnviarPagosV1
o NifEnte. Nif del pagador
o FormatoFichero. Formato del fichero que va en el parámetro
“contenidoFichero”. Actualmente este parámetro solo soporta los valores
“csv”.
o ContenidoFichero. El contenido del propio fichero en el formato especificado
(ver Anexos de formatos de ficheros).
o NumeroLote. Opcional. Identificador externo del ente para esta petición.
Parámetros de salida:
EnviarPagosV1Out
En esta etiqueta se incluye la información del resultado del procesado de los pagos,
como la fecha y hora del cruce, la fecha y hora límite de envío de actuaciones de
embargo y el listado de los pagos que han dado cruce positivo.
En caso de detectarse un error en el fichero de pagos (un pago con un formato
erróneo, un pago repetido, etc.) el Punto Neutro rechaza el fichero al completo y
devuelve el listado de los pagos erróneos para que el pagador pueda subsanarlos y
enviar de nuevo el fichero.
6
Recuperar actuaciones de embargo
El punto neutro notifica las actuaciones de embargo recibidas contra pagos de un pagador
mediante la bandeja de entrada de la AEAT. La recuperación de notificaciones en bandeja se
hace a través del servicio web de la bandeja de entrada en dos pasos, primero se recupera la
lista de mensajes sin leer y luego se recupera el detalle de un mensaje en particular.
Vamos a ver más en detalle la secuencia de operaciones que hay que realizar para recuperar
las actuaciones de embargo:
1.- Consulta en bandeja de entrada de las actuaciones de embargo pendientes para el
pagador
Mediante la invocación del método ListaDecV4 del servicio web de la bandeja de entrada,
especificando el Nif del pagador como Nif del declarante:
De la lista de mensajes pendientes obtenidos en la consulta anterior, hay que quedarse con los
que tengan el elemento tipoRespuesta igual a:
https://www2.agenciatributaria.gob.es/ADUA/internet/es/aeat/dit/adu/srem/pne/ActuacionV
1.wsdl
Las referencias de los mensajes de actuaciones de embargo devueltos pueden ser de dos
formas diferentes:
PNE + número de lote
(Número de lote del fichero de pagos al que pertenecen los pagos contra los que va la
actuación, si el ente informó número de lote en el envío)
PNE + nif pagador + AAAAMMDD + NNNN
(AAAAMMDD es la fecha de entrada del fichero de pagos al que pertenecen los pagos
contra los que va la actuación y NNNN es el ordinal diario de ese fichero, si el ente no
informó el número de lote en el envío)
2.- Recuperación del detalle de las actuaciones de embargo en bandeja de entrada
ListaDecV4
Punto Neutro
Ente
Lista mensajes
pendientes
Servicio web
Bandeja Entrada
¿Hay actuaciones
pendientes?
El sistema soporta ficheros de hasta un máximo de 100.000 pagos.
7
Para recuperar el detalle de cada una de las actuaciones de embargo se invoca el método
DetalleV4Ent indicando la clave de cada mensaje.
El detalle de cada actuación sigue el esquema definido en:
https://www2.agenciatributaria.gob.es/ADUA/internet/es/aeat/dit/adu/srem/pne/ActuacionS
alV1.xsd
Este esquema es un contenedor de documentos, donde hay que especificar para cada
documento el formato, si va en base64 o no y el contenido.
Las actuaciones de embargo del punto neutro tienen obligatoriamente como primer
documento un xml (campo formato = XML) firmado con XAdES por el embargante y codificado
en base 64. Dentro de este primer documento estarán los datos estructurados de la actuación,
que siguen el esquema:
https://www2.agenciatributaria.gob.es/ADUA/internet/es/aeat/dit/adu/srem/pne/ActuacionF
irmada.xsd
El pagador puede validar, si lo desea, la firma del embargante sobre los datos de la
actuación antes de aplicarla a la ejecución del pago.
DetalleV4Ent
Punto Neutro
Ente
Sigue esquema: ActuacionSalV1.xsd
Servicio web
Bandeja
entrada
¿Detalle Actuación?
Una vez que el pagador accede al detalle de la actuación, el Punto Neutro marca la
actuación como leída.
8
Entes embargantes Antes de entrar a describir la API disponible para los entes embargantes vamos a ver el
escenario típico de funcionamiento para un ente embargante.
Escenario de funcionamiento de un Ente embargante Paso 1: Envío de deudores al punto neutro de embargos
El ente embargante deberá mantener actualizada su información de deudores en el Punto
Neutro. Existen tres formas de hacerlo, enviando la lista completa de todos sus deudores o
enviando ficheros para incorporar deudores o para eliminar deudores.
Con la primera opción se sustituye por completo toda la información de deudores con el nuevo
fichero que se envíe y con las otras se actualiza la información que haya previamente en el
Punto Neutro, añadiendo nuevos o eliminando existentes.
La información enviada será vigente a partir de las 2:00 del día siguiente y tendrá una vigencia
de un mes.
El formato del fichero de deudores está especificado en los anexos.
Paso 2: Consulta de pagos susceptibles de embargos
Los entes embargantes deben consultar diariamente si algún pagador ha enviado pagos contra
alguno de sus deudores, ya que esos pagos serán susceptibles de embargo.
Paso 3: Generación de actuaciones de embargo y envío al punto neutro
En el caso de comprobar que hay algún pago susceptible de embargar, el ente embargante
puede realizar y enviar al Punto Neutro las actuaciones de embargo contra el pago que
considere oportunas, siempre antes de la fecha límite de envío de actuaciones de embargo.
Operaciones disponibles para entes embargantes
Envío de información de deudores
Un ente embargante debe enviar al Punto Neutro sus deudores. El sistema soporta tres
métodos de envío de información de deudores.
En todos los casos el servicio web responde con una respuesta síncrona indicando si el fichero
ha sido recibido correctamente o si ha habido algún error y el fichero ha sido rechazado.
SustituirFicheroDeudoresV1
Punto Neutro
Ente Servicio
web PNE
Deudores
Ok
9
Método: SustituirFicheroDeudoresV1 (servicio web del PNE)
Este método envía un fichero de deudores al punto neutro. El contenido del fichero sustituye a
toda la información de deudores que tenga el Punto Neutro de este ente. La nueva
información será vigente a partir de las 2:00 horas del día siguiente de la recepción del fichero
y tiene una duración de un mes.
Parámetros de entrada:
SustituirFicheroDeudoresV1
o NifEnte. Nif del embargante
o FormatoFichero. Formato del fichero que va en el parámetro
“contenidoFichero”. Actualmente solo soporta el valor “csv”.
o ContenidoFichero. El contenido del propio fichero en el formato especificado
(ver anexo de formato de ficheros).
Parámetros de salida:
SustituirFicheroDeudoresV1Out
En esta etiqueta se informa si el proceso ha ido bien o no. (Ver más detalle en la definición del
wsdl)
Además del método de sustituir el fichero de deudores al completo, existe la opción de
incorporar nuevos deudores al fichero actual o de eliminar deudores existentes.
Métodos: IncorporarDeudoresV1 y EliminarDeudoresV1
Estos métodos envían al punto neutro un fichero con deudores que se quieren incorporar o
eliminar. La nueva información será vigente a partir de las 2:00 horas del día siguiente de la
recepción del fichero y tiene una duración de un mes, sin que afecte a la vigencia de los
deudores que ya estuvieran en el sistema.
Los parámetros son análogos al método para enviar un fichero de sustitución.
Parámetros de entrada:
IncorporarDeudoresV1 o EliminarDeudoresV1 (en función de la operación deseada)
o NifEnte. Nif del embargante
o FormatoFichero. Formato del fichero que va en el parámetro
“contenidoFichero”. Actualmente solo soporta el valor “csv”.
o ContenidoFichero. El contenido del propio fichero en el formato especificado
(Ver anexo de formato de ficheros).
Parámetros de salida:
10
IncorporarDeudoresV1Out o EliminarDeudoresV1Out
En esta etiqueta se informa si el proceso ha ido bien o no. (Ver más detalle en la definición
del wsdl)
Consolidación de los deudores
Recuperación de pagos susceptibles de embargo
Cada vez que el punto neutro detecta que un pago enviado cruza contra un deudor de un ente
embargante, notifica este hecho al embargante mediante la bandeja de entrada de la AEAT. La
recuperación de notificaciones en bandeja se hace a través del servicio web de la bandeja de
entrada en dos pasos, primero se recupera la lista de mensajes sin leer y luego se recupera e l
detalle de un mensaje en particular.
Vamos a ver más en detalle la secuencia de operaciones que hay que realizar para recuperar
las actuaciones de embargo:
1.- Consulta en bandeja de entrada de los pagos susceptibles de embargo para un
embargante
Mediante la invocación del método ListaDecV4 del servicio web de la bandeja de entrada,
especificando el Nif del pagador como Nif del declarante:
En caso de detectarse un error en el fichero de deudores (un deudor con un formato
erróneo, etc.) el Punto Neutro rechaza el fichero al completo y devuelve el listado
de los deudores erróneos para que el embargante pueda subsanarlos y enviar de
nuevo el fichero.
Los ficheros de deudores enviados a lo largo del día se procesan entre las 00:00
horas y las 02:00 horas del día siguiente, comenzando a tener vigencia a partir de
las 02:00 y con una duración de un mes.
Esto implica que los entes embargantes deben enviar al menos una vez al mes la
información de todos sus deudores.
ListaDecV4
Punto Neutro
Ente
Lista mensajes
pendientes
Servicio web
Bandeja Entrada
¿Hay pagos
embargables ?
pendientes?
El sistema soporta ficheros de deudores de hasta un máximo de 1.500.000 de
deudores.
11
De la lista de mensajes pendientes obtenidos en la consulta anterior, hay que quedarse con los
que tengan el elemento tipoRespuesta igual a:
https://www2.agenciatributaria.gob.es/ADUA/internet/es/aeat/dit/adu/srem/pne/PagoSuscE
mbV1.wsdl
Las referencias de los mensajes de un pago susceptible de embargo son de la forma:
PNE + nif pagador + AAAAMMDD + NNNN
(AAAAMMDD es la fecha de entrada del fichero de pagos al que pertenecen los pagos
y NNNN es el ordinal diario de ese fichero)
2.- Recuperación del detalle de los pagos en bandeja de entrada
Para recuperar el detalle de cada uno de los pagos se invoca el método DetalleV4Ent indicando
la clave de cada mensaje.
El detalle de cada pago sigue el esquema definido en:
https://www2.agenciatributaria.gob.es/ADUA/internet/es/aeat/dit/adu/srem/pne/PagoSuscE
mbSalV1.xsd
En los datos de un pago susceptible de embargo viene la información del pagador que lo ha
enviado, la información del pago, los datos del cruce y la fecha límite para que el embargante
envíe actuaciones para embargar dicho pago:
PagoSuscEmbV1
Punto Neutro
Ente
Sigue esquema: PagoSuscEmbSalV1.xsd
Servicio web
Bandeja
entrada
¿Detalle Pago?
12
Envío de diligencias de embargo
Si un ente embargante embarga alguno de los pagos susceptibles de embargo que le han sido
notificados a través de la bandeja de entrada, debe enviar la diligencia de embargo al punto
neutro antes de la fecha límite de envío de actuaciones de embargo.
El ente embargante debe enviar las diligencias firmadas individualmente.
El punto neutro publicará dichas diligencias recibidas en la bandeja de entrada del pagador
que corresponda para que éste las pueda recuperar.
El método para que los embargantes envíen las diligencias es EnviarActuacionV1
Método: EnviarActuacionV1 (servicio web del PNE)
Este método permite a un ente embargante enviar una diligencia de embargo al punto neutro
de embargos. El punto neutro la pondrá a disposición del pagador a través de la bandeja de
entrada.
EnviarActuacionV1
Punto Neutro
Ente Servicio
web PNE
Diligencia firmada
Ok
13
Parámetros de entrada:
EnviarActuacionV1
o NifEnte. Nif del embargante
o Documentos. Información de la diligencia de embargo que se envía.
Parámetros de salida:
EnviarActuacionV1Out
o Codigo. 0 si la actuación es recibida correctamente, otro valor numérico en
caso de error.
o Descripcion. Descripción del error.
o CSV. Es una etiqueta opcional que sólo existe cuando la diligencia de embargo
se ha recibido correctamente en el punto neutro. En ese caso contiene un
código seguro de verificación que identifica el documento de constancia de
recepción de la actuación en el Punto Neutro y que puede ser consultado
desde la sede electrónica de la Agencia Tributaria.
Los datos de la diligencia de embargo van dentro de la etiqueta documentos, que se comporta
como un contenedor de documentos en el que hay que especificar para cada documento el
formato, si va en base64 o no y el contenido, según este esquema:
Actualmente las diligencias de embargo del punto neutro se deben informar añadiendo en
este “contenedor” un documento xml (campo formato = XML), firmado con XAdES por el
embargante y codificado en base 64. Dentro de este documento estarán los datos
estructurados de la actuación, que deben seguir el esquema:
https://www2.agenciatributaria.gob.es/ADUA/internet/es/aeat/dit/adu/srem/pne/ActuacionF
irmada.xsd
Los entes embargantes deben generar sus actuaciones de embargo según el
esquema ActuacionFirmada.xsd, deben firmarlas con XAdES, codificarlas en base
64. Deben enviarlas al Punto Neutro mediante el método EnviarActuacionV1 del
servicio web dentro del plazo de envío de actuaciones de embargo de los pagos que
estén embargando.
14
ANEXO I: Servicio web de recogida de información del punto
neutro de embargos: bandeja de entrada
La definición del servicio web es la siguiente:
https://www2.agenciatributaria.gob.es/ADUA/internet/es/aeat/dit/adu/adws/banent/ListaDe
cV4.wsdl
El funcionamiento de este sistema de recogida de información se basa en dos operaciones que
se hacen en dos pasos que atacan a dos endpoints diferentes:
1 Recuperar la lista de mensajes pendientes:
https://www1.agenciatributaria.gob.es/wlpl/inwinvoc/es.aeat.dit.adu.adws.banent.ListaDecV4SOAP (en Internet)
https://ws.ia.aeat.es/wlpl/iniinvoc/es.aeat.dit.adu.adws.banent.ListaDecV4SOAP (en Red SARA)
En este endpoint se hace la consulta de la lista de todos los mensajes sin leer del declarante. Es
el método ListaDecV4, que tiene los parámetros siguientes:
nifDeclarante
nombreDeclarante
El método devuelve una lista de mensajes informando para cada uno de ellos lo siguiente:
clave (es la clave única interna de la bandeja de entrada)
referencia
tipoRespuesta (que identifica al servicio web de consulta de detalle)
Es responsabilidad del cliente identificar el tipo de respuesta de cada mensaje pendiente para
procesarlo como corresponda.
2 Recuperar el detalle de un mensaje en particular
Cada tipoRespuesta de los mensajes respondidos mediante el método anterior define un
servicio web (wsdl) de consulta del detalle, aunque todos ellos usan el mismo endpoint de
acceso al detalle del mensaje:
https://www1.agenciatributaria.gob.es/wlpl/inwinvoc/es.aeat.dit.adu.adws.banent.DetalleV4SOAP (en Internet)
https://ws.ia.aeat.es/wlpl/iniinvoc/es.aeat.dit.adu.adws.banent.DetalleV4SOAP (en Red SARA)
En este documento se puede encontrar información más detallada sobre la bandeja
de entrada:
https://www2.agenciatributaria.gob.es/ADUA/es/aeat/dit/adu/adht/banent/Bandeja
Entrada.pdf
15
Para recuperar el detalle de un mensaje hay que invocar el método DetalleV4Ent, con los
parámetros:
clave (clave única del mensaje a recuperar)
El esquema de la respuesta es concreto de cada tipoRespuesta y está definido en su (wsdl).
Cuando un declarante accede al detalle de un mensaje, éste se marca como leído en la bandeja
de entrada y ya no volverá a ser devuelto en la lista de mensajes pendientes ( ListaDecV4).
ANEXO II: Configuración de los certificados para la conexión vía
web service La seguridad de las peticiones realizadas a los servicios web del punto neutro se realizan
mediante el protocolo de seguridad TLS, con certificado de cliente y de servidor (en lugar de
usar otras opciones como WS-Security).
Los tipos de certificados que pueden usar los clientes son:
Certificado de persona jurídica (acceso por internet)
Certificado de sello de AAPP (acceso por red SARA)
Certificado de componente (acceso por red SARA)
Puede darse la situación en que un ente vaya a automatizar el acceso a información de otros
entes. La forma de permitir esta actuación en nombre de otros es mediante el apoderamiento,
que se puede gestionar desde el menú de apoderamientos en el portal del punto neutro.
Se considerará válido cualquiera de los certificados de firma electrónica reconocidos por la Agencia Tributaria.
ANEXO III: Formato de los ficheros de pagos Actualmente, el sistema soporta el formato de fichero “.csv” que consiste en un fichero de
texto, donde cada línea representa un pago y cada atributo del pago va separado por un punto
y coma.
Formato genérico csv
Nif perceptor; Nombre perceptor; Referencia Pago; importe líquido (céntimos); Capítulo
presupuestario
Donde:
Nif perceptor debe ser no nulo y con un tamaño máximo de 9 caracteres
Nombre perceptor debe ser no nulo y con un tamaño máximo de 150 caracteres
Referencia de pago debe ser no nulo y con un tamaño máximo de 30 caracteres
Importe líquido de ser numérico, expresado en céntimos de euros y soporta un
número de dígitos máximo de 15 dígitos (145,90€ debe ir expresado como 14590)
16
Capítulo presupuestario deber un dígito de 1 a 9 si el pago es presupuestario o cero si
el pago no es presupuestario.
IBAN del perceptor es un dato opcional donde el pagador puede informar de la cuenta
bancaria del perceptor, en la cual el embargante debería reintegrar el importe
embargado si hubiera un levantamiento de embargo posterior o similar.
Ficheros con errores
En el caso de que se envíe un fichero de pagos con algún pago con formato erróneo, el punto
neutro rechaza el fichero al completo e informa de las líneas del fichero que han causado el
problema. En estos casos, el pagador debe subsanar dichas líneas y enviar de nuevo el fichero
al punto neutro.
ANEXO IV: Formato de los ficheros de deudores Actualmente, el sistema soporta el formato de fichero “.csv” generado por la aplicación Excel
que consiste en un fichero de texto, donde cada línea representa un pago y cada atributo del
pago va separado por un punto y coma.
Formato genérico csv
Nif perceptor; Nombre perceptor
Donde:
Nif perceptor debe ser no nulo y con un tamaño máximo de 9 caracteres
Nombre perceptor debe ser no nulo y con un tamaño máximo de 150 caracteres
Ficheros con errores
Por ejemplo, si hay un pago de 1200,99€ para Fulanito Pérez, con referencia de pago
“factura1 enero2015” para la compra de algún tipo de bien (Capítulo 2), el pago
debería ir de la forma:
12345678A;Fulanito Perez;factura1 enero2015;120099;2
Y si se quiere informar una cuenta bancaria:
12345678A;Fulanito Perez;factura1 enero2015;120099;2;ES0099990100998801010101
Por ejemplo, si un embargante tiene como deudor a Fulanito Pérez, y quiere enviar
un fichero de deudores con dicho deudor, éste debe ir con la forma:
12345678A;Fulanito Perez
17
En el caso de que se envíe un fichero de deudores con algún deudor con formato erróneo, e l
punto neutro rechaza el fichero al completo e informa de las líneas del fichero que han
causado el problema. En estos casos, el embargante debe subsanar dichas líneas y enviar de
nuevo el fichero al punto neutro.
ANEXO V: Formato de las diligencias de embargo El servicio web del punto neutro permite enviar las dil igencias individualmente en formato xml y deben
ir firmadas. El esquema del xml de las dil igencias es el siguiente: https://www2.agenciatributaria.gob.es/ADUA/internet/es/aeat/dit/adu/srem/pne/ActuacionFirmada.xsd
Dentro de este esquema se definen los campos donde deberá ir la información estructurada de una
dil igencia de embargo y el esquema permite la inclusión de una firma xml dentro del fichero.
Una vez construido un xml que siga este esquema, el ente embargante debe firmarlo, codificarlo en
Base 64 y enviarlo a través del servicio web.
El formato admitido para la firma de las actuaciones de embargo es XAdES en sus versiones 1.2.2 o 1.3.2
con los siguientes parámetros de firma:
Parámetro Valor format XAdES Enveloped
nodeToSign PuntoNeutroEmb policyIdentifier http://administracionelectronica.gob.es/es/ctt/politicafirma/politica_firma_AGE_v1_8.pdf
policyIdentifierHash VYICYpNOjso9g1mBiXDVxNORpKk=
policyIdentifierHashAlgorithm SHA1 referencesDigestMethod http://www.w3.org/2000/09/xmldsig#sha1
18
Ejemplos:
Actuación firmada (antes de firmar) de la AEAT contra un pago del TESORO PUBLICO
<ActuacionFirmada:PuntoN eutroEmb xmlns:ActuacionFirmada="https ://www2.agenciatributaria.gob.es/ADUA/i nternet/es/aeat/dit/adu/srem/pne/ActuacionFirmada.xsd" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Id="PuntoNeutroEmb"> <ActuacionFirmada:ActuacionFirmada encoding="text/xml">
<ActuacionFirmada:DatosEmbargante> <ActuacionFirmada:NIFEmbargante>Q2826000H</ActuacionFirmada:NIFEmbargante> <ActuacionFirmada:RazonSoci alEmbargante>AGENCIA ESTATAL DE LA ADMINISTRACION TRIBUTARIA</ActuacionFirmada:RazonSocialEmbargante> </ActuacionFirmada:DatosEmbargante>
<ActuacionFirmada:DatosPagador> <ActuacionFirmada:NIFPagador>S2826011E</ActuacionFirmada:NIFPagador> <ActuacionFirmada:RazonSocialPagador>SEC GRAL DEL TESORO Y POLITICA FINANCIER</ActuacionFirmada:RazonSoci alPagador> <ActuacionFirmada:FechaFichero>20170605</Ac tuacionFirmada:FechaFichero>
</ActuacionFirmada:DatosPagador> <ActuacionFirmada:DatosPerceptor> <ActuacionFirmada:NIFPerceptor> </ActuacionFirmada:NIFPerceptor> <ActuacionFirmada:RazonSocialPerceptor> </ActuacionFirmada:RazonSocialPerceptor>
</ActuacionFirmada:DatosPerceptor> <ActuacionFirmada:PagosActuacion NumPagos="1"> <ActuacionFirmada:DatosPago> <ActuacionFirmada:RefPago> </ActuacionFirmada:RefPago>
<ActuacionFirmada:ImporteLiquido>100000</Ac tuaci onFirmada:ImporteLiquido> </ActuacionFirmada:DatosPago> </ActuacionFirmada:PagosActuacion> <ActuacionFirmada:DatosActuacion>
<ActuacionFirmada:NumExpediente> </ActuacionFirmada:NumExpediente> <ActuacionFirmada:NIFDeudor> </ActuacionFirmada:NIFDeudor> <ActuacionFirmada:FechaActuacion> </ActuacionFirmada:FechaActuacion> <ActuacionFirmada:HoraActuacion> </ActuacionFirmada:HoraActuacion> <ActuacionFirmada:ImporteSolicitado> </ActuacionFirmada:ImporteSolicitado>
<ActuacionFirmada:IBAN> </ActuacionFirmada:IBAN> <ActuacionFirmada:ConceptoTransferenci a> </ActuacionFirmada:ConceptoTransfer encia> <ActuacionFirmada:DocumentoIngreso> </ActuacionFirmada:DocumentoIngreso> </ActuacionFirmada:DatosAc tuaci on>
</ActuacionFirmada:ActuacionFirmada> </ActuacionFirmada:PuntoNeutr oEmb>
Ejemplo actuación firmada con XAdES (después de la firma).
Se destacan en verde las etiquetas representativas de la firma. Las principales características son:
La firma es enveloped (está incluida dentro del xml con etiqueta raíz PuntoNeutroEmb)
Se firma todo el contenido, es decir, se firma la etiqueta raíz PuntoNeutroEmb.
Se incluye la información del timestamp de firmado y de la política de firma seguida en el
proceso de firma .
<ActuacionFirmada:PuntoN eutroEmb xmlns:ActuacionFirmada="https ://www2.agenciatributaria.gob. es/ADUA/i nternet/es/aeat/dit/adu/srem/pne/ActuacionFirmada.xsd" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance” Id="PuntoNeutroEmb"> <ActuacionFirmada:ActuacionFirmada encoding="text/xml">
<ActuacionFirmada:DatosEmbargante> <ActuacionFirmada:NIFEmbargante>Q2826000H</ActuacionFirmada:NIFEmbargante> <ActuacionFirmada:RazonSoci alEmbargante>AGENCIA ESTATAL DE LA ADMINISTRACION TRIBUTARIA</ActuacionFirmada:RazonSocialEmbargante> </ActuacionFirmada:DatosEmbargante>
<ActuacionFirmada:DatosPagador> <ActuacionFirmada:NIFPagador>S2826011E</ActuacionFirmada:NIFPagador> <ActuacionFirmada:RazonSocialPagador>SEC GRAL DEL TESORO Y POLITICA FINANCIER</ActuacionFirmada:RazonSoci alPagador> <ActuacionFirmada:FechaFichero>20170605</Ac tuacionFirmada:FechaFichero>
</ActuacionFirmada:DatosPagador> <ActuacionFirmada:DatosPerceptor> <ActuacionFirmada:NIFPerceptor> </ActuacionFirmada:NIFPerceptor> <ActuacionFirmada:RazonSocialPerceptor> </ActuacionFirmada:RazonSocialPerceptor>
</ActuacionFirmada:DatosPerceptor> <ActuacionFirmada:PagosActuacion NumPagos="1"> <ActuacionFirmada:DatosPago> <ActuacionFirmada:RefPago> </ActuacionFirmada:RefPago>
<ActuacionFirmada:ImporteLiquido>100000</Ac tuaci onFirmada:ImporteLiquido> </ActuacionFirmada:DatosPago> </ActuacionFirmada:PagosActuacion> <ActuacionFirmada:DatosActuacion>
<ActuacionFirmada:NumExpediente> </ActuacionFirmada:NumExpediente>
19
<ActuacionFirmada:NIFDeudor> </ActuacionFirmada:NIFDeudor>
<ActuacionFirmada:FechaActuacion> </ActuacionFirmada:FechaActuacion> <ActuacionFirmada:HoraActuacion> </ActuacionFirmada:HoraActuacion> <ActuacionFirmada:ImporteSolicitado> </ActuacionFirmada:ImporteSolicitado> <ActuacionFirmada:IBAN> </ActuacionFirmada:IBAN> <ActuacionFirmada:ConceptoTransferenci a> </ActuacionFirmada:ConceptoTransfer encia>
<ActuacionFirmada:DocumentoIngreso> </ActuacionFirmada:DocumentoIngreso> </ActuacionFirmada:DatosAc tuaci on> </ActuacionFirmada:ActuacionFirmada>
<Signature xmlns="http://www.w3.org/2000/09/xmldsig#" Id="Firma"> <SignedInfo> <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/> <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/>
<Reference URI="#PuntoNeutroEmb"> … </SignedInfo> <Object>
<etsi:QualifyingProperties xmlns:etsi="http://uri.etsi.org/01903/v1.2.2#" Target="#Firma"> <etsi:SignedProperties Id="SignedProperties"> <etsi:SignedSignatureProperties> <etsi:SigningTime>2017-06-05T16:01:14+02:00</etsi:SigningTime>
<etsi:SigningCertificate> … </etsi:SigningCertificate> <etsi:SignaturePolicyIdentifier> <etsi:SignaturePolicyId>
<etsi:SigPolicyId> <etsi:Identifier>http://admi nistracionelectronica.gob.es /es/ct t/politicafirma/politica_fir ma_AGE_v1_8.pdf</etsi:Identifier> </etsi:SigPolicyId> <etsi:SigPolicyHash>
<ds:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/> <ds:DigestValue>VYICYpNOjso9g1mBiXDVxNOR pKk=</ds:DigestValue> </etsi:SigPolicyHash> </etsi:SignaturePolicyId>
</etsi:SignaturePolicyIdentifi er> </etsi:SignedSignatureProperties> </etsi:SignedProperties> </etsi:QualifyingProperties>
</Object> </Signature> </ActuacionFirmada:PuntoNeutr oEmb>
20
ANEXO VI: Entorno de PREPRODUCCION para realizar las pruebas
de integración La definición de los wsdl de preproducción es la misma que para el entorno de producción:
https://www2.agenciatributaria.gob.es/ADUA/internet/es/aeat/dit/adu/srem/pne/PuntoNeut
roEmbV1.wsdl
https://www2.agenciatributaria.gob.es/ADUA/internet/es/aeat/dit/adu/adws/banent/ListaDe
cV4.wsdl
Los endpoints de pruebas varían en función de si se está entrando por internet o por Red
SARA.
Los endpoints de Pruebas del servicio web del punto neutro son:
https://www1.agenciatributaria.gob.es/wlpl/inwinvoc/es.aeat.dit.adu.srem.pne.ws.PuntoNeutroEmbP1SOAP (en Intenet)
https://ws.iax.aeat.es/wlpl/iniinvoc/es.aeat.dit.adu.srem.pne.ws.PuntoNeutroEmbV1SOAP (en Red SARA)
Los endpoints de Pruebas de la bandeja de entrada son:
https://www1.agenciatributaria.gob.es/wlpl/inwinvoc/es.aeat.dit.adu.adws.banent.ListaDecP4SOAP (en Intenet)
https://www1.agenciatributaria.gob.es/wlpl/inwinvoc/es.aeat.dit.adu.adws.banent.DetalleP4SOAP (en Intenet)
https://ws.iax.aeat.es/wlpl/iniinvoc/es.aeat.dit.adu.adws.banent.ListaDecV4SOAP (en Red SARA)
https://ws.iax.aeat.es/wlpl/iniinvoc/es.aeat.dit.adu.adws.banent.DetalleV4SOAP (en Red SARA)
Certificado electrónico para las pruebas Los certificados válidos para que un ente pueda hacer las pruebas contra el servicio web del
punto neutro son los mismos que en producción.
Excepcionalmente para las pruebas que se hagan por Internet y solicitándolo en la dirección de
correo del punto neutro ([email protected]) se puede dar permiso a Certificados de
persona física (Por ejemplo, para realizar peticiones SOAP desde un PC con algún cliente
genérico de servicios web).
En la solicitud se debe especificar el ente de pruebas y el NIF del certificado de persona f ísica
que va a usar en dichas pruebas.
Configuración previa a las pruebas Para que un ente pueda realizar pruebas en el entorno de pruebas es necesario que
previamente el ente se haya adherido al punto neutro de embargos. Eso se debe realizar desde
la opción de ‘Solicitud de adhesión’ del portal en producción del punto neutro, según se
explica en el manual de adhesión.
21
A partir del día siguiente al momento en que la solicitud sea aceptada (Se notifica mediante un
correo a la dirección usada en el proceso de adhesión) el ente podrá realizar las pruebas a
través de los endpoint de preproducción del servicio web.
Pruebas de un ente pagador Una vez que un ente se ha adherido al punto neutro con la funcionalidad de pagador puede
hacer uso de un entorno de pruebas desasistido, de forma que el ente podrá probar la
funcionalidad en cualquier momento de la misma forma que lo haría en producción.
La operativa que puede hacer un ente pagador y que debe probar es enviar ficheros de pagos
al punto neutro y consultar si ha recibido diligencias de embargo de dichos pagos.
Las operaciones que debe realizar para las pruebas son:
El ente debe enviar por el servicio web del punto neutro un fichero de pagos y ver la
respuesta online de los cruces positivos.
En el entorno de pruebas, el sistema simulará siempre un cruce positivo para el
primer pago que esté incluido en el fichero. De esta forma, el pagador siempre recibirá
una respuesta con cruces positivos.
Unos minutos después, el sistema simula el envío de una diligencia de embargo
ficticia contra el pago que ha dado resultado positivo.
22
El ente debe consultar y recuperar dicha diligencia a través del servicio web de la
bandeja de entrada. Si el ente ha configurado algún contacto suscrito a los avisos por
correo, además recibirá un correo con el aviso de la recepción de dicha diligencia.
Ejemplo de envío de un fichero de pagos
Envío de un fichero con tres pagos, dos de los cuales cruzan de forma positiva
Contenido de la petición (EnviarPagosV1):
<soapenv:Envel ope xmlns:soapenv="http:/ /schemas.xmlsoap.org/soap/envelope/"
xmlns:pun="https://www2.agenciatributaria.gob.es /ADUA/internet/es/aeat/dit/adu/srem/pne/PuntoN eutroEmbV1.wsdl"> <soapenv:Header/> <soapenv:Body> <pun:EnviarPagosV1> <pun:NIFEnte>A45454545</pun:NIFEnte>
<pun:FormatoFichero>csv</pun:For matoFichero> <pun:ContenidoFichero> 01010101Y;Juan español español;pago03-1;30000;7 01010101Y;Juan español español;pago03-2;30000;7 02020202Y;Pepe español español;pago03-3;30000;7
</pun:ContenidoFichero> </pun:EnviarPagosV1> </soapenv:Body> </soapenv:Envelope>
Contenido de la respuesta (EnviarPagosV1Out):
<soapenv:Envel ope xmlns:soapenv="http:/ /schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XM LSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <soapenv:Header/> <soapenv:Body> <pne:EnviarPagosV1Out xmlns:pne="https://www2.agenciatributaria.gob.es /ADUA/internet/es /aeat/dit/adu/srem/pne/Pu ntoNeutroEmbV1.wsdl"> <pne:DatosPagador>
<pne:NIFPagador> A45454545</pne:NIFPagador> <pne:RazonSocialPagador> </pne:RazonSocialPagador> <pne:FechaFichero></pne:FechaFichero> <pne:OrdinalFichero></pne:OrdinalFichero> </pne:DatosPagador>
<pne:RespuestaOK> <pne:NumTotalPagos>1</pne:NumTotalPagos> <pne:ImpLiqTotal>500</pne:ImpLiqTotal> <pne:FechaCruce>20170628</pne:FechaCruce> <pne:HoraCruce>085404</pne:H oraCruce>
<pne:FechaLimiteActuaciones>20170703</pne:FechaLimiteActuaciones> <pne:HoraLimiteActuaciones>235959</pne:HoraLimiteActuaciones> <pne:PagosCrucePositivo NumPagos="1"> <pne:IdPago>pago03-1</pne:IdPago> </pne:PagosCrucePositivo> </pne:RespuestaOK>
</pne:EnviarPagosV1Out> </soapenv:Body> </soapenv:Envelope>
Ejemplo de recuperar la lista de diligencias de embargo recibidas
Consulta de actuaciones de embargo pendientes en bandeja sin leer
Contenido de la petición (ListaDecV4Ent):
<soapenv:Envel ope xmlns:soapenv="http:/ /schemas.xmlsoap.org/soap/envelope/" xmlns:lis="https://www2.agenciatributaria.gob.es/ADUA/i nternet/es/aeat/dit/adu/adws/banent/List aDecV4Ent.xsd"> <soapenv:Header/> <soapenv:Body> <lis:ListaDecV4Ent>
<lis:declarante> <lis:NifDeclarante> A45454545</lis:NifDeclarante> <lis:NombreDeclarante>ENTE FICTICIO PAGADOR</lis:NombreDeclarante> </lis:declarante> </lis:ListaDecV4Ent>
</soapenv:Body> </soapenv:Envelope>
Contenido de la respuesta sin mensajes pendientes (ListaDecV4Sal):
<soapenv:Envel ope xmlns:soapenv="http:/ /schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XM LSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <soapenv:Header/>
<soapenv:Body>
23
<ListaDecV4Sal xmlns="https://www2.agenciatributaria.gob.es /ADUA/internet/es /aeat/dit/adu/adws/banent/ListaDecV4Sal.xsd"/>
</soapenv:Body> </soapenv:Envelope>
Contenido de la respuesta con 2 mensajes pendientes del tipo ActuacionV1 (ListaDecV4Sal):
<?xml version="1.0" encoding="UTF-8"?><soapenv:Envel ope xmlns:soapenv="http:/ /schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XM LSchema-instance"><soapenv:Header></soapenv:H eader> <soapenv:Body>
<ListaDecV4Sal xmlns="https://www2.agenci atributaria.gob.es/ADUA/internet/es/aeat/dit /adu/adws/banent/ListaDecV4Sal.xsd"> <declaracion> <clave>20170502150330275323</clave> <referencia>PNE00575201700544</refer encia> <tipoRespuesta>https://www2.agenciatributar ia.gob.es/ADUA/internet/es/aeat/dit/adu/srem/pne/ActuacionV1.wsdl</tipoRespuesta>
</declaracion> <declaracion> <clave>20170502160630327651</clave> <referencia>PNE00575201700544</refer encia> <tipoRespuesta>https://www2.agenciatributar ia.gob.es/ADUA/internet/es/aeat/dit/adu/srem/pne/ActuacionV1.wsdl</tipoRespuesta>
</declaracion> </ListaDecV4Sal> </soapenv:Body></soapenv:Envelope>
Ejemplo de recuperar el detalle de una diligencia recibida
Consulta del detalle de una actuación pendiente de leer por clave
Contenido de la petición (DetalleV4Ent):
<?xml version="1.0" encoding="UTF-8"?><soapenv:Envel ope xmlns:soapenv="http:/ /schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XM LSchema-instance"> <soapenv:Body> <DetalleV4Ent xmlns="https://www2.agenciatributaria.gob.es/ADUA/i nternet/es/aeat/dit/adu/adws/banent/DetalleV4Ent.xsd"> <clave>20170502150330275323</clave>
</DetalleV4Ent> </soapenv:Body> </soapenv:Envelope>
Contenido de la respuesta con el detalle de un mensaje de tipo ActuacionV1.xsd (DetalleV4EntSal): <?xml version="1.0" encoding="UTF-8"?> <soapenv:Envel ope xmlns:soapenv="http:/ /schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XM LSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <soapenv:Body>
<ActuacionSalV1:PuntoNeutroEmb xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ActuacionSalV1="https://www2.agenciatributaria.gob.es/ADUA/i nternet/es/aeat/dit/adu/srem/pne/ActuacionSal V1.xsd" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xsi:schemaLocation="https://www2.agenciatributaria.gob.es /ADUA/internet/es /aeat/dit/adu/srem/pne/ActuacionSalV1.xsd https://www2.agenciatributaria.gob.es /ADUA/internet/es/aeat/dit/adu/srem/pne/ActuacionSalV1.xsd">
<ActuacionSalV1:ActuacionSalV1> <ActuacionSalV1:Documentos NumDocs="1"> <ActuacionSalV1:DatosDocumento> <ActuacionSalV1:Formato>XML</Ac tuacionSalV1:For mato> <ActuacionSalV1:Base64> 1</ActuacionSal V1:Base64>
<ActuacionSalV1:Contenido>PD94bWwgdmVyc2lvbj0iMS4wIiBl bmN vZGluZz0iVVRGLTgiPz48QWN0 dW50b05ldXRyb0VtYi B4bWxuczpBY3R1YWNpb25GaXJtYWRhPSJodHRwczovL3d3dzIuYWdlbmNp YXRyaWJ1dGFyaWEuZ29iLmVzL0FEVUEvaW50ZXJuZXQvZXM vYWVhdC9kaXQvYWR1L3N yZW0vcG5l L0FjdHVhY2lvbkZpcm1hZGEueHNkIiB4bWxuczpkcz0iaHR0cDovL3d3dy53M y5vcmcvMjAwMC8w OS94bWxkc2lnIyIgeG1sbnM6eHNpPSJodHR wOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYS1p
Z1BvbGljeUhhc2g+PC9ldHNpOlNpZ25hdHVyZVBvbGljeUlkPjwvZXRzaTpTaWduYXR 1cmVQb2xp Y3lJZGVudGlmaWVyPj wvZXRzaTpTaWduZWRTaWduYXR1cmVQcm9wZXJ0aWVzPjwvZXRzaTpTaWdu ZWRQcm9wZXJ0aWVzPjwvZXRzaTpRdWFsaWZ5aW5nUHJvcGVydGllcz48L09iamVjdD48L1NpZ25h dHVyZT48L0FjdHVhY2lvbkZpcm1hZGE6UHVudG9OZXV0cm9FbWI+</ActuacionSalV1:Contenido> </ActuacionSalV1:DatosDocumento>
</ActuacionSalV1:Documentos> </ActuacionSalV1:ActuacionSalV1> </ActuacionSalV1:PuntoNeutroEmb> </soapenv:Body> </soapenv:Envelope>
En el anexo de firma de actuaciones de embargo se puede ver un ejemplo de un fichero xml
que sigue el esquema ActuacionFirmada.xsd
En este mensaje recuperado, se puede ver que el contenido está en Base64. Al decodificarlo
se obtiene, a su vez, otro xml firmado por el ente embargante, con los datos estructurados de
la actuación y que sigue el formato ActuacionFirmada.xsd
24
Pruebas de un ente embargante
Una vez que un ente se ha adherido al punto neutro con la funcionalidad de embargante
puede hacer uso de un entorno de pruebas desasistido, de forma que el ente podrá probar la
funcionalidad en cualquier momento de la misma forma que lo haría en producción.
La operativa que puede hacer un ente embargante y que debe probar es enviar ficheros de
deudores al punto neutro, consultar si hay pagos susceptibles de embargo y enviar diligencias
de embargo contra esos pagos.
Las operaciones que debe realizar para las pruebas son:
El ente embargante debe enviar un fichero de deudores mediante el servicio web del
punto neutro. Puede optar por alguna de las tres opciones, incorporar, sustituir o
eliminar deudores.
A diferencia del entorno de producción en el que los ficheros de deudores se cargan a
las 2:00 del día siguiente, en pruebas cada fichero enviado se procesa unos minutos
después de haber sido enviado.
En las operaciones de incorporar deudores, el sistema simula el envío de un pago
ficticio para el primer nif incluido en el fichero de deudores, de tal forma que ese
pago ficticio va a ser susceptible de ser embargado por el ente embargante (además se
le avisará por correo al embargante si está suscritos a los avisos)
El ente embargante debe consultar si hay pagos susceptibles de embargo mediante el
servicio web de la bandeja de entrada. Si el ente ha realizado previamente un envío de
un fichero de deudores, esta consulta le devolverá al menos el pago ficticio generado
por el sistema.
El ente embargante debe enviar una diligencia de embargo contra ese pago ficticio a
través del servicio web del punto neutro.
Ejemplo de envío de un fichero de deudores para incorporar deudores
Envío de un fichero para incorporar dos deudores
Contenido de la petición (IncorporarDeudoresV1):
<soapenv:Envel ope xmlns:soapenv="http:/ /schemas.xmlsoap.org/soap/envelope/" xmlns:pun="https://www2.agenciatributaria.gob.es /ADUA/internet/es/aeat/dit/adu/srem/pne/PuntoN eutroEmbV1.wsdl"> <soapenv:Header/> <soapenv:Body>
<pun:IncorporarDeudoresV1> <pun:NIFEnte> A45454545</pun:NIFEnte> <pun:FormatoFichero>csv</pun:For matoFichero> <pun:ContenidoFichero> 12345678A;Fulanito Perez
87654321A;Menganito Lopez </pun:ContenidoFichero> </pun:IncorporarDeudoresV1> </soapenv:Body> </soapenv:Envelope>
Contenido de la respuesta:
<soapenv:Envel ope xmlns:soapenv="http:/ /schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XM LSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <soapenv:Header/> <soapenv:Body> <pne:IncorporarDeudoresV1Out xmlns:pne="https://www2.agenciatributaria.gob.es/ADUA/internet/es/aeat/dit/adu/sr em/pne/PuntoNeutroEmbV1.wsdl"> <pne:DatosEmbargante>
<pne:NIFEmbargante>A45454545</pne:NIFEmbargante> <pne:RazonSocialEmbargante>ENTE FICTICIO</pne:RazonSocialEmbargante> <pne:FechaFichero>20170713</pne:FechaFicher o> <pne:OrdinalFichero>1</pne:OrdinalFicher o> </pne:DatosEmbargante>
25
<pne:RespuestaOK>
<pne:NumTotalDeudores>2</pne:NumTotalDeudores> </pne:RespuestaOK> </pne:IncorporarDeudoresV1Out> </soapenv:Body> </soapenv:Envelope>
Ejemplo de consulta para saber si hay pagos susceptibles de embargo
Contenido de la petición (ListaDecV4Ent):
<soapenv:Envel ope xmlns:soapenv="http:/ /schemas.xmlsoap.org/soap/envelope/" xmlns:lis="https://www2.agenciatributaria.gob.es/ADUA/i nternet/es/aeat/dit/adu/adws/banent/ListaDecV4Ent.xsd">
<soapenv:Header/> <soapenv:Body> <lis:ListaDecV4Ent> <lis:declarante> <lis:NifDeclarante> A45454545</lis:NifDeclarante>
<lis:NombreDeclarante>ENTE FICTICIO </lis:NombreDeclarante> </lis:declarante> </lis:ListaDecV4Ent> </soapenv:Body> </soapenv:Envelope>
Contenido de la respuesta con 2 mensajes pendientes del tipo (ListaDecV4Sal):
<?xml version="1.0" encoding="UTF-8"?><soapenv:Envel ope xmlns:soapenv="http:/ /schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XM LSchema-instance"><soapenv:Header></soapenv:H eader> <soapenv:Body> <ListaDecV4Sal xmlns="https://www2.agenci atributaria.gob.es/ADUA/internet/es/aeat/dit /adu/adws/banent/ListaDecV4Sal.xsd"> <declaracion>
<clave>20170502150330275323</clave> <referencia>PNE00575201700544</refer encia> <tipoRespuesta>https://www2.agenciatributar ia.gob.es/ADUA/internet/es/aeat/dit/adu/srem/pne/PagoSuscEmbV1.wsdl</tipoRespuesta> </declaracion> <declaracion>
<clave>20170502160630327651</clave> <referencia>PNE00575201700544</refer encia> <tipoRespuesta>https://www2.agenciatributar ia.gob.es/ADUA/internet/es/aeat/dit/adu/srem/pne/PagoSuscEmbV1.wsdl</tipoRespuesta> </declaracion> </ListaDecV4Sal>
</soapenv:Body></soapenv:Envelope>
Ejemplo de recuperar el detalle de un pago susceptible de embargo
Consulta del detalle de una actuación pendiente de leer por clave
Contenido de la petición (DetalleV4Ent):
<?xml version="1.0" encoding="UTF-8"?><soapenv:Envel ope xmlns:soapenv="http:/ /schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XM LSchema-instance"> <soapenv:Body> <DetalleV4Ent xmlns="https://www2.agenciatributaria.gob.es/ADUA/i nternet/es/aeat/dit/adu/adws/banent/DetalleV4Ent.xsd"> <clave>20170502150330275323</clave> </DetalleV4Ent>
</soapenv:Body> </soapenv:Envelope>
Contenido de la respuesta con el detalle de un mensaje de tipo PagoSuscEmbV1.xsd (DetalleV4EntSal): <?xml version="1.0" encoding="UTF-8"?> <PagoSuscEmbSalV1:PuntoNeutroEmb xmlns:PagoSuscEmbSalV1="https ://www2.agenciatributaria.gob.es /ADUA/internet/es /aeat/dit/adu/srem/pne/PagoSuscEmbSalV1.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://www2.agenciatributaria.gob.es /ADUA/internet/es /aeat/dit/adu/srem/pne/PagoSuscEmbSalV1.xsd ">
<PagoSuscEmbSalV1:PagoSuscEmbSalV1> <PagoSuscEmbSalV1:DatosPagador> <PagoSuscEmbSalV1:NIFPagador>44444444</PagoSuscEmbSalV1:NIFPagador> <PagoSuscEmbSalV1:RazonSocialPagador>PAGADOR</PagoSuscEmbSalV1:RazonSoci alPagador> <PagoSuscEmbSalV1:FechaFichero>20170711</PagoSuscEmbSalV1:FechaFichero>
<PagoSuscEmbSalV1:OrdinalFichero>6</PagoSuscEmbSal V1:Or dinalFichero> </PagoSuscEmbSalV1:DatosPagador> <PagoSuscEmbSalV1:DatosPago> <PagoSuscEmbSalV1:NIFPerceptor>12345678E</PagoSuscEmbSalV1:NIFPerceptor> <PagoSuscEmbSalV1:RazonSocialPerceptor>FULANITO</PagoSuscEmbSalV1:RazonSoci alPerceptor>
<PagoSuscEmbSalV1:RefPago>00163QQQQQ0008276</PagoSuscEmbSalV1:RefPago> <PagoSuscEmbSalV1:ImporteDispOLiq>7000</PagoSuscEmbSalV1:ImporteDispOLiq> </PagoSuscEmbSalV1:DatosPago>
26
<PagoSuscEmbSalV1:FechaCruce>20170711</PagoSuscEmbSalV1:FechaCruce>
<PagoSuscEmbSalV1:HoraCruce>133848</PagoSuscEmbSalV1:HoraCruce> <PagoSuscEmbSalV1:FechaLimiteActuaciones> 20170712</PagoSuscEmbSalV1:FechaLimiteActuaciones> <PagoSuscEmbSalV1:HoraLimiteActuaci ones>235959</PagoSuscEmbSalV1:H oraLi miteAc tuaci ones> </PagoSuscEmbSalV1:PagoSuscEmbSalV1> </PagoSuscEmbSalV1:PuntoNeutroEmb>
Ejemplo de envío de una actuación de embargo contra un pago <soapenv:Envel ope xmlns:soapenv="http:/ /schemas.xmlsoap.org/soap/envelope/" xmlns:pun="https://www2.agenciatributaria.gob.es /ADUA/internet/es/aeat/dit/adu/srem/pne/PuntoN eutroEmbV1.wsdl"> <soapenv:Header/> <soapenv:Body> <pun:EnviarActuacionV1>
<pun:NIFEnte>?</pun:NIFEnte> <pun:Documentos NumDocs="?"> <!--1 or more repetitions:--> <pun:DatosDocumento> <pun:Formato>XML</pun:For mato>
<pun:Base64>1</pun:Base64> <pun:Contenido> PD94bWwgdmVyc2l vbj 0iMS4wIiBlbmN vZGluZz0iVVRGLTgiPz48QWN 0 dW50b05ldXRyb0VtYi B4bWxuczpBY3R1YWNpb25GaXJtYWRhPSJodHRwczovL3d3dzIuYWdlbmNp YXRyaWJ1dGFyaWEuZ29iLmVzL0FEVUEvaW50ZXJuZXQvZXM vYWVhdC9kaXQvYWR1L3N yZW0vcG5l L0FjdHVhY2lvbkZpcm1hZGEueHNkIiB4bWxuczpkcz0iaHR0cDovL3d3dy53M y5vcmcvMjAwMC8w
OS94bWxkc2lnIyIgeG1sbnM6eHNpPSJodHR wOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYS1p Z1BvbGljeUhhc2g+PC9ldHNpOlNpZ25hdHVyZVBvbGljeUlkPjwvZXRzaTpTaWduYXR 1cmVQb2xp Y3lJZGVudGlmaWVyPj wvZXRzaTpTaWduZWRTaWduYXR1cmVQcm9wZXJ0aWVzPjwvZXRzaTpTaWdu ZWRQcm9wZXJ0aWVzPjwvZXRzaTpRdWFsaWZ5aW5nUHJvcGVydGllcz48L09iamVjdD48L1NpZ25h dHVyZT48L0FjdHVhY2lvbkZpcm1hZGE6UHVudG9OZXV0cm9FbWI+</pun:Contenido>
</pun:DatosDocumento> </pun:Documentos> </pun:EnviarActuacionV1> </soapenv:Body> </soapenv:Envelope>
El documento en base64 debe ser una actuación firmada que siga el esquema
ActuacionFirmada.xsd. En el anexo de firma de actuaciones de embargo se puede ver un
ejemplo de un fichero xml que sigue el esquema ActuacionFirmada.xsd como se detal la en e l
Anexo V.
