Muestra las diferencias entre dos versiones de la página.
Próxima revisión | Revisión previa | ||
ada:howto:sicoferp:factory:integrations:portal.contribuyente:administracionws [2021/09/01 13:57] 192.168.177.37 creado |
ada:howto:sicoferp:factory:integrations:portal.contribuyente:administracionws [2021/09/01 17:56] (actual) 192.168.177.37 |
||
---|---|---|---|
Línea 5: | Línea 5: | ||
^Nombre^Descripción^Tipo Servicio^Tecnología^Lenguaje^Tipo Desarrollo^Versión Desarrollo^Archivo de Configuración^ | ^Nombre^Descripción^Tipo Servicio^Tecnología^Lenguaje^Tipo Desarrollo^Versión Desarrollo^Archivo de Configuración^ | ||
- | |Ada|Funcionalidad exponer microservicios para gestión de parámetros|Rest|RESTFull|Java 11.0.315|Nuevo|11.0.1.0|configuration.properties| | + | |Ada|Funcionalidad exponer microservicios para gestión de parámetros|Rest|RESTFull|Java 11.0.315|Nuevo|0.0.1-SNAPSHOT|configuration.properties| |
^Tipo Empaquetado^Gestor de Dependencias^Servidor de Despliegue^IDE Proyecto^Tipo Repositorio^Url Desarrollo^Url Calidad^Url Producción^ | ^Tipo Empaquetado^Gestor de Dependencias^Servidor de Despliegue^IDE Proyecto^Tipo Repositorio^Url Desarrollo^Url Calidad^Url Producción^ | ||
- | |jar|Maven 3.8.1|Tomcat 6|Eclipse 2021-03|Subversión |[[http://adacsc.co:1443/svn/repository/ADA/NOTIFICACION_ELECTRONICA/branches/development/enotificacion/administracion|SVN branches]]|[[|SVN trunk]]|[[|SVN tags]]| | + | |war|Maven 3.8.2|wildfly-18.0.1.Final|Eclipse 2019-12 (4.14.0)|Subversión |[[http://adacsc.co:1443/svn/repository/ADA/NOTIFICACION_ELECTRONICA/branches/development/enotificacion/administracion|SVN branches]]|[[|SVN trunk]]|[[http://adacsc.co:1443/svn/repository/ADA/NOTIFICACION_ELECTRONICA/Tags/1.0.0/back-end/development/enotificacion/administracion|SVN tags]]| |
^Dependencias^^^^^^^^ | ^Dependencias^^^^^^^^ | ||
^groupId^artifactId^^version^scope^optional^Descripción^^ | ^groupId^artifactId^^version^scope^optional^Descripción^^ | ||
- | |org.springframework.boot|spring-boot-starter-data-jpa||N/A|N/A|N/A|API de persistencia|| | + | |co.ada.enotificacion|comun||0.0.1-SNAPSHOT|N/A|N/A|API de utilidades comunes en el sistema|| |
- | |org.springframework.boot|spring-boot-starter-web||N/A|N/A|N/A|Core Servicios Web|| | + | |co.ada.enotificacion|administracionNegocio||0.0.1-SNAPSHOT|N/A|N/A|API de utilidades comunes en el sistema|| |
- | |org.springframework.boot|spring-boot-devtools||N/A|runtime|true|Recarga de aplicaciones|| | + | |commons-discovery|commons-discovery||0.4|N/A|N/A|API de persistencia|| |
- | |com.oracle.ojdbc|ojdbc8||N/A|runtime|N/A|Driver DB Oracle|| | + | |org.mybatis|mybatis||3.1.1|N/A|N/A|API de persistencia|| |
- | |org.springframework.boot|spring-boot-starter-test||N/A|test|N/A|Core|| | + | |javax.faces|javax.faces-api||2.3|N/A|N/A|Recarga de aplicaciones|| |
- | |org.springframework.boot|spring-boot-starter-data-jdbc||N/A|N/A|N/A|API JDBC para conexión a Base de Datos|| | + | |
- | |org.apache.tomcat.embed|tomcat-embed-jasper||N/A|provided|N/A|Servidor embebido tomcat|| | + | |
- | |org.springframework.boot|spring-boot-starter-tomcat||N/A|provided|N/A|Core tomcat|| | + | |
- | |org.apache.maven.plugins|maven-compiler-plugin||3.8.1|N/A|N/A|Gestor de dependencias|| | + | |
- | |io.springfox|springfox-swagger2||2.9.2|N/A|N/A|Core Documentación Web Services RESTful|| | + | |
- | |io.springfox|springfox-swagger-ui||2.9.2|N/A|N/A|GUI Documentación Web Services RESTful|| | + | |
^Operaciones^^^^^^^^ | ^Operaciones^^^^^^^^ | ||
^Tipo Petición Http^Nombre operación^^Descripción^^^Documentación^^ | ^Tipo Petición Http^Nombre operación^^Descripción^^^Documentación^^ | ||
Línea 39: | Línea 33: | ||
^Ambientes de Despliegue^^^^^^^^ | ^Ambientes de Despliegue^^^^^^^^ | ||
^Tipo^Url^^Observaciones^^^^^ | ^Tipo^Url^^Observaciones^^^^^ | ||
- | |Desarrollo:|http://10.1.140.20:8001/ ||Ambiente de desarrollo||||| | + | |Desarrollo:| http://10.1.140.1:42002/ ||Ambiente de desarrollo||||| |
- | |Calidad:| ||Ambiente de validación||||| | + | |Calidad:| http://10.1.140.1:42002/ ||Ambiente de validación||||| |
|Producción:| ||Ambiente de producción||||| | |Producción:| ||Ambiente de producción||||| | ||
Línea 47: | Línea 41: | ||
==== Contrato de Servicio ==== | ==== Contrato de Servicio ==== | ||
A continuación se presenta el contrato de servicio con las operaciones implementadas. La documentación está realizada en el estandar [[https://spec.openapis.org/oas/v3.1.0|OpenAPI V3.0.1]]. Para visualizar la documentación (Vista html) copie el código [[https://yaml.org/spec/1.2/spec.html|Yaml]] en un visor [[https://editor.swagger.io/|Swagger]]. | A continuación se presenta el contrato de servicio con las operaciones implementadas. La documentación está realizada en el estandar [[https://spec.openapis.org/oas/v3.1.0|OpenAPI V3.0.1]]. Para visualizar la documentación (Vista html) copie el código [[https://yaml.org/spec/1.2/spec.html|Yaml]] en un visor [[https://editor.swagger.io/|Swagger]]. | ||
- | |||
- | Para más información acerca de la estructura de los campos, puede consultar el [[http://10.1.20.89/doku.php?id=ada:howto:sicoferp:factory:logmodels|Diccionario de datos]] | ||
<code yaml> | <code yaml> | ||
openapi: 3.0.1 | openapi: 3.0.1 | ||
info: | info: | ||
- | title: Service Log | + | title: Servicio Portal del Contribuyente |
contact: | contact: | ||
name: ADA.S.A | name: ADA.S.A | ||
Línea 60: | Línea 52: | ||
license: | license: | ||
name: Apache License Version 2.0 | name: Apache License Version 2.0 | ||
- | version: "1.0" | + | version: '1.0' |
servers: | servers: | ||
- | - url: //10.1.140.20:8001/ | + | - url: //10.1.140.1:42002/ |
tags: | tags: | ||
- | - name: file-upload-log-controller | + | - name: administracion-ws |
- | description: File Upload Log Controller | + | description: Gestor de usuarios y parámetros |
- | - name: mov-log-errores-controller | + | - name: portal-ws |
- | description: Mov Log Errores Controller | + | description: Gestor core del portal, sesiones, consultas, pagos en línea |
- | - name: session-log-app | + | - name: notificacion-ws |
- | description: Session Log App | + | description: Gestor de transacciones masivas entre el cliente y el portal |
- | - name: transactional-log-app | + | - name: registro-ws |
- | description: Transactional Log App | + | description: Gestor del registro de usuarios al sistema |
paths: | paths: | ||
- | /error/getRegisters: | + | /administracionws/consulta/parametros/todos/: |
get: | get: | ||
tags: | tags: | ||
- | - mov-log-errores-controller | + | - administracion-ws |
- | summary: getRegisters | + | summary: obtenerListadoParametros |
- | operationId: getRegistersUsingGET_1 | + | operationId: obtenerListadoParametrosGET |
parameters: | parameters: | ||
- | - name: codigoInterno | + | - name: authorization |
- | in: query | + | in: header |
- | description: codigoInterno | + | required: true |
- | schema: | + | description: token de la aplicación |
- | type: integer | + | schema: |
- | format: int32 | + | type: string |
- | default: 0 | + | |
- | - name: codOracle | + | |
- | in: query | + | |
- | description: codOracle | + | |
- | schema: | + | |
- | type: integer | + | |
- | format: int32 | + | |
- | default: 0 | + | |
- | - name: msjOracle | + | |
- | in: query | + | |
- | description: msjOracle | + | |
- | schema: | + | |
- | type: string | + | |
- | default: "0" | + | |
- | - name: nomPrecedimiento | + | |
- | in: query | + | |
- | description: nomPrecedimiento | + | |
- | schema: | + | |
- | type: string | + | |
- | default: "0" | + | |
responses: | responses: | ||
- | 200: | + | '200': |
description: OK | description: OK | ||
content: | content: | ||
- | '*/*': | + | application/json: |
schema: | schema: | ||
type: array | type: array | ||
items: | items: | ||
- | $ref: '#/components/schemas/MovLogErrores' | + | $ref: '#/components/schemas/Parametros' |
- | 401: | + | '204': |
- | description: Unauthorized | + | description: NoContent |
- | content: {} | + | |
- | 403: | + | |
- | description: Forbidden | + | |
- | content: {} | + | |
- | 404: | + | |
- | description: Not Found | + | |
- | content: {} | + | |
- | /error/save: | + | |
- | post: | + | |
- | tags: | + | |
- | - mov-log-errores-controller | + | |
- | summary: save | + | |
- | operationId: saveUsingPOST | + | |
- | requestBody: | + | |
- | description: sessionLog | + | |
- | content: | + | |
- | application/json: | + | |
- | schema: | + | |
- | $ref: '#/components/schemas/MovLogErrores' | + | |
- | required: true | + | |
- | responses: | + | |
- | 200: | + | |
- | description: OK | + | |
content: | content: | ||
- | '*/*': | + | application/json: |
schema: | schema: | ||
- | type: integer | + | $ref: '#/components/schemas/EstadoTransaccion' |
- | format: int32 | + | '401': |
- | 201: | + | |
- | description: Created | + | |
- | content: {} | + | |
- | 401: | + | |
description: Unauthorized | description: Unauthorized | ||
- | content: {} | + | content: |
- | 403: | + | application/json: |
+ | schema: | ||
+ | $ref: '#/components/schemas/EstadoTransaccion' | ||
+ | '403': | ||
description: Forbidden | description: Forbidden | ||
- | content: {} | + | content: |
- | 404: | + | application/json: |
- | description: Not Found | + | schema: |
- | content: {} | + | $ref: '#/components/schemas/EstadoTransaccion' |
- | x-codegen-request-body-name: sessionLog | + | '500': |
- | /error/{id}/getRegister: | + | description: Internal Server Error |
+ | content: | ||
+ | application/json: | ||
+ | schema: | ||
+ | $ref: '#/components/schemas/EstadoTransaccion' | ||
+ | /administracionws/consulta/aplicaciones/todos/: | ||
get: | get: | ||
tags: | tags: | ||
- | - mov-log-errores-controller | + | - administracion-ws |
- | summary: getRegisterById | + | summary: obtenerListadoAplicaciones |
- | operationId: getRegisterByIdUsingGET | + | operationId: obtenerListadoAplicacionesGET |
parameters: | parameters: | ||
- | - name: id | + | - name: authorization |
- | in: path | + | in: header |
- | description: id | + | required: true |
- | required: true | + | description: token de la aplicación |
- | schema: | + | schema: |
- | type: string | + | type: string |
responses: | responses: | ||
- | 200: | + | '200': |
description: OK | description: OK | ||
content: | content: | ||
- | '*/*': | + | application/json: |
schema: | schema: | ||
- | $ref: '#/components/schemas/MovLogErrores' | + | type: array |
- | 401: | + | items: |
+ | $ref: '#/components/schemas/Aplicaciones' | ||
+ | '204': | ||
+ | description: NoContent | ||
+ | content: | ||
+ | application/json: | ||
+ | schema: | ||
+ | $ref: '#/components/schemas/EstadoTransaccion' | ||
+ | '401': | ||
description: Unauthorized | description: Unauthorized | ||
- | content: {} | + | content: |
- | 403: | + | application/json: |
+ | schema: | ||
+ | $ref: '#/components/schemas/EstadoTransaccion' | ||
+ | '403': | ||
description: Forbidden | description: Forbidden | ||
- | content: {} | + | content: |
- | 404: | + | application/json: |
- | description: Not Found | + | schema: |
- | content: {} | + | $ref: '#/components/schemas/EstadoTransaccion' |
- | /session/getRegisters: | + | '500': |
+ | description: Internal Server Error | ||
+ | content: | ||
+ | application/json: | ||
+ | schema: | ||
+ | $ref: '#/components/schemas/EstadoTransaccion' | ||
+ | /administracionws/consulta/usuarios/todos/: | ||
get: | get: | ||
tags: | tags: | ||
- | - session-log-app | + | - administracion-ws |
- | summary: getRegisters | + | summary: obtenerListadoUsuarios |
- | operationId: getRegistersUsingGET_2 | + | operationId: obtenerListadoUsuariosGET |
parameters: | parameters: | ||
- | - name: codigoAplicacion | + | - name: authorization |
- | in: query | + | in: header |
- | description: codigoAplicacion | + | required: true |
- | schema: | + | description: token de la aplicación |
- | type: integer | + | schema: |
- | format: int64 | + | type: string |
- | - name: codigoDependencia | + | |
- | in: query | + | |
- | description: codigoDependencia | + | |
- | schema: | + | |
- | type: integer | + | |
- | format: int64 | + | |
- | - name: codigoUsuario | + | |
- | in: query | + | |
- | description: codigoUsuario | + | |
- | schema: | + | |
- | type: integer | + | |
- | format: int64 | + | |
- | - name: id | + | |
- | in: query | + | |
- | description: id | + | |
- | schema: | + | |
- | type: string | + | |
- | - name: nitEmpresa | + | |
- | in: query | + | |
- | description: nitEmpresa | + | |
- | schema: | + | |
- | type: integer | + | |
- | format: int64 | + | |
- | - name: tipoRegistro | + | |
- | in: query | + | |
- | description: tipoRegistro | + | |
- | schema: | + | |
- | type: string | + | |
responses: | responses: | ||
- | 200: | + | '200': |
description: OK | description: OK | ||
content: | content: | ||
- | '*/*': | + | application/json: |
schema: | schema: | ||
type: array | type: array | ||
items: | items: | ||
- | $ref: '#/components/schemas/SessionLog' | + | $ref: '#/components/schemas/Usuarios' |
- | 401: | + | '204': |
+ | description: NoContent | ||
+ | content: | ||
+ | application/json: | ||
+ | schema: | ||
+ | $ref: '#/components/schemas/EstadoTransaccion' | ||
+ | '401': | ||
description: Unauthorized | description: Unauthorized | ||
- | content: {} | + | content: |
- | 403: | + | application/json: |
+ | schema: | ||
+ | $ref: '#/components/schemas/EstadoTransaccion' | ||
+ | '403': | ||
description: Forbidden | description: Forbidden | ||
- | content: {} | + | content: |
- | 404: | + | application/json: |
- | description: Not Found | + | schema: |
- | content: {} | + | $ref: '#/components/schemas/EstadoTransaccion' |
- | /session/save: | + | '500': |
- | post: | + | description: Internal Server Error |
+ | content: | ||
+ | application/json: | ||
+ | schema: | ||
+ | $ref: '#/components/schemas/EstadoTransaccion' | ||
+ | /portalws/login/: | ||
+ | get: | ||
tags: | tags: | ||
- | - session-log-app | + | - portal-ws |
- | summary: saveSessionLog | + | summary: login |
- | operationId: saveSessionLogUsingPOST_1 | + | operationId: loginGET |
- | requestBody: | + | parameters: |
- | description: sessionLog | + | - name: authorization |
- | content: | + | in: header |
- | application/json: | + | required: true |
- | schema: | + | description: Nombre del path del cliente, según el valor en la tabla aplicacion |
- | $ref: '#/components/schemas/SessionLog' | + | schema: |
- | required: true | + | type: string |
+ | - name: usuario | ||
+ | in: header | ||
+ | required: true | ||
+ | description: Cuenta de correo del usuario o nickname | ||
+ | schema: | ||
+ | type: string | ||
+ | - name: password | ||
+ | in: header | ||
+ | required: true | ||
+ | description: Contraseña de la cuenta de usuario | ||
+ | schema: | ||
+ | type: string | ||
responses: | responses: | ||
- | 200: | + | '200': |
description: OK | description: OK | ||
- | content: | + | headers: |
- | '*/*': | + | authorization: |
+ | description: Token de sesión del usuario | ||
schema: | schema: | ||
type: string | type: string | ||
- | 201: | + | authorization_app: |
- | description: Created | + | description: Token de la aplicación asociada al path recibido en el request |
- | content: {} | + | schema: |
- | 401: | + | type: string |
- | description: Unauthorized | + | content: |
- | content: {} | + | application/json: |
- | 403: | + | schema: |
+ | $ref: '#/components/schemas/EstadoTransaccion' | ||
+ | '403': | ||
description: Forbidden | description: Forbidden | ||
- | content: {} | + | content: |
- | 404: | + | application/json: |
- | description: Not Found | + | schema: |
- | content: {} | + | $ref: '#/components/schemas/EstadoTransaccion' |
- | x-codegen-request-body-name: sessionLog | + | '500': |
- | /session/{id}: | + | description: Internal Server Error |
- | put: | + | content: |
+ | application/json: | ||
+ | schema: | ||
+ | $ref: '#/components/schemas/EstadoTransaccion' | ||
+ | /portalws/factura/: | ||
+ | post: | ||
tags: | tags: | ||
- | - session-log-app | + | - portal-ws |
- | summary: updateRegister | + | summary: consultaFacturasPortalContribuyente |
- | operationId: updateRegisterUsingPUT | + | operationId: consultaFacturasPortalContribuyentePOST |
- | parameters: | + | |
- | - name: id | + | |
- | in: path | + | |
- | description: id | + | |
- | required: true | + | |
- | schema: | + | |
- | type: string | + | |
requestBody: | requestBody: | ||
- | description: sessionLog | + | description: Parámetros de consulta |
content: | content: | ||
application/json: | application/json: | ||
schema: | schema: | ||
- | $ref: '#/components/schemas/SessionLog' | + | $ref: '#/components/schemas/ConsultaInformacion' |
- | required: true | + | |
- | responses: | + | |
- | 200: | + | |
- | description: OK | + | |
- | content: | + | |
- | '*/*': | + | |
- | schema: | + | |
- | $ref: '#/components/schemas/SessionLog' | + | |
- | 201: | + | |
- | description: Created | + | |
- | content: {} | + | |
- | 401: | + | |
- | description: Unauthorized | + | |
- | content: {} | + | |
- | 403: | + | |
- | description: Forbidden | + | |
- | content: {} | + | |
- | 404: | + | |
- | description: Not Found | + | |
- | content: {} | + | |
- | x-codegen-request-body-name: sessionLog | + | |
- | /transactional/getRegisters: | + | |
- | get: | + | |
- | tags: | + | |
- | - transactional-log-app | + | |
- | summary: getRegisters | + | |
- | operationId: getRegistersUsingGET_3 | + | |
parameters: | parameters: | ||
- | - name: codigoUsuario | + | - name: authorization |
- | in: query | + | in: header |
- | description: codigoUsuario | + | required: true |
- | schema: | + | description: Token de aplicacion |
- | type: integer | + | schema: |
- | format: int64 | + | type: string |
- | - name: id | + | |
- | in: query | + | |
- | description: id | + | |
- | schema: | + | |
- | type: integer | + | |
- | format: int64 | + | |
- | - name: logColumn | + | |
- | in: query | + | |
- | description: logColumn | + | |
- | schema: | + | |
- | type: string | + | |
- | - name: logTabla | + | |
- | in: query | + | |
- | description: logTabla | + | |
- | schema: | + | |
- | type: string | + | |
- | - name: nitEmpresa | + | |
- | in: query | + | |
- | description: nitEmpresa | + | |
- | schema: | + | |
- | type: integer | + | |
- | format: int64 | + | |
- | - name: nombreProceso | + | |
- | in: query | + | |
- | description: nombreProceso | + | |
- | schema: | + | |
- | type: string | + | |
responses: | responses: | ||
- | 200: | + | '200': |
description: OK | description: OK | ||
+ | headers: | ||
+ | authorization: | ||
+ | description: Token de sesión del usuario | ||
+ | schema: | ||
+ | type: string | ||
content: | content: | ||
- | '*/*': | + | application/json: |
schema: | schema: | ||
type: array | type: array | ||
items: | items: | ||
- | $ref: '#/components/schemas/TransactionalLog' | + | $ref: '#/components/schemas/TipoNotificacionRespuestas' |
- | 401: | + | '204': |
- | description: Unauthorized | + | description: No Content |
- | content: {} | + | content: |
- | 403: | + | application/json: |
+ | schema: | ||
+ | $ref: '#/components/schemas/EstadoTransaccion' | ||
+ | '403': | ||
description: Forbidden | description: Forbidden | ||
- | content: {} | + | content: |
- | 404: | + | application/json: |
- | description: Not Found | + | schema: |
- | content: {} | + | $ref: '#/components/schemas/EstadoTransaccion' |
- | /transactional/save: | + | '500': |
+ | description: Internal Server Error | ||
+ | content: | ||
+ | application/json: | ||
+ | schema: | ||
+ | $ref: '#/components/schemas/EstadoTransaccion' | ||
+ | /portalws/acuerdos/: | ||
post: | post: | ||
tags: | tags: | ||
- | - transactional-log-app | + | - portal-ws |
- | summary: saveTransactional | + | summary: consultaAcuerdosPortalContribuyente |
- | operationId: saveTransactionalUsingPOST | + | operationId: consultaAcuerdosPortalContribuyentePOST |
requestBody: | requestBody: | ||
- | description: log | + | description: Parámetros de consulta |
content: | content: | ||
application/json: | application/json: | ||
schema: | schema: | ||
- | $ref: '#/components/schemas/TransactionalLog' | + | $ref: '#/components/schemas/ConsultaInformacion' |
- | required: true | + | parameters: |
+ | - name: authorization | ||
+ | in: header | ||
+ | required: true | ||
+ | description: Token de aplicacion | ||
+ | schema: | ||
+ | type: string | ||
responses: | responses: | ||
- | 200: | + | '200': |
description: OK | description: OK | ||
- | content: | + | headers: |
- | '*/*': | + | authorization: |
+ | description: Token de sesión del usuario renovado | ||
schema: | schema: | ||
type: string | type: string | ||
- | 201: | + | content: |
- | description: Created | + | application/json: |
- | content: {} | + | schema: |
- | 401: | + | type: array |
- | description: Unauthorized | + | items: |
- | content: {} | + | $ref: '#/components/schemas/TipoNotificacionRespuestas' |
- | 403: | + | '204': |
+ | description: No Content | ||
+ | content: | ||
+ | application/json: | ||
+ | schema: | ||
+ | $ref: '#/components/schemas/EstadoTransaccion' | ||
+ | '403': | ||
description: Forbidden | description: Forbidden | ||
- | content: {} | + | content: |
- | 404: | + | application/json: |
- | description: Not Found | + | schema: |
- | content: {} | + | $ref: '#/components/schemas/EstadoTransaccion' |
- | x-codegen-request-body-name: log | + | '500': |
- | /transactional/{id}/getRegister: | + | description: Internal Server Error |
+ | content: | ||
+ | application/json: | ||
+ | schema: | ||
+ | $ref: '#/components/schemas/EstadoTransaccion' | ||
+ | /portalws/descargar/{authorization}/{authorization2}/{fuente}/{tipo_doc}: | ||
get: | get: | ||
tags: | tags: | ||
- | - transactional-log-app | + | - portal-ws |
- | summary: getRegisterById | + | summary: descargarDocumento |
- | operationId: getRegisterByIdUsingGET_1 | + | operationId: descargarDocumentoGET |
parameters: | parameters: | ||
- | - name: id | + | - name: authorization |
- | in: path | + | in: path |
- | description: id | + | required: true |
- | required: true | + | description: token de sesión de usuario |
- | schema: | + | schema: |
- | type: integer | + | type: string |
- | format: int64 | + | - name: authorization2 |
+ | in: path | ||
+ | required: true | ||
+ | description: token de único del documento | ||
+ | schema: | ||
+ | type: string | ||
+ | - name: fuente | ||
+ | in: path | ||
+ | required: true | ||
+ | description: token de único del documento | ||
+ | schema: | ||
+ | type: string | ||
+ | - name: tipo_doc | ||
+ | in: path | ||
+ | required: true | ||
+ | description: >- | ||
+ | Indica si el documento es un paz y salvo (pyz) o un documento de | ||
+ | cobro (fact) | ||
+ | schema: | ||
+ | type: string | ||
responses: | responses: | ||
- | 200: | + | '200': |
description: OK | description: OK | ||
+ | headers: | ||
+ | authorization: | ||
+ | description: Token de sesión del usuario renovado | ||
+ | schema: | ||
+ | type: string | ||
content: | content: | ||
- | '*/*': | + | application/pdf: |
schema: | schema: | ||
- | $ref: '#/components/schemas/TransactionalLog' | + | type: object |
- | 401: | + | '204': |
- | description: Unauthorized | + | description: NoContent |
- | content: {} | + | content: |
- | 403: | + | application/json: |
+ | schema: | ||
+ | $ref: '#/components/schemas/EstadoTransaccion' | ||
+ | '403': | ||
description: Forbidden | description: Forbidden | ||
- | content: {} | + | content: |
- | 404: | + | application/json: |
- | description: Not Found | + | schema: |
- | content: {} | + | $ref: '#/components/schemas/EstadoTransaccion' |
- | /upload/getRegisters: | + | '500': |
+ | description: Internal Server Error | ||
+ | content: | ||
+ | application/json: | ||
+ | schema: | ||
+ | $ref: '#/components/schemas/EstadoTransaccion' | ||
+ | /portalws/seguridad/cambio/solicitud/: | ||
get: | get: | ||
tags: | tags: | ||
- | - file-upload-log-controller | + | - portal-ws |
- | summary: getRegisters | + | summary: solicitarCambiarContrasenia |
- | operationId: getRegistersUsingGET | + | operationId: solicitarCambiarContraseniaGET |
parameters: | parameters: | ||
- | - name: id | + | - name: authorization |
- | in: query | + | in: header |
- | description: id | + | required: true |
- | schema: | + | description: token de sesión de usuario |
- | type: integer | + | schema: |
- | format: int32 | + | type: string |
- | default: 0 | + | - name: usuario |
- | - name: nombreArchivo | + | in: header |
- | in: query | + | required: true |
- | description: nombreArchivo | + | description: correo electrónico o nickname |
- | schema: | + | schema: |
- | type: integer | + | type: string |
- | format: int32 | + | |
- | default: 0 | + | |
- | - name: nombreProceso | + | |
- | in: query | + | |
- | description: nombreProceso | + | |
- | schema: | + | |
- | type: string | + | |
- | default: "0" | + | |
responses: | responses: | ||
- | 200: | + | '200': |
description: OK | description: OK | ||
+ | headers: | ||
+ | authorization: | ||
+ | description: Token de sesión del usuario renovado | ||
+ | schema: | ||
+ | type: string | ||
content: | content: | ||
- | '*/*': | + | application/json: |
schema: | schema: | ||
- | type: array | + | $ref: '#/components/schemas/EstadoTransaccion' |
- | items: | + | '204': |
- | $ref: '#/components/schemas/FileUploadLog' | + | description: NoContent |
- | 401: | + | content: |
- | description: Unauthorized | + | application/json: |
- | content: {} | + | schema: |
- | 403: | + | $ref: '#/components/schemas/EstadoTransaccion' |
+ | '403': | ||
description: Forbidden | description: Forbidden | ||
- | content: {} | + | content: |
- | 404: | + | application/json: |
- | description: Not Found | + | schema: |
- | content: {} | + | $ref: '#/components/schemas/EstadoTransaccion' |
- | /upload/save: | + | '500': |
- | post: | + | description: Internal Server Error |
+ | content: | ||
+ | application/json: | ||
+ | schema: | ||
+ | $ref: '#/components/schemas/EstadoTransaccion' | ||
+ | /portalws/seguridad/cambio/completar/: | ||
+ | get: | ||
tags: | tags: | ||
- | - file-upload-log-controller | + | - portal-ws |
- | summary: saveSessionLog | + | summary: cambiarContrasenia |
- | operationId: saveSessionLogUsingPOST | + | operationId: cambiarContraseniaGET |
- | requestBody: | + | parameters: |
- | description: sessionLog | + | - name: authorization |
- | content: | + | in: header |
- | application/json: | + | required: true |
- | schema: | + | description: token de sesión de usuario |
- | $ref: '#/components/schemas/FileUploadLog' | + | schema: |
- | required: true | + | type: string |
+ | - name: password | ||
+ | in: header | ||
+ | required: true | ||
+ | description: nuevo password | ||
+ | schema: | ||
+ | type: string | ||
responses: | responses: | ||
- | 200: | + | '200': |
description: OK | description: OK | ||
+ | headers: | ||
+ | authorization: | ||
+ | description: Token de sesión del usuario renovado | ||
+ | schema: | ||
+ | type: string | ||
content: | content: | ||
- | '*/*': | + | application/json: |
schema: | schema: | ||
- | type: integer | + | $ref: '#/components/schemas/EstadoTransaccion' |
- | format: int32 | + | '204': |
- | 201: | + | description: NoContent |
- | description: Created | + | content: |
- | content: {} | + | application/json: |
- | 401: | + | schema: |
- | description: Unauthorized | + | $ref: '#/components/schemas/EstadoTransaccion' |
- | content: {} | + | '403': |
- | 403: | + | |
description: Forbidden | description: Forbidden | ||
- | content: {} | + | content: |
- | 404: | + | application/json: |
- | description: Not Found | + | schema: |
- | content: {} | + | $ref: '#/components/schemas/EstadoTransaccion' |
- | x-codegen-request-body-name: sessionLog | + | '500': |
+ | description: Internal Server Error | ||
+ | content: | ||
+ | application/json: | ||
+ | schema: | ||
+ | $ref: '#/components/schemas/EstadoTransaccion' | ||
components: | components: | ||
schemas: | schemas: | ||
- | FileUploadLog: | + | Parametros: |
- | title: FileUploadLog | + | title: Parametros |
type: object | type: object | ||
properties: | properties: | ||
- | codigoAplicacion: | + | error: |
- | type: integer | + | type: boolean |
- | format: int32 | + | codigoMensaje: |
- | codigoMEmpresa: | + | |
type: string | type: string | ||
- | codigoUsuario: | + | mensaje: |
+ | type: string | ||
+ | totalRegistros: | ||
type: integer | type: integer | ||
- | format: int32 | + | payload: |
- | columnaGrupo: | + | type: array |
+ | items: | ||
+ | $ref: '#/components/schemas/Parametro' | ||
+ | Aplicaciones: | ||
+ | title: Aplicaciones | ||
+ | type: object | ||
+ | properties: | ||
+ | error: | ||
+ | type: boolean | ||
+ | codigoMensaje: | ||
type: string | type: string | ||
- | fecha: | + | mensaje: |
type: string | type: string | ||
- | format: date-time | + | totalRegistros: |
- | fechaRegistro: | + | type: integer |
+ | payload: | ||
+ | type: array | ||
+ | items: | ||
+ | $ref: '#/components/schemas/Aplicacion' | ||
+ | Usuarios: | ||
+ | title: Usuarios | ||
+ | type: object | ||
+ | properties: | ||
+ | error: | ||
+ | type: boolean | ||
+ | codigoMensaje: | ||
type: string | type: string | ||
- | format: date-time | + | mensaje: |
- | hostCliente: | + | |
type: string | type: string | ||
- | id: | + | totalRegistros: |
type: integer | type: integer | ||
- | format: int32 | + | payload: |
- | infoApp: | + | type: array |
+ | items: | ||
+ | $ref: '#/components/schemas/Usuario' | ||
+ | TipoNotificacionRespuestas: | ||
+ | title: TipoNotificacionRespuestas | ||
+ | type: object | ||
+ | properties: | ||
+ | error: | ||
+ | type: boolean | ||
+ | codigoMensaje: | ||
+ | type: string | ||
+ | mensaje: | ||
type: string | type: string | ||
- | nitEmpresa: | + | totalRegistros: |
+ | type: integer | ||
+ | payload: | ||
+ | type: array | ||
+ | items: | ||
+ | $ref: '#/components/schemas/TipoNotificacionRespuesta' | ||
+ | Parametro: | ||
+ | title: Parametro | ||
+ | type: object | ||
+ | properties: | ||
+ | id: | ||
type: integer | type: integer | ||
format: int64 | format: int64 | ||
- | nombreArchivo: | + | description: Identificador del registro |
+ | nombre: | ||
type: string | type: string | ||
- | nombreProceso: | + | description: Nombre del parámetro |
+ | tipo: | ||
type: string | type: string | ||
- | notificacion: | + | description: Tipo de parámetro |
+ | valor: | ||
type: string | type: string | ||
- | numeroLinea: | + | description: Valor del parámetro |
- | type: integer | + | descripcion: |
- | format: int32 | + | |
- | sessionBrowserVersion: | + | |
- | type: string | + | |
- | sessionMac: | + | |
- | type: string | + | |
- | sessionOstype: | + | |
type: string | type: string | ||
- | MovLogErrores: | + | description: Descripción del parámetro |
- | title: MovLogErrores | + | idAplicacion: |
+ | type: integer | ||
+ | format: int64 | ||
+ | description: Identificador de la aplicación propietaria del parámetro | ||
+ | Aplicacion: | ||
+ | title: Aplicacion | ||
type: object | type: object | ||
properties: | properties: | ||
- | codRacle: | + | id: |
type: integer | type: integer | ||
- | format: int32 | + | format: int64 |
- | codigoAplicacion: | + | description: Identificador del registro |
+ | nombre: | ||
type: string | type: string | ||
- | codigoEmpresa: | + | description: Nombre de la aplicación o cliente |
+ | token: | ||
type: string | type: string | ||
- | codigoInterno: | + | fechaVigencia: |
- | type: integer | + | |
- | format: int32 | + | |
- | codigoUsuario: | + | |
- | type: integer | + | |
- | format: int64 | + | |
- | errorLog: | + | |
type: string | type: string | ||
- | errorType: | + | format: date |
+ | description: Fecha hasta la que estará vigente el acceso del cliente al portal | ||
+ | esInterna: | ||
type: string | type: string | ||
- | fecha: | + | description: Indica si la aplicación es interna o del sistema S o es un cliente N |
+ | estado: | ||
type: string | type: string | ||
- | format: date-time | + | description: >- |
- | fechaRegistro: | + | Indica el estado de la aplicación A, I o S (Activa, Inactiva o |
+ | Suspendida) | ||
+ | Usuario: | ||
+ | title: Usuario | ||
+ | type: object | ||
+ | properties: | ||
+ | id: | ||
+ | type: integer | ||
+ | format: int64 | ||
+ | description: Identificador del registro | ||
+ | numeroDocumento: | ||
type: string | type: string | ||
- | format: date-time | + | description: Número de documento del usuario |
- | hostCliente: | + | nombre: |
type: string | type: string | ||
- | infoApp: | + | description: Nombre del usuario |
+ | correoElectronico: | ||
type: string | type: string | ||
- | msjRacle: | + | description: Correo electrónico del usuario. Nickname de la cuenta de usuario |
+ | direccion: | ||
type: string | type: string | ||
- | nitEmpresa: | + | description: Dirección física del usuario |
- | type: integer | + | telefono: |
- | format: int64 | + | |
- | nomProcedimiento: | + | |
type: string | type: string | ||
- | observacion: | + | description: Número telefónico principal del usuario |
+ | telefonoAlterno: | ||
type: string | type: string | ||
- | sessionBrowserVersion: | + | description: Número telefónico alterno del usuario |
+ | token: | ||
type: string | type: string | ||
- | sessionMac: | + | ultimoIngreso: |
type: string | type: string | ||
- | sessionOstype: | + | format: date-time |
+ | description: Fecha del último ingreso del usuario al sistema | ||
+ | tokenVigencia: | ||
type: string | type: string | ||
- | usuarioBD: | + | format: date-time |
+ | description: Fecha de vigencia del token de sesión | ||
+ | aceptaNotificacionElectronica: | ||
+ | type: boolean | ||
+ | description: Indica si el usuario recibe notificaciones elctrónicas | ||
+ | estado: | ||
type: string | type: string | ||
- | SessionLog: | + | description: Indica el estado del usuario P, *, -, M, D, I, A, S, Z, R, V, O, B |
- | title: SessionLog | + | TipoNotificacionRespuesta: |
+ | title: TipoNotificacionRespuesta | ||
type: object | type: object | ||
properties: | properties: | ||
- | codigoAplicacion: | + | id: |
type: integer | type: integer | ||
format: int64 | format: int64 | ||
- | codigoDependencia: | + | description: Identificador del registro |
+ | urlPago: | ||
+ | type: string | ||
+ | format: url | ||
+ | description: URL de la pasarela de pagos en línea | ||
+ | respuestas: | ||
+ | type: array | ||
+ | items: | ||
+ | $ref: '#/components/schemas/ConsultaInformacionRespuesta' | ||
+ | ConsultaInformacionRespuesta: | ||
+ | title: ConsultaInformacionRespuesta | ||
+ | type: object | ||
+ | properties: | ||
+ | id: | ||
type: integer | type: integer | ||
format: int64 | format: int64 | ||
- | codigoEmpresa: | + | description: Identificador del registro |
- | type: number | + | consecutivo: |
- | format: double | + | |
- | codigoUsuario: | + | |
type: integer | type: integer | ||
format: int64 | format: int64 | ||
- | fechaLogout: | + | description: Consecutivo del documento de cobro |
+ | idDocumento: | ||
+ | type: integer | ||
+ | format: int64 | ||
+ | description: Identificador del documento de cobro (id factura) | ||
+ | idTipoNotificacion: | ||
+ | type: integer | ||
+ | format: int64 | ||
+ | description: Identificador del tipo de documento | ||
+ | idFormaPago: | ||
+ | type: integer | ||
+ | format: int64 | ||
+ | description: Identificador de la forma de pago | ||
+ | formaPago: | ||
type: string | type: string | ||
- | format: date-time | + | description: Forma de pago |
- | fechaRegistro: | + | valor: |
+ | type: integer | ||
+ | format: int64 | ||
+ | description: Valor del documento de cobro | ||
+ | fechaElaboracion: | ||
type: string | type: string | ||
- | format: date-time | + | format: date |
- | fechaSessionActiva: | + | description: Fecha de elaboración del documento de cobro |
+ | fechaVencimiento: | ||
type: string | type: string | ||
- | format: date-time | + | format: date |
- | id: | + | description: Fecha de vencimiento del documento de cobro |
+ | token: | ||
type: string | type: string | ||
- | nitEmpresa: | + | description: Token generado para la identificación segura del documento |
- | type: integer | + | objeto: |
- | format: int64 | + | |
- | sessionBrowserVersion: | + | |
type: string | type: string | ||
- | sessionId: | + | description: >- |
+ | Identificador del objeto conocido por el usuario (cédula catastral, | ||
+ | placa, línea teleónica, etc.) | ||
+ | estado: | ||
type: string | type: string | ||
- | sessionMac: | + | description: Estado del documento de cobro (cancelado, pendiente de pago, etc.) |
+ | vigencia: | ||
type: string | type: string | ||
- | sessionOsType: | + | description: Vigencia del documento de cobro, formato yyyy |
+ | icono: | ||
type: string | type: string | ||
- | tipoApp: | + | description: Imagen o ícono que representa el tipo de documento |
+ | tipo: | ||
type: string | type: string | ||
- | tipoRegistro: | + | description: >- |
+ | Descripción del tipo de documento (Vehículo particula, Lote, | ||
+ | Discoteca, etc.) | ||
+ | datoAdicional: | ||
type: string | type: string | ||
- | usuarioDb: | + | description: Información adicional del objeto. Dirección, referencias, etc |
+ | urlPago: | ||
type: string | type: string | ||
- | TransactionalLog: | + | description: URL de pago única para este documento de cobro en referencia. |
- | title: TransactionalLog | + | urlDocumento: |
+ | type: string | ||
+ | description: URL para descargar el documento de cobro. | ||
+ | urlPazYSalvo: | ||
+ | type: string | ||
+ | description: URL para descargar el documento de paz y salvo. | ||
+ | urlResolucion: | ||
+ | type: string | ||
+ | description: >- | ||
+ | URL para descargar el documento de resolución asociado a la | ||
+ | facturación del periodo. | ||
+ | idPazYSalvo: | ||
+ | type: integer | ||
+ | format: int64 | ||
+ | description: Identificador del documento de paz y salvo | ||
+ | deudaTotal: | ||
+ | type: integer | ||
+ | format: int64 | ||
+ | description: Valor de la deuda total (Aplica para acuerdos de pago) | ||
+ | valorPagado: | ||
+ | type: integer | ||
+ | format: int64 | ||
+ | description: Valor total de los pagos anteriores (Aplica para acuerdos de pago) | ||
+ | deudaActual: | ||
+ | type: integer | ||
+ | format: int64 | ||
+ | description: Deuda total actual (Aplica para acuerdos de pago) | ||
+ | proximoPago: | ||
+ | type: integer | ||
+ | format: int64 | ||
+ | description: Valor total de los próximos pagos (Aplica para acuerdos de pago) | ||
+ | pagos: | ||
+ | type: array | ||
+ | items: | ||
+ | $ref: '#/components/schemas/ConsultaInformacionRespuestaPagos' | ||
+ | description: Listado de pagos aplicados (Aplica para acuerdos de pago) | ||
+ | pendientes: | ||
+ | type: array | ||
+ | items: | ||
+ | $ref: '#/components/schemas/ConsultaInformacionRespuestaPendiente' | ||
+ | description: Listado de cuotas pendientes (Aplica para acuerdos de pago) | ||
+ | ConsultaInformacionRespuestaPagos: | ||
+ | title: ConsultaInformacionRespuestaPagos | ||
type: object | type: object | ||
properties: | properties: | ||
- | codigoAplicacion: | + | id: |
type: integer | type: integer | ||
format: int64 | format: int64 | ||
- | codigoEmpresa: | + | description: Identificador del registro |
- | type: string | + | idCuota: |
- | codigoUsuario: | + | type: integer |
+ | format: int64 | ||
+ | description: Número de cuota (1, 2, 3, etc.) | ||
+ | referencia: | ||
type: integer | type: integer | ||
format: int64 | format: int64 | ||
- | fecha: | + | description: Referencia de pago (comprobante de ingreso) |
- | type: string | + | fechaPago: |
- | format: date-time | + | |
- | fechaRegistro: | + | |
- | type: string | + | |
- | format: date-time | + | |
- | hostCliente: | + | |
type: string | type: string | ||
+ | format: date | ||
+ | description: Fecha en que se aplicó el pago | ||
+ | valor: | ||
+ | type: integer | ||
+ | format: int64 | ||
+ | description: Valor pagado | ||
+ | ConsultaInformacionRespuestaPendiente: | ||
+ | title: ConsultaInformacionRespuestaPendiente | ||
+ | type: object | ||
+ | properties: | ||
id: | id: | ||
type: integer | type: integer | ||
format: int64 | format: int64 | ||
- | infoApp: | + | description: Identificador del registro |
+ | idCuota: | ||
+ | type: integer | ||
+ | format: int64 | ||
+ | description: Número de cuota (1, 2, 3, etc.) | ||
+ | fechaVencimiento: | ||
type: string | type: string | ||
- | logColumna: | + | format: date |
- | type: string | + | description: Fecha de vencimiento de la cuota |
- | logPeticion: | + | valor: |
+ | type: integer | ||
+ | format: int64 | ||
+ | description: Valor por pagar | ||
+ | deudaTotal: | ||
+ | type: integer | ||
+ | format: int64 | ||
+ | description: Deuda total al momento de la cuota | ||
+ | valorPagado: | ||
+ | type: integer | ||
+ | format: int64 | ||
+ | description: Valor pagado al momento de la cuota | ||
+ | deudaActual: | ||
+ | type: integer | ||
+ | format: int64 | ||
+ | description: Deuda actual al momento de la cuota | ||
+ | proximoPago: | ||
+ | type: integer | ||
+ | format: int64 | ||
+ | description: Valor próximos pagos al momento de la cuota | ||
+ | ConsultaInformacion: | ||
+ | title: ConsultaInformacion | ||
+ | type: object | ||
+ | properties: | ||
+ | estado: | ||
type: string | type: string | ||
- | logTabla: | + | description: Estado del documento de cobro. Se aceptan sólo dos estados P o C |
+ | numeroDocumento: | ||
type: string | type: string | ||
- | logValorAct: | + | description: Número de documento del usuario |
- | type: string | + | vigencia: |
- | logValorAnt: | + | |
- | type: string | + | |
- | loginUsuario: | + | |
- | type: string | + | |
- | nitEmpresa: | + | |
type: integer | type: integer | ||
format: int64 | format: int64 | ||
- | nombreProceso: | + | description: Vigencia del documento de cobro |
+ | EstadoTransaccion: | ||
+ | title: EstadoTransaccion | ||
+ | type: object | ||
+ | properties: | ||
+ | error: | ||
+ | type: boolean | ||
+ | description: Indica si hubo un error en el procesamiento de la solicitud del usuario | ||
+ | codigoMensaje: | ||
type: string | type: string | ||
- | sessionBrowserVersion: | + | description: Código HTML que se generó para la respuesta de la petición |
+ | mensaje: | ||
type: string | type: string | ||
- | sessionMac: | + | description: Mensaje generado para informar al usuario la respuesta de su petición |
- | type: string | + | mensajeTecnico: |
- | sessionOsType: | + | |
- | type: string | + | |
- | tipoTransaccion: | + | |
type: string | type: string | ||
+ | description: Mensaje técnico con el eventual error presentado generado para informar al cliente consumidor del servicio | ||
+ | totalRegistros: | ||
+ | type: integer | ||
+ | description: Total registros devueltos en el primer arreglo de la respuesta (payload) | ||
</code> | </code> | ||