Quick start

Estándares técnicos#

La siguiente tabla resume los principales estándares tecnológicos utilizados:

CaracterísticaDescripción
Servidor de aplicacionesJetty
Protocolo de InternetTLS v1.1 ou TLS v1.
AutenticaciónBasic Authentication
Patrón de intercambio de mensajesREST
Patrón de mensajeJSON
ProcessamentoSíncrono

Autenticación y autorización en el WebService#

Para autenticarse en Query WebService, es necesario enviar TODAS las solicitudes de autenticación del tipo: Basic Authentication, donde el nombre de usuario y la contraseña utilizados serán los mismos que se utilizaron para acceder a SiTef- Conciliación.

El login enviado se utilizará como filtro para todas las solicitudes. En otras palabras, Si login no enviado tener permiso para resolver problemas pendientes (Niveles de "Operador de informes" Tienda o Sede, por ejemplo), no se devolverán artículos pendientes.

Además, solo se devolverán las transacciones de las tiendas asociadas con el inicio de sesión enviado y sus respectivos asuntos pendientes tratados. En otras palabras, si el login enviado solo tiene permitido acceder a una única tienda, solo se devolverán las transacciones de esta tienda y solo estas transacciones se pueden manejar.

Y al utilizar la consulta en la plataforma SiTef GW / Express, la misma regla de la tienda se aplicará a los clientes. Solo se devolverán las transacciones del cliente relacionadas con el login enviado si el parámetro del cliente no ha sido enviado.

Servicios#

El WebService de Consulta proporcionará las siguientes características:

  • Consulta por transacción
  • Consulta de transacciones pendientes
  • Cancelación de transacción pendiente
  • Confirmação de Transação Pendente
  • Consultar transacciones por fecha
  • Consultar transacciones por fecha de exportación
  • Consultar transacciones por BIN
  • Transacciones de reversión de consultas
  • Transacciones de reversión de consultas por fecha
  • Versión

El flujo de comunicación siempre lo inicia el sistema integrador / cliente enviando un mensaje a WSConsulta, solicitando la funcionalidad deseada.

La solicitud se atenderá en la misma conexión. (todos los servicios serán sincrónicos). En otras palabras, el el procesamiento de la orden de servicio se completa en la misma conexión, con devolver un mensaje JSON que contiene la declaración de procesamiento.

URL básica para acceder al servicio:

https://identificador_do_serviço/