Se ha dispuesto de un método de configuración, setup, diseñado para configurar la url de callback sobre la que devolver los mensajes N43 y el modo en que se realizará dicha devolución.
El método aceptará una petición JSON que se utilizará para configurar los siguientes atributos de la integración:
URL Callback: Gestoría Virtual notificará al cliente de modo reactivo sobre todos los movimientos N43 recibidos por el sistema.
Transacciones en mensaje: Gestoría virtual permite la notificación de respuestas online o mediante la generación de un fichero de respuesta y facilitando una URL de descarga al cliente.
Parámetros
Tipo de dato
Requerido
Descripción
idCliente
Alfanumérico
Si
Identificador del cliente
urlCallback
Alfanumérico
Si
URL en la que Gestoría Virtual notificará los rechazos
transaccionesEnMensaje
Numérico
Si
Si el valor es 0, no se enviará el detalle de los rechazos en la llamada a la URL de Callback y se ofrecerán a través de un fichero de descarga. Cualquier otro valor indicará que las transacciones serán incluidas en la invocación.
Firma
Alfanumérico
Si
Cadena de firma de validación del mensaje
Respuesta del servicio
El servicio devolverá un código con un valor numérico que informará sobre el resultado dela petición:
Campo
Tipo de dato
Descripción
resultado
Numérico
Resultado de la petición
Los códigos que podrán ser devueltos son los siguientes:
Código
Descripción
0
Petición procesada correctamente
1000
URL de entrega no segura /incorrecta
9000
Petición errónea
9998
Firma del mensaje inválido
9999
Error no específicado
La firma se realizará de la siguiente manera.
Se concatenan todos los campos de la petición, en el siguiente orden:
idCliente
urlCallback
transaccionesEnMensaje
Además, se añade también, al final, la clave privada del cliente.
Se aplicará una función SHA-256 sobre la cadena anterior. El resultado será codificado en una
cadena hexadecimal y convertido a una cadena en mayúsculas.
Se aplicará una función SHA-256 sobre la cadena anterior. El resultado será codificado en una cadena hexadecimal y convertido a una cadena en mayúsculas.