Guía de Conexión IMPORTANTE: El protocolo correcto del endpoint para generar el token es: https. El token que se obtiene en el acuse una vez que se acepta el uso de la API en el portal de REDECO, es único para cada Entidad Financiera y no tiene vencimiento. Descripción de los procedimientos Los usuarios de REDECO tendrán que considerar los siguientes aspectos para el uso de la API: -Cada área de desarrollo de las instituciones financieras deberá decidir la herramienta que utilizarán para establecer la comunicación con la API y puedan consumirla a manera de prueba. Algunos ejemplos son: Postman, Swagger, Mabl, Sandbox, Hurl, etc. El URL definitivo para la API de REDECO, en ambiente de producción, será el siguiente: https://api-redeco.condusef.gob.mx Aclarando que por el momento se encuentra desactivado y que una vez finalizado el periodo de pruebas, estará disponible para las Entidades Financieras. -Se comparten los "endpoint" para realizar la conexión: NOTA: LOS SIGUIENTES EJEMPLOS DE PRUEBA SE REALIZARON CON LA HERRAMIENTA POSTMAN Creación de Súper Usuario POST api.condusef.gob.mx/auth/users/create-super-user/ { "key": "921212127|403243543|40011212127|NO|NO", "username": "superuserprueba", "password": "1234", "confirm_password": "1234" } La estructura tendrá que tener el siguiente formato: { "key": Clave de acceso que se proporciona desde el sistema REDECO. "username": Nombre del súper usuario. "password": Contraseña. "confirm_password": Confirmar la contraseña. } Cuando se realice correctamente el envío de cada uno de los campos, obtendremos una respuesta que contiene el “token_access”: { "message": "El usuario ha sido creado exitosamente!", "data": { "userid": "fbbd9f4f-3cd1-413a-b958-2ec78f35c459", "username": "superusertest", "password": "$2a$10$x0N5M1qtIhkBkgjshuohQu/HvmGndog0vBRqYfhQAyAI.6ggr1Mee", "institucionid": "D2FDFDFF-F622-4BDC-9ECB-BF7B3D62", "is_active": "true", "profileid": "2" "token_access": "eyJhbGciOiJIUz" } } El "token_access" nos permitirá la autenticación en cada uno de los endpoints correspondientes. Creación de Usuario POST api.condusef.gob.mx/auth/users/create-user/ En Headers daremos la autorizacion (Authorization) y deberá integrarse el token access que se generó. Key Value Description Authorization (Token generado por usuario) En body tendrémos los siguientes campos: { "username": Nombre de usuario que tendrá acceso. "password": Contraseña. "confirm_password": Confirmar contraseña. } Modificaremos los campos de acuerdo con los datos requeridos: { "username": "userprueba", "password": "1234", "confirm_password": "1234" } La creación de Superusuario y de Usuarios estará disponible durante los primeros 5 días hábiles de cada mes en ambiente productivo, y en todo momento en ambiente de pruebas y podrán ser utilizados en el ambiente de producción. Renovación de Token GET api.condusef.gob.mx/auth/users/token/ En body tendrémos los siguientes campos: { "username": Nombre de usuario. "password": Contraseña. } Modificaremos los campos de acuerdo con los datos requeridos: { "username": "superuserprueba", "password": "1234", } Cuando se realice correctamente el envío de cada uno de los campos, obtendremos una respuesta que contiene el “token_access”: { "msg": "Login exitoso!!!", "user": { "token_access": "fbbd9f4f-3cd1-413a-b958-2ec78f35c459", "username": "superuserprueba", } } NOTA: Todo token Access generado tiene una vigencia de 30 días naturales. Es responsabilidad de cada Institución Financiera hacer el resguardo de esta información. Envío de quejas POST api.condusef.gob.mx/redeco/quejas En Headers daremos la autorizacion (Authorization) y deberá integrarse el token access que se generó. Key Value Description Authorization (Token generado por usuario) En body tendrémos los siguientes campos: { "QuejasDenominacion": Denominación o razón social. "QuejasSector": Sector. "QuejasNoMes": Mes a informar. "QuejasNum": Número de quejas. "QuejasFolio": Número de folio. "QuejasFecRecepcion": Fecha de la queja. "QuejasMedio": Medio de recepción o canal. "QuejasNivelAT": Nivel de atención o contacto. "QuejasProducto": Producto y/o Servicio. "QuejasCausa": Causa de la queja. "QuejasPORI": PORI. "QuejasEstatus": Estado. "QuejasEstados": Entidad Federativa. "QuejasMunId": Municipio o Alcaldía. "QuejasLocId": Localidad. "QuejasColId": Colonia. "QuejasCP": Código Postal. "QuejasTipoPersona": Tipo de persona. "QuejasSexo": Sexo. "QuejasEdad": Edad. "QuejasFecResolucion": Fecha de resolución. "QuejasFecNotificacion": Fecha en la que se notificó al usuario. "QuejasRespuesta": Sentido de la resolución. "QuejasNumPenal": Número de penalización. "QuejasPenalizacion": Tipo de penalización. } Modificaremos los campos de acuerdo con los datos requeridos: { "QuejasDenominacion": "CONDUSEF PRUEBAS, S.A. DE C.V.", "QuejasSector": "Sociedades Financieras de Objeto Múltiple E.N.R.", "QuejasNoMes": 3, "QuejasNum": 1, "QuejasFolio": "2024/REDECO/4731_ADA34", "QuejasFecRecepcion": "10/03/2024", "QuejasMedio": 1, "QuejasNivelAT": 4, "QuejasProducto": "126911811258", "QuejasCausa": "08777", "QuejasPORI": "SI", "QuejasEstatus": 2, "QuejasEstados": 4, "QuejasMunId": 2, "QuejasLocId": 9, "QuejasColId": 32, "QuejasCP": 24026, "QuejasTipoPersona": 1, "QuejasSexo": "M", "QuejasEdad": 18, "QuejasFecResolucion": "15/03/2024", "QuejasFecNotificacion": "15/03/2024", "QuejasRespuesta": 1, "QuejasNumPenal": 1, "QuejasPenalizacion": 1 } NOTA: En los casos en que no se cuente con información y el campo sea opcional, deberán enviar la palabra “null”. En la respuesta se obtendrá un status 200 si todo se envió de manera correcta: { "Número total de envios":1, "Quejas enviadas": [ "2024/REDECO/4731_CONDUSEF" ], "message": "Los registros mostrados arriba fueron adicionados." } Y se obtendrá un status 400 si existe algún dato con error: { "errors": { "2024/REDECO/4731_CONDUSEF": [ "Folio duplicado. Ya existe un folio 2024/REDECO/4731_CONDUSEF para la Institución Financiera y debe de ser único", "El campo Medio de recepción o canal es obligatorio. En el folio 2024/REDECO/4731_CONDUSEF.", "El campo Producto y/o servicio es obligatorio. En el folio 2024/REDECO/4731_CONDUSEF." ] }, "message": "Ninguno de los resgitros enviados fue adicionado hasta que se haga la corrección total de los folios." } Eliminar quejas DEL api.condusef.gob.mx/redeco/quejas/?quejaFolio=1010 PRUEBA1 En Headers daremos la autorizacion (Authorization) y deberá integrarse el token access que se generó. Key Value Description Authorization (Token generado por usuario) En Params pondremos el número del folio de la queja en valor (Value). Key Value Description quejaFolio 1010 PRUEBA1(número de folio de la queja) Consulta de quejas por mes y año GET api.condusef.gob.mx/redeco/quejas/?year=2024&month=1 (year=año de consulta, month=número de mes a consultar) Consulta de Catálogos de Medios de Recepción GET api.condusef.gob.mx/catalogos/medio-recepcion Consulta de catálogos de Niveles de Atención GET api.condusef.gob.mx/catalogos/niveles-atencion Consulta de catálogos de Lista de Productos GET api.condusef.gob.mx/catalogos/products-list Obtiene la lista de todos los productos de la institución financiera En Headers daremos la autorización (Authorization) y deberá integrarse el token access que se generó. Key Value Description Authorization (Token generado por usuario) Consulta de catálogos de Lista de Causas para la Institución Financiera elegida GET api.condusef.gob.mx/catalogos/causas-list/?product=027712411343 En Headers daremos la autorización (Authorization) y deberá integrarse el token access que se generó. Key Value Description Authorization (Token generado por usuario) Consulta de catálogos de Estados en SEPOMEX GET api.condusef.gob.mx/sepomex/estados/ Consulta de catálogos de Códigos Postales en SEPOMEX GET api.condusef.gob.mx/sepomex/codigos-postales/?estado_id=9 (estado_id=id correspondiente al estado) Consulta de catálogos de municipios en SEPOMEX GET api.condusef.gob.mx/sepomex/municipios/?estado_id=9&cp=05400 (estado_id= id correspondiente al estado, cp= número de código postal correspondiente) Consulta de catálogos de Colonias en SEPOMEX GET api.condusef.gob.mx/sepomex/colonias/?cp=05410 (cp= número de código postal correspondiente) Diccionario de datos Campo Descripción Tipo Dato Longitud máxima Dato requerido Información QuejasDenominacion Denominación o razón social Alfanumérico 400 SI Copiar y pegar el nombre completo tal cual como se muestra en SIPRES o REUNE. QuejasSector Sector al que pertenece la IF. Alfanumérico 200 SI Nombre del sector al que pertenece mi Institución Financiera. QuejasNoMes Mes a informar Numérico 2 SI 1= Enero; 2= Febrero; 3= Marzo; 4= Abril; 5= Mayo; 6= Junio; 7= Julio; 8= Agosto; 9= Septiembre; 10= Octubre; 11= Noviembre; 12= Diciembre. QuejasNum Número de quejas Numérico 1 SI Valor por default 1 QuejasFolio Número de folio Alfanumérico 50 SI QuejasFecRecepcion Fecha de la queja Fecha SI Formato: dd/mm/aaaa. Esta fecha debe estar dentro del mes a reportar. QuejasMedio Medio de recepción o canal Numérico 2 SI Clave de Medio de recepción (Ver catálogo) QuejasNivelAT Nivel de atención o contacto Numérico 2 SI Clave de Nivel de atención (Ver catálogo) QuejasProducto Producto y/o servicio Alfanumérico 12 SI QuejasCausa Causa de la queja Alfanumérico 4 SI QuejasPORI PORI Alfanumérico 2 SI Debe registrar "SI" o "NO" (Mayúsculas) QuejasEstatus Estado Numérico 1 SI 1 = Pendiente: Queja que no ha sido resuelta al Usuario por la Institución Financiera, dentro del mes a reportar; 2 = Concluido: Queja resuelta al Usuario por la Institución Financiera, dentro del mes a reportar. QuejasEstados Entidad federativa Numérico 2 SI Clave de Entidad federativa (Ver catálogo) QuejasMunId Municipio o Alcaldía Numérico 8 SI Clave del Municipio de acuerdo a la Entidad Federativa y Código Postal (Ver catálogo) QuejasLocId Localidad Numérico 8 Localidad de acuerdo a la Entidad Federativa (Ver catálogo) QuejasColId Colonia Numérico 8 SI Colonia de acuerdo a la Entidad Federativa (Ver catálogo) QuejasCP Código postal Numérico 10 SI Código Postal de acuerdo a la Entidad Federativa (Ver catálogo) QuejasTipoPersona Tipo de persona Numérico 1 SI 1 = Persona Física 2 = Persona Moral QuejasSexo Sexo Alfanumérico 1 H = HOMBRE M = MUJER (Solo para persona física, en caso de que lo tengan) QuejasEdad Edad Numérico 3 Solo para persona física (En caso de que lo tengan) QuejasFecResolucion Fecha de resolución Fecha Formato: dd/mm/aaaa. QuejasFecNotificacion Fecha en la que se notifico al usuario Fecha Formato: dd/mm/aaaa. QuejasRespuesta Sentido de la resolución Numérico 1 Cuando el estado de la queja sea igua a Concluido (2): 1 - Totalmente favorable al usuario 2 - Desfavorable al Usuario 3 - Parcialmente favorable al usuario y puede ser nulo si el Estado de la Queja es igual a (1) Pendiente QuejasNumPenal Número de penalización Numérico 4 Número de penalizaciones impuestas al despacho de cobranza QuejasPenalizacion Tipo de penalización Numérico 1 1 - Contractuales - Cancelación del contrato 2 - Contractuales - Reasignación de cartera 3 - Económicas - Multa