amap-pagos

Última modificación por Administrator el 2019/06/07 13:06

amap-pagos-1.7.3 2019/06/07

- Elimina referencia supérflua a XERCES

amap-pagos-1.7.2 2019/05/31

- Implementación por defecto HTTPCLIENT
- Corrige bug en la cabecera de seguridad
- Mapea domicilios extranjeros en el servicio CatalogoMouro.

amap-pagos-1.7.1 2019/05/22

- Corrección de urls 

amap-pagos-1.7.0 2019/04/15

- Incorpora el modelo 047
- Soporte de domicilios extranjeros en el modelo 046
- Alineación de componentes bouncy castle a la versión jdk15on
- Se incluyen los de errores (codigo y descripción) del servicio pagoPresentacion en la respuesta de la petición.

amap-pagos-1.6.1 2018/12/10

- Corrección de interface (compatiblidad hacia atrás, eliminar ParseException como excepción de vuelta).

amap-pagos-1.6.0 2018/11/23

- Creación de Implementación HttpClient.
- Creación de Implementación MOCK.

amap-pagos-1.5.0 2016/11/23

- Introducción de nuevas variables de entorno individualizadas por servicio

amap-pagos-1.4.1 2016/11/23

- Nuevo parámetro de pago para indicar el código colectivo.
- Mejorada la documentación

amap-pagos-1.4.0 2016/11/17

- Nuevo parámetro de pago para indicar un sujeto pasivo diferente al presentador.

amap-pagos-1.3.2 2016/08/03

- Añadir funcionalidad para poder enviar al modelo046 los datos de contacto del representante solicitante.

amap-pagos-1.3.1 2016/06/28

- Añadir metodo getServicio que reciba ademas el host de CatalogoMourov2.

amap-pagos-1.3.0 2016/06/28

- Añadido método de obtención de información de liquidación en el catálogo de Mouro.

amap-pagos-1.2.0 2016/06/15

- Añadido método de validación de códigos postales, mejora de la documentación.

amap-pagos-1.1.1 2016/06/10

- Eliminada la referencia al wsdl del catalogomodelo046.wsdl como fichero (se utiliza el wsdl publicado en el servicio).

amap-pagos-1.1.0 2016/06/06

- Añadido el documento justificante al realizar pago mediante el modelo 046 entre los datos de retorno.

amap-pagos-1.0.5 2016/04/19

-Añadidos métodos para la obtención de tipo de IVA del catálogo del Modelo 046
- Para el modelo 046: si el concepto no indica tipo de IVA o el importe se toman de los datos proporcionados en los datos de liquidación.

amap-pagos-1.0.4 2016/02/10

-Añadidos métodos para invocar a los servicio listaEntidadesColaboradoras y listaEntidadesCodigos.
-Fix de incidencias menores.

amap-pagos-1.0.0 2013/11/04

Primera versión del componente

<dependency>
<groupId>es.gobcantabria.amap.integracion</groupId>
<artifactId>amap-pagos</artifactId>
<version>1.7.3</version>
</dependency>

Datos necesarios

Necesita disponer de la siguiente información

  • SERVIDOR_WS: Servidor donde se alojan los WS de la ACAT
  • SERVIDOR_TPV: Asistente de Pago Virtual de la ACAT.
  • USUARIO_WSSECURITY: Usuario de acceso a los servicios web
  • PASSWORD_WSSECURIRY: Password de acceso a los servicios web

Estos datos se obtendrán usando la política de acceso a propiedades del sistema establecida.

Certificado de servidor SSL

A los servicios web de la ACAT es obligatorio acceder vía HTTS. El certificado de servidor deberá ser instalado en la máquina que aloja la aplicación.

Sin recursos disponibles.

Información necesaria


