---
url: https://auditwaste.com/api-docs
title: AuditWaste API Documentation - REST API para Integracion
description: Documentacion de la API REST de AuditWaste. Endpoints, autenticacion, webhooks, integraciones POS.
lang: es
last_updated: 2026-04-13
---

# AuditWaste API - Documentacion

## Descripcion General

La API de AuditWaste permite integrar datos de desperdicio alimentario con sistemas externos (ERP, POS, BI, dashboards propios). Disponible en planes Enterprise y Enterprise Multi.

## Autenticacion

La API utiliza claves de API (API Keys) generadas desde el panel de Super Admin. Cada clave esta vinculada a un establecimiento y tiene permisos granulares.

```
Authorization: Bearer YOUR_API_KEY
```

## Base URL

```
https://auditwaste.com/api/v1
```

## Endpoints Principales

### Analytics
- `GET /api/v1/analytics` - Obtener metricas de desperdicio (filtrable por fecha, categoria, causa, destino)

### Causas
- `GET /api/v1/causas` - Listar causas de merma del establecimiento

### Destinos
- `GET /api/v1/destinos` - Listar destinos de merma del establecimiento

### Registros
- `POST /api/v1/records/batch` - Crear registros de desperdicio en lote

### Productos
- `GET /api/v1/products` - Listar productos del catalogo

### Establecimientos
- `GET /api/v1/establishments` - Listar establecimientos (multi-local)

### Sesiones
- `GET /api/v1/sessions` - Listar sesiones de registro
- `POST /api/v1/sessions` - Crear nueva sesion

### Turnos
- `GET /api/v1/shifts` - Listar turnos configurados

### Prediccion
- `GET /api/v1/predict` - Obtener predicciones de demanda/desperdicio

### Benchmarking
- `GET /api/v1/benchmarking` - Comparativa entre establecimientos (Enterprise)

## Webhooks

AuditWaste soporta webhooks salientes para notificar eventos en tiempo real a sistemas externos:

### Eventos Disponibles
- `record.created` - Nuevo registro de desperdicio
- `session.completed` - Sesion de registro finalizada
- `alert.triggered` - Alerta de pico detectada
- `plan.generated` - Plan de Prevencion generado/actualizado
- `subscription.changed` - Cambio de plan/suscripcion

### Configuracion
Los webhooks se configuran desde el panel de administracion o via API:
- URL de destino (HTTPS requerido)
- Eventos a suscribir
- Secret para validacion de firma (HMAC-SHA256)
- Reintentos automaticos con backoff exponencial

### Formato del Payload
```json
{
  "event": "record.created",
  "timestamp": "2026-04-13T10:30:00Z",
  "data": {
    "id": "uuid",
    "establishment_id": "uuid",
    "food_category": "meat",
    "weight_kg": 2.5,
    "cause": "sobreproduccion",
    "destination": "donacion"
  }
}
```

## Webhooks Entrantes (POS Integration)

AuditWaste puede recibir datos de sistemas POS para correlacionar ventas con desperdicio:

### Conectores Disponibles
- Revo XEF
- Cover Manager
- Last.app
- Glop
- Square

### Endpoint Generico
- `POST /api/v1/webhooks/inbound` - Recibir datos de POS/ERP con formato estandarizado

## Rate Limiting

- 100 requests/minuto por API Key (estandar)
- 1.000 requests/minuto (Enterprise)
- Headers de respuesta incluyen `X-RateLimit-Remaining` y `X-RateLimit-Reset`

## Formato de Respuesta

Todas las respuestas usan JSON:

```json
{
  "success": true,
  "data": { ... },
  "meta": {
    "page": 1,
    "per_page": 50,
    "total": 122
  }
}
```

## Errores

| Codigo | Significado |
|---|---|
| 400 | Request invalido |
| 401 | API Key invalida o ausente |
| 403 | Sin permisos para este recurso |
| 404 | Recurso no encontrado |
| 429 | Rate limit excedido |
| 500 | Error interno del servidor |

## SDKs y Herramientas

- Documentacion interactiva: https://auditwaste.com/api-docs
- Coleccion Postman: disponible bajo peticion
- Soporte: api@auditwaste.com (Enterprise)

## Seguridad

- HTTPS obligatorio para todos los endpoints
- API Keys con permisos granulares por recurso
- Webhooks firmados con HMAC-SHA256
- Rate limiting por API Key
- Datos en la UE (Frankfurt)
- Logs de acceso auditables

## Disponibilidad

La API esta disponible exclusivamente en planes Enterprise y Enterprise Multi. Para mas informacion sobre precios y acceso, contactar con ventas.

## Enlaces

- Precios: https://auditwaste.com/precios
- Contacto Ventas: https://auditwaste.com/contact-sales
- Integraciones: https://auditwaste.com/funcionalidades