amap-terceros

Última modificación por Administrator el 2019/11/04 12:20

AMAPTerceros-1.3.0 2017/09/22

Se han añadido los siguientes métodos para la inserción y modificación de datos contacto:
 - Insertar Dato Contacto
 - Modificar Dato Contacto

AMAPTerceros-1.2.1 2017/06/08

Corrección del interface

AMAPTerceros-1.2.0 2017/05/30

Se han añadido los siguientes métodos para la inserción y modificación de los distintos domicilios:
 - Insertar Domicilio Nacional Normalizado
 - Modificar Domicilio Nacional Normalizado
 - Insertar Domicilio No Normalizado
 - Modificar Domicilio No Normalizado
 - Insertar Domicilio Extranjero
 - Modificar Domicilio Extranjero

AMAPTerceros-1.1.2 2015/07/27

Cambios menores y corrección de bugs.

AMAPTerceros-1.0.0 2013/12/11

 Primera versión del componente

<dependency>
<groupId>es.gobcantabria.amap.integracion</groupId>
<artifactId>amap-terceros</artifactId>
<version>1.3.0</version>
</dependency>

Es necesario de disponer de los siguientes datos:

  • Usuario del Proxy de Servicios
  • URL del servicio de amap-terceros

Sin recursos disponibles.

Configuración

Configuración de la factoría de servicios

Para la utilización del componente amap-terceros basta con añadir el jar y sus correspondientes dependencias al classpath de la aplicación y crear un servicio del siguiente modo:

La configuración del componente se realiza a la hora de obtener la instancia del servicio. El cliente se conectará sobre los webservices SOAP de amap terceros. Los parámetros soportados son:

  • Host o urlHost: dirección ip o alias del servidor donde se aloja el servidor de AMAP terceros o URL donde está desplegado el servicio (instancia de java.net.URL).
  • UsuarioProxy: usuario del proxy de servicios necesario para conectarse a a través del proxyws.

La forma convencional de generar un cliente sería:

TercerosWSInterface miservicio = TercerosCliente.getService(host,usuarioProxy);

O bien 

TercerosWSInterface miservicio = TercerosCliente.getService(urlHost,usuarioProxy);

El servicio concreto a usar se definirá a partir de un fichero de properties junto con el resto de los parámetros:

KeyDescripciónEjemplo
sistemas.global.amap.terceros.urlEndpoint del servicio web de terceros.http://******/amap-terceros-servidor/services/TercerosWS?wsdl

Los valores de las propieades aquí mostrados son meramente ilustrativos. En los entornos de desarrollo / preproducción y producción los valores de las variables han de ser externalizados tal y como se especifica en el documento Definición de acceso a propiedades de sistema

Ejemplo de contenido del fichero de propiedades:

sistemas.global.amap.terceros.url=http://*****/proxyws/services/TercerosWSImplPort

Tercero

Representa a un tercero

App_X_Tercero

Aplicaciones subscritas a un tercero

Tercero_Fisico

Representa a un tercero físico

Tercero_Juridico

Representa a un tercero jurídico

Tipo_Documento

Tipos de Documentos

Tipo_DatoContacto

Tipos de Datos Contacto

Dato_Contacto

Datos de Contacto de un tercero

Domicilio

Datos de un domicilio

Domicilio_Nacional

Datos de un domicilio nacional y normalizado

Domicilio_No_Normalizado

Datos de un domicilio no normalizado

Domicilio_Extranjero

Datos de un domicilio en el extranjero

Nombreamap-terceros
Identificadoramap-terceros
Grupoes.gobcantabria.amap.integracion
Versión1.3.0
Licencia
DesarrolladorDGDIT
Descripción

Gestión de Terceros

Documentaciónamap-terceros (JavaDoc)
Binarioamap-terceros (Jar)

Sin particularidades. Seguir las recomendaciones del fabricante.

Ejemplos de uso

Una vez creado el servicio, tal y como se indica en el apartado de configuración, se pueden acceder a los métodos disponibles.

Catálogo de operaciones

El componente soporta las siguientes operaciones

Obtener los datos de un Tercero por Identificador

 

Se realiza mediante el método "getTerceroByID". Los parámetros necesarios para su invocación son:

