Documentación API

📡 URL Base

Todas las peticiones deben realizarse a: https://api.foodposs.com/v2

1000

Solicitudes/min

100

Por endpoint/min

12h

Token TTL

Autenticación

Foodposs usa autenticación Bearer Token. Incluye el token en el header Authorization de todas tus peticiones.

Request Body (JSON)

Parámetro	Tipo	Descripción
`email`	string	Email de usuario (requerido)
`password`	string	Contraseña (requerido)

Ejemplo de Respuesta

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 43200,
  "restaurant_id": "rest_abc123"
}

Productos

Parámetros de Query

Parámetro	Tipo	Descripción
`category`	string	Filtrar por categoría (opcional)
`active`	boolean	Solo productos activos (default: true)
`page`	integer	Página de resultados (default: 1)
`limit`	integer	Resultados por página (max: 100)

Ejemplo de Respuesta

{
  "data": [
    {
      "id": "prod_xyz789",
      "name": "Ceviche Clásico",
      "price": 12990,
      "category": "Entradas",
      "description": "Salmón fresco con limón",
      "available": true,
      "modifiers": ["Sin ост", "Extra limón"]
    }
  ],
  "pagination": {
    "page": 1,
    "total": 45,
    "pages": 3
  }
}

Request Body (JSON)

Parámetro	Tipo	Descripción
`name` *	string	Nombre del producto
`price` *	integer	Precio en CLP (sin decimales)
`category`	string	Categoría del producto
`description`	string	Descripción del producto
`modifiers`	array	Lista de modificadores disponibles

Pedidos

Parámetros de Query

Parámetro	Tipo	Descripción
`status`	string	Filtrar por estado: pending, preparing, ready, delivered, cancelled
`from_date`	date	Fecha inicio (YYYY-MM-DD)
`to_date`	date	Fecha fin (YYYY-MM-DD)
`table_id`	string	Filtrar por mesa específica

Request Body (JSON)

{
  "table_id": "table_05",
  "waiter_id": "user_xyz",
  "items": [
    {
      "product_id": "prod_abc",
      "quantity": 2,
      "modifiers": ["Sin cebolla"],
      "notes": "Salsas separadas"
    }
  ],
  "customer_name": "Carlos M.",
  "source": "pos" // pos, delivery, api
}

Mesas

Estados Posibles

Estado	Descripción
`available`	Mesa libre
`occupied`	Mesa con pedido activo
`waiting`	Clientes esperando
`reserved`	Reservada

Request Body

{
  "status": "available" // available | occupied | waiting | reserved
}

Usuarios

Roles Disponibles

Rol	Descripción
`Zona Clientes`	Administrador con acceso total
`manager`	Gerente con permisos de gestión
`waiter`	Garzón con acceso a ventas
`kitchen`	Personal de cocina

Reportes

Parámetros de Query

Parámetro	Tipo	Descripción
`from` *	date	Fecha inicio (YYYY-MM-DD)
`to` *	date	Fecha fin (YYYY-MM-DD)
`group_by`	string	Agrupar por: day, week, month, product, category

Códigos de Error

Estructura de Errores

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "El campo 'price' debe ser un número entero",
    "field": "price"
  }
}

Código	HTTP Status	Descripción
`AUTH_INVALID`	401	Credenciales inválidas
`AUTH_EXPIRED`	401	Token expirado
`FORBIDDEN`	403	Sin permisos para este recurso
`NOT_FOUND`	404	Recurso no encontrado
`VALIDATION_ERROR`	400	Datos de entrada inválidos
`RATE_LIMIT`	429	Demasiadas solicitudes
`SERVER_ERROR`	500	Error interno del servidor

Documentación API

Contenido

📡 URL Base

Autenticación

Request Body (JSON)

Ejemplo de Respuesta

Productos

Parámetros de Query

Ejemplo de Respuesta

Request Body (JSON)

Pedidos

Parámetros de Query

Request Body (JSON)

Mesas

Estados Posibles

Request Body

Usuarios

Roles Disponibles

Reportes

Parámetros de Query

Códigos de Error

Estructura de Errores