Ir al contenido principal

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

No hay comentarios para mostrar

Volver arriba