# Obtener opciones de montos

A través de este endpoint, se proporcionan hasta tres opciones de montos que cubren diferentes porcentajes del total de transacciones pendientes de conciliación. Las opciones varían en función del monto total por conciliar. Los usuarios o transportadores se identifican mediante su número telefónico o correo electrónico.

En la respuesta del endpoint, cada opción incluye un ID único que almacena las transacciones asociadas. Este ID es crucial para el uso en otro endpoint denominado '[Crear referencia de pago](https://docs.qentaz.com/documentation/conciliacion/crear-referencia-de-pago)', el cual genera una referencia de pago necesaria para realizar la consignación en un corresponsal.

{% hint style="info" %}
Para identificar al usuario al que se va a conciliar, es necesario proporcionar al menos uno de los siguientes datos: número de teléfono (merchant\_phone) o correo electrónico (merchant\_email).
{% endhint %}

## Ruta

<mark style="color:green;">`GET`</mark>`/v1/merchant/conciliation`

## **Encabezado**

| Name                                                   | Value              |
| ------------------------------------------------------ | ------------------ |
| `Content-Type`                                         | `application/json` |
| `x-auth-token`*<mark style="color:red;">**\***</mark>* | {{token}}          |

## **Cuerpo**

<table><thead><tr><th>Name</th><th>Type<select><option value="oVoHAIqE0fZb" label="string" color="blue"></option><option value="uKMfyvHmkdCi" label="date" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><code>merchant_phone</code></td><td><span data-option="oVoHAIqE0fZb">string</span></td><td>Número de celular del usuario que se desea conciliar (incluir el código de área del país).<br><br><em><mark style="color:blue;"><code>Ejemplo: 573112229999</code></mark></em></td></tr><tr><td><code>merchant_email</code></td><td><span data-option="oVoHAIqE0fZb">string</span></td><td>Correo electrónico del usuario que se desea conciliar.<br><br><em><mark style="color:blue;"><code>Ejemplo: usuario@minegocio.com</code></mark></em></td></tr><tr><td><code>start_date</code></td><td><span data-option="uKMfyvHmkdCi">date</span></td><td>La fecha incial en la que se desea realizar la conciliación.<br><br><mark style="color:green;"><code>Formato: AAAA/MM/DD</code></mark><br><br><em><mark style="color:blue;"><code>Ejemplo: 2025/01/30</code></mark></em></td></tr><tr><td><code>end_date</code></td><td><span data-option="uKMfyvHmkdCi">date</span></td><td>La fecha final en la que se desea realizar la conciliación.<br><br><mark style="color:green;"><code>Formato: AAAA/MM/DD</code></mark><br><br><em><mark style="color:blue;"><code>Ejemplo: 2025/01/30</code></mark></em></td></tr></tbody></table>

## **Respuesta**

{% tabs %}
{% tab title="200" %}

```json
{
 "options": [
   {
     "id": "ad28f10s",
     "coverage": 1,
     "quantity": 10,
     "amount": 1000000
   },
   {
     "id": "320g9f3",
     "coverage": 0.78,
     "quantity": 6,
     "amount": 780000
   },
   {
     "id": "019248gv",
     "coverage": 0.55,
     "quantity": 3,
     "amount": 550000
   }
 ]
}

```

{% endtab %}

{% tab title="400" %}

```json
{
    "error": "No transactions were found for reconciliation for the specified date (07/24/2024)."
}
```

{% endtab %}

{% tab title="401" %}

```json
{
    "status": "unauthorized",
    "code": "Q103",
    "error": "El x-auth-token se encuentra vencido. Por favor genera un nuevo token y reintenta de nuevo el cobro."
}
```

{% endtab %}
{% endtabs %}

## Ejemplo

{% tabs %}
{% tab title="cURL" %}

```bash
curl --location --request GET '{{base_url}}/v1/merchant/conciliation' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: {{token}}' \
--data '{
    "merchant_phone": "573112229999"
}'
```

{% endtab %}

{% tab title="NodeJS (Axios)" %}

```javascript
const axios = require('axios');
let data = JSON.stringify({
  "merchant_phone": "573112229999"
});

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: `${base_url}/v1/merchant/conciliation`,
  headers: { 
    'Content-Type': 'application/json', 
    'x-auth-token': token //Añadir token
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

{% endtab %}

{% tab title="Python" %}

```python
import requests
import json

url = f"{base_url}/v1/merchant/conciliation"

payload = json.dumps({
  "merchant_phone": "573112229999"
})
headers = {
  'Content-Type': 'application/json',
  'x-auth-token': token #Añadir token
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

```

{% endtab %}
{% endtabs %}