> 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/pedidos.md).

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