/
4.- Servicios de SRT

4.- Servicios de SRT

INDICE


1.- Registro Electrónico General (servicios SOAP)


1.1.- Servicio EntryService

En los siguientes apartados se especifican tanto los tipos de datos utilizados, como los métodos que la componen, detallando los parámetros y mostrando ejemplos de uso.

1.1.1- Método 'listEntry'

Devuelve el listado con los datos de los asientos registrales que se corresponden a los criterios de búsqueda especificados.

 Más detalles...

1.1.1.1- Signatura

ResultListEntries listEntry(String idApplication, ParamListEntries param) throws RemoteException, SRTException

1.1.1.2.- Parámetros de invocación

NombreTipoLongitud máximaDescripciónObligatorio
infoInfo-Filtro de búsqueda en función de la información básica del asiento. Son obligatorios los campos organism, requestType y register.
consolidatedValueInt-Filtro para seleccionar los asientos consolidados (en Registro Físico), los no consolidados ó indistinto
INDISTINTO = 0
NO CONSOLIDADOS = 1
CONSOLIDADOS = 2
No
senderActor-Interesado que envía el asientoNo
senderAgentActor-Aportador (Agente emisor)No
receiverActor-Destinatario al que va dirigido el asientoNo
receiverAgentActor-Representante del destinatario al que va dirigido el asientoNo
dateStartDate-Fecha (y hora) de presentación a partir de la cual se desea listar los asientosNo
dateEndDate-Fecha (y hora) de presentación hasta la que se desea listar los asientosNo
specificDataData[]-Datos específicos asociadosNo
sortColumnString-Ordenación por el nombre de la columna
ascendingBoolean-

Ordenación de las columnas

ASCENDENTE = true

DESCENDENTE = false

fromIndexInt-Valor desde el cual se busca
toIndexInt-Valor de búsqueda

El emisor (Sender), representante del emisor (SenderAgent), receptor/es (Receivers) y representante del receptor(ReceiverAgent) pueden ser de tipo Person, Organism, Company y UndefinedActor

Solamente se debería utilizar UndefinedActor para el Sender.

Person extends ActorTipoLongitud máximaDescripciónObligatorio
NifString255 caracteres
NameString255 caracteresNombreNo
Surname1String255 caracteresPrimer apellidoNo
Surname2String255 caracteresSegundo apellidoNo
MailString255 caracteresCorreoNo
AddressString255 caracteresDirecciónNo


Organism extends ActorTipoLongitud máximaDescripciónObligatorio
CodeString255 caracteresCódigo del organismo
NameString255 caracteresDescripción del organismo


Company extends ActorTipoLongitud máximaDescripciónObligatorio
CifString255 caracteresCif
NameString255 caracteresNombre
UndefinedActor extends ActorTipoLongitud máximaDescripciónObligatorio
NOTA: En métodos en los que se cree un asiento registral, solamente se debería utilizar este tipo UndefinedActor para el Sender. Por ejemplo, en un caso en el que el interesado es menor, el Sender (el menor) sería de tipo UndefinedActor y el representante del menor  (SenderAgent) que presenta el documento sería de tipo Person.
codeString255 caracteresCódigo
nameString255 caracteresNombre

1.1.1.3.- Parámetros de respuesta

NombreTipoDescripción
entriesEntry[]Listado de asientos que cumplen los filtros de búsqueda establecidos.

1.1.1.4.- Validaciones

NombreDescripción
InternalCoreExceptionSe agrupan todos aquellos errores internos de funcionamiento del SRT.

1.1.1.5.- Códigos error

TipoDescripción
SRTExceptionError en la operación.
RemoteExceptionError remoto.

1.1.1.6.- Ejemplo de invocación

Ejemplo de invocación
ParamListEntries paramListEntries = new ParamListEntries();
ResultListEntries entries = new ResultListEntries();
Info info = new Info();
// Código de organismo, es un atributo que el integrador deberá pedir
al responsable funcional que le ha solicitado la aplicación
info.setOrganism("ORGXXXXX");
//Código de Libro de registro
info.setRegister("REG_XXX");
// Código de procedimiento, es un atributo que el integrador deberá
pedir al responsable funcional que le ha solicitado la aplicación
info.setProcessType("xxx");
//Tipo de Entry (Entrada(0), Salida(1))
info.setRequestType(SRTClientConstants.REQUEST_TYPE_INPUT);
//Fecha de creación del Entry
Calendar requestTime = Calendar.getInstance();
info.setRequestTime(requestTime);
paramListEntries.setInfo(info);
entries = entryClient.listEntry(paramListEntries);

1.1.2.- Método 'getEntryDetails'

Obtiene los datos sobre un asiento registral, a partir del identificador de su libro de registro y del número de asiento registral.

 Más detalles...

1.1.2.1.- Signatura