{id}: Identificador del tercero. Es obligatorio.

{id_aplicacion}: Aplicación. Campo opcional. Si viene relleno, la aplicación tendrá que estar subscrita al tercero para que se muestren datos.

{activo}: Campo opcional, por defecto a "true". Si el valor es "true", sólo mostrará los datos del tercero si éste está activo. Si el valor es "false", mostrará los datos del tercero independientemente de su estado.

  Long id=new Long(39763);
  Boolean activo=true;
  String idAplicacion="";
  Result resultado=miservicio.getTerceroByID(id, idAplicacion,activo);

Obtener los datos de un Tercero por Documento

 

Se realiza mediante el método "getTerceroByDocumento". Los parámetros necesarios para su invocación son:

{documento}: Documento del tercero(NIF, CIF...). Es obligatorio.

{id_aplicacion}: Aplicación. Campo opcional. Si viene relleno, la aplicación tendrá que estar subscrita al tercero para que se muestren datos.

{activo}: Campo opcional, por defecto a "true". Si el valor es "true", sólo mostrará los datos del tercero si éste está activo. Si el valor es "false", mostrará los datos del tercero independientemente de su estado.

  String doc="XXXXXXXXX";
  String idAplicacion="XXXXXXXXX";
  Boolean activo=true;
  Result resultado= miservicio.getTerceroByDocumento(doc, idAplicacion,activo);

Insertar Tercero Físico

 

Se realiza mediante el método "insertTerceroFisico". Los parámetros necesarios para su invocación son:

{tercero_fisico}: Modelo de datos a cumplimentar para dar de alta los campos necesarios en las tablas de terceros y tercero_fisico.

{id_aplicacion}: Aplicación. Campo obligatorio. Si la aplicación no está vinculada al tercero, se subscribirá.

Si el tercero ya existía en la bbdd, se le modificarán los datos. Si su estado era "no activo", se activará.

  String idAplicacion="XXXXXXXXXXX";
  TerceroFisicodto tj=new TerceroFisicodto();

  tj.setDocumento("XXXXXXXXH");
  tj.setTipoDocumentoId(new Long(1));
  tj.setNombre("XXXX XXXXXX");
  tj.setApellido1("XXXXXXXXXXXXXX");
  tj.setPais(new Long(108));
  tj.setSexoId(2);

  Result resultado= miservicio.insertTerceroFisico(tj, idAplicacion);

Insertar Tercero Jurídico

 

Se realiza mediante el método "insertTerceroJuridico". Los parámetros necesarios para su invocación son:

{tercero_juridico}: Modelo de datos a cumplimentar para dar de alta los campos necesarios en las tablas de terceros y tercero_juridico.

{id_aplicacion}: Aplicación. Campo obligatorio. Si la aplicación no está vinculada al tercero, se subscribirá.

Si el tercero ya existía en la bbdd, se le modificarán los datos. Si su estado era "no activo", se activará.

  String idAplicacion="XXXXXXXXX";
  TerceroJuridicodto tj=new TerceroJuridicodto();

  tj.setDocumento("XXXXXXXXX");
  tj.setTipoDocumentoId(new Long(2));
  tj.setFormaJuridicaId(new Long(2));
  tj.setRazonSocial("Prueba Terceros Jurídicos Patrimonios");
  tj.setPais(new Long(108));

  Result resultado= miservicio.insertTerceroJuridico(tj, idAplicacion);

Modificar Tercero Físico

 

Se realiza mediante el método "upadteTerceroFisico". Los parámetros necesarios para su invocación son:

{tercero_fisico}: Modelo de datos a cumplimentar para modificar los campos en las tablas de terceros y tercero_fisico.

{id_aplicacion}: Aplicación. Campo obligatorio. Si la aplicación no está vinculada al tercero, se subscribirá.

Si el tercero ya existía en la bbdd, se le modificarán los datos. No se modificará su estado.

  String idAplicacion="XXXXXXXXXXXX";

  TerceroFisicodto tj=new TerceroFisicodto();
  tj.setDocumento("XXXXXXXXXXXXX");
  tj.setTerceroId(new Long(18046));
  tj.setTipoDocumentoId(new Long(1));
  tj.setNombre("XXXX");
  tj.setApellido1("XXXXXXXXXX");
  tj.setPais(new Long(108));
  tj.setSexoId(2);

  Result resultado = miservicio.updateTerceroFisico(tj, idAplicacion);