sistemas.app.amap.pago.usuario: Usuario de acceso a los servicios web
sistemas.app.amap.pago.password: Password de acceso a los servicios web
sistemas.global.amap.pagos.srv1.catalogo.genacat.url: url del servicio de genacat (urlCatalogoGenacatService)
sistemas.global.amap.pagos.srv1.catalogo.modelo046.url: url del servicio del cálogo del modelo 046 (urlCatalogoModelo046Service)
sistemas.global.amap.pagos.srv1.catalogo.mouro.url: url del servicio del catálogo mouro (urlCatalogoMouroService)
sistemas.global.amap.pagos.srv1.modelo046.url: url del servicio del modelo 046 (urlModelo046Service)
sistemas.global.amap.pagos.srv1.modelo047.url: url del servicio del modelo 047 (urlModelo047Service)
sistemas.global.amap.pagos.srv2.catalogo.mouro.url: url del servicio del catálogo mouro (urlCatalogoMouro2Service)

Creación de los servicios de forma programática

 

La configuración del componente se realiza a la hora de obtener la instancia del servicio. Los parámetros soportados son:

  • URL:  URL donde está desplegado el servicio.

Por lo que la forma convencional de generar un cliente, en el entorno de desarrollo, sería: 

En un entorno de producción los datos necesarios para instanciar el servicio han de provenir de ficheros externos de propiedades tal y como se recoge en la política de acceso a datos.

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

CatalogoMouroService

servicio = CatalogoMouroService.getService(new URL(urlCatalogoMouroService), new URL(urlCatalogoMouro2Service), usuario, password);

Modelo046Service

servicio = Modelo046Service.getService(new URL(urlModelo046Service), new URL(urlCatalogoModelo046Service),
                                    new URL(urlCatalogoGenacatService), usuario, password);

Modelo047Service

servicio = Modelo047Service.getService(new URL(urlModelo047Service), usuario, password);

CatalogoModelo046Service

servicio = CatalogoModelo046Service.getService(new URL(urlCatalogoModelo046Service), usuario, password);

CatalogoGenacatService

servicio = CatalogoGenacatService.getService(new URL(urlCatalogoGenacatService), usuario, password);

Opcionalmente, si se quiere utilizar cualquiera de estos servicios bajo la implementación MOCK, se deberá indicar un cuarto parámetro a la hora de obtener el servicio, por ejemplo:

servicio = Modelo046Service.getService(new URL(urlModelo046Service), usuario, password, "MOCK");

Las librerías requeridas serían las siguientes:

Para httpclient:

<dependency>
 <groupId>org.apache.httpcomponents</groupId>
 <artifactId>httpclient</artifactId>
</dependency>

Para axis2:

<dependency> 
 <groupId>org.apache.axis2</groupId>
 <artifactId>axis2</artifactId>
</dependency>

<dependency>
 <groupId>org.apache.axis2</groupId>
 <artifactId>axis2-transport-local</artifactId>
</dependency>

<dependency>
 <groupId>org.apache.axis2</groupId>
 <artifactId>axis2-transport-http</artifactId>
</dependency>  

NOTA IMPORTANTE : Las urls deben pasarse como objeto URL no como String, ya que ese método está deprecado y no corresponde con los valores de las sistemas descritos en los entornos del Gobierno de Cantabria. 

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.app.amap.pago.usuarioUsuario necesario para autenticarse y tener acceso a los servicios web*
sistemas.app.amap.pago.passwordPassword necesaria para autenticarse y tener acceso a los servicios web*
sistemas.global.amap.pagos.srv1.catalogo.genacat.url url del servicio de genacathttp://<host>/acat_services1/services/CatalogoGenacat.wsdl
sistemas.global.amap.pagos.srv1.catalogo.modelo046.url url del servicio de modelo 046http://<host>/acat_services1/services/CatalogoModelo046.wsdl
sistemas.global.amap.pagos.srv1.catalogo.mouro.url url del servicio de catálogo mourohttp://<host>/acat_services1/services/CatalogoMouro.wsdl
sistemas.global.amap.pagos.srv1.modelo046.url url del servicio de modelo 046http://<host>/acat_services1/services/Modelo046.wsdl
sistemas.global.amap.pagos.srv1.modelo047.url url del servicio de modelo 047http://<host>/acat_services1/services/Modelo047.wsdl
sistemas.global.amap.pagos.srv2.catalogo.mouro.urlurl del servicio de catálogo mouro v2http://<host>/acat_services2/services/CatalogoMouro.wsdl

