Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/teofilobetancourt/Restaurant-Equis/llms.txt

Use this file to discover all available pages before exploring further.

The Suppliers module provides the purchasing team with a centralised directory of all ingredient and supply vendors used by Restaurant Equis. Each record stores the company name, Venezuelan tax ID (RIF), primary contact person, phone number, email address, city, and physical address. The module supports full create, read, update, and delete operations through a modal form, with phone and email values rendered as clickable tel: and mailto: links for quick outreach.

Supplier Records

All suppliers are fetched on mount via GET /api/proveedores. Each record exposes the following fields:
nombre
string
required
Company or trading name (maps to Nombre_Empresa in the database). Example: Distribuidora La Central.
rif
string
required
Venezuelan tax identification number (maps to Identificacion_RIF). Must be unique across all supplier records. Example: J-12345678-0.
contacto
string
Name of the primary contact person at the supplier (maps to Nombre_Encargado). Example: Carlos López.
telefono
string
required
Supplier phone number (maps to Telefono_Empresa). Rendered as a tel: link in the table. Example: 0414-0000000.
email
string
Supplier email address (maps to Email_Empresa). Rendered as a mailto: link when present. Example: ventas@empresa.com.
Ciudad
string
City where the supplier is located. Defaults to Caracas when not provided. Example: Valencia.
Direccion
string
Physical address of the supplier. Example: Av. Libertador, Edificio Central, Piso 3.

Adding a Supplier

Click Agregar Proveedor to open the creation modal. The fields Nombre, RIF, and Teléfono are required; all other fields are optional. Click Guardar to submit:
POST /api/proveedores
Content-Type: application/json
{
  "nombre": "Distribuidora La Central",
  "rif": "J-12345678-0",
  "contacto": "Carlos López",
  "telefono": "0414-0000000",
  "email": "ventas@lacentral.com",
  "Ciudad": "Caracas",
  "Direccion": "Av. Libertador, Edificio Central, Piso 3"
}
The API returns the created supplier record including the assigned id_proveedor, and the new row is appended to the table immediately.

Editing a Supplier

Click the pencil icon on any row to open the edit modal pre-populated with the current values. Any subset of fields can be changed. Click Guardar to submit:
PUT /api/proveedores/{id_proveedor}
Content-Type: application/json
{
  "nombre": "Distribuidora La Central",
  "rif": "J-12345678-0",
  "contacto": "María González",
  "telefono": "0424-1111111",
  "email": "mgonzalez@lacentral.com"
}
The updated row replaces the old one in the table on success.

Deleting a Supplier

Click the trash icon on any row. A browser confirmation dialog appears:
¿Eliminar este proveedor? Esta acción no se puede deshacer.
If confirmed, the frontend calls:
DELETE /api/proveedores/{id_proveedor}
The row is removed from the table on a successful response.

RIF Format

The RIF (Registro de Información Fiscal) is Venezuela’s tax identification system. The format varies by entity type:
Entity typeFormatExample
Company (Jurídico)J-XXXXXXXX-XJ-12345678-0
Individual (Natural)V-XXXXXXXXV-12345678
Government entityG-XXXXXXXX-XG-20000002-0
Foundation / NGOF-XXXXXXXX-XF-11111111-1
Always enter the RIF with its prefix letter and hyphens as shown above to ensure consistent formatting across records.
The Identificacion_RIF field has a unique constraint in the database. Attempting to register two suppliers with the same RIF value will result in a validation error from the API. If a supplier company operates under multiple trading names, create a separate record for each name but verify that the underlying legal entity (and therefore RIF) is not already present in the directory.

Build docs developers (and LLMs) love