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

# Facturas

## Obtener el listado de facturas

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

#### 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)                          |
| uuid                   | string  | Filtro por UUID                                                                                      |
| 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> |

## Crear Factura

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

#### 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>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",
      "descripcion_adicional": "Concepto diferente para esta partida"
    }
]
</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>cliente_rfc</td><td>string</td><td>RFC del cliente (este parámetro es opcional si se especifica cliente)</td></tr><tr><td>cliente</td><td>integer</td><td>ID de cliente (este parámetro es opcional si se especifica cliente_rfc)</td></tr><tr><td>vendedor</td><td>integer</td><td>ID de empleado para asignarlo como vendedor a la factura</td></tr><tr><td>metodo_pago</td><td>string</td><td>Valores permitidos: PPD o PUE (si no se especifica se intentará tomar del cliente)</td></tr><tr><td>forma_pago</td><td>string</td><td>Posibles valores: "01", "02", "03", "04", "05", "06", "08", "12", "13", "14", "15", "17", "23", "24", "25", "26", "27", "28", "29", "30", "31", "99" (si no se especifica se intentará tomar del 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
    },
    "uso_cfdi": "P01"
}
```

{% endtab %}
{% endtabs %}

## Obtener PDF's de facturas

Para consultar el PDF de una factura podemos usar la URL que se retorna en la propiedad `url_pdf` del  objeto de factura agregando adicional el parámetro GET `access_token` ó `api_key` dependiendo el caso, ejemplo:

**Ejemplo de la URL si se tiene un token JWT**

https\://{clave}.admintotal.com/api/v2/movimientos/facturas/?access\_token={mi\_access\_token}

**Ejemplo de la URL si se tiene un api key**

https\://{clave}.admintotal.com/api/v2/movimientos/facturas/?api\_key={api\_key}