Ir al contenido

Crear una cuenta de proveedor

POST/api/provider-account

Crea una cuenta de proveedor. El servidor la guarda con estado activo y asigna al usuario autenticado como creador (create_user_id). Responde 201 con el registro.

provider_idintegerobligatorio

Identificador del proveedor. Debe existir entre los proveedores. No se puede cambiar al actualizar.

bank_idintegerobligatorio

Banco de la cuenta. Si account_type es detracción, debe ser el Banco de la Nación.

coin_idintegerobligatorio

Moneda de la cuenta. Si account_type es detracción, debe ser la moneda marcada por defecto.

namestringobligatorio

Nombre de la cuenta. Máximo 60 caracteres; solo letras, números y espacios.

responsiblestringobligatorio

Responsable de la cuenta. Máximo 60 caracteres; solo letras y espacios.

account_numberstringobligatorio

Número de cuenta. Máximo 20 caracteres y único entre las cuentas (provider_accounts). Mensaje si se repite: El número de cuenta ya está en uso.

account_typestringobligatorio

Tipo de cuenta: detracción o recaudación (AccountTypeEnum). Si no es uno de los dos, el mensaje es El tipo de cuenta seleccionado no es válido.

descriptionstring

Descripción. Máximo 500 caracteres.

provider.create, que se valida en ProviderAccountPolicy::create.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/provider-account" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"provider_id": 12,
"bank_id": 3,
"coin_id": 1,
"name": "Cuenta soles",
"responsible": "Juan Pérez",
"account_number": "19412345678",
"account_type": "recaudación"
}'
Cuenta de proveedor creada201
{
"id": 1,
"provider_id": 12,
"bank_id": 3,
"coin_id": 1,
"responsible": "Juan Pérez",
"name": "Cuenta soles",
"account_number": "19412345678",
"account_type": "recaudación",
"email": null,
"description": null,
"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,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
Sin permiso403
{
"message": "This action is unauthorized."
}
Datos no válidos422
{
"message": "El proveedor es requerido.",
"errors": {
"provider_id": ["El proveedor es requerido."]
}
}