Skip to main content

​
Overview

The Suppliers and Brands module helps you organize product metadata by managing brand information and maintaining supplier contacts and details.

​
Accessing Suppliers and Brands

1

Navigate to the page

Click “Marcas y Proveedores” in the sidebar navigation to open the management page.
2

Choose a tab

The page has two tabs:
  • Marcas (Brands): Manage product brands
  • Proveedores (Suppliers): Manage supplier information

​
Managing Brands

​
Viewing Brands

1

Access the Brands tab

Click “Marcas” in the navigation tabs (active by default).
2

Review brand cards

Brands are displayed in a grid layout showing:
  • Brand name
  • Description
  • Number of associated products
  • Creation date
  • Action buttons (Edit/Delete)
3

View statistics

The stats area shows total number of brands in the system.

​
Searching Brands

1

Use the search bar

Type in the “Buscar marcas…” search field to filter brands by name.
2

View filtered results

The grid updates in real-time as you type, showing only matching brands.

​
Creating a New Brand

1

Click Nueva Marca

Click the purple “Nueva Marca” button in the top-right corner.
2

Fill in brand information

In the modal form:
  • Nombre de la Marca (required): Enter the brand name (e.g., “Samsung”, “Apple”, “HP”)
  • Descripción (optional): Add a description (e.g., “Productos electrónicos Samsung de alta calidad”)
3

Save the brand

  • Click “Guardar” to create the brand
  • System calls brandsService.createBrand(brandData)
  • The new brand appears in the grid
  • Modal closes automatically
Brand names should be unique to avoid confusion when assigning products.

​
Editing a Brand

1

Find the brand

Locate the brand you want to edit using the search or scrolling through the grid.
2

Click Edit

Click the edit icon (pencil) on the brand card.
3

Modify information

Update the brand name or description in the modal form.
4

Save changes

Click “Guardar” to update the brand via brandsService.updateBrand(brandId, updateData).

​
Deleting a Brand

Brands associated with products cannot be deleted. Remove products from the brand first.
1

Click Delete

Click the delete icon (trash) on the brand card.
2

Confirm deletion

A confirmation dialog appears asking you to confirm.
3

Complete deletion

  • Click “Eliminar” to confirm
  • System calls brandsService.deleteBrand(brandId)
  • Brand is removed from the grid

​
Viewing Brand Statistics

Click on a brand to view detailed statistics:
  • Total products under the brand
  • Active vs. inactive products
  • Limited vs. unlimited stock products
  • Total stock quantity
  • Low stock product count
  • Average product price
Data retrieved via brandsService.getBrandStats(brandId).

​
Managing Suppliers

​
Viewing Suppliers

1

Switch to Proveedores tab

Click “Proveedores” in the navigation tabs.
2

Review supplier list

Suppliers are displayed in a list/card format showing:
  • Supplier name
  • Contact person
  • Email and phone
  • Address
  • Number of products
  • Active/inactive status
3

Filter by status

Check “Incluir inactivos” to show inactive suppliers in the list.

​
Searching Suppliers

1

Use the search bar

Type in the “Buscar proveedores…” field to filter suppliers.
2

Search by multiple fields

Search works across:
  • Supplier name
  • Contact name
  • Email
  • Phone number

​
Creating a New Supplier

1

Click Nuevo Proveedor

Click the purple “Nuevo Proveedor” button.
2

Enter required information

Fill in the form fields:
  • Nombre del Proveedor (required): Company name (e.g., “Distribuidora Tecnología S.A.”)
3

Add contact details

Enter optional but recommended information:
  • Persona de Contacto: Contact person name (e.g., “Juan Pérez”)
  • Email: Contact email (e.g., “ventas@proveedor.com”)
  • Teléfono: Phone number (e.g., “+52 55 1234 5678”)
4

Add location and description

  • Dirección: Physical address
  • Descripción: Additional details about the supplier
5

Set active status

Check or uncheck “Proveedor activo” to set the initial status.
6

Save the supplier

  • Click “Guardar”
  • System calls suppliersService.createSupplier(supplierData)
  • New supplier appears in the list
Include complete contact information to make reordering easier.

​
Editing a Supplier

1

Find the supplier

Use search or browse the list to locate the supplier.
2

Click Edit

Click the edit icon on the supplier card.
3

Update information

Modify any fields in the form:
  • Company name
  • Contact details
  • Address
  • Description
  • Active status
4

Save changes

Click “Guardar” to update via suppliersService.updateSupplier(supplierId, updateData).

​
Deactivating a Supplier

