Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


...


A continuación se describen todos los servicios REST de TTO, junto con los parámetros de invocación, resultado y ejemplo de integración de cada servicio.

...

Atributo

Tipo

Descripción

progreso

Integer

Porcentaje de completado del trámite.

requestInformation

RequestInformation

Contiene la información específica de una solicitud.

applicant

Applicant

Datos del usuario que solicita el trámite. Este usuario puede ser persona física o jurídica.

documents

Array de Document

Listado de documentos que el usuario debe aportar al trámite.

otherDocuments

Array de Document

Listado de documentos que el usuario aporta voluntariamente.

authorizations

Autorizacion

Listado de autorizaciones del trámite.

form1Array

de CategoryList<Map<String, Object>>

Formulario del trámite. Cada elemento de la lista se corresponde con una sección del procedimiento al que pertenece la solicitud. Está compuesto por un único atributo, que lleva como nombre el título de dicha sección y como valor los campos de la sección.

beneficiary

Beneficiary

Datos del beneficiario del trámite. Este campo solo aparece cuando el usuario que solicita el trámite (applicant) ejerce como representante.

agentsAgentsDatos de los agentes que actúan sobre el trámite.
notificationNotificationBloque con los de contacto que se utilizarán a efectos de notificación.
queryParamsMapa String-String

Parámetros de la URL con los que el usuario ha accedido al trámite.

Pueden especificarse desde las aplicaciones integradoras si estas desean asociar atributos personalizados a los trámites.

Info
titleNota

Si se accede especificando un parámetro con nombre numExpediente, se reflejará el valor indicado en el título durante su tramitación con el siguiente formato:

[Nombre del trámite] del expediente [valor de numExpediente]

Por ejemplo, con nombre del trámite "Subsanaciones" y valor de numExpediente "2123":

Subsanaciones del expediente 2123


...

AtributoTipoDescripcion

registerId

StringIdentificador del registro. Aparecerá sólo en el caso de que el trámite se haya enviado a registro.
csvRegisterReceiptStringCSV del justificante de registro. Aparecerá sólo en el caso de que el trámite se haya enviado a registro.
registerDateLongFecha en la que se ha realizado el registro del trámite. Aparecerá sólo en el caso de que el trámite se haya enviado a registro (representación en tiempo UNIX).
bentId1LongIdentificador del envío a BENT. 
legalEntityCertBooleanIndica cuando el trámite se realiza con un certificado de persona jurídica.


Note

1 Se puede dar el caso en el que se haya completado el trámite pero no se haya especificado el identificador de BENT. Las causas pueden ser las siguientes:

Caída de BENT.

Reinicio de BENT en el servidor.

Un error ajeno a las aplicaciones como, por ejemplo, un problema en la conexión en la red.

Para solucionar este contratiempo y recuperar dicho identificador, TTO tiene programada una llamada diaria al servicio de BENT en horario nocturno. Una vez obtenido el identificador de BENT, estará disponible como valor de este mismo atributo.

...

Ejemplos JSONEjemplos XML


Expand
titleMostrar


Code Block
languagejs
themeDJango
{
  "number": 11889,
  "csvRequest": "CSVBA83A3O46R1X01TTO",
  "signature": 1862,
  "requestSignature": 1996,
  "entity": 0,
  "denomination": "Solicitud General",
  "receiverOrgCode": "ORG11214",
  "registerOrgCode": "ORG11197",
  "requestCode": "11889GRZWV8V5",
  "requestCodeAssociated": "20303R2LMD0S69V",
  "creationDate": 1571666310573,
  "sendEventSGA": false,
  "eventSGA": "",
  "version": 4,
  "onlineOnly": false,
  "updateDate": null,
  "origin": "SOLICITUD",
  "registerInfo: {
	  "registerId": "RT_000005695/2019",
	  "csvRegisterReceipt": "CSVTA77QJP15D1P00SRT",
	  "registerDate": 1571666477478,
	  "bentId": 515,
      "legalEntityCert": true
  }
}