ResultGetEntryDetails getEntryDetails(String idApplication, ParamGetEntryDetails param) throws RemoteException, SRTException

1.1.2.2.- Parámetros de invocación

NombreTipoLongitud máximaDescripciónObligatorio
registerIdString-Identificador del libro de registro en el que se va a realizar la consolidación de los asientos.
requestTypeInt-Tipo de asiento
ENTRADA = 0
SALIDA = 1
entryIdString-Nº de registro del asiento asociado al sistema telemático
consolidatedIdString-Nº de registro del asiento asociado al sistema físico con el que se consolidaNo
invokingIdString-Identificador (NIF) de la persona que origina la petición desde la aplicación invocante. Si se trata de una aplicación web será la persona autenticada en el mismo.No

1.1.2.3.- Parámetros de respuesta

NombreTipoDescripción
entryEntryInformación general del asiento y datos específicos en 'specificdata'
requestStringContenido del documento de solicitud de alta de asiento (fichero PDF, XML, etc.) codificado en Base64
receiptStringContenido del documento de justificante de asiento (fichero PDF, XML, etc.) codificado en Base64 y firmado electrónicamente por el sistema telemático
attachmentsAttachmentInfo[]Datos generales de los documentos adjuntos

1.1.2.4.- Validaciones

NombreDescripción
idApplicationSe valida que existe una aplicación dada de alta con ese código.

1.1.2.5.- Códigos error

TipoDescripción
SRTExceptionError en la operación.
RemoteExceptionError remoto.

1.1.2.6.- Ejemplo de invocación

Ejemplo de invocación
ParamGetEntryDetails paramGetEntryDetails = new
ParamGetEntryDetails();
ResultGetEntryDetails resultGetEntryDetails = new
ResultGetEntryDetails();
//Identificador de Libro de Registro
paramGetEntryDetails.setRegisterId("REG_XXX");
//Código del Asiento Registral
paramGetEntryDetails.setEntryId("PREF_XXXXXXXXXX/SUF");
//Tipo de Entry (Entrada(0), Salida(1))
paramGetEntryDetails.setRequestType(SRTClientConstants.REQUEST_TYPE_INPUT);
//paramGetEntryDetails.setInvokginId(null);
paramGetEntryDetails.setInvokginId("NIF"));
resultGetEntryDetails = entryClient.getEntryDetails(paramGetEntryDetails);

1.1.3.- Método 'getEntryAttachmentByFileRef'

 Más detalles...

1.1.3.1.- Signatura

String getEntryAttachmentByFileRef(String idApplication,ParamGetEntryAttachment param) throws RemoteException, SRTException

1.1.3.2.- Parámetros de invocación

NombreTipoLongitud máximaDescripciónObligatorio
registerIdString-Identificador del libro de registro en el que se va a realizar la consolidación de los asientos.
requestTypeint-Tipo de la solicitud
Entrada = 0
Salida = 1
entryIdString-Identificador del tramite
idAttachmentString-Identificador del documento adjunto
invokingIdString-Identificador (NIF) de la persona que origina la petición desde la aplicación invocante. Si se trata de una aplicación web será la persona autenticada en el mismo.No

1.1.3.3.- Parámetros de respuesta

NombreTipoDescripción
idRefStringIdentificador (“id”) del contenido del fichero dentro de la petición SOAP de invocación

1.1.3.4.- Validaciones

NombreDescripción
idApplicationSe valida que existe una aplicación dada de alta con ese código.

1.1.3.5.- Códigos error

TipoDescripción
SRTExceptionError en la operación.
RemoteExceptionError remoto.

1.1.3.6.- Ejemplo de invocación

Ejemplo de invocación
ParamGetEntryAttachment paramGetEntryAttachment = new
ParamGetEntryAttachment();
//Identificador de Libro de Registro
paramGetEntryAttachment.setRegisterId("REG_XXX");
//Código del Asiento Registral
paramGetEntryAttachment.setEntryId("PREF_XXXXXXXXX/SUF");
//Identificador del adjunto
paramGetEntryAttachment.setIdAttachment("idAttachment");
//Tipo de Entry (Entrada(0), Salida(1))
paramGetEntryAttachment.setRequestType(SRTClientConstants.REQUEST_TYPE_INPUT);
paramGetEntryAttachment.setInvokingId(null);
InputStream inputStream = entryClient.getEntryAttachmentByFileRef(paramGetEntryAttachment);

1.1.4.- Método 'getEntrySpecificData'

Información general del asiento y datos específicos en 'specificdata'

 Más detalles...

1.1.4.1.- Signatura

ResultGetEntrySpecificData getEntrySpecificData(String idApplication, ParamGetEntryDetails param)throws RemoteException, SRTException

1.1.4.2.- Parámetros de invocación

NombreTipoLongitud máximaDescripciónObligatorio
registerIdString-Identificador del libro de registro en el que se va a realizar la consolidaci&