Los valores de las propiedades 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

Creación de los servicios mediante Spring

 

Modelo046Service

<bean id="modelo046Service"
 class="org.springframework.beans.factory.config.MethodInvokingFactoryBean">
 <property name="targetClass"
  value="es.gobcantabria.integracion.amappagos.services.modelo046.Modelo046Service" />
 <property name="targetMethod" value="getService" />
 <property name="arguments">
  <list>
   <value type="java.net.URL"> ${sistemas.global.amap.pagos.srv1.modelo046.url} </value>
   <value> ${sistemas.app.amap.pago.usuario} </value>
   <value> ${sistemas.app.amap.pago.password} </value>
  </list>
 </property>
</bean>

Modelo047Service

<bean id="modelo047Service"
 class="org.springframework.beans.factory.config.MethodInvokingFactoryBean">
 <property name="targetClass"
  value="es.gobcantabria.integracion.amappagos.services.modelo047.Modelo047Service" />
 <property name="targetMethod" value="getService" />
 <property name="arguments">
  <list>
   <value type="java.net.URL"> ${sistemas.global.amap.pagos.srv1.modelo047.url} </value>
   <value> ${sistemas.app.amap.pago.usuario} </value>
   <value> ${sistemas.app.amap.pago.password} </value>
  </list>
 </property>
</bean>

CatalogoModelo046Service

<bean id="catalogoModelo046Service"
 class="org.springframework.beans.factory.config.MethodInvokingFactoryBean">
 <property name="targetClass"
  value="es.gobcantabria.integracion.amappagos.services.modelo046.CatalogoModelo046Service" />
 <property name="targetMethod" value="getService" />
 <property name="arguments">
  <list>
   <value type="java.net.URL"> ${sistemas.global.amap.pagos.srv1.catalogo.modelo046.url} </value>
   <value> ${sistemas.app.amap.pago.usuario} </value>
   <value> ${sistemas.app.amap.pago.password} </value>
  </list>
 </property>
</bean>

CatalogoMouroService

<bean id="catalogoMouroService"
 class="org.springframework.beans.factory.config.MethodInvokingFactoryBean">
 <property name="targetClass"
  value="es.gobcantabria.integracion.amappagos.services.mouro.CatalogoMouroService" />
 <property name="targetMethod" value="getService" />
 <property name="arguments">
  <list>
   <value type="java.net.URL"> ${sistemas.global.amap.pagos.srv1.catalogo.mouro.url} </value>
   <value type="java.net.URL"> ${sistemas.global.amap.pagos.srv2.catalogo.mouro.url} </value>
   <value> ${sistemas.app.amap.pago.usuario} </value>
   <value> ${sistemas.app.amap.pago.password} </value>
  </list>
 </property>
</bean>

CatalogoGenacatService

<bean id="catalogoGenacatService"
 class="org.springframework.beans.factory.config.MethodInvokingFactoryBean">
 <property name="targetClass"
  value="es.gobcantabria.integracion.amappagos.services.genacat.CatalogoGenacatService" />
 <property name="targetMethod" value="getService" />
 <property name="arguments">
  <list>
   <value type="java.net.URL"> ${sistemas.global.amap.pagos.srv1.catalogo.genacat.url} </value>
   <value> ${sistemas.app.amap.pago.usuario} </value>
   <value> ${sistemas.app.amap.pago.password} </value>
  </list>
 </property>
</bean>

Generales

DatosLiquidacion

Información sobre el pago: concepto, tasa...

DatosPago

Datos del pago: número de justificante, NRC, CSV...

Documento

Representa al modelo 046.