Instead of deleting, you can deactivate suppliers:
1

Edit the supplier

Click the edit icon for the supplier.
2

Uncheck active status

Uncheck the “Proveedor activo” checkbox.
3

Save changes

The supplier is now inactive but remains in the system for historical records.
Inactive suppliers don’t appear in product creation dropdowns but are still linked to existing products.

​
Deleting a Supplier

Suppliers with associated products cannot be deleted. Reassign products first or deactivate instead.
1

Click Delete

Click the delete icon on the supplier card.
2

Confirm deletion

Confirm the deletion in the dialog.
3

Complete deletion

System calls suppliersService.deleteSupplier(supplierId) to remove the supplier.

​
Viewing Supplier Statistics

Click on a supplier to view:
  • Total products from this supplier
  • Active product count
  • Stock distribution (limited vs. unlimited)
  • Total inventory from supplier
  • Low stock items
  • Average product price
Accessed via suppliersService.getSupplierStats(supplierId).

​
Refreshing Data

1

Click Actualizar

Click the “Actualizar” button in the header to refresh all data.
2

Wait for reload

The system fetches latest information for both brands and suppliers.

​
Best Practices

​
For Brands

  • Use official names: Enter brands exactly as they appear officially
  • Add descriptions: Help staff identify what each brand represents
  • Keep it current: Remove obsolete brands when no longer carrying them
  • Avoid duplicates: Check existing brands before creating new ones
  • Be consistent: Use the same naming convention (e.g., “HP” not “Hewlett-Packard”)

​
For Suppliers

Maintain accurate supplier information for efficient reordering and relationship management.
  • Complete contact info: Always include email and phone
  • Update regularly: Keep contact details current
  • Add notes: Use description field for payment terms, lead times, etc.
  • Mark inactive properly: Don’t delete suppliers with historical orders
  • Multiple contacts: Add backup contact info in description
  • Track performance: Use description to note supplier reliability

​
Common Workflows

​
Adding Products from a New Supplier

1

Create the supplier

First, add the new supplier with all contact details.
2

Create brand(s)

If the supplier carries new brands, add those brands.
3

Add products

Go to Inventory and create products, selecting the new supplier and brands.

​
Supplier Contact Update

1

Receive new contact info

When a supplier changes contact details.
2

Update immediately

Edit the supplier record and update email, phone, or address.
3

Verify the change

Send a test email or call to confirm the new contact works.

​
Discontinuing a Brand

1

Check product count

View brand statistics to see how many products use it.
2

Update or remove products

Either delete products or reassign them to a different brand.
3

Delete the brand

Once no products are associated, delete the brand.

​
Troubleshooting

​
Cannot Delete Brand/Supplier

Reason: The brand/supplier has associated products. Solution:
  1. View the statistics to see product count
  2. Go to Inventory and filter by that brand/supplier
  3. Either delete those products or reassign them
  4. Return and delete the brand/supplier

​
Duplicate Brand Names

Reason: Brand was created multiple times with slight variations. Solution:
  1. Identify the correct brand name
  2. Reassign all products to the correct brand
  3. Delete duplicate brands

​
Supplier Information Not Saving

Possible causes:
  • Email format is invalid
  • Name field is empty (required)
  • Network connection issue
Solution:
  1. Verify all required fields are filled
  2. Check email format (must include @ and domain)
  3. Retry saving
  4. Check browser console for errors

​
Technical Reference

​
Brands Service

Operations use brandsService.js:
  • Get brands: brandsService.getBrands(params)
    • Params: search, page, limit
  • Create brand: brandsService.createBrand(brandData)
    • Required: name
    • Optional: description
  • Update brand: brandsService.updateBrand(brandId, updateData)
  • Delete brand: brandsService.deleteBrand(brandId)
  • Get stats: brandsService.getBrandStats(brandId)

​
Suppliers Service

Operations use suppliersService.js:
  • Get suppliers: suppliersService.getSuppliers(params)
    • Params: search, isActive, page, limit
  • Create supplier: suppliersService.createSupplier(supplierData)
    • Required: name
    • Optional: description, contactName, email, phone, address
  • Update supplier: suppliersService.updateSupplier(supplierId, updateData)
  • Delete supplier: suppliersService.deleteSupplier(supplierId)
  • Get stats: suppliersService.getSupplierStats(supplierId)
All operations require authentication and communicate with:
  • Brands: https://cemac-api.vercel.app/brands
  • Suppliers: https://cemac-api.vercel.app/suppliers

Build docs developers (and LLMs) love

Get started for freeTalk to us