---
title: "Log de actividades de la empresa"
method: GET
path: "/actividad"
tags: ["actividad"]
---

# Log de actividades de la empresa

`GET /actividad`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/actividad`
- Auth: HTTP bearer

Quién creó, cambió o anuló qué, y cuándo: una fila por cada escritura sobre clientes, productos, comprobantes, compras y asientos, lo último primero. La fila no lleva datos personales de clientes ni de proveedores, solo el id del registro y, cuando no identifica a nadie, su número o su código. Solo se registra mientras la empresa tiene el módulo `auditoria`, y se conserva 24 meses. Solo `owner` y `admin`.

## Query parameters

- `usuarioId` string, uuid
- `entidad` 'cliente' | 'producto' | 'comprobante' | 'compra' | 'retencion_recibida' | 'asiento' | 'periodo'
- `desde` string, date
- `hasta` string, date
- `limit` integer
- `offset` integer

## Response `200`

Página de actividad

- object[]
  - `id` integer
  - `fecha` string, date-time
  - `actorTipo` 'usuario' | 'api_key' | 'mcp' | 'partner' | 'buzon': Por dónde entró el cambio.
  - `usuarioId` string, uuid, nullable
  - `usuarioNombre` string, nullable: Nombre de quien actuó. `null` con una credencial de máquina.
  - `entidad` 'cliente' | 'producto' | 'comprobante' | 'compra' | 'retencion_recibida' | 'asiento' | 'periodo'
  - `accion` string: `crear`, `guardar`, `editar`, `eliminar`, `emitir`, `anular`, `registrar`...
  - `entidadId` string, nullable: Id del registro tocado, si fue uno.
  - `referencia` string, nullable: Número del comprobante, código del producto o número del asiento. Nunca un dato personal.
  - `cantidad` integer, nullable: Cuántos elementos, en una carga en lote.

## Other responses

- `400`: Cuerpo inválido o validación de negocio (previene errores SRI 62/52/65/69/39)
- `402`: El tenant no tiene el módulo `auditoria` (`upgrade: true`)
- `403`: Rol insuficiente o acceso denegado

---

[API](https://skmtc.dev/contadeo/apis/api-de-contadeo.md) · [All operations](https://skmtc.dev/contadeo/apis/api-de-contadeo/llms.txt) · [OpenAPI document](https://skmtc.dev/contadeo/apis/api-de-contadeo/revisions/461bbb9a74ce?raw)