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

# Crear o editar un impuesto

`POST /taxes`

## Request

- Base URL: `https://api.pirpos.com`
- URL: `https://api.pirpos.com/taxes`
- Auth: HTTP bearer

Crea un nuevo impuesto o actualiza uno existente según la presencia del campo `_id` en el body.

- **Sin `_id`:** Se crea un nuevo impuesto asociado al negocio del usuario autenticado.
- **Con `_id`:** Se actualiza el impuesto existente (nombre, porcentaje e integración externa).
  Solo se puede modificar un impuesto que pertenezca al negocio propio o al negocio padre.

**Permiso requerido:** `TX_POST` (Crear/Editar)

**Autenticación requerida:** Bearer Token obtenido del campo `tokenCurrent` en el servicio de login.

`Authorization: Bearer {tokenCurrent}`

## Request body

- TaxInput
  - `_id` string: ID del impuesto. Si se envía, se actualiza el registro existente; si no se envía, se crea uno nuevo.
  - `name` string, required: Nombre del impuesto
  - `percentage` number: Porcentaje del impuesto
  - `type` 'Percentage' | 'PerUnit' | 'None': Tipo de impuesto. Por defecto: Percentage
  - `externalIntegration` object: Datos de integración con sistemas externos (Siigo, DIAN, Loggro)
    - `siigo` object
      - `id` number
    - `DIAN` object
      - `id` string
    - `loggro` object
      - `rate` number
      - `rateCode` string
      - `rateDescription` string
      - `id` string
      - `taxCode` string
    - `loggroEnterprise` object
      - `id` string

## Response `200`

Impuesto creado o actualizado exitosamente

- Tax
  - `_id` string: ID único del impuesto
  - `business` string: ID del negocio al que pertenece el impuesto
  - `name` string: Nombre del impuesto
  - `percentage` number: Porcentaje del impuesto
  - `type` 'Percentage' | 'PerUnit' | 'None': Tipo de impuesto
  - `deleted` boolean: Indica si el impuesto ha sido eliminado
  - `externalIntegration` object: Datos de integración con sistemas externos
    - `siigo` object
      - `id` number: ID del impuesto en Siigo
    - `DIAN` object
      - `id` string: ID del impuesto en la DIAN
    - `loggro` object
      - `rate` number: Tarifa en Loggro
      - `rateCode` string: Código de tarifa en Loggro
      - `rateDescription` string: Descripción de la tarifa en Loggro
      - `id` string: ID del impuesto en Loggro
      - `taxCode` string: Código del impuesto en Loggro
    - `loggroEnterprise` object
      - `id` string: ID del impuesto en Loggro Enterprise
  - `modifiedOn` string, date-time: Fecha de última modificación
  - `createdOn` string, date-time: Fecha de creación

## Other responses

- `401`: No autorizado - Token JWT inválido o ausente
- `403`: Prohibido - Sin permiso TX_POST o el impuesto pertenece a otro negocio
- `503`: Error del servidor al guardar el impuesto

---

[API](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar.md) - [All operations](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/revisions/9d4431a3cddc?raw)