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

# Crear un impuesto

`POST /taxes`

## Request

- Base URL: `https://api.alegra.com/api/v1`
- URL: `https://api.alegra.com/api/v1/taxes`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

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.dev/alegra/apis/configuraciones.md) - [All operations](https://skmtc.dev/alegra/apis/configuraciones/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/configuraciones/revisions/5a651ca3b942?raw)