> For the complete documentation index, see [llms.txt](https://developers.admintotal.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.admintotal.com/api/cotizaciones.md).

# Cotizaciones

## Obtener un listado de Cotizaciones

<mark style="color:blue;">`GET`</mark> `https://{clave}.admintotal.com/api/v2/movimientos/cotizaciones/`

#### Parámetros GET disponibles

| Name                   | Type    | Description                                                                 |
| ---------------------- | ------- | --------------------------------------------------------------------------- |
| cliente                | integer | Filtro por ID de cliente                                                    |
| cliente\_razon\_social | string  | Filtro por razón social de cliente                                          |
| fecha                  | string  | Filtro por fecha (formato YYYY-MM-DD)                                       |
| desde                  | string  | Filtro por fecha donde sea mayor o igual a este valor  (formato YYYY-MM-DD) |
| hasta                  | string  | Filtro por fecha donde sea menor o igual a este valor  (formato YYYY-MM-DD) |
| prospecto              | integer | Filtro por ID de prospecto                                                  |

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

```javascript
{
    "count": 368,
    "next": "https://{clave}.admintotal.com/api/v2/cotizaciones/",
    "previous": null,
    "results": [
        {
            "id": 25319,
            "saldo": "0.00",
            "folio": 222,
            "serie": "",
            "orig_total": "297.000000",
            "moneda": {
                "nombre": "MXN"
            },
            "cancelado": false,
            "almacen": 1545,
            "motivo_cancelacion": "",
            "folio_completo": "222",
            "fecha": "09/11/2021",
            "fecha_vencimiento": "19/11/2021",
            "folio_serie": "000222",
            "vencida": false,
            "cliente": {
                "id": 1522,
                "activo": true,
                "tipo_cliente": 1,
                "razon_social": "PUBLICO EN GENERAL",
                "codigo": "",
                "referencia": "",
                "nombre_comercial": "",
                "sitio_web": "",
                "rfc": "XAXX010101000",
                "curp": "",
                "limite_credito": "10000000.00",
                "representante_legal": "",
                "direccion": {
                    "id": 3283,
                    "municipio": "",
                    "localidad": "",
                    "estado": "",
                    "calle": ".",
                    "colonia": "",
                    "cp": "",
                    "telefono": "",
                    "email": "",
                    "numero_e": "",
                    "numero_i": "",
                    "pais_residencia": "",
                    "latitud": "0.00000000",
                    "longitud": "0.00000000",
                    "referencia": ""
                },
                "bloquear_vencido": false,
                "dias_cortar_credito": 10,
                "saldo_pendiente": "1796182.8100",
                "dias_credito": 10
            }
        }
    ]
}
```

{% endtab %}
{% endtabs %}

## Crear una Cotización

<mark style="color:green;">`POST`</mark> `https://{clave}.admintotal.com/api/v2/movimientos/cotizaciones/`

Se tiene que especificar como mínimo un dato de estos datos del cliente (cliente, cliente\_rfc o cliente\_razon\_social)

#### Headers

| Name    | Type   | Description            |
| ------- | ------ | ---------------------- |
| Api-key | String | Token de autenticación |

#### Request Body

<table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>almacen</td><td>String</td><td>ID del almacén (en caso de no especificar se tomará el primer almacén)</td></tr><tr><td>cliente</td><td>String</td><td>ID de cliente (este parámetro es opcional si se especifica cliente_razon_social) </td></tr><tr><td>cliente_email</td><td>String</td><td>Email del cliente</td></tr><tr><td>cliente_razon_social</td><td>String</td><td>Razón social del cliente (este parámetro es opcional si se especifica cliente)</td></tr><tr><td>cliente_telefono</td><td>String</td><td>Teléfono del cliente</td></tr><tr><td>detalles</td><td>Array</td><td><p>Lista de objetos con la información de los productos de la factura (para especificar el producto puede ser por producto, producto_codigo o producto_codigo_proveedor), ejemplo: </p><pre class="language-json"><code class="lang-json">[
    {
      "cantidad": "1.00",
      "producto_codigo": "CAPCON",
      "descripcion": "Descripción del producto",
      "precio_unitario": "100.00",
      "um": {
        "factor": 1,
        "nombre": "Pieza"
      }
    }
]
</code></pre></td></tr><tr><td>fecha</td><td>String</td><td>Fecha de la cotización en formato ISO</td></tr><tr><td>cliente_rfc</td><td>String</td><td>RFC del cliente (este parámetro es opcional si se especifica cliente)</td></tr></tbody></table>

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

```javascript
{
    "count": 368,
    "next": "https://{clave}.admintotal.com/api/v2/cotizaciones/",
    "previous": null,
    "results": [
        {
            "id": 25319,
            "saldo": "0.00",
            "folio": 222,
            "serie": "",
            "orig_total": "297.000000",
            "moneda": {
                "nombre": "MXN"
            },
            "cancelado": false,
            "almacen": 1545,
            "motivo_cancelacion": "",
            "folio_completo": "222",
            "fecha": "09/11/2021",
            "fecha_vencimiento": "19/11/2021",
            "folio_serie": "000222",
            "vencida": false,
            "cliente": {
                "id": 1522,
                "activo": true,
                "tipo_cliente": 1,
                "razon_social": "PUBLICO EN GENERAL",
                "codigo": "",
                "referencia": "",
                "nombre_comercial": "",
                "sitio_web": "",
                "rfc": "XAXX010101000",
                "curp": "",
                "limite_credito": "10000000.00",
                "representante_legal": "",
                "direccion": {
                    "id": 3283,
                    "municipio": "",
                    "localidad": "",
                    "estado": "",
                    "calle": ".",
                    "colonia": "",
                    "cp": "",
                    "telefono": "",
                    "email": "",
                    "numero_e": "",
                    "numero_i": "",
                    "pais_residencia": "",
                    "latitud": "0.00000000",
                    "longitud": "0.00000000",
                    "referencia": ""
                },
                "bloquear_vencido": false,
                "dias_cortar_credito": 10,
                "saldo_pendiente": "1796182.8100",
                "dias_credito": 10
            }
        }
    ]
}
```

{% endtab %}
{% endtabs %}