The Suppliers API manages theDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/teofilobetancourt/Tradiciones-y-Sabores/llms.txt
Use this file to discover all available pages before exploring further.
Inventario.Proveedores table, giving you full CRUD control over every vendor your kitchen depends on. Each supplier record holds the company name, Venezuelan RIF tax identifier, primary contact, phone, email, city, and address. All four endpoints live under the /api/proveedores prefix and return responses using a dual-key shape so both lowercase shorthand and PascalCase field names work side-by-side.
Every supplier response object includes two keys for each field — a lowercase shorthand (e.g.
nombre, rif, contacto) and the canonical PascalCase column name (e.g. Nombre_Empresa, Identificacion_RIF, Nombre_Encargado). Both keys always carry the same value. This dual-key design preserves backward compatibility with earlier frontend integrations that relied on either naming convention.Venezuelan businesses are identified by a RIF (Registro de Información Fiscal). The standard format is a letter prefix followed by 8 digits and a verification digit, separated by hyphens:
J-XXXXXXXX-X. The prefix denotes entity type — J for juridical (company), V for Venezuelan individual, E for foreign individual, G for government. Always store the RIF in this hyphenated format to avoid duplicate-constraint errors on the Identificación_RIF column.GET /api/proveedores
Returns the full list of suppliers in the vendor directory, ordered alphabetically by company name (Nombre_Empresa).
Response
Returns a JSON array of supplier objects. Each element contains the following fields:Numeric primary key of the supplier (shorthand alias for
ID_Proveedor).Canonical primary key of the supplier record in
Inventario.Proveedores.Company name (shorthand alias for
Nombre_Empresa).Full legal company name, up to 150 characters.
Venezuelan tax identifier (shorthand alias for
Identificacion_RIF).Venezuelan RIF in
J-XXXXXXXX-X format. Unique across all supplier records.Name of the primary contact person (shorthand alias for
Nombre_Encargado).Full name of the account manager or main contact at the supplier.
Company phone number (shorthand alias for
Telefono_Empresa).Primary business phone number of the supplier, up to 30 characters.
Business email address (shorthand alias for
Email_Empresa).Primary business email of the supplier. Unique across all supplier records.
City where the supplier is located.
Full street address of the supplier, up to 255 characters.
POST /api/proveedores
Creates a new supplier record. The endpoint accepts both lowercase shorthand keys and PascalCase column names in the request body — if both variants are sent for the same field, the shorthand key takes precedence.Identificacion_RIF and Email_Empresa are subject to unique constraints; attempting to create a duplicate will return a database integrity error.
Status on success: 201 Created
Request body
Company name. Accepts
nombre or Nombre_Empresa. Defaults to "Proveedor Desconocido" if omitted.Venezuelan RIF identifier. Accepts
rif or Identificacion_RIF. Must be unique. Defaults to "J-00000000-0" if omitted.Name of the primary contact. Accepts
contacto or Nombre_Encargado. Defaults to "Encargado General" if omitted.Business phone number. Accepts
telefono or Telefono_Empresa. Defaults to "0000000000" if omitted.Business email address. Accepts
email or Email_Empresa. Must be unique. Defaults to a generated placeholder if omitted.City of the supplier. Defaults to
"Caracas" if omitted.Full street address. Defaults to
"Dirección Principal" if omitted.Response
Returns the newly created supplier object in the same dual-key format described under GET /api/proveedores.PUT /api/proveedores/
Updates one or more fields on an existing supplier. Only the keys present in the request body are modified; omitted fields retain their current values. The same dual-key aliases (nombre / Nombre_Empresa, etc.) are accepted.
Returns 404 Not Found with {"detail": "Proveedor no encontrado"} if no supplier exists for the given id_proveedor.
Path parameter
The numeric primary key (
ID_Proveedor) of the supplier to update.Request body
All fields are optional. Provide only the fields you want to change.New company name. Also accepted as
Nombre_Empresa.New RIF identifier. Also accepted as
Identificacion_RIF. Must remain unique.New contact name. Also accepted as
Nombre_Encargado.New phone number. Also accepted as
Telefono_Empresa.New email address. Also accepted as
Email_Empresa. Must remain unique.Response
Returns the full updated supplier object in dual-key format.DELETE /api/proveedores/
Permanently deletes the supplier record identified byid_proveedor. This action is irreversible.
Returns 404 Not Found with {"detail": "Proveedor no encontrado"} if no supplier exists for the given ID.
Status on success: 204 No Content (empty response body)
Path parameter
The numeric primary key (
ID_Proveedor) of the supplier to delete.