---
title: "Crear un impuesto"
method: POST
path: "/taxes"
tags: ["Impuestos"]
---

# Crear un impuesto

`POST /taxes`

Endpoint que permite crear un impuesto en la cuenta de Alegra.

## Request body

- union
  - object
    - `name` string
    - `percentage` number
    - `description` string
    - `type` string
    - `categoryFavorable` object
      - `id` string
    - `categoryToBePaid` object
      - `id` string
  - object
    - `name` string
    - `percentage` number
    - `description` string
    - `status` string
    - `type` string
    - `categoryFavorable` object
      - `id` string
    - `categoryToBePaid` object
      - `id` string
    - `metadata` object
      - `rate` string

## Response `200`

Retorna información de un impuesto

- object
  - `id` string — ID del impuesto
  - `name` string — Nombre del impuesto
  - `percentage` number — Porcentaje del impuesto
  - `description` string — Descripción del impuesto
  - `status` 'active' | 'inactive' — Estado del impuesto
  - `type` string — Tipo de impuesto
  - `categoryFavorable` object — Categoría favorable
    - `id` string — ID de la categoría
    - `idParent` string — ID del padre
    - `name` string — Nombre de la categoría
    - `text` string — Texto de la categoría
    - `code` string, nullable — Código de la categoría
    - `description` string — Descripción de la categoría
    - `type` string — Tipo de categoría
    - `readOnly` boolean — Solo lectura
    - `nature` string — Naturaleza de la categoría
    - `blocked` string — Estado de bloqueo
    - `status` string — Estado de la categoría
    - `categoryRule` object — Regla de categoría
      - `id` string — ID de la regla
      - `name` string — Nombre de la regla
      - `key` string — Clave de la regla
    - `use` string — Uso de la categoría
    - `showThirdPartyBalance` boolean — Mostrar balance de terceros
  - `categoryToBePaid` object — Categoría por pagar
    - `id` string — ID de la categoría
    - `idParent` string — ID del padre
    - `name` string — Nombre de la categoría
    - `text` string — Texto de la categoría
    - `code` string, nullable — Código de la categoría
    - `description` string — Descripción de la categoría
    - `type` string — Tipo de categoría
    - `readOnly` boolean — Solo lectura
    - `nature` string — Naturaleza de la categoría
    - `blocked` string — Estado de bloqueo
    - `status` string — Estado de la categoría
    - `categoryRule` object — Regla de categoría
      - `id` string — ID de la regla
      - `name` string — Nombre de la regla
      - `key` string — Clave de la regla
    - `use` string — Uso de la categoría
    - `showThirdPartyBalance` boolean — Mostrar balance de terceros
  - `rate` string, nullable — Tasa del impuesto

## Other responses

- `400` — Bad Request
- `401` — unresolved $ref
- `403` — unresolved $ref

---

[API](https://skmtc.net/alegra/apis/ingresos.md) · [All operations](https://skmtc.net/alegra/apis/ingresos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/ingresos/revisions/cd52d3f68f1b/schema)