Expand
titleMostrar


Code Block
languagexml
themeDJango
<requestInformation>
  <number>11797</number>
  <csvRequest>CSVD17WTR616U1D01TTO</csvRequest>
  <signature>2005</signature>
  <requestSignature>1996</requestSignature>
  <entity>0</entity>
  <denomination>procedimiento prueba</denomination>
  <receiverOrgCode>ORG11214</receiverOrgCode>
  <registerOrgCode>ORG11197</registerOrgCode>
  <requestCode>00000000TOXPURE</requestCode>
  <requestCodeAssociated>20303R2LMD0S69V</requestCodeAssociated>
  <creationDate>2019-10-15T14:10:40.463+02:00</creationDate>
  <sendEventSGA>false</sendEventSGA>
  <version>2</version>
  <onlineOnly>false</onlineOnly>
  <origin>SOLICITUD</origin>
  <registerInfo>
    <registerId>RT_000005611/2019</registerId>
    <csvRegisterReceipt>CSVFI2DH6B36S1500SRT</csvRegisterReceipt>
    <registerDate>2019-10-15T16:11:28.595+02:00</registerDate>
	<legalEntityCert>true</legalEntityCert>
  </registerInfo>
</requestInformation>



...

Atributo

Tipo

Descripción

representativeIdentifier

String

Campo de identificación la entidad física, que actúa en nombre de la entidad jurídica.

representativeName

String

Nombre de la persona física, que actúa en nombre de una entidad jurídica.

representativeSurname

String

Primer apellido de la persona física, que actúa en nombre de la entidad jurídica.

representativeSurname2StringSegundo apellido de la persona física, que actúa en nombre de la entidad jurídica.

tipoRepresentacionrepresentation

Integer

Indica el tipo de representación. Los posibles valores son:

Tutor legal

Documento específico representación

Documento público REA

...

Ejemplos JSONEjemplos XML


Expand
titleMostrar


Code Block
languagejs
themeDJango
{
  "nif": "Q0100000I",
  "name": "FUFASA",
  "surname": "",
  "surname2": "",
  "notificationMail": "correo@ejemplo.com",
  "notificationPhone": "974000000",
  "address": "C/Ejemplo nº1",
  "postalCode": 0,
  "city": "Zaragoza",
  "province": "Zaragoza",
  "country": "España",
  "documentType": "NIF",
  "naturalPerson": true,
  "representativeIdentifier": "10000322Z",
  "representativeName": "MANUELA",
  "representativeSurname": "BLANCO",
  "representativeSurname2": "VIDAL",
  "tipoRepresentacionrepresentation": 0
}




Expand
titleMostrar


Code Block
languagexml
themeDJango
<applicant>
  <nif>Q0100000I</nif>
  <name>FUFASA</name>
  <surname/>
  <surname2/>
  <notificationMail>asdf@ho.es</notificationMail>
  <postalCode>0</postalCode>
  <representativeIdentifier>10000322Z</representativeIdentifier>
  <representativeName>MANUELA</representativeName>
  <representativeSurname>BLANCO</representativeSurname>
  <representativeSurname2>VIDAL</representativeSurname2>
  <representation>0</representation>
</applicant>




3.1.5 - Document

...

Atributo

Tipo

Descripción

id

String

Identificador calculado del documento.

name

String

Nombre del fichero subido. Aparecerá sólo en el caso del que el documento se haya aportado.

document

String

CSV del documento. Aparecerá sólo en el caso de que el documento se haya aportado y no sea un documento múltiple.

documentListInteger

Array de Document

Lista de ficheros aportados por el ciudadano (en caso de ser un documento múltiple).

description


Status
titleOBSOLETO
 Descripción del documento.

sign


Status
titleOBSOLETO
 Indica si el documento esta firmado.

isAuthorized


Indica si el usuario ha dado permiso para la consulta del documento.

...