Impuestos

Crear o editar un impuesto

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}

post/taxes

Request

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

Request body

_idstring

ID del impuesto. Si se envía, se actualiza el registro existente; si no se envía, se crea uno nuevo.

namestring required

Nombre del impuesto

percentagenumber

Porcentaje del impuesto

type'Percentage' | 'PerUnit' | 'None'

Tipo de impuesto. Por defecto: Percentage

Example request

{
  "_id": "507f1f77bcf86cd799439020",
  "name": "IVA",
  "percentage": 19,
  "type": "Percentage",
  "externalIntegration": {
    "siigo": {
      "id": 5
    },
    "DIAN": {
      "id": "01"
    },
    "loggro": {
      "rate": 19,
      "rateCode": "IVA_19",
      "rateDescription": "IVA 19%",
      "id": "abc123",
      "taxCode": "IVA"
    },
    "loggroEnterprise": {
      "id": "ent_001"
    }
  }
}

Response

Impuesto creado o actualizado exitosamente

_idstring

ID único del impuesto

businessstring

ID del negocio al que pertenece el impuesto

namestring

Nombre del impuesto

percentagenumber

Porcentaje del impuesto

type'Percentage' | 'PerUnit' | 'None'

Tipo de impuesto

deletedboolean

Indica si el impuesto ha sido eliminado

modifiedOnstring date-time

Fecha de última modificación

createdOnstring date-time

Fecha de creación

Example response

{
  "_id": "507f1f77bcf86cd799439020",
  "business": "507f1f77bcf86cd799439012",
  "name": "IVA",
  "percentage": 19,
  "type": "Percentage",
  "externalIntegration": {
    "siigo": {
      "id": 5
    },
    "DIAN": {
      "id": "01"
    },
    "loggro": {
      "rate": 19,
      "rateCode": "IVA_19",
      "rateDescription": "IVA 19%",
      "id": "abc123",
      "taxCode": "IVA"
    },
    "loggroEnterprise": {
      "id": "ent_001"
    }
  },
  "modifiedOn": "2025-02-23T10:00:00.000Z",
  "createdOn": "2025-01-15T08:30:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.