Domicilio

Domicilio fiscal o a efectos de notificación de una persona.

Genacat

Municipio

Agrupa la información referente a un domicilio(id, descripción y si se encuentra despoblado).

Provincia

Agrupa la información referente a una provincia(id y descripción).

Tipo via

Agrupa la información referente a un tipo de via(id y descripción).

Mouro

PagoDocumento

Agrupa la información asociada al pago y presentación de un documento de tipo 046.

Tercero

Cualquier persona física o jurídica interviniente, ya sea declarante o presentador del documento.

EntidadBancaria

Representa a una entidad bancaria

Modelo046

Casilla

Representa una casilla y un valor.

Código territorial

Agrupa la información del Código Territorial u Órgano administrativo responsable. 

Concepto

Agrupa la información del concepto. Para la confección solo es necesario rellenar el código del concepto.

Datos adicionales

Agrupa información adicional del modelo046.

Datos contacto

Agrupa informaciñon de contacto(telefono y fax).

Datos liquidación

Agrupa la información relativa a la liquidación del documento. Para la confección solo es obligatoria la descripción de la operación y la cuota.

Dirección

Agrupa toda la información que compone una dirección(Tipo via, provincia, municipio, etc ...).

Documento

Elemento que contiene el documento en version 

Liquidación 046 Resultado

Agrupa la información relativa a la liquidación del documento. Para la confección solo es obligatoria la descripción de la operación y la cuota.

Metodo pago

Agrupa la información referente al método de pago(número de cuenta corriente y número de tarjeta).

Modelo046

Agrupa todo la información que comprende un documento de tipo 046.

Modelo046 Error

Agrupa los errores generados en alguno de los procesos de validación o confección del modelo.

Modelo046 Resultado

Agrupa la información de resultado del pago y presentación de un modelo 046.

Pago

Contiene la información referente al pago(Documento e importe).

Pago presentación

Engloba la información necesaria para solicitar el pago y presentación de un documento.

Pago presentación resultado

Elemento que identifica los datos de salida de una operación de pago y presentación.

Pago resultado

Datos de salida de una operación de pago.

Persona

Representa a un tercero.

Presentación resultado

Datos de salida de una operación de presentación.

Presentador

Agrupa la información relativa al presentador del documento.

Sujeto pasivo

Agrupa la información relativa al sujeto pasivo.

Tecero046

Cualquier persona física o jurídica interviniente, ya sea declarante o presentador del documento.

Tipo IVA

porcentaje de I.V.A. que tiene asociado un determinado tipo de I.V.A. para una fecha determinada

Tipo liquidación

Identifica si se trata de una Tasa, Precio público, Reintegros, Sanciones y concesiones, Derecho privado o un depósito en metálico.

Nombreamap-pagos
Identificadoramap-pagos
Grupoes.gobcantabria.amap.integracion
Versión1.7.3
Licencia
Desarrollador
Descripción

Componente para la realización de pagos electrónicos con tarjeta de crédito

Documentaciónamap-pagos (JavaDoc)
Binarioamap-pagos (Jar)
Dependenciasamap-pagos (Librerías)

Sin particularidades. Seguir las recomendaciones del fabricante.

Modelo046Service

A continuación se muestra la definición del flujo del modelo 046, para más información se puede consultar el documento "Plataforma ACAT - CONFECCION Y PAGO 046" de la sección de recursos.

Tratamiento de errores

A la hora del envío del pago mediante el método pagoPresentacion, los errores de la operación se incluyen en una lista.
Dependiendo del tipo de error, en ocasiones devolverá datos del pago y/o documento, como por ejemplo el número de documento o el DOI.

Ejemplo de acceso a la lista de errores del pago:

DatosPagoPresentacion datosPagoPresentacion=
                          (DatosPagoPresentacion)servicioPago.pagoPresentacion(doiPresentador, ccc, importe, numDoc);

