Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/EricMartinez758/corpointa-frontend/llms.txt

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

Suppliers (proveedores) represent the external vendors and individuals from whom your organization receives goods. Every supplier record stores basic contact identification that is referenced when raising a Control Perceptivo warehouse receipt. You can manage all suppliers at the /proveedores route.

​
Data Model

Each supplier record contains the following fields:
FieldTypeConstraintsDescription
id_proveedorintegerPrimary key, auto-generatedUnique numeric identifier for the supplier
nombrestringRequired, max 100 charsFull legal name of the vendor or individual
rif_o_cedulastringRequired, max 30 charsVenezuelan business tax ID (RIF) or individual national ID (cédula)
telefonostringRequired, max 30 charsPrimary contact phone number
RIF vs. Cédula — A RIF (Registro de Información Fiscal) is Venezuela’s business tax identification number, assigned to companies and self-employed professionals. A cédula is the individual national identity number. Corpointa accepts either in the rif_o_cedula field; the field label makes this explicit in the UI.

​
Features

Searchable Table

The suppliers list is fully searchable and column-filterable. Type in the global search bar or use per-column filters to narrow results by name or tax ID.

Inline Create Dialog

Click New Supplier to open a modal dialog with validated form fields. All three required fields must pass validation before the record is saved.

Inline Edit Dialog

Click the edit action on any row to open the same form pre-populated with the supplier’s current data. Changes are submitted with a PUT request.

Delete Confirmation

Deleting a supplier triggers a confirmation dialog to prevent accidental removal. Suppliers referenced by existing warehouse receipts should be reviewed before deletion.

​
API Reference

All endpoints operate on the /proveedores resource and return or accept JSON.

​
List Suppliers

​
GET /proveedores
Proveedor[]
Returns an array of all supplier records.
GET /proveedores
Response
[
  {
    "id_proveedor": 1,
    "nombre": "Distribuidora Central C.A.",
    "rif_o_cedula": "J-30456789-0",
    "telefono": "+58 212 555 0100"
  }
]

​
Get Single Supplier

​
GET /proveedores/:id
Proveedor
Returns a single supplier by its id_proveedor.
GET /proveedores/1

​
Create Supplier

​
POST /proveedores
Proveedor
Creates a new supplier record. The id_proveedor is assigned by the server.
POST /proveedores
Content-Type: application/json

{
  "nombre": "Suministros del Norte S.R.L.",
  "rif_o_cedula": "J-40123456-1",
  "telefono": "+58 261 555 0200"
}

​
Update Supplier

​
PUT /proveedores/:id
Proveedor
Updates an existing supplier. Send the full set of writable fields.
PUT /proveedores/1
Content-Type: application/json

{
  "nombre": "Distribuidora Central C.A.",
  "rif_o_cedula": "J-30456789-0",
  "telefono": "+58 212 555 0199"
}

​
Field Validation

​
nombre
string
required
Full legal name of the vendor. Must be between 1 and 100 characters.
​
rif_o_cedula
string
required
Venezuelan RIF (businesses) or cédula (individuals). Must be between 1 and 30 characters. Include the document prefix in your data, e.g. J-30456789-0 or V-12345678.
​
telefono
string
required
Contact phone number. Must be between 1 and 30 characters. Any format is accepted.

Build docs developers (and LLMs) love

Get started for freeTalk to us