Crear un banco
Crea un banco. El servidor guarda el registro con estado activo y asigna al usuario autenticado como creador. Devuelve el modelo creado.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»namestringobligatorioNombre del banco. Máximo 50 caracteres y único entre los bancos.
typestringobligatorioTipo de banco: físico o virtual (BankTypeEnum).
abbreviationstringobligatorioAbreviatura del banco. Máximo 10 caracteres y única.
locationstringobligatorioUbicación: nacional o extranjero (BankLocationEnum).
descriptionstringDescripción. Máximo 500 caracteres.
swift_codestringCódigo SWIFT. Entre 8 y 11 caracteres, solo letras y números.
business_advisor_namestringNombre del asesor de negocios. Máximo 100 caracteres.
business_advisor_emailstringCorreo del asesor de negocios. Debe ser un correo válido.
business_advisor_phonestringTeléfono del asesor de negocios. Debe ser numérico.
settingsobjectConfiguración del banco. Hoy solo se valida settings.color: un color hexadecimal de la forma #RRGGBB o vacío.
Permiso
Sección titulada «Permiso»cashbox.configuration.create, que se valida en BankPolicy::create. Ver Permisos y políticas.
curl -X POST \ "https://servererp.allendostmen.app/api/bank" \ -H "Authorization: Bearer $TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "name": "Banco de Crédito del Perú", "type": "físico", "abbreviation": "BCP", "location": "nacional", "swift_code": "BCPLPEPL", "settings": { "color": "#0055A4" }}'const response = await fetch( "https://servererp.allendostmen.app/api/bank", { method: "POST", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "name": "Banco de Crédito del Perú", "type": "físico", "abbreviation": "BCP", "location": "nacional", "swift_code": "BCPLPEPL", "settings": { "color": "#0055A4" } }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->post('https://servererp.allendostmen.app/api/bank', [ 'name' => 'Banco de Crédito del Perú', 'type' => 'físico', 'abbreviation' => 'BCP', 'location' => 'nacional', 'swift_code' => 'BCPLPEPL', 'settings' => [ 'color' => '#0055A4', ], ]);{ "id": 1, "name": "Banco de Crédito del Perú", "type": "físico", "abbreviation": "BCP", "location": "nacional", "description": null, "swift_code": "BCPLPEPL", "business_advisor_name": "Ana Torres", "business_advisor_email": "ana.torres@example.com", "business_advisor_phone": "987654321", "settings": { "color": "#0055A4" }, "status": "activo", "previous_status": null, "status_update_comment": null, "status_update_date": null, "status_update_user_id": null, "create_user_id": 1, "update_user_id": null, "delete_user_id": null, "restore_user_id": null, "restored_at": null, "created_at": "2026-11-19T10:40:15.000000Z", "updated_at": "2026-11-19T10:40:15.000000Z", "deleted_at": null}{ "message": "This action is unauthorized."}{ "message": "Este nombre de banco ya existe. Verifique o restaure el registro si fue eliminado anteriormente.", "errors": { "name": [ "Este nombre de banco ya existe. Verifique o restaure el registro si fue eliminado anteriormente." ] }}