if(datosPagoPresentacion.getErroresPago()!=null) {

  if(datosPagoPresentacion.getDocumento() != null) {
    log.info("Número Documento :"+ datosPagoPresentacion.getDocumento().getNumDocumento());
    log.info("Número DOI :"+ datosPagoPresentacion.getDocumento().getDOI());
  }

  log.error(datosPagoPresentacion.getErroresPago().get(0).toString());
}

Flujo de pago con numero de cuenta

pago_cuenta.png

  • El cliente solicita la realización de un pago. Ha de proporcionar los datos del declarante y del presentador.
  • La aplicación recibe los datos del declarante y del presentador (de existir) y junto a los datos de la liquidación solicita al WS correspondiente la confección del modelo 046 (confeccionarModelo046 del servicio Modelo046Service).
DatosLiquidacion datosLiquidacion = new DatosLiquidacion();

datosLiquidacion.setIdConcepto("5332");
datosLiquidacion.setIdCodTerritorial("GA3921");
datosLiquidacion.setIdTasa("01");
datosLiquidacion.setDescripcion("Prueba de Pago con Tarjeta");

Documento doc046 = servicioPago.confeccionarModelo046(declarante, datosLiquidacion);
  • Los WS de la ACAT devuelven el documento 046 a la aplicación.
  • Extraemos el numero de documento necesario para realizar el pago
//Numero de documento
String numDoc = doc046.getNumeroDocumento046();
  • Realizamos el pago el pago contra la acat.
  • necesitaremos el presentador, el número de cuenta, el importe y el número del documento que ya hemos extraido.
DatosPagoPresentacion datosPagoPresentacion= (DatosPagoPresentacion)servicioPago.pagoPresentacion(doiPresentador, ccc, importe, numDoc);
  • Si la aplicación retorna y contiene el identificador del  pago, esta será capaz de verificar si el pago se ha realizado con éxito. Para ello invocará al servicio método getPagoPresentacionValido del servicio CatalogoMouroService.
DatosPago datosPago = catalogoMouro.getPagoPresentacionValido(numDoc);

Nota Importante: Los parámetros de "datosLiquidacion" tipoIva e importe solamente son tomados en consideración si no están asociados al concepto indicado.

Flujo de pago con tarjeta

pago.png

  • El cliente solicita la realización de un pago. Ha de proporcionar los datos del declarante y del presentador.
  • La aplicación recibe los datos del declarante y del presentador (de existir) y junto a los datos de la liquidación solicita al WS correspondiente la confección del modelo 046 (confeccionarModelo046 del servicio Modelo046Service).
DatosLiquidacion datosLiquidacion = new DatosLiquidacion();

datosLiquidacion.setIdConcepto("5332");
datosLiquidacion.setIdCodTerritorial("GA3921");
datosLiquidacion.setIdTasa("01");
datosLiquidacion.setDescripcion("Prueba de Pago con Tarjeta");

Documento doc046 = servicioPago.confeccionarModelo046(declarante, datosLiquidacion);
  • Los WS de la ACAT devuelven el documento 046 a la aplicación.
  • La aplicación devuelve al cliente los datos del nuevo 046 así como un mensaje cifrado que contiene datos del pago y una URL de retorno a la que el TPV devolverá en control una vez finalizado el pago. Es conveniente que la URL de retorno lleve como parámetro el identificador del pago para poder verificar posteriormente el pago.
