The Suppliers API manages theDocumentation 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.
Inventario.Proveedores table — the directory of vendors that supply raw materials and other goods to the restaurant. Each supplier record stores company identification (including the Venezuelan RIF tax number), a designated contact person, and full location and communication details. All endpoints are available under /api/proveedores.
Every response object includes dual field names: a short lowercase alias (e.g.
nombre, rif, contacto) and the original PascalCase database column name (e.g. Nombre_Empresa, Identificacion_RIF, Nombre_Encargado). Both names always carry the same value. When submitting request bodies you may use either form — the API resolves them with an or fallback pattern, checking the alias first and then the full column name.List All Suppliers
Nombre_Empresa. No pagination or query filters are applied.
Response
Returns an array of supplier objects:Alias for
ID_Proveedor. The auto-incremented primary key used in path parameters for update and delete operations.Primary key of the supplier record in the
Inventario.Proveedores table.Alias for
Nombre_Empresa. Trading or legal name of the supplier company.Company name, up to 150 characters.
Alias for
Identificacion_RIF. Venezuelan tax identification number, e.g. "J-12345678-9". Unique across all suppliers.RIF (Registro de Información Fiscal) identifier. Stored up to 30 characters. Must be unique.
Alias for
Nombre_Encargado. Name of the person responsible for managing the relationship with this supplier.Full name of the supplier’s contact/account manager.
Alias for
Telefono_Empresa. Main phone number for the supplier, up to 30 characters.Company phone number.
Alias for
Email_Empresa. Business email address for the supplier. Unique across all suppliers.Supplier’s business email. Unique at the database level.
City where the supplier is located, e.g.
"Caracas".Full street address of the supplier, up to 255 characters.
Create Supplier
201 Created with the full supplier object.
Identificacion_RIF (alias: rif) is unique at the database level. Attempting to create two suppliers with the same RIF will result in a database integrity error. Similarly, Email_Empresa (alias: email) must be unique.Request Body
Company or trading name of the supplier. Alias:
Nombre_Empresa. Defaults to "Proveedor Desconocido" if omitted.Venezuelan RIF tax ID, e.g.
"J-29876543-1". Alias: Identificacion_RIF. Must be unique. Defaults to "J-00000000-0" if omitted.Name of the supplier’s account manager or primary contact. Alias:
Nombre_Encargado. Defaults to "Encargado General" if omitted.Company phone number. Alias:
Telefono_Empresa. Defaults to "0000000000" if omitted.Business email address. Alias:
Email_Empresa. Must be unique. Auto-generated from a hash of the company name if omitted.City where the supplier operates. Defaults to
"Caracas" if omitted.Full street address. Defaults to
"Dirección Principal" if omitted.Response
Returns201 Created with the full supplier object (same shape as the list response):
Example 201 response
Update Supplier
404 if no supplier with the given ID exists.
Path Parameters
The
ID_Proveedor / id_proveedor of the supplier to update.Request Body
All fields are optional. Include only the fields you want to change. Both alias and PascalCase names are accepted.Updated company name. Alias:
Nombre_Empresa.Updated RIF identifier. Alias:
Identificacion_RIF. Must remain unique.Updated contact person name. Alias:
Nombre_Encargado.Updated phone number. Alias:
Telefono_Empresa.Updated business email. Alias:
Email_Empresa. Must remain unique.Response
Returns the updated supplier object (same shape as the list response).Delete Supplier
204 No Content on success. Raises 404 if no supplier with the given ID exists.
Path Parameters
The
ID_Proveedor / id_proveedor of the supplier to delete.Response
Returns204 No Content with an empty body on success.