SNR - Realtech 1

Especificación WS Impuesto Registro - REL

Proyecto
Radicación Electrónica

Versión:
1.0

Diseño
Especificación servicio web
Pago impuesto de registro

Elaborado
Fabián Agudelo Mayorga
Ingeniero de Desarrollo Senior

Fecha
2017 / 07 / 05

Realtech
Soluciones de Desarrollo de Software
www.realtechltda.com
 SNR - Realtech 2
Especificación WS Impuesto Registro - REL

Control de Cambios

Fecha Responsable Cambio

2017 / 07 / 05 Fabián Agudelo Mayorga Creación del documento
2017 / 07 / 05 Javier Realpe Validación de documento

Información de documento.

Creado por Revisado por Aprobado por

Fabián Agudelo Mayorga Javier Realpe Javier Realpe
Ingeniero de Desarrollo Senior Líder Proyecto Líder Proyecto

Realtech
Soluciones de Desarrollo de Software
www.realtechltda.com
 SNR - Realtech 3
Especificación WS Impuesto Registro - REL

Contenido

Introducción .............................................................................................................................. 4
Ambientes ................................................................................................................................. 4
Excepciones / Códigos de Respuesta. .......................................................................................... 4
Definición de Métodos / Operaciones .......................................................................................... 5

Realtech
Soluciones de Desarrollo de Software
www.realtechltda.com
 SNR - Realtech 4
Especificación WS Impuesto Registro - REL

Introducción

Este documento contiene todas las operaciones relacionadas con la capa de servicios para el
proceso de envío del pago de impuesto de registro.

Esta capa de servicios está basada en la implementación SOAP.

Ambientes

Al momento de la creación de este documento se proporciona el ambiente de pruebas para realizar

las peticiones e implementaciones necesarias bajo la siguiente dirección:

Ambienté de Integración / Pruebas:

http://radicacion.supernotariado.gov.co/services/ImpuestoServices?wsdl

Excepciones / Códigos de Respuesta.

La siguiente tabla muestra las excepciones y códigos de error arrojados por la capa de servicios.

Código Mensaje
1000 Envío de la información realizado correctamente
1001 Pago reportado anteriormente
1100 No se ha encontrado impuesto con el código enviado
1200 Se debe enviar el documento antes de realizar el reporte de pago
1210 Necesita enviar el documento de soporte de pago de la extemporaneidad
1300 El código de validación es incorrecto para la entidad enviada
1700 La fecha no tiene un formato adecuado
1710 No se ha recibido la fecha del pago, debe enviarla para reportar dicho pago

Realtech
Soluciones de Desarrollo de Software
www.realtechltda.com
 SNR - Realtech 5
Especificación WS Impuesto Registro - REL

Definición de Métodos / Operaciones

ReportarPagoImpuesto

Definición:
Función principal que almacena el recibo de pago junto a toda la información asociada al Id
enviado.

Entrada:
Parámetro Tipo Requerido Definición
idImpuesto STRING SI Id principal del proceso, se envía al inicio
del proceso a la gobernación
reciboPago BYTE[] NO Comprobante del recibo de pago en
arreglo de bytes.
fechaPago STRING NO Fecha en la cual se realiza el pago en
formato DD-MM-YYYY
estadoPago STRING NO Informa si se ha realizado el pago del
impuesto, puede tener solo dos valores:
S, N.
reciboExtemporaneidad BYTE[] NO Comprobante del pago de la
extemporaneidad en arreglo de bytes.
codigoEntidad STRING SI Código identificador de la entidad que
envía el pago. Para pruebas: 123.

El idImpuesto es un número único para cada proceso y que es adjuntado a la gobernación al

momento de enviar el documento una vez se crea cada proceso en el sistema de radicación
electrónica. Ese ID debe ser almacenado y se usa como parámetro principal para este proceso de
pago.

Este método puede ser llamado las veces que sean necesarias para el mismo proceso hasta que el
estado del trámite sea “S”, momento en el cual no se aceptarán envíos ya que se ha reportado el
pago final. Es decir, se puede llamar una primera vez para solo enviar el recibo de pago, luego se
puede llamar otra vez para enviar la fecha de pago, luego una tercera vez para enviar el recibo de
pago de extemporaneidad si se necesita y una última vez para reportar el estado de pago en “S”. O
se pueden enviar todos los parámetros en un mismo llamado, ya es decisión de la entidad que
mejor se ajuste a sus procesos internos.

Cabe resaltar que una vez vencida la fecha de pago, el sistema no dejará colocar el estado en “S”
hasta que no se suba el recibo comprobante del pago de la extemporaneidad.

Salida:
Parámetro Tipo Definición
logWS LOGWS Información detallada de la consulta realizada(Ver siguiente tabla)

LOGWS

Realtech
Soluciones de Desarrollo de Software
www.realtechltda.com
 SNR - Realtech 6
Especificación WS Impuesto Registro - REL

Nombre Tipo Detalle

codigo STRING Código del log de respuesta
tipo STRING Tipo de log (OK,INFO,WARNING,ERROR)
fecha DATE Fecha de generación del log
mensaje STRING Mensaje del log
mensajeTecnico STRING Mensaje técnico de la plataforma.

Ejemplo Request.

Ejemplo Response.

Realtech
Soluciones de Desarrollo de Software
www.realtechltda.com