Impuestos

Listar impuestos creados en Bsale. Para usar los impuestos creados, usar el nodo taxId o taxes en el envío del documento.

Estructura JSON

Al realizar una petición HTTP, el servicio retornara un JSON con la siguiente estructura:

{
  "href": "https://api.bsale.cl/v1/taxes/1.json",
  "id": 1,
  "name": "IVA",
  "percentage": "19.0",
  "forAllProducts": 0,
  "ledgerAccount": null,
  "code": "14",
  "state": 0
}
  • href, url de la forma de pago (String).
  • id, identificador único del impuesto (Integer).
  • name, nombre del impuesto (String).
  • percentage, porcentaje de impuesto (Float).
  • forAllProducts, indica si es aplicado para todos los productos, No(0) o Si (1)(Boolean).
  • ledgerAccount, cuenta contable del impuesto (String).
  • code, código del impuesto (Boolean).
  • state, estado del impuesto indica si el impuesto esta activo(0) o inactivo (1) (Boolean).

GET lista de impuestos

  • GET /v1/taxes.json retornara todos los impuestos.

Parámetros

  • limit, limita la cantidad de items de una respuesta JSON, por defecto el limit es 25, el máximo permitido es 50.
  • offset, permite paginar los items de una respuesta JSON, por defecto el offset es 0.
  • fields, solo devolver atributos específicos de un recurso
  • expand, permite expandir instancias y colecciones.
  • name, Permite filtrar por nombre del impuesto.
  • percentage, filtra por porcentaje de impuesto.
  • code, filtra código.
  • ledgeraccount, filtra por cuenta contable.
  • state, boolean (0 o 1) indica si los impuestos están activos(0) inactivos(1).

Ejemplos

  • GET /v1/taxes.json?limit=10&offset=0
  • GET /v1/taxes.json?fields=[name,percentage,state]

Respuesta

{
  "href": "https://api.bsale.cl/v1/taxes.json",
  "count": 2,
  "limit": 25,
  "offset": 0,
  "items": [
    {
      "href": "https://api.bsale.cl/v1/taxes/2.json",
      "id": 2,
      "name": "Exento",
      "percentage": "0.0",
      "forAllProducts": 1,
      "ledgerAccount": null,
      "code": "0",
      "state": 0
    },
    {
      "href": "https://api.bsale.cl/v1/taxes/1.json",
      "id": 1,
      "name": "IVA",
      "percentage": "19.0",
      "forAllProducts": 0,
      "ledgerAccount": null,
      "code": "0",
      "state": 0
    }
  ]
}

GET un impuesto

  • GET /v1/taxes/1.json retornara un impuesto específico.

Respuesta

{
  "href": "https://api.bsale.cl/v1/taxes/1.json",
  "id": 1,
  "name": "IVA",
  "percentage": "19.0",
  "forAllProducts": 0,
  "ledgerAccount": null,
  "code": "0",
  "state": 0
}

GET cantidad de impuestos

  • GET /v1/taxes/count.json

Parámetros

  • state, permite filtrar por estado, activos (0) inactivos (1).

Respuesta

{
  "count": 3
}