# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.admintotal.com/api/cotizaciones.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.