Modificar Tercero Jurídico

 

Se realiza mediante el método "upadteTerceroJuridico". Los parámetros necesarios para su invocación son:

{tercero_juridico}: Modelo de datos a cumplimentar para modificar los campos en las tablas de terceros y tercero_juridico.

{id_aplicacion}: Aplicación. Campo obligatorio. Si la aplicación no está vinculada al tercero, se subscribirá.

Si el tercero ya existía en la bbdd, se le modificarán los datos. No se modificará su estado.

  String idAplicacion="XXXXXXXXX";
  TerceroJuridicodto tj=new TerceroJuridicodto();
  tj.setTerceroId(new Long(1));
  tj.setDocumento("XXXXXXXX");
  tj.setCapitalSocial(new Double(20000));
  tj.setFormaJuridicaId(new Long(2));
  tj.setNombreComercial("Nombre Terceros Jurídicos Patrimonios");
  tj.setCnae2009Id(new Long(2));
  tj.setTipoDocumentoId(new Long(2));
  tj.setRazonSocial("Prueba Terceros Jurídicos Patrimonio");
  tj.setPais(new Long(108));
  
  Result resultado =miservicio.updateTerceroJuridico(tj, idAplicacion);

Obtener los tipos de Documentos

 

Se realiza mediante el método "getTipoDocumentos". No necesita parámetros. Devuele los distintos tipos de documentos que se recogen en la bbdd.

Obtener los tipos de Dato Contacto

 

Se realiza mediante el método "getTiposDatoContacto". No necesita parámetros. Devuele los distintos tipos de datos de contacto que se recogen en la bbdd.

Obtener los Datos de Contacto de un tercero

 

Se realiza mediante el método "getDatosContactoTercero". Los parámetros necesarios para su invocación son:

{id}: Identificador del tercero. Es obligatorio.

{id_aplicacion}: Aplicación. Campo opcional. Si viene relleno, la aplicación tendrá que estar subscrita al tercero para que se muestren datos.

{activo}: Campo opcional, por defecto a "true". Si el valor es "true", sólo mostrará los datos del tercero si éste está activo. Si el valor es "false", mostrará los datos del tercero independientemente de su estado.

  Long id = new Long(12345);
  String idAplicacion = "aplicacion";
  Boolean activo=false;
  ResultDatoContacto resultado = miservicio.getDatosContactoTercero(id, idAplicacion, activo);

Obtener los domicilios nacionales y normalizados de un tercero

 

Se realiza mediante el método "getDomiciliosNacNormTercero". Los parámetros necesarios para su invocación son:

{id}: Identificador del tercero. Es obligatorio.

{id_aplicacion}: Aplicación. Campo opcional. Si viene relleno, la aplicación tendrá que estar subscrita al tercero para que se muestren datos.

{activo}: Campo opcional, por defecto a "true". Si el valor es "true", sólo mostrará los datos del tercero si éste está activo. Si el valor es "false", mostrará los datos del tercero independientemente de su estado.

  Long id=new Long(12345);
  Boolean activo=true;
  String idAplicacion="";
  ResultDomicilio resultado = miservicio.getDomiciliosNacNormTercero(id, idAplicacion,activo);

Obtener los domicilios nacionales no normalizados de un tercero

 

Se realiza mediante el método "getDomiciliosNacNoNormTercero". Los parámetros necesarios para su invocación son:

{id}: Identificador del tercero. Es obligatorio.

{id_aplicacion}: Aplicación. Campo opcional. Si viene relleno, la aplicación tendrá que estar subscrita al tercero para que se muestren datos.

{activo}: Campo opcional, por defecto a "true". Si el valor es "true", sólo mostrará los datos del tercero si éste está activo. Si el valor es "false", mostrará los datos del tercero independientemente de su estado.

  Long id=new Long(1848);
  String idAplicacion="aplicacion";
  Boolean activo=true;
  ResultDomicilio resultado = miservicio.getDomiciliosNacNoNormTercero(id, idAplicacion,activo);

Obtener los domicilios en el extranjero de un tercero

 

Se realiza mediante el método "getDomiciliosExtranjeroTercero". Los parámetros necesarios para su invocación son:

{id}: Identificador del tercero. Es obligatorio.

{id_aplicacion}: Aplicación. Campo opcional. Si viene relleno, la aplicación tendrá que estar subscrita al tercero para que se muestren datos.

{activo}: Campo opcional, por defecto a "true". Si el valor es "true", sólo mostrará los datos del tercero si éste está activo. Si el valor es "false", mostrará los datos del tercero independientemente de su estado.

  Long id=new Long(1848);
  String idAplicacion="aplicacion";
  Boolean activo=true;
  ResultDomicilio resultado = miservicio.getDomiciliosExtranjeroTercero(id, idAplicacion,activo);

Insertar Domicilio

 

Se realiza mediante el método "insertDomicilio". Los parámetros necesarios para su invocación son:

{domicilio}: Campo obligatorio. Modelo de datos a cumplimentar para dar de alta los campos necesarios en las tablas de domicilio, y según el tipo de domicilio que queramos insertar: domicilio_nacional, domicilio_extranjero o domicilio_no_normalizado.

{idAplicacion}: Aplicación. Campo opcional. Si la aplicación no está vinculada al domicilio, se subscribirá. Puede haber varias aplicaciones para un domicilio.

Si el domicilio ya existía en la bbdd, se le modificarán los datos. Si su estado era "no activo", se activará.


  /* Ejemplo de inserción de domicilio nacional */
  String idAplicacion="aplicacion";
  Domicilio domicilio = new Domicilio();   
  DomicilioNacional domicilioNacional = new DomicilioNacional();   
  
  domicilio.setTerceroId(XXXX);
  domicilioNacional.setTipoViaId("X");
  domicilioNacional.setCodigoPostal("XXXXX");
  domicilioNacional.setApartadoPostal("XXXXXXX"); 
 
  domicilio.setDomicilioNacional(domicilioNacional);
  
  resultado=getTercerosCliente().insertDomicilio(domicilio, idAplicacion);


  /* Ejemplo de inserción de domicilio no nomalizado */
  String idAplicacion="aplicacion";
  Domicilio domicilio = new Domicilio();
  DomicilioNoNormalizado domicilioNoNormalizado  = new DomicilioNoNormalizado();
  
  domicilio.setTerceroId(XXXX); 
  domicilioNoNormalizado.setDomicilioS("XXXXXXXXXXXXXXX");

  domicilio.setDomicilioNonormalizado(domicilioNoNormalizado);
  
  resultado=getTercerosCliente().insertDomicilio(domicilio, idAplicacion);


  /* Ejemplo de inserción de domicilio extranjero */
  String idAplicacion="aplicacion";
  Domicilio domicilio = new Domicilio();
  DomicilioExtranjero domicilioExtranjero  = new DomicilioExtranjero();
  
  domicilio.setTerceroId(XXXX); 
  domicilioExtranjero.setPaisId(XXXX);
  domicilioExtranjero.setVia("XX" );
  domicilioExtranjero.setCodigoPostal("XXXXX" );
  domicilioExtranjero.setLocalidad( "XXXXXXXXXXX" );
  
  domicilio.setDomicilioExtranjero(domicilioExtranjero);

  resultado=getTercerosCliente().insertDomicilio(domicilio, idAplicacion);

Modificar Domicilio

 

Se realiza mediante el método "updateDomicilio". Los parámetros necesarios para su invocación son:

{domicilioNacional}: Campo obligatorio. Modelo de datos a cumplimentar para modificar los campos necesarios en las tablas de domicilio y según el tipo de domicilio que queramos insertar: domicilio_nacional, domicilio_extranjero o domicilio_no_normalizado. 

{idAplicacion}: Aplicación. Campo opcional. Si la aplicación no está vinculada al domicilio, se subscribirá. Puede haber varias aplicaciones para un domicilio.

Si el domicilio ya existía en la bbdd, se le modificarán los datos. Si no se indica valor a un campo se borrará el valor actual de dicho campo.

  /* Ejemplo de modificación de domicilio nacional */
  String idAplicacion="aplicacion";
  Domicilio domicilio = new Domicilio();   
  DomicilioNacional domicilioNacional = new DomicilioNacional();   
  
  domicilio.setId(XXXX);
  domicilio.setTerceroId(XXXX);
  domicilioNacional.setTipoViaId("X");
  domicilioNacional.setCodigoPostal("XXXXX");
  domicilioNacional.setApartadoPostal("XXXXXXX"); 
 
  domicilio.setDomicilioNacional(domicilioNacional);
  
  resultado=getTercerosCliente().updateDomicilio(domicilio, idAplicacion);


  /* Ejemplo de modificación de domicilio no nomalizado */
  String idAplicacion="aplicacion";
  Domicilio domicilio = new Domicilio();
  DomicilioNoNormalizado domicilioNoNormalizado  = new DomicilioNoNormalizado();
  
  domicilio.setId(XXXX);
  domicilio.setTerceroId(XXXX); 
  domicilioNoNormalizado.setDomicilioS("XXXXXXXXXXXXXXX");

  domicilio.setDomicilioNonormalizado(domicilioNoNormalizado);
  
  resultado=getTercerosCliente().updateDomicilio(domicilio, idAplicacion);


  /* Ejemplo de modificación de domicilio extranjero */
  String idAplicacion="aplicacion";
  Domicilio domicilio = new Domicilio();
  DomicilioExtranjero domicilioExtranjero  = new DomicilioExtranjero();
  
  domicilio.setId(XXXX);
  domicilio.setTerceroId(XXXX); 
  domicilioExtranjero.setPaisId(XXXX);
  domicilioExtranjero.setVia("XX" );
  domicilioExtranjero.setCodigoPostal("XXXXX" );
  domicilioExtranjero.setLocalidad( "XXXXXXXXXXX" );
  
  domicilio.setDomicilioExtranjero(domicilioExtranjero);

  resultado=getTercerosCliente().updateDomicilio(domicilio, idAplicacion);

Insertar Dato Contacto

 

Se realiza mediante el método "insertDatoContacto". Los parámetros necesarios para su invocación son:

{datoContacto}: Campo obligatorio. Modelo de datos a cumplimentar para dar de alta los campos necesarios en la tabla dato_contacto.

{idAplicacion}: Aplicación. Campo obligatorio. Si la aplicación no está vinculada al dato, se subscribirá. Puede haber varias aplicaciones para un dato.

Si el dato ya existía en la bbdd, se le modificarán los datos. Si su estado era "no activo", se activará.

  String idAplicacion="aplicacion";
  DatoContacto datoContacto = new DatoContacto();
  TipoDatoContacto tipoDatoContacto = new TipoDatoContacto();
  
  tipoDatoContacto.setId(X);
 
  datoContacto.setTerceroId(XXXXX);
  datoContacto.setValor("XXXXXXXXXXX");
  datoContacto.setTipoDatoContacto(tipoDatoContacto);
  
  resultado=getTercerosCliente().insertDatoContacto(datoContacto, idAplicacion);

Modificar Dato Contacto

 

Se realiza mediante el método "updateDatoContacto". Los parámetros necesarios para su invocación son:

{datoContacto}: Campo obligatorio. Modelo de datos a cumplimentar para modificar los campos necesarios en la tabla dato_contacto.

{idAplicacion}: Aplicación. Campo opcional. Si la aplicación no está vinculada al dato, se subscribirá. Puede haber varias aplicaciones para un dato.

Si el dato ya existía en la bbdd, se le modificarán los campos. Si no se indica valor a un campo se borrará el valor actual de dicho campo.

  String idAplicacion="aplicacion";
  DatoContacto datoContacto = new DatoContacto();
  TipoDatoContacto tipoDatoContacto = new TipoDatoContacto();
  
  tipoDatoContacto.setId(X);
 
  datoContacto.setId(XX);
  datoContacto.setTerceroId(XXXXX);
  datoContacto.setValor("XXXXXXXXXXX");
  datoContacto.setTipoDatoContacto(tipoDatoContacto);
  
  resultado=getTercerosCliente().updateDatoContacto(datoContacto, idAplicacion);
© 2014 GOBIERNO DE CANTABRIA - AVISO LEGAL Y PROTECCIÓN DE DATOS