# Pedidos

## Obtener listado de pedidos

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

#### 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)                          |
| folio                  | integer | Filtro por folio                                                                                     |
| serie                  | string  | Filtro por serie                                                                                     |
| cancelado              | int     | <p>Filtro por movimiento cancelado:<br>0 = Mostrará solo activos<br>1 = Mostrará solo cancelados</p> |

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

```
{
    "count": 33282,
    "next": "https://cliente.admintotal.com/api/v2/movimientos/pedidos/",
    "previous": null,
    "results": [
        {
            "id": 755484,
            "status": 1,
            "almacen": 9,
            "fecha": "2021-03-03",
            "iva": "105.600000",
            "subtotal": "660.00",
            "total": "765.600000",
            "comentarios": "",
            "detalles": [
                {
                    "id": 3536050,
                    "producto": 125072,
                    "cantidad": "3.0000",
                    "precio_unitario": "220.0000",
                    "importe": "660.000000",
                    "iva": "105.600000"
                }
            ],
            "creado": "2021-02-02T11:00:41.741114-07:00",
            "status_display": "Pendientes",
            "direccion_entrega": {
                "id": 32980,
                "municipio": "Hermosillo",
                "localidad": "Hermosillo",
                "estado": "Sonora",
                "calle": "Articulo 123",
                "colonia": "Misión del sol",
                "cp": "83100",
                "telefono": "",
                "email": "",
                "numero_e": "93A",
                "numero_i": "",
                "pais_residencia": "MEX",
                "latitud": null,
                "longitud": null,
                "referencia": ""
            },
            "folio": 25148,
            "folio_completo": "025148",
            "cliente": {
                "id": 3628,
                "activo": true,
                "tipo_cliente": 1,
                "razon_social": "221 Proyectos SA de CV",
                "codigo": "",
                "referencia": null,
                "nombre_comercial": "",
                "sitio_web": "",
                "rfc": "DVP140305BI0",
                "curp": "",
                "limite_credito": "0.00",
                "representante_legal": "",
                "direccion": {
                    "id": 24827,
                    "municipio": "Hermosillo, Hermosillo",
                    "localidad": "",
                    "estado": "Estado de México",
                    "calle": "Blvd Antonio Quiroga",
                    "colonia": "Real de Quiroga",
                    "cp": "83224",
                    "telefono": "",
                    "email": "jahaziel@admintotal.com",
                    "numero_e": "142",
                    "numero_i": "",
                    "pais_residencia": "",
                    "latitud": "0.00000000",
                    "longitud": "0.00000000",
                    "referencia": null
                },
                "saldo_pendiente": "0",
                "dias_credito": 0
            },
            "contacto": null
        },
        ...
    ]
}
```

{% endtab %}
{% endtabs %}

## Crear pedido

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

#### 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>contacto</td><td>object</td><td><p>Objeto con la información del contacto, ejemplo: </p><pre class="language-json"><code class="lang-json">{
    "nombre": "Nombre del ",
    "celular": "6623232323",
    "telefono": "",
    "email": "micorreo@midominio.com",
    "puesto": "",
    "extension": ""
  }
</code></pre></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">[
    {
      "producto": 3131,
      "cantidad": 1,
      "um": {
        "nombre": "Caja",
        "factor": 12
      },
      "precio_unitario": "30.00"
    }
]
</code></pre></td></tr><tr><td>direccion_entrega</td><td>object</td><td><p>Objeto  con la información de dirección de entrega, ejemplo:</p><pre class="language-json"><code class="lang-json">{
    "nombre": "Ejemplo 1",
    "direccion": {
      "municipio": "Hermosillo",
      "localidad": "Hermosillo",
      "estado": "Sonora",
      "calle": "Articulo 123",
      "colonia": "Misión del sol",
      "cp": "83100",
      "telefono": "",
      "email": "",
      "numero_e": "93A",
      "numero_i": "",
      "pais_residencia": "MEX",
      "latitud": null,
      "longitud": null,
      "referencia": ""
    }
}
</code></pre></td></tr><tr><td>comentarios</td><td>string</td><td>Comentarios sobre el pedido</td></tr><tr><td>fecha</td><td>string</td><td>Fecha del pedido en formato YYYY-MM-DD</td></tr><tr><td>almacen</td><td>integer</td><td>ID del almacén (en caso de no especificar se tomará el primer almacén)</td></tr><tr><td>rfc_cliente</td><td>string</td><td>RFC del cliente (este parámetro es opcional si se especifica cliente)</td></tr><tr><td>id_cliente</td><td>integer</td><td>ID de cliente (este parámetro es opcional si se especifica rfc_cliente) </td></tr><tr><td>codigo_cliente</td><td>String</td><td>ID de cliente (este parámetro es opcional si se especifica rfc_cliente o id_cliente) </td></tr></tbody></table>

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

```
{
    "id": 755484,
    "status": 1,
    "almacen": 9,
    "fecha": "2021-03-03",
    "iva": "105.600000",
    "subtotal": "660.00",
    "total": "765.600000",
    "comentarios": "",
    "detalles": [
        {
            "id": 3536050,
            "producto": 125072,
            "cantidad": "3.0000",
            "precio_unitario": "220.0000",
            "importe": "660.000000",
            "iva": "105.600000"
        }
    ],
    "creado": "2021-02-02T11:00:41.741114-07:00",
    "status_display": "Pendientes",
    "direccion_entrega": {
        "id": 32980,
        "municipio": "Hermosillo",
        "localidad": "Hermosillo",
        "estado": "Sonora",
        "calle": "Articulo 123",
        "colonia": "Misión del sol",
        "cp": "83100",
        "telefono": "",
        "email": "",
        "numero_e": "93A",
        "numero_i": "",
        "pais_residencia": "MEX",
        "latitud": null,
        "longitud": null,
        "referencia": ""
    },
    "folio": 25148,
    "folio_completo": "025148",
    "cliente": {
        "id": 3628,
        "activo": true,
        "tipo_cliente": 1,
        "razon_social": "Empresa cliente",
        "codigo": "",
        "referencia": null,
        "nombre_comercial": "",
        "sitio_web": "",
        "rfc": "HHH140305BI0",
        "curp": "",
        "limite_credito": "0.00",
        "representante_legal": "",
        "direccion": {
            "id": 24827,
            "municipio": "Hermosillo, Hermosillo",
            "localidad": "",
            "estado": "Estado de México",
            "calle": "Blvd Antonio Quiroga",
            "colonia": "Real de Quiroga",
            "cp": "83224",
            "telefono": "",
            "email": "email@empresa.com",
            "numero_e": "142",
            "numero_i": "",
            "pais_residencia": "",
            "latitud": "0.00000000",
            "longitud": "0.00000000",
            "referencia": null
        },
        "saldo_pendiente": "0",
        "dias_credito": 0
    },
    "contacto": null
}
```

{% 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/pedidos.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.