VerifikaDocs
ReferenciaEgresos

Editar una categoría de egreso

Renombrar, cambiar el emoji o la descripción, reordenar — y desactivar, que es lo que se hace con una categoría que ya tiene gastos.

PATCH
/expense-categories/{id}

Autorización

apiKey categories.write
AutorizaciónBearer <token>

La llave del negocio, creada en el panel: Integraciones → API pública. vk_live_… es una llave real; vk_test_…, una llave de modo prueba (verificaciones simuladas, nada toca el libro real). Ver la guía «Modo de prueba».

Va en: header

Permiso: categories.write

Parámetros de la ruta

id*string

Id de la categoría.

Parámetros de consulta

companyId?string

Sobre qué negocio actúa la petición. Obligatorio solo si la llave entra a varios negocios; con uno solo, se deduce.

Cuerpo de la petición

application/json

Tipos de TypeScript

Usa el tipo request body en TypeScript.

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/expense-categories/string" \  -H "Content-Type: application/json" \  -d '{    "emoji": "📢",    "description": "Pauta digital y volantes"  }'
{  "object": "expenseCategory",  "id": "string",  "name": "string",  "description": "string",  "emoji": "string",  "color": "string",  "isDefault": true,  "active": true}

Crear una categoría de egreso POST

Un negocio nace con once categorías por defecto y puede crear las suyas. Crear categorías propias es una función aparte del módulo de egresos (expense_categories_custom): en el plan más bajo se usan solo las que vienen.

Eliminar una categoría de egreso DELETE

Solo si no tiene gastos. Una categoría con movimientos no se borra: borrarla dejaría egresos huérfanos y rompería el histórico, que es justo el dato por el que el negocio paga. Para esas, PATCH { "active": false }.