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

# Toma de Inventario

Obtener listado de Tomas de Inventario

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

#### Headers

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

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

```
{
    "count": 1106,
    "next": "https://{clave}.admintotal.com/api/v2/movimientos/toma_inventario/",
    "previous": null,
    "results": [
        {
            "id": 573455,
            "status": 1,
            "almacen": 9,
            "fecha": "2026-03-04",
            "fecha_vencimiento": "2026-03-04",
            "iva": "0.00",
            "subtotal": "0.00",
            "total": "0.00",
            "uso_cfdi": null,
            "comentarios": "Toma de inventario",
            "mostrar_comentarios": false,
            "forma_pago": null,
            "detalles": [],
            "creado": "2026-03-04T11:17:15.757397-07:00",
            "xml_timbrado": "",
            "cfdi_uuid": "",
            "cfdi_status": "",
            "cancelado": false,
            "motivo_cancelacion": "",
            "usuario_cancelacion": null,
            "fecha_cancelacion": null,
            "fecha_entrega": null,
            "hora_entrega_a": null,
            "hora_entrega_b": null,
            "centro_costo": 22,
            "tipo_cuenta": 0,
            "cuenta": null,
            "status_display": "Pendientes",
            "direccion_entrega": null,
            "folio": 292,
            "folio_completo": "292",
            "vendedor": "",
            "url_pdf": "",
            "proveedor": []
        }
    ]
}
```

{% endtab %}
{% endtabs %}

## Obtener una sola Toma de Inventario

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

#### Path Parameters

| Name | Type    | Description                 |
| ---- | ------- | --------------------------- |
| ID   | integer | ID de la Toma de Inventario |

#### Headers

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

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

```
{
    "id": 573455,
    "status": 1,
    "almacen": 9,
    "fecha": "2026-03-04",
    "fecha_vencimiento": "2026-03-04",
    "iva": "0.00",
    "subtotal": "0.00",
    "total": "0.00",
    "uso_cfdi": null,
    "comentarios": "Toma de inventario",
    "mostrar_comentarios": false,
    "forma_pago": null,
    "detalles": [
        {
            "id": 1831246,
            "producto": {
                "id": 37496,
                "codigo": "PRODUCTO DE EJEMPLO",
                "descripcion": "Lorem ipsum dolor..."
            },
            "cantidad": 4.0,
            "descripcion_adicional": "",
            "unidad": {
                "id": 1531,
                "nombre": "PIEZA",
                "factor": "1.00000000"
            },
            "precio_um": "0.0",
            "precio_unitario": "0.0",
            "importe": "0.0",
            "total": "0.0",
            "iva": "0.0",
            "ieps": "0.0"
        }
    ],
    "creado": "2026-03-04T11:17:15.757397-07:00",
    "xml_timbrado": "",
    "cfdi_uuid": "",
    "cfdi_status": "",
    "cancelado": false,
    "motivo_cancelacion": "",
    "usuario_cancelacion": null,
    "fecha_cancelacion": null,
    "fecha_entrega": null,
    "hora_entrega_a": null,
    "hora_entrega_b": null,
    "centro_costo": 22,
    "tipo_cuenta": 0,
    "cuenta": null,
    "status_display": "Pendientes",
    "direccion_entrega": null,
    "folio": 292,
    "folio_completo": "292",
    "vendedor": "",
    "url_pdf": "",
    "campos_personalizados": [],
    "movimiento_origen": null,
    "movimientos_relacionados": [],
    "proveedor": {
        "activo": false,
        "tipo_cliente": null,
        "razon_social": "",
        "codigo": "",
        "referencia": "",
        "nombre_comercial": "",
        "sitio_web": "",
        "rfc": "",
        "curp": "",
        "limite_credito": null,
        "representante_legal": "",
        "direccion": {
            "municipio": "",
            "localidad": "",
            "estado": "",
            "calle": "",
            "colonia": "",
            "cp": "",
            "telefono": "",
            "email": "",
            "numero_e": "",
            "numero_i": "",
            "pais_residencia": "",
            "latitud": null,
            "longitud": null,
            "referencia": ""
        },
        "bloquear_vencido": false,
        "dias_cortar_credito": null,
        "dias_credito": null,
        "regimen_fiscal": null
    }
}
```

{% endtab %}
{% endtabs %}

## Crear una Toma de Inventario

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

#### Headers

<table><thead><tr><th>Name</th><th width="202.13671875">Type</th><th>Description</th></tr></thead><tbody><tr><td>Api-key</td><td>String</td><td>Token de autenticación</td></tr></tbody></table>

<table><thead><tr><th width="275.52734375">Name</th><th width="199.97265625">Type</th><th>Description</th></tr></thead><tbody><tr><td>almacén</td><td>Integer</td><td>ID del almacén</td></tr><tr><td>detalles</td><td>Array</td><td><p>Lista de objetos con la información de los productos de la toma de inventario (para especificar el producto puede ser por producto, producto_codigo o producto_codigo_proveedor), ejemplo: </p><pre><code>[
    {
      "cantidad": "1.00",
      "producto_codigo": "PRODUCTO DE EJEMPLO",
      "descripcion": "Liquidar orden de compra"
      "precio_unitario": "100.00",
      "um": {
        "factor": 1,
        "nombre": "Pieza"
      }
    }
]
</code></pre></td></tr></tbody></table>

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

```
{
    "id": 573457,
    "status": 1,
    "almacen": 9,
    "fecha": "2026-03-05",
    "fecha_vencimiento": "2026-03-05",
    "iva": "0.00",
    "subtotal": "0.00",
    "total": "0.00",
    "uso_cfdi": null,
    "comentarios": "Toma de inventario",
    "mostrar_comentarios": false,
    "forma_pago": null,
    "detalles": [],
    "creado": "2026-03-05T15:09:06.998753-07:00",
    "xml_timbrado": "",
    "cfdi_uuid": "",
    "cfdi_status": "",
    "cancelado": false,
    "motivo_cancelacion": "",
    "usuario_cancelacion": null,
    "fecha_cancelacion": null,
    "fecha_entrega": null,
    "hora_entrega_a": null,
    "hora_entrega_b": null,
    "centro_costo": 22,
    "tipo_cuenta": 0,
    "cuenta": null,
    "status_display": "Pendientes",
    "direccion_entrega": null,
    "folio": 293,
    "folio_completo": "293",
    "vendedor": "",
    "url_pdf": "",
    "proveedor": []
}
```

{% endtab %}
{% endtabs %}