//Numero de documento
String numDoc = doc046.getNumeroDocumento046();
//Mensaje
String mensaje = MensajeTPVHelper.buildMensaje(buildUrlRetorno(URL, numDoc, declarante.getNif(), doc046.getImporte());

Nota Importante: La url a utilizar ha de ser la definida en la variable de entorno sistemas.global.amap.pagos.tpv.url.

  • El cliente enviará por el método POST el mensaje recibido al TPV.
<form action="https://SERVIDOR_TPV/emouro/asistenteSimpleTPV.do" method="post">
<input type="hidden" name="numDoc" value="${numDoc}" />
<input type="hidden" name="MENSAJE" value="${mensaje}" />
<input type="submit" value="Pagar" />
</form>
  • Cuando se termine de ejecutar el asistente del TPV, este redirigirá a la URL de retorno especificada en el mensaje.
  • Si la aplicación sirve la URL de retorno y contiene el identificador del  pago, esta será capaz de verificar si el pago se ha realizado con éxito. Para ello invocará al servicio método getPagoPresentacionValido del servicio CatalogoMouroService.
DatosPago datosPago = catalogoMouro.getPagoPresentacionValido(numDoc);

Nota Importante: Los parámetros de "datosLiquidacion" tipoIva e importe solamente son tomados en consideración si no están asociados al concepto indicado.

Modelo047Service

A continuación se muestra la creación del modelo 047, para más información se puede consultar el documento "Plataforma ACAT - CONFECCION Y PAGO 047" de la sección de recursos.

modelo047

Este método permite la creación del modelo 047

Persona tercero = new Persona();
tercero.setId("000044444");
tercero.setNif("00000000W");
tercero.setNombre("MARIA");
tercero.setPrimerApellido("SANCHEZ");
tercero.setSegundoApellido("FERNANDEZ");

Domicilio dom = new Domicilio(); 
dom.setIdTipoVia("AV");
dom.setCalle("RUALASAL");
dom.setNumero(21);
dom.setCodigoPostal("39001");
dom.setIdMunicipio("075");
dom.setNombreMunicipio("SANTANDER");
dom.setIdProvincia("39");
dom.setNombreProvincia("CANTABRIA");
tercero.setDomicilio(dom);

DatosLiquidacionModelo047 datosL = new DatosLiquidacionModelo047();
datosL.setFechaVecimiento(new Date());
datosL.setIdConcepto("0670");
datosL.setIdCodTerritorial("SA3953");
datosL.setDescripcion("PAGO"); 
datosL.setImporte(100);
datosL.setIdTasa("02");

DatosDocumento047 doc = servicio.modelo047(datosL, tercero);

Catálogo modelo 046

Este catálogo es un servicio de acceso a la consulta de entidades de información especificas para la confección del modelo 046(Tipo de liquidación, Tipo de IVA, Conceptos y Códigos territoriales).

getCodigoTerritorial

Este metodo devuelve un Objeto del tipo CodigoTerritorial a partir del id del código territorial.

CodigoTerritorial codigo = servicio.getCodigoTerritorial("GA3921");

getConcepto

Este método retorna un objeto del tipo Concepto a partir del id del concepto y el id de la tasa.

Conceptoservicio concepto = servicio.getConcepto("5332", "01");

getTipoLiquidacion

Este método retorna un objeto del tipo TipoLiquidacion a partir del id de la tasa

TipoLiquidacion tipoLiquidacion = servicio.getTipoLiquidacion("01");

getTipoIva

Este método retorna un objeto del tipo TipoIva a partir del id del iva y de la fecha de devengo

TipoIva tipoIva = servicio.getTipoIva("2",new Date());

Catálogo de GenacatService

Este catálogo es un servicio de acceso a la consulta de entidades de información de carácter general  (Tipos de vía, Provincias, Municipios,..) necesarias para la confección del Modelo 046.
Para utilizar este catálogo de servicios ha de utilizar una instancia de CatalogoGenacatClienteWS
Mas información al respecto de como instanciar CatalogoGenacatClienteWS en la pestaña configuración

getMunicipios

Método que da acceso a todos los registros de la entidad Municipios

Provincia provincia = new Provincia();
provincia.setIdProvincia("39");
provincia.setDescripcion("");
// or Provincia provincia = servicio.getProvincia("39");
List<Municipio> mucipios = servicio.getMunicipios(provincia);

getMunicipio

Método que da acceso a la consulta de la entidad Municipios de uso obligatorio en la declaración de la dirección de cualquiera de los terceros participantes en una operación.

Municipio municipio = servicio.getMunicipio("39087");

getProvincias

Método que da acceso a todos los registros de la entidad provincias.

List<Provincia> provincias = servicio.getProvincias();

getProvincia

Método que da acceso a la consulta de la entidad provincias de uso obligatorio en la declaración de la dirección de cualquiera de los terceros participantes en una operación.

Provincia provincia = servicio.getProvincia("01");

getTiposVia

Método que da acceso a todos los registros de la entidad tipos de via.

List<TipoVia> tiposVia = servicio.getTiposVia();

getTipoVia

Método que da acceso a la consulta de la entidad tipos de vía de uso obligatorio en la declaración de la dirección de cualquiera de los terceros participantes en una operación.

TipoVia tipoVia = servicio.getTipoVia("AV");

isCodigoPostalValido (Cantabria)

Este método es válido solamente para la comunidad autónoma de Cantabria.

Operación que valida un código postal a partir del municipio.

Municipio municipio = new Municipio();
municipio.setIdMunicipio("39075"); 
// or Municipio municipio = servicio.getMunicipio("39075");
boolean valido = servicio.isCodigoPostalValido(municipio, "39007");

Catálogo de Mouro

Mas información al respecto de como instanciar CatalogoMouroClienteWS en la pestaña configuración
Para utilizar este catálogo de servicios ha de utilizar una instancia de CatalogoMouroClienteWS

getDomicilios

El método getDomicilios nos devuelve una lista de los domicilios de un tercero.
Como argumento toma un objeto del tipo Tercero(El unico requisito es que contenga un Id valido).

List<Domicilio> listaDomicilios = servicio.getDomicilios(tercero);

getDomicilioFiscal

El metodo getDomicilioFiscal retorna un objeto del tipo DomicilioFiscal con los datos del domicilio.
Como argumento toma un objeto del tipo Tercero(El unico requisito es que contenga un Id valido).

  DomicilioFiscal domicilio = servicio.getDomicilioFiscal(tercero);

getPagoPresentacionValido

El método getPagoPresentacionValido devuelve los datos de un pago, como argumento recibe el número de documento como una cadena de texto, una cadena correspondiente al nrc y otra correspondiente al csv.

datosPago datosPago = servicio.getPagoPresentacionValido(String numDocumento, String nrc, String csv);

Otra sobrecarga posible del método nos permite introducirle unicamente el número del documento.

DatosPago datosPago = servicio.getPagoPresentacionValido("0462900054951");

getTerceros

El método getTercero devuelve un listado de objetos de tipo Tercero que coinciden con el consultado
Recibe como argumentos el dni y el apellido.

List<Tercero> lista = servicio.getTerceros("99999999X", "SANCHEZ");

getListaEntidadesColaboradoras

El método getListaEntidadesColaboradoras devuelve una cadena con el nombre de todas las entidades que colaboran con ACAT

String lista = servicio.getListaEntidadesColaboradoras();

getListaEntidadesCodigos

El método getListaEntidadesCodigos devuelve una lista de objetos del tipo EntidadBancario con todas las entidades que colaboran con ACAT

List<EntidadBancaria> lista = servicio.getListaEntidadesCodigos();

isCodigoPostalValido (España)

Este método es válido para toda España

Operación que valida un código postal a partir del identificador de provincia.

String codigoPostal="24391";
String idProvincia="24";
boolean valido = servicio.isCodigoPostalValido(idProvincia, codigoPostal);

informacionLiquidacion

Operación que obtiene la información de liquidación asociada al número de documento.

  String numeroDocumento = "XXXXXXXX";
  List<InformacionLiquidacion> lista = servicio.informacionLiquidacion(numeroDocumento);
  for(InformacionLiquidacion infoLiq : lista) {
   System.out.println(infoLiq.getCodigo() + ", " + infoLiq.getDescripcion());
  }
© 2014 GOBIERNO DE CANTABRIA - AVISO LEGAL Y PROTECCIÓN DE DATOS