Cambio de cuenta bancaria(Solicitar cambio de cuenta (1)) - [store]

🧾 Descripción 

 Registra una nueva solicitud de cambio de cuenta bancaria para un empleado, validando previamente: 

 

 

 Que la información esté completa. 

 

 

 Que el formato del número de cuenta coincida con las reglas del banco seleccionado. 

 

 

 Que el empleado no tenga ya una solicitud en estado Borrador . 

 

 

 Que se adjunte el documento de acreditación de la nueva cuenta bancaria. 

 

 

 Si todo es correcto, crea un nuevo documento en el ERP:  Cambio de Cuenta Bancaria 

 

 🚀 Endpoint 

 POST /cambio-cuenta-bancaria/store 

 

 📥 Request Body 

 

 

 

 

 

 

 

 { 

 "empleado" : "EMP-0001" , 

 "nuevo_banco" : "Banco de Crédito del Perú" , 

 "nueva_cuenta_bancaria" : "12345678901234" , 

 "documento_cuenta" : "/files/archivo.pdf" 

 } 

 

 

 

 

 

 

 

 

 Campos requeridos 

 

 

 

 

 

 Campo 

 Tipo 

 Obligatorio 

 Descripción 

 

 

 

 

 empleado 

 string 

 ✔️ 

 ID del empleado 

 

 

 nuevo_banco 

 string 

 ✔️ 

 Nuevo banco elegido 

 

 

 nueva_cuenta_bancaria 

 string 

 ✔️ 

 Número de cuenta del nuevo banco 

 

 

 documento_cuenta 

 string 

 ✔️ 

 Archivo previamente cargado en ERP 

 

 

 

 

 

 

 🔐 Seguridad 

 Requiere autenticación interna mediante ServiceErp() y dbErp() hacia el ERP corporativo. 

 

 🧠 Flujo del Servicio (resumen real) 

 1. Validaciones iniciales 

 

 

 Verifica que todos los campos obligatorios estén presentes. 

 

 

 Valida longitud del número de cuenta según el banco: 

 

 

 

 

 

 

 

 Banco 

 Longitudes válidas 

 

 

 

 

 BCP 

 14 o 20 

 

 

 BBVA 

 16, 18 o 20 

 

 

 Interbank 

 18 o 20 

 

 

 Otros 

 20 

 

 

 

 

 

 Si no cumple → devuelve error. 

 

 2. Verifica si el empleado ya tiene una solicitud en estado Borrador 

 Se consulta en el ERP: 

 

 

 

 

 

 

 

 GET Cambio de Cuenta Bancaria 

 filters = [[ "empleado" , "=" , empleado],[ "docstatus" , "=" , 0 ]] 

 

 

 

 

 

 

 

 

 Si ya existe un documento en borrador → error. 

 

 3. Registrar la nueva solicitud 

 Si no existe borrador, crea el documento: 

 

 

 

 

 

 

 

 POST resource/Cambio de Cuenta Bancaria

{

 "empleado" : empleado,

 "nombre_de_banco_nuevo" : nuevo_banco,

 "nuevo_num_de_cuenta_bancaria" : nueva_cuenta_bancaria,

 "documento_cuenta" : documento_cuenta

} 

 

 

 

 

 

 

 

 

 

 📤 Response 200 – Éxitoso 

 

 

 

 

 

 

 

 { 

 "valor" : true , 

 "msn" : "Registrado con éxito" , 

 "response" : { 

 "name" : "CCB-000123" , 

 "empleado" : "EMP-0001" , 

 "nombre_de_banco_nuevo" : "Banco de Crédito del Perú" , 

 "nuevo_num_de_cuenta_bancaria" : "12345678901234" 

 } 

 } 

 

 

 

 

 

 

 

 

 

 ❗ Posibles Errores 

 1. Falta un dato obligatorio 

 

 

 

 

 

 

 

 { 

 "valor" : false , 

 "msn" : "Debe adjuntar un documento de acreditación de cuenta bancaria" 

 } 

 

 

 

 

 

 

 

 

 2. Número de cuenta inválido 

 

 

 

 

 

 

 

 { 

 "valor" : false , 

 "msn" : "Cantidad de dígitos de número de cuenta incorrecto" 

 } 

 

 

 

 

 

 

 

 

 3. Ya existe solicitud en borrador 

 

 

 

 

 

 

 

 { 

 "valor" : false , 

 "msn" : "Ya cuenta con una solicitud en Borrador pendiente de validar" 

 } 

 

 

 

 

 

 

 

 

 4. Error al registrar en ERP 

 

 

 

 

 

 

 

 { 

 "valor" : false , 

 "msn" : "Ocurrió un error al registrar el cambio de cuenta bancaria" , 

 "error" : { ... } 

 } 

 

 

 

 

 

 

 

 

 

 📚 Schemas utilizados 

 Cambio de Cuenta Bancaria (POST) 

 

 

 

 

 

 

 

 { 

 "empleado" : "string" , 

 "nombre_de_banco_nuevo" : "string" , 

 "nuevo_num_de_cuenta_bancaria" : "string" , 

 "documento_cuenta" : "string" 

 } 

 

 

 

 

 

 

 

 

 Consulta de solicitudes 

 

 

 

 

 

 

 

 { 

 "name" : "string" 

 } 

 

 

 

 

 

 

 

 

 

 🗃 Lógica en pseudo-código 

 

 

 

 

 

 

 

 if faltan_datos:

 return error

validar_longitud_segun_banco()

buscar_borrador = GET CambioCuentaBancaria where empleado and docstatus=0

if existe_borrador:

 return error "Ya cuenta con una solicitud"

crear_documento = POST CambioCuentaBancaria {

 empleado,

 banco,

 cuenta,

 documento

}

return éxito