> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Endpoint de cálculo de IVA

> El endpoint `calculate` permite un cálculo preciso del IVA para precios conformes, teniendo en cuenta las regulaciones específicas del país, los importes de transacción y las categorías de productos opcionales para cálculos fiscales precisos.

## Primeros pasos

### URL base

```
https://vat.cleariflow.com/v1/calculate/
```

### Endpoint de cálculo

El endpoint `calculate` requiere su clave API única, el país y el precio que desea verificar:

```
https://vat.cleariflow.com/v1/calculate/
? api_key = YOUR_UNIQUE_API_KEY
& amount = 175  
& country_code = DE
& category = standard
```

Esta solicitud exitosa devuelve resultados completos del cálculo de IVA, incluidas tasas, importes e información del país:

<ResponseExample>
  ```json theme={"system"}
  {
      "amount_excluding_vat": "175.00",
      "amount_including_vat": "208.25",
      "country": {
          "code": "DE",
          "name": "Germany"
      },
      "vat_amount": "33.25",
      "vat_category": "standard",
      "vat_rate": "0.190"
  }
  ```
</ResponseExample>

### Parámetros de solicitud

<ParamField query="api_key" type="String" required>
  Su clave API única. Tenga en cuenta que cada usuario tiene claves API únicas para cada una de las APIs de Cleariflow, por lo que su clave de la API de validación de IVA no funcionará para su API de geolocalización IP, por ejemplo.
</ParamField>

<ParamField query="amount" type="String" required>
  El importe para el que desea obtener el monto de IVA o calcularlo a partir de él.
</ParamField>

<ParamField query="country_code" type="String" required>
  El código ISO 3166-1 alpha-2 de dos letras del país en el que tiene lugar la transacción.
</ParamField>

<ParamField query="category" type="String" required>
  La categoría de IVA a utilizar para el cálculo. Use "standard" para la tasa estándar de IVA, o categorías específicas como "e-books", "audiobooks", etc. para tasas reducidas.
</ParamField>

<ParamField query="is_vat_incl" type="Boolean">
  Si el importe ya incluye IVA y desea realizar el cálculo inverso para separar el importe y el IVA, establezca este parámetro en true. Si este parámetro no se incluye explícitamente, su valor predeterminado será false.
</ParamField>

### Parámetros de respuesta

La respuesta de la API se devuelve en un [formato JSON](https://www.json.org/json-en.html) universal y ligero.

<ResponseField name="amount_excluding_vat" type="String">
  El importe sin IVA.
</ResponseField>

<ResponseField name="amount_including_vat" type="String">
  La suma del importe base y el IVA, es decir, `amount_excluding_vat` + `vat_amount`.
</ResponseField>

<ResponseField name="vat_amount" type="String">
  El importe de IVA calculado.
</ResponseField>

<ResponseField name="vat_category" type="String">
  La categoría de la compra, utilizada para determinar si califica para una tasa reducida. Consulte a continuación una lista de categorías admitidas.
</ResponseField>

<ResponseField name="vat_rate" type="String">
  La tasa de IVA como cadena decimal (p. ej., "0.190" para el 19 %).
</ResponseField>

<ResponseField name="country" type="Object">
  Objeto que contiene información del país.
</ResponseField>

<ResponseField name="country.code" type="String">
  El código ISO 3166-1 alpha-2 de dos letras del país en el que tiene lugar la transacción.
</ResponseField>

<ResponseField name="country.name" type="String">
  El nombre del país desde el que se calcula el IVA.
</ResponseField>