Skip to content
Factuplan Factuplan Documentación API para Desarrolladores | Factuplan

Impuestos

Maneja todas las operaciones CRUD para los impuestos en la API.

Endpoints

Section titled “Endpoints”

Obtener todos los impuestos

Section titled “Obtener todos los impuestos”

GET /taxes

Parámetros de consulta:

  • query: Parámetros de filtrado y ordenamiento (opcional)
[
  {
    "id": "82a81d68-f786-46a8-8184-31efc5bee730",
    "deletedAt": null,
    "createdAt": "2025-06-03T03:11:19.350Z",
    "updatedAt": "2025-06-03T03:11:19.350Z",
    "name": "QUINCE",
    "code": "IVA",
    "percentage": "15.00",
    "isRetention": false,
    "sriCode": "2"
  },
  {
    "id": "fe58bcfc-8be2-4ef0-9498-2df2adce551e",
    "deletedAt": null,
    "createdAt": "2025-06-03T03:19:40.775Z",
    "updatedAt": "2025-06-03T03:19:40.775Z",
    "name": "QUINCE",
    "code": "IVA",
    "percentage": "15.00",
    "isRetention": false,
    "sriCode": "2"
  }
]

Filtros

Section titled “Filtros”
CampoOperadorEjemplo
nameeqGET /taxes?query=filter.name__eq=QUINCE
codelikeGET /taxes?query=filter.code__like=IVA
percentageeqGET /taxes?query=filter.percentage__eq=15
isRetentioneqGET /taxes?query=filter.isRetention__eq=true

Obtener impuestos por defecto

Section titled “Obtener impuestos por defecto”

GET /taxes/default

Crea y devuelve los impuestos predeterminados para la empresa actual.

[
  {
    "id": "82a81d68-f786-46a8-8184-31efc5bee730",
    "deletedAt": null,
    "createdAt": "2025-06-03T03:11:19.350Z",
    "updatedAt": "2025-06-03T03:11:19.350Z",
    "name": "QUINCE",
    "code": "IVA",
    "percentage": "15.00",
    "isRetention": false,
    "sriCode": "2"
  },
  {
    "id": "fe58bcfc-8be2-4ef0-9498-2df2adce551e",
    "deletedAt": null,
    "createdAt": "2025-06-03T03:19:40.775Z",
    "updatedAt": "2025-06-03T03:19:40.775Z",
    "name": "QUINCE",
    "code": "IVA",
    "percentage": "15.00",
    "isRetention": false,
    "sriCode": "2"
  }
]

Obtener un impuesto por ID

Section titled “Obtener un impuesto por ID”

GET /taxes/{id}

Parámetros de URL:

  • id: ID del impuesto a buscar
{
  "id": "4c415301-2932-4614-8b57-e4df1deca600",
  "deletedAt": null,
  "createdAt": "2025-06-03T03:20:07.856Z",
  "updatedAt": "2025-06-03T03:20:07.856Z",
  "name": "QUINCE",
  "code": "IVA",
  "percentage": "15.00",
  "isRetention": false,
  "sriCode": "2"
}

Crear un nuevo impuesto

Section titled “Crear un nuevo impuesto”

POST /taxes

{
  "name": "QUINCE",
  "code": "IVA",
  "percentage": "15.00",
  "isRetention": false,
  "sriCode": "2"
}

Actualizar un impuesto existente

Section titled “Actualizar un impuesto existente”

PUT /taxes/{id}

Parámetros de URL:

  • id: ID del impuesto a actualizar
{
  "name": "QUINCE",
  "code": "IVA",
  "percentage": "15.00",
  "isRetention": false,
  "sriCode": "2"
}

Eliminar un impuesto

Section titled “Eliminar un impuesto”

DELETE /taxes/{id}

Parámetros de URL:

  • id: ID del impuesto a eliminar