Skip to main content

​
Overview

The Products API provides access to the catalog of available dairy products that can be used when creating production batches. Products include both dairy milk products and cheese varieties.

​
Base URL

/productos
Authentication Required: No (Public endpoint)

​
List All Products

curl -X GET https://api.tambo360.com/productos
Retrieves the complete catalog of available dairy products.

​
Response

​
statusCode
integer
HTTP status code (200 for success)
​
message
string
“Productos listados correctamente”
​
data
array
Array of product objects:
​
idProducto
string
UUID of the product
​
nombre
string
Product name
​
categoria
string
Product category. Possible values:
  • “leches” (milk products)
  • “quesos” (cheese products)
​
success
boolean
Indicates success (true)
{
  "statusCode": 200,
  "message": "Productos listados correctamente",
  "data": [
    {
      "idProducto": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "nombre": "Leche Entera",
      "categoria": "leches"
    },
    {
      "idProducto": "b2c3d4e5-6789-01ab-cdef-234567890abc",
      "nombre": "Leche Descremada",
      "categoria": "leches"
    },
    {
      "idProducto": "c3d4e5f6-789a-12bc-def0-34567890abcd",
      "nombre": "Queso Cremoso",
      "categoria": "quesos"
    },
    {
      "idProducto": "d4e5f6a7-89ab-23cd-ef01-4567890abcde",
      "nombre": "Queso Sardo",
      "categoria": "quesos"
    },
    {
      "idProducto": "e5f6a7b8-9abc-34de-f012-567890abcdef",
      "nombre": "Queso Mozzarella",
      "categoria": "quesos"
    }
  ],
  "success": true
}

​
Product Categories

Products in Tambo360 are organized into two main categories:

​
Leches (Milk Products)

Milk-based products including:
  • Leche Entera (Whole Milk)
  • Leche Descremada (Skimmed Milk)
  • Leche Semidescremada (Semi-skimmed Milk)

​
Quesos (Cheese Products)

Cheese varieties including:
  • Queso Cremoso (Cream Cheese)
  • Queso Sardo (Sardo Cheese)
  • Queso Mozzarella (Mozzarella Cheese)
  • Queso Parmesano (Parmesan Cheese)
  • Queso Provolone (Provolone Cheese)

​
Usage

The product IDs (idProducto) returned by this endpoint are used when creating production batches via the Batches API. Example workflow:
  1. Call GET /productos to retrieve available products
  2. Select a product and use its idProducto
  3. Create a batch using POST /lote/registrar with the selected idProducto

​
Error Responses

​
404 Not Found

  • No products are registered in the system

​
500 Internal Server Error

  • Unexpected server error
  • Database connection issues

Build docs developers (and LLMs) love

Get started for freeTalk to us