> 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

Consultar, editar o crear facturas a clientes

## Endpoints disponibles

<table><thead><tr><th width="127.837890625">Method</th><th>Endpoint</th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>GET</strong></mark></td><td><code>https://{clave}.admintotal.com/api/v2/movimientos/facturas/</code> </td></tr><tr><td><mark style="color:blue;"><strong>GET</strong></mark></td><td><code>https://{clave}.admintotal.com/api/v2/movimientos/facturas/{id}/</code> </td></tr><tr><td><mark style="color:green;"><strong>POST</strong></mark></td><td><code>https://{clave}.admintotal.com/api/v2/movimientos/facturas/</code></td></tr></tbody></table>

## Obtener el listado de facturas

Obtiene el listado de facturas registradas. \
La consulta puede limitarse utilizando los parámetros de filtrado disponibles.

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

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

| Name         | Type   | Description            |
| ------------ | ------ | ---------------------- |
| Api-key      | string | Token de autenticacion |
| {% endtab %} |        |                        |

{% tab title="Parámetros GET" %}

<table><thead><tr><th width="220.041259765625">Name</th><th width="85.541015625">Type</th><th width="226.8460693359375">Description</th><th>Values</th></tr></thead><tbody><tr><td><code>cliente</code></td><td>integer</td><td>Filtro por identificador único del cliente.</td><td>—</td></tr><tr><td><code>cliente_razon_social</code></td><td>string</td><td>Filtro por razón social de cliente.</td><td>—</td></tr><tr><td><code>fecha</code></td><td>string</td><td>Filtro por fecha.</td><td>Formato: YYYY-MM-DD</td></tr><tr><td><code>desde</code></td><td>string</td><td>Filtro por fecha donde sea mayor o igual a este valor. </td><td>Formato: YYYY-MM-DD</td></tr><tr><td><code>hasta</code></td><td>string</td><td>Filtro por fecha donde sea menor o igual a este valor. </td><td>Formato: YYYY-MM-DD</td></tr><tr><td><code>uuid</code></td><td>string</td><td>Filtro por UUID.</td><td>—</td></tr><tr><td><code>folio</code></td><td>integer</td><td>Filtro por folio.</td><td>—</td></tr><tr><td><code>serie</code></td><td>string</td><td>Filtro por serie.</td><td>—</td></tr><tr><td><code>cancelado</code> </td><td>integer</td><td>Filtro por movimiento cancelado.</td><td><code>0</code>: Mostrará solo activos.<br><code>1</code>: Mostrará solo cancelados.</td></tr><tr><td><code>centro_responsabilidad</code></td><td>integer</td><td>Filtro por identificador único del centro de responsabilidad.</td><td>—</td></tr></tbody></table>
{% endtab %}

{% tab title="200 OK" %}

```json
}
    "count": 722,
    "next": "https://{clave}.admintotal.com/api/v2/clientes/",
    "previous": null,
    "results": [
        {
            "id": 4659569,
            "status": 1,
            "status_display": "Pendientes",
            "almacen": 9,
            "fecha": "2026-09-03",
            "fecha_vencimiento": "2026-09-03",
            "iva": "20.800000",
            "subtotal": "130.00",
            "total": "150.800000",
            "uso_cfdi": "G01",
            "comentarios": "",
            "mostrar_comentarios": true,
            "forma_pago": "01",
            "detalles": [
                {
                    "id": 5323921,
                    "factura": null,
                    "producto": 8355,
                    "cantidad": "1.0000",
                    "precio_unitario": "130.000000",
                    "importe": "130.000000",
                    "iva": "20.800000",
                    "ieps": "0.000000",
                    "entrega_domicilio": true
                }
            ],
            "creado": "2026-09-03T16:58:23.884366-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,
            "factura_pagada": "Sí",
            "vendedor": "",
            "saldo": "150.80",
            "mensualidad": null,
            "condicion": "Contado",
            "poliza_texto": "",
            "descuento": "0.00",
            "moneda": "MXN",
            "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": 208,
            "folio_completo": "F208",
            "centro_responsabilidad": {
                "id": 4,
                "numero": "3",
                "nombre": "TERCERO"
            },
            "url_pdf": "http://{clave}.admintotal.com/admin/pdf_salida/4659569/",
            "cliente": {
                "id": 1850,
                "activo": true,
                "tipo_cliente": 2,
                "razon_social": "Empresa cliente",
                "codigo": "",
                "referencia": "",
                "nombre_comercial": "",
                "sitio_web": "",
                "rfc": "HHH140305BI0",
                "curp": "",
                "limite_credito": "0.00",
                "representante_legal": "",
                "direccion": {
                    "id": 24827,
                    "municipio": "Hermosillo, Hermosillo",
                    "localidad": "",
                    "estado": "Sonora",
                    "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
                },
                "bloquear_vencido": true,
                "dias_cortar_credito": 0,
                "dias_credito": 0,
                "regimen_fiscal": "616",
                "creado": "2023-01-31T11:06:18.440186-07:00",
                "usuario_creado": 23,
                "direccion_txt": "Blvd Antonio Quiroga 142  C.P. 83224 Hermosillo, Sonora.",
                "almacen_precios": {
                    "id": 9,
                    "codigo": "001",
                    "nombre": "001 Matriz"
                },
                "clasificacion": null,
                "segmentacion": null
            },
            "metodo_pago": 0
        },
        ...
    ]
}
```

{% endtab %}
{% endtabs %}

### Campos principales facturas

<table><thead><tr><th width="218.82464599609375">Name</th><th width="94.10546875">Type</th><th>Description</th><th>Values</th></tr></thead><tbody><tr><td><code>id</code></td><td>integer</td><td>Identificador único de la factura creada.</td><td>—</td></tr><tr><td><code>status</code></td><td>integer</td><td>Identificador numérico del estado actual de la factura.</td><td>—</td></tr><tr><td><code>status_display</code></td><td>string</td><td>Descripción legible del estado actual de la factura.</td><td>—</td></tr><tr><td><code>almacen</code></td><td>integer</td><td>Identificador del almacén asociado a la factura.</td><td>—</td></tr><tr><td><code>fecha</code></td><td>string</td><td>Fecha de la factura.</td><td>Formato: YYYY-MM-DD</td></tr><tr><td><code>fecha_vencimiento</code></td><td>string</td><td>Fecha de vencimiento de la factura.</td><td>Formato: YYYY-MM-DD</td></tr><tr><td><code>iva</code></td><td>decimal</td><td>Importe total correspondiente al IVA.</td><td>—</td></tr><tr><td><code>subtotal</code></td><td>decimal</td><td>Importe de la factura antes de impuestos.</td><td>—</td></tr><tr><td><code>total</code></td><td>decimal</td><td>Importe total de la factura.</td><td>—</td></tr><tr><td><code>uso_cfdi</code></td><td>string</td><td>Clave de uso del CFDI asignada a la factura.</td><td>—</td></tr><tr><td><code>comentarios</code></td><td>string</td><td>Comentarios asociados a la factura.</td><td>—</td></tr><tr><td><code>mostrar_comentarios</code></td><td>boolean</td><td>Configurar si se desea mostrar los comentarios ingresados en la factura.</td><td>—</td></tr><tr><td><code>forma_pago</code></td><td>string</td><td>Clave SAT correspondiente a la forma de pago. Si no se especifica, se intentará utilizar la configurada en el cliente.</td><td>—</td></tr><tr><td><code>detalles</code></td><td>array</td><td>Productos incluidos en la factura.</td><td>—</td></tr><tr><td><code>creado</code></td><td>datetime</td><td>Fecha y hora en que se creó el registro.</td><td>Formato: YYYY-MM-DDTHH:mm:ss±hh:mm</td></tr><tr><td><code>xml_timbrado</code></td><td>string</td><td>Timbre Fiscal Digital autorizado y validado por el SAT.</td><td>—</td></tr><tr><td><code>cfdi_uuid</code></td><td>string</td><td>UUID del xml de la factura.</td><td>—</td></tr><tr><td><code>cfdi_status</code></td><td>string</td><td>Guarda el mensaje de error arrojado al intentar timbrar.</td><td>—</td></tr><tr><td><code>cancelado</code></td><td>boolean</td><td>Saber si la factura se encuentra cancelada o no.</td><td>—</td></tr><tr><td><code>motivo_cancelacion</code></td><td>string</td><td>Motivo por el cual la factura fue cancelada.</td><td>—</td></tr><tr><td><code>usuario_cancelacion</code></td><td>integer</td><td>Identificador numérico del usuario que canceló la factura.</td><td>—</td></tr><tr><td><code>fecha_cancelacion</code></td><td>string</td><td>Fecha de cancelación de la factura.</td><td>Formato: YYYY-MM-DD</td></tr><tr><td><code>fecha_entrega</code></td><td>string</td><td>Fecha de entrega de la factura.</td><td>Formato: YYYY-MM-DD</td></tr><tr><td><code>hora_entrega_a</code></td><td>string</td><td>Hora de inicio de la entrega.</td><td>Formato: HH:MM AM/PM</td></tr><tr><td><code>hora_entrega_b</code></td><td>string</td><td>Hora de fin de la entrega.</td><td>Formato: HH:MM AM/PM</td></tr><tr><td><code>factura_pagada</code></td><td>string</td><td>Indicador de la factura se encuentra pagada.</td><td>—</td></tr><tr><td><code>vendedor</code></td><td>string</td><td>Nombre del vendedor de la factura.</td><td>—</td></tr><tr><td><code>saldo</code></td><td>decimal</td><td>Total neto de la factura.</td><td>—</td></tr><tr><td><code>mensualidad</code></td><td>integer</td><td>Identificador numérico de la mensualidad asociada a la factura.</td><td>—</td></tr><tr><td><code>condicion</code></td><td>string</td><td>Plazo para la liquidación de la factura.</td><td>—</td></tr><tr><td><code>poliza_texto</code></td><td>string</td><td>Número de Póliza.</td><td>—</td></tr><tr><td><code>descuento</code></td><td>decimal</td><td>Descuento aplicado para la factura.</td><td>—</td></tr><tr><td><code>moneda</code></td><td>string</td><td>Moneda en la que se expresan los importes de la factura.</td><td>—</td></tr><tr><td><code>direccion_entrega</code></td><td>object</td><td>Dirección de entrega asociada a la factura.</td><td>—</td></tr><tr><td><code>folio</code></td><td>integer</td><td>Número de folio asignado a la factura.</td><td>—</td></tr><tr><td><code>folio_completo</code></td><td>string</td><td>Folio de la factura con el formato utilizado por el sistema.</td><td>—</td></tr><tr><td><code>centro_responsabilidad</code></td><td>object</td><td>Centro de responsabilidad ligado a la factura.</td><td>—</td></tr><tr><td><code>url_pdf</code></td><td>string</td><td>URL del PDF de la factura.</td><td>—</td></tr><tr><td><code>cliente</code></td><td>object</td><td>Información del cliente asociado a la factura.</td><td>—</td></tr><tr><td><code>metodo_pago</code></td><td>string</td><td><p>Método de pago del CFDI.</p><p>Valores permitidos: <code>PPD</code> o <code>PUE</code>. Si no se especifica, se intentará utilizar el configurado en el cliente.</p></td><td>—</td></tr></tbody></table>

<details>

<summary><strong>Status</strong> <mark style="color:$info;">( <code>status</code> )</mark></summary>

<table><thead><tr><th width="135.4453125">Value</th><th width="336.953125">Description</th></tr></thead><tbody><tr><td><code>1</code></td><td>Pendiente</td></tr><tr><td><code>2</code></td><td>Parciales</td></tr><tr><td><code>3</code></td><td>No pendiente</td></tr><tr><td><code>4</code></td><td>Cerrado</td></tr><tr><td><code>5</code></td><td>Aprobado</td></tr><tr><td><code>21</code></td><td>En proceso</td></tr><tr><td><code>22</code></td><td>Terminada</td></tr><tr><td><code>23</code></td><td>Entregada</td></tr><tr><td><code>24</code></td><td>Cancelada</td></tr><tr><td><code>25</code></td><td>Cerrada por cancelación backorder</td></tr><tr><td><code>30</code></td><td>Incidencia</td></tr></tbody></table>

</details>

<details>

<summary><strong>Formas de pago</strong> <mark style="color:$info;">( <code>forma_pago</code> )</mark></summary>

<table><thead><tr><th width="185.12847900390625">Value</th><th width="347.3837890625">Description</th></tr></thead><tbody><tr><td><code>01</code></td><td>Efectivo.</td></tr><tr><td><code>02</code></td><td>Cheque nominativo.</td></tr><tr><td><code>03</code></td><td>Transferencia electrónica de fondos.</td></tr><tr><td><code>04</code></td><td>Tarjeta de crédito.</td></tr><tr><td><code>05</code></td><td>Monedero electrónico.</td></tr><tr><td><code>06</code></td><td>Dinero electrónico.</td></tr><tr><td><code>08</code></td><td>Vales de despensa.</td></tr><tr><td><code>12</code></td><td>Dación en pago.</td></tr><tr><td><code>13</code></td><td>Pago por subrogación.</td></tr><tr><td><code>14</code></td><td>Pago por consignación.</td></tr><tr><td><code>15</code></td><td>Condonación.</td></tr><tr><td><code>17</code></td><td>Compensación.</td></tr><tr><td><code>23</code></td><td>Novación.</td></tr><tr><td><code>24</code></td><td>Confusión.</td></tr><tr><td><code>25</code></td><td>Remisión de deuda.</td></tr><tr><td><code>26</code></td><td>Prescripción o caducidad.</td></tr><tr><td><code>27</code></td><td>A satisfacción del acreedor.</td></tr><tr><td><code>28</code></td><td>Tarjeta de débito.</td></tr><tr><td><code>29</code></td><td>Tarjeta de servicio.</td></tr><tr><td><code>30</code></td><td>Aplicación de anticipos.</td></tr><tr><td><code>31</code></td><td>Intermediario pagos.</td></tr><tr><td><code>99</code></td><td>Por definir.</td></tr></tbody></table>

</details>

<details>

<summary><strong>Detalles</strong> <mark style="color:$info;">( <code>detalles</code> )</mark></summary>

El arreglo `detalles` contiene los productos o conceptos que conforman la factura.\
Cada elemento representa una partida de la factura.

```
[
    {
        "id": 33,
        "producto": 8355,
        "cantidad": "1.0000",
        "precio_unitario": "130.000000",
        "importe": "1560.000000",
        "iva": "249.600000",
        "ieps": "0.000000",
        "entrega_domicilio": true
    }
],
```

#### Campos de cada detalle.

<table><thead><tr><th width="181.0496826171875">Name</th><th width="102.8984375">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>id</code></td><td>integer</td><td>Identificador único del detalle</td></tr><tr><td><code>producto</code></td><td>integer</td><td>Identificador único del producto.</td></tr><tr><td><code>cantidad</code></td><td>decimal</td><td>Cantidad del producto incluida en la factura.</td></tr><tr><td><code>precio_unitario</code></td><td>decimal</td><td>Precio por unidad del producto.</td></tr><tr><td><code>importe</code></td><td>string</td><td>Importe del producto.</td></tr><tr><td><code>iva</code></td><td>decimal</td><td>IVA del producto.</td></tr><tr><td><code>ieps</code></td><td>decimal</td><td>IEPS del producto.</td></tr><tr><td><code>entrega_domicilio</code></td><td>boolean</td><td>Indicador que el producto requiere entregar a domicilio.</td></tr></tbody></table>

</details>

<details>

<summary><strong>Factura pagada</strong> <mark style="color:$info;">( <code>factura_pagada</code> )</mark></summary>

La factura **se marca como pagada** cuando su saldo se reduce a cero.

<table><thead><tr><th width="245.33984375">value</th><th width="234.484375">Description</th></tr></thead><tbody><tr><td>"Si"</td><td>Factura pagada.</td></tr><tr><td>"No"</td><td>Factura NO pagada.</td></tr><tr><td>"Cancelada"</td><td>Factura cancelada.</td></tr></tbody></table>

</details>

<details>

<summary><strong>Centro de Responsabilidad</strong> <mark style="color:$info;">( <code>centro_responsabilidad</code> )</mark></summary>

<table><thead><tr><th width="127.9296875">Name</th><th width="179.05859375">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>id</code></td><td>integer</td><td>Identificador único del centro de responsabilidad.</td></tr><tr><td><code>numero</code></td><td>string</td><td>Número que se le definió al centro de responsabilidad.</td></tr><tr><td><code>nombre</code></td><td>string</td><td>Nombre del centro de responsabilidad.</td></tr></tbody></table>

</details>

<details>

<summary><strong>Dirección de entrega</strong> <mark style="color:$info;">( <code>direccion_entrega</code> )</mark></summary>

El objeto `direccion_entrega` contiene la información del domicilio en el que se realizará la entrega.

<table><thead><tr><th width="145.2977294921875">Name</th><th width="131.49481201171875">Type</th><th>Descripcion</th></tr></thead><tbody><tr><td><code>nombre</code></td><td>string</td><td>Nombre utilizado para identificar la dirección de entrega.</td></tr><tr><td><code>direccion</code></td><td>object</td><td>Datos completos del domicilio.</td></tr><tr><td><code>es_sucuersal</code></td><td>boolena</td><td>Indica si la dirección corresponde a una sucursal registrada.</td></tr></tbody></table>

**direccion\_entrega.direccion**

<table><thead><tr><th width="177.27685546875">Name</th><th width="129.75958251953125">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>municipio</code></td><td>string</td><td>Municipio de la dirección.</td></tr><tr><td><code>localidad</code></td><td>string</td><td>Localidad de la dirección.</td></tr><tr><td><code>estado</code></td><td>string</td><td>Estado o entidad federativa.</td></tr><tr><td><code>calle</code></td><td>string</td><td>Nombre de la calle.</td></tr><tr><td><code>colonia</code></td><td>string</td><td>Colonia de la dirección.</td></tr><tr><td><code>cp</code></td><td>string</td><td>Código postal.</td></tr><tr><td><code>telefono</code></td><td>string</td><td>Número telefónico asociado a la dirección.</td></tr><tr><td><code>email</code></td><td>string</td><td>Correo electrónico asociado a la dirección.</td></tr><tr><td><code>numero_e</code></td><td>string</td><td>Número exterior.</td></tr><tr><td><code>numero_i</code></td><td>string</td><td>Número interior.</td></tr><tr><td><code>pais_residencia</code></td><td>string</td><td>Clave del país de residencia.</td></tr><tr><td><code>latitud</code></td><td>decimal</td><td>Latitud geográfica de la dirección.</td></tr><tr><td><code>longitud</code></td><td>decimal</td><td>Longitud geográfica de la dirección.</td></tr><tr><td><code>referencia</code></td><td>string</td><td>Información adicional para localizar el domicilio.</td></tr></tbody></table>

</details>

<details>

<summary><strong>Cliente</strong> <mark style="color:$info;">( <code>cliente</code> )</mark></summary>

<table><thead><tr><th width="210.55859375">Name</th><th width="138.19921875">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>id</code></td><td>integer</td><td>Identificador único del cliente.</td></tr><tr><td><code>activo</code></td><td>boolean</td><td>Indicador de actividad del cliente</td></tr><tr><td><code>tipo_cliente</code></td><td>number</td><td>Tipo de cliente.</td></tr><tr><td><code>razon_social</code></td><td>string</td><td>Razón social o nombre fiscal del cliente.</td></tr><tr><td><code>codigo</code></td><td>string</td><td>Código interno utilizado para identificar al cliente.</td></tr><tr><td><code>referencia</code></td><td>string</td><td>Referencia adicional asociada al cliente.</td></tr><tr><td><code>nombre_comercial</code></td><td>string</td><td>Nombre comercial del cliente.</td></tr><tr><td><code>sitio_web</code></td><td>string</td><td>Sitio web del cliente.</td></tr><tr><td><code>rfc</code></td><td>string</td><td>RFC del cliente</td></tr><tr><td><code>curp</code></td><td>string</td><td>CURP del cliente.</td></tr><tr><td><code>limite_credito</code></td><td>decimal</td><td>Monto máximo de crédito autorizado para el cliente.</td></tr><tr><td><code>representante_legal</code></td><td>string</td><td>Representante legal del cliente.</td></tr><tr><td><code>direccion</code></td><td>object</td><td>Objeto de relacion con una direccion por Información del domicilio principal del cliente.</td></tr><tr><td><code>bloquear_vencido</code></td><td>boolean</td><td>Restringir ventas con facturas vencidas.</td></tr><tr><td><code>dias_cortar_credito</code></td><td>integer</td><td>Días de gracia por defecto para facturas vencidas.</td></tr><tr><td><code>dias_credito</code></td><td>integer</td><td>Número de días de crédito otorgados al cliente.</td></tr><tr><td><code>regimen_fiscal</code></td><td>string</td><td>Régimen Fiscal del cliente.</td></tr><tr><td><code>creado</code></td><td>string</td><td>Identificador único del usuario que creó al cliente.</td></tr><tr><td><code>usuario_creado</code></td><td>integer</td><td>Usuario que creó el registro del cliente.</td></tr><tr><td><code>direccion_txt</code></td><td>string</td><td>Direccion escrita del cliente.</td></tr><tr><td><code>almacen_precios</code></td><td>object</td><td>Precios por almacén del cliente.</td></tr><tr><td><code>clasificacion</code></td><td>object</td><td>Clasificación del cliente.</td></tr><tr><td><code>segmentacion</code></td><td>object</td><td>Segmentación del cliente.</td></tr></tbody></table>

</details>

## Obtener una factura

Obtiene la información detallada de un cliente específico.

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

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

| Name         | Type   | Description             |
| ------------ | ------ | ----------------------- |
| Api-key      | string | Token de autenticación. |
| {% endtab %} |        |                         |

{% tab title="Respuesta 200" %}

```json
{
    "id": 4659569,
    "status": 1,
    "status_display": "Pendientes",
    "almacen": 9,
    "fecha": "2026-09-03",
    "fecha_vencimiento": "2026-09-03",
    "iva": "20.800000",
    "subtotal": "130.00",
    "total": "150.800000",
    "uso_cfdi": "G01",
    "comentarios": "",
    "mostrar_comentarios": true,
    "forma_pago": "01",
    "detalles": [
        {
            "id": 5323921,
            "factura": null,
            "producto": 8355,
            "cantidad": "1.0000",
            "precio_unitario": "130.000000",
            "importe": "130.000000",
            "iva": "20.800000",
            "ieps": "0.000000",
            "entrega_domicilio": true
        }
    ],
    "creado": "2026-09-03T16:58:23.884366-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,
    "factura_pagada": "Si",
    "vendedor": "",
    "saldo": "150.80",
    "mensualidad": null,
    "condicion": "Contado",
    "poliza_texto": "",
    "descuento": "0.00",
    "moneda": "MXN",
    "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": 208,
    "folio_completo": "F208",
    "centro_responsabilidad": {
        "id": 4,
        "numero": "3",
        "nombre": "TERCERO"
    },
    "url_pdf": "http://{clave}.admintotal.com/admin/pdf_salida/4659569/",
    "campos_personalizados": [],
    "movimiento_origen": null,
    "movimientos_relacionados": [],
    "cliente": {
        "id": 1850,
        "activo": true,
        "tipo_cliente": 2,
        "razon_social": "Empresa cliente",
        "codigo": "",
        "referencia": "",
        "nombre_comercial": "",
        "sitio_web": "",
        "rfc": "HHH140305BI0",
        "curp": "",
        "limite_credito": "0.00",
        "representante_legal": "",
        "direccion": {
            "id": 24827,
            "municipio": "Hermosillo, Hermosillo",
            "localidad": "",
            "estado": "Sonora",
            "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
        },
        "bloquear_vencido": true,
        "dias_cortar_credito": 0,
        "dias_credito": 0,
        "regimen_fiscal": "616",
        "creado": "2023-01-31T11:06:18.440186-07:00",
        "usuario_creado": 23,
        "direccion_txt": "Blvd Antonio Quiroga 142  C.P. 83224 Hermosillo, Sonora.",
        "almacen_precios": {
            "id": 9,
            "codigo": "001",
            "nombre": "001 Matriz"
        },
        "clasificacion": null,
        "segmentacion": null
    },
    "metodo_pago": 0
}
```

{% endtab %}
{% endtabs %}

### Campos adicionales disponibles al consultar una factura individual

{% hint style="info" %}
Cuando se consulta una factura de forma individual, se muestran campos adicionales que permiten obtener información más detallada sobre esa factura en especifico.
{% endhint %}

<table><thead><tr><th width="240.8427734375">Name</th><th width="113.3466796875">Type</th><th>Descripcion</th></tr></thead><tbody><tr><td><code>movimiento_origen</code></td><td>string</td><td>Describe desde que parte del sistema fue creada la factura.</td></tr><tr><td><code>movimientos_relacionados</code></td><td>array</td><td>Muestra los documentos relacionados a la factura.</td></tr><tr><td><code>campos_personalizados</code></td><td>array</td><td>Campos personalizados.</td></tr></tbody></table>

<details>

<summary><strong>Detalles</strong> <mark style="color:$info;">( <code>detalles</code> )</mark></summary>

Campos adicionales en los detalles al consultar una factura individual.&#x20;

<table><thead><tr><th width="224.1795654296875">Name</th><th width="102.8984375">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>descripcion</code></td><td>string</td><td>Identificador único del detalle.</td></tr><tr><td><code>descripcion_adicional</code></td><td>string</td><td>Identificador único del producto.</td></tr></tbody></table>

</details>

## Crear Factura

Crea una nueva factura asociada a un cliente.

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

### Request Body

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

| Name         | Type   | Description             |
| ------------ | ------ | ----------------------- |
| Api-key      | string | Token de autenticación. |
| {% endtab %} |        |                         |

{% tab title="Ejemplo Body" %}

#### Body básico para crear una factura.

El siguiente ejemplo muestra la estructura mínima o básica que puede enviarse en el cuerpo de la solicitud para crear una factura. Los campos pueden variar según los datos requeridos para cada cliente o factura.

```json
{
    "fecha": null,
    "cliente": 2647,
    "almacen": null,
    "comentarios": "",
    "detalles": [
        {
            "producto": 8355,
            "cantidad": "1.0000",
            "um": {
                "nombre": "Caja",
                "factor": 12
            },
            "precio_unitario": "130.000000",
            "descripcion_adicional": "Descripción de prueba 2"
        }
    ],
    "vendedor": null,
    "mostrar_comentarios": false,
    "campos_personalizados": [],
    "cliente_rfc": "AMR091120QD6",
    "cliente_cp": "",
    "cliente_regimen_fiscal": "",
    "uso_cfdi": "",
    "codigo_cliente": "",
    "codigo_almacen": "",
    "forma_pago": ""
}
```

{% endtab %}
{% endtabs %}

<table><thead><tr><th width="230.82672119140625">Name</th><th width="90.469970703125">Type</th><th width="107.19921875">Required</th><th width="314.843994140625">Description</th></tr></thead><tbody><tr><td><code>fecha</code></td><td>string</td><td>No</td><td>Fecha de la factura. <br><sub><mark style="color:$info;">Formato: YYYY-MM-DD</mark></sub></td></tr><tr><td><code>cliente</code></td><td>integer</td><td>Si</td><td><p>Identificador único del cliente. </p><p>Puede utilizarse cuando no se envía <code>cliente_rfc</code>.</p></td></tr><tr><td><code>almacen</code></td><td>integer</td><td>No</td><td>Identificador único del almacén. Si no se especifica, se utilizará el primer almacén.</td></tr><tr><td><code>direccion_entrega</code></td><td>object</td><td>No</td><td>Información de la dirección en la que se realizará la entrega.</td></tr><tr><td><code>comentarios</code></td><td>string</td><td>No</td><td>Comentarios u observaciones asociados a la factura.</td></tr><tr><td><code>detalles</code></td><td>array</td><td>Si</td><td>Lista de productos que conforman la factura.<br><sub><mark style="color:$info;">(Para especificar el producto puede ser por producto, producto_codigo o producto_codigo_proveedor)</mark></sub></td></tr><tr><td><code>vendedor</code></td><td>integer</td><td>No</td><td>Identificador único del empleado que será asignado como vendedor de la factura.</td></tr><tr><td><code>mostrar_comentarios</code></td><td>boolean</td><td>No</td><td>Indica si los comentarios de la factura deben mostrarse.</td></tr><tr><td><code>campos_personalizados</code></td><td>array</td><td>No</td><td>Lista de campos personalizados.</td></tr><tr><td><code>cliente_rfc</code></td><td>string</td><td>No</td><td>RFC del cliente. Puede utilizarse para identificar al cliente cuando no se envía <code>cliente</code>.</td></tr><tr><td><code>cliente_cp</code></td><td>string</td><td>No</td><td>Código postal del cliente.</td></tr><tr><td><code>cliente_regimen_fiscal</code></td><td>string</td><td>No</td><td>Régimen fiscal del cliente.</td></tr><tr><td><code>uso_cfdi</code></td><td>string</td><td>No</td><td>Clave del Uso de CFDI asignado a la factura, conforme al catálogo del SAT.</td></tr><tr><td><code>codigo_cliente</code></td><td>string</td><td>No</td><td>Código asignado al cliente.</td></tr><tr><td><code>codigo_almacen</code></td><td>string</td><td>No</td><td>Código asignado al almacén.</td></tr><tr><td><code>carta_porte</code></td><td>object</td><td>No</td><td>Información requerida para generar el complemento Carta Porte.</td></tr><tr><td><code>forma_pago</code></td><td>string</td><td>No</td><td>Clave SAT correspondiente a la forma de pago. Si no se especifica, se intentará utilizar la configurada en el cliente.</td></tr><tr><td><code>nombre_direccion_entrega</code></td><td>string</td><td>No</td><td>Nombre asignada a la dirección de entrega.</td></tr></tbody></table>

<details>

<summary><strong>Status</strong> <mark style="color:$info;">( <code>status</code> )</mark></summary>

<table><thead><tr><th width="135.4453125">Value</th><th width="336.953125">Description</th></tr></thead><tbody><tr><td><code>1</code></td><td>Pendiente</td></tr><tr><td><code>2</code></td><td>Parciales</td></tr><tr><td><code>3</code></td><td>No pendiente</td></tr><tr><td><code>4</code></td><td>Cerrado</td></tr><tr><td><code>5</code></td><td>Aprobado</td></tr><tr><td><code>21</code></td><td>En proceso</td></tr><tr><td><code>22</code></td><td>Terminada</td></tr><tr><td><code>23</code></td><td>Entregada</td></tr><tr><td><code>24</code></td><td>Cancelada</td></tr><tr><td><code>25</code></td><td>Cerrada por cancelación backorder</td></tr><tr><td><code>30</code></td><td>Incidencia</td></tr></tbody></table>

</details>

<details>

<summary><strong>Detalles</strong> <mark style="color:$info;">( <code>detalles</code> )</mark></summary>

El arreglo `detalles` contiene los productos o conceptos que conforman la factura.\
Cada elemento representa una partida de la factura.

```
[
    {
      "producto": 3131,
      "cantidad": 1,
      "um": {
        "nombre": "Caja",
        "factor": 12,
      },
      "precio_unitario": "30.00",
      "descripcion_adicional": "Concepto diferente para esta partida",
    }
],
```

#### Campos de cada detalle.

<table><thead><tr><th width="218.0418701171875">Name</th><th width="102.8984375">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>producto</code></td><td>integer</td><td>Identificador único del producto.</td></tr><tr><td><code>cantidad</code></td><td>decimal</td><td>Cantidad del producto incluida en la factura.</td></tr><tr><td><code>um</code></td><td>object</td><td>Unidad de medida utilizada para la partida.</td></tr><tr><td><code>precio_unitario</code></td><td>decimal</td><td>Precio por unidad del producto.</td></tr><tr><td><code>descripcion_adicional</code></td><td>string</td><td>Descripción adicional o personalizada de la partida.</td></tr></tbody></table>

</details>

<details>

<summary><strong>Dirección de entrega</strong> <mark style="color:$info;">( <code>direccion_entrega</code> )</mark></summary>

El objeto `direccion_entrega` contiene la información del domicilio en el que se realizará la entrega.

<table><thead><tr><th width="145.2977294921875">Name</th><th width="131.49481201171875">Type</th><th>Descripcion</th></tr></thead><tbody><tr><td><code>nombre</code></td><td>string</td><td>Nombre utilizado para identificar la dirección de entrega.</td></tr><tr><td><code>direccion</code></td><td>object</td><td>Datos completos del domicilio.</td></tr><tr><td><code>es_sucuersal</code></td><td>boolena</td><td>Indica si la dirección corresponde a una sucursal registrada.</td></tr></tbody></table>

**direccion\_entrega.direccion**

<table><thead><tr><th width="177.27685546875">Name</th><th width="129.75958251953125">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>municipio</code></td><td>string</td><td>Municipio de la dirección.</td></tr><tr><td><code>localidad</code></td><td>string</td><td>Localidad de la dirección.</td></tr><tr><td><code>estado</code></td><td>string</td><td>Estado o entidad federativa.</td></tr><tr><td><code>calle</code></td><td>string</td><td>Nombre de la calle.</td></tr><tr><td><code>colonia</code></td><td>string</td><td>Colonia de la dirección.</td></tr><tr><td><code>cp</code></td><td>string</td><td>Código postal.</td></tr><tr><td><code>telefono</code></td><td>string</td><td>Número telefónico asociado a la dirección.</td></tr><tr><td><code>email</code></td><td>string</td><td>Correo electrónico asociado a la dirección.</td></tr><tr><td><code>numero_e</code></td><td>string</td><td>Número exterior.</td></tr><tr><td><code>numero_i</code></td><td>string</td><td>Número interior.</td></tr><tr><td><code>pais_residencia</code></td><td>string</td><td>Clave del país de residencia.</td></tr><tr><td><code>latitud</code></td><td>decimal</td><td>Latitud geográfica de la dirección.</td></tr><tr><td><code>longitud</code></td><td>decimal</td><td>Longitud geográfica de la dirección.</td></tr><tr><td><code>referencia</code></td><td>string</td><td>Información adicional para localizar el domicilio.</td></tr></tbody></table>

</details>

<details>

<summary><strong>Unidad de medida</strong> <mark style="color:$info;">( <code>um</code> )</mark></summary>

<table><thead><tr><th width="131.478271484375">Name</th><th width="122.498291015625">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>nombre</code></td><td>string</td><td>Nombre de la unidad de medida.</td></tr><tr><td><code>factor</code></td><td>decimal</td><td>Factor de la unidad de medida.</td></tr></tbody></table>

</details>

<details>

<summary><strong>Formas de pago</strong> <mark style="color:$info;">( <code>forma_pago</code> )</mark></summary>

<table><thead><tr><th width="185.12847900390625">Value</th><th width="347.3837890625">Description</th></tr></thead><tbody><tr><td><code>01</code></td><td>Efectivo.</td></tr><tr><td><code>02</code></td><td>Cheque nominativo.</td></tr><tr><td><code>03</code></td><td>Transferencia electrónica de fondos.</td></tr><tr><td><code>04</code></td><td>Tarjeta de crédito.</td></tr><tr><td><code>05</code></td><td>Monedero electrónico.</td></tr><tr><td><code>06</code></td><td>Dinero electrónico.</td></tr><tr><td><code>08</code></td><td>Vales de despensa.</td></tr><tr><td><code>12</code></td><td>Dación en pago.</td></tr><tr><td><code>13</code></td><td>Pago por subrogación.</td></tr><tr><td><code>14</code></td><td>Pago por consignación.</td></tr><tr><td><code>15</code></td><td>Condonación.</td></tr><tr><td><code>17</code></td><td>Compensación.</td></tr><tr><td><code>23</code></td><td>Novación.</td></tr><tr><td><code>24</code></td><td>Confusión.</td></tr><tr><td><code>25</code></td><td>Remisión de deuda.</td></tr><tr><td><code>26</code></td><td>Prescripción o caducidad.</td></tr><tr><td><code>27</code></td><td>A satisfacción del acreedor.</td></tr><tr><td><code>28</code></td><td>Tarjeta de débito.</td></tr><tr><td><code>29</code></td><td>Tarjeta de servicio.</td></tr><tr><td><code>30</code></td><td>Aplicación de anticipos.</td></tr><tr><td><code>31</code></td><td>Intermediario pagos.</td></tr><tr><td><code>99</code></td><td>Por definir.</td></tr></tbody></table>

</details>

<details>

<summary><strong>Métodos de pago</strong> <mark style="color:$info;">( <code>metodo_pago</code> )</mark></summary>

| Value | Description                       |
| ----- | --------------------------------- |
| `PUE` | Pago en una sola exhibición.      |
| `PPD` | Pago en parcialidades o diferido. |

</details>

<details>

<summary><strong>Factura pagada</strong> <mark style="color:$info;">( <code>factura_pagada</code> )</mark></summary>

La factura **se marca como pagada** cuando su saldo se reduce a cero.

<table><thead><tr><th width="245.33984375">value</th><th width="234.484375">Description</th></tr></thead><tbody><tr><td>"Si"</td><td>Factura pagada.</td></tr><tr><td>"No"</td><td>Factura NO pagada.</td></tr><tr><td>"Cancelada"</td><td>Factura cancelada.</td></tr></tbody></table>

</details>

<details>

<summary><strong>Carta Porte</strong> <mark style="color:$info;">( <code>carta_porte</code> )</mark></summary>

El objeto `carta_porte` contiene la información necesaria para generar el complemento Carta Porte cuando la factura lo requiera.

Si la factura no utiliza Carta Porte, este objeto puede enviarse vacío.

<table><thead><tr><th width="220.575439453125">Name</th><th width="106.21356201171875">Type</th><th width="111.0654296875">Required</th><th>Description</th></tr></thead><tbody><tr><td>direccion_origen</td><td>object</td><td>Si</td><td>Dirección desde la cual inicia el traslado de las mercancías.</td></tr><tr><td>fecha_hora_origen</td><td>datetime</td><td>Si</td><td>Fecha y hora de salida desde el origen.<br><sub><mark style="color:$info;">Formato: YYYY-MM-DDTHH:mm:ss±hh:mm</mark></sub><br><sub><mark style="color:$info;">Ejemplo: 2026-08-11T07:06:01+00:00</mark></sub></td></tr><tr><td>remitente</td><td>integer</td><td>Si</td><td>Identificador del remitente registrado en el sistema.</td></tr><tr><td>direccion_destino</td><td>object</td><td>Si</td><td>Dirección final de entrega de las mercancías.</td></tr><tr><td>fecha_hora_destino</td><td>datetime</td><td>Si</td><td>Fecha y hora estimada o registrada de llegada al destino.<br><sub><mark style="color:$info;">Formato: YYYY-MM-DDTHH:mm:ss±hh:mm</mark></sub><br><sub><mark style="color:$info;">Ejemplo: 2026-08-11T07:06:01+00:00</mark></sub></td></tr><tr><td>destinatario</td><td>integer</td><td>Si</td><td>Identificador del  cliente destinatario registrado en el sistema.</td></tr><tr><td>vehiculo</td><td>integer</td><td>No</td><td>Identificador del vehículo utilizado para el traslado.</td></tr><tr><td>operador</td><td>integer</td><td>No</td><td>Identificador del operador responsable del traslado.</td></tr><tr><td>distancia_destino</td><td>decimal</td><td>Si</td><td>Distancia recorrida o estimada hasta el destino.</td></tr><tr><td>remolques</td><td>array</td><td>No</td><td>Lista de placas de remolques asociados al traslado.</td></tr><tr><td>remitente_rfc</td><td>string</td><td>No</td><td>RFC del remitente.</td></tr><tr><td>remitente_nombre</td><td>string</td><td>No</td><td>Nombre o razón social del remitente.</td></tr><tr><td>destinatario_rfc</td><td>string</td><td>No</td><td>RFC del destinatario.</td></tr><tr><td>destinatario_nombre</td><td>string</td><td>No</td><td>Nombre o razón social del destinatario.</td></tr><tr><td>vehiculo_placa</td><td>string</td><td>No</td><td>Placa del vehículo utilizado para el traslado.</td></tr><tr><td>nombre_aseguradora</td><td>string</td><td>No</td><td>Nombre de la aseguradora del vehículo.</td></tr><tr><td>num_poliza_seguro</td><td>string</td><td>No</td><td>Número de la póliza de seguro.</td></tr><tr><td>num_permiso_sct</td><td>string</td><td>No</td><td>Número del permiso otorgado.</td></tr><tr><td>configuracion_vehicular</td><td>string</td><td>No</td><td>Clave de configuración vehicular utilizada en Carta Porte.</td></tr><tr><td>operador_clave</td><td>string</td><td>No</td><td>Clave interna utilizada para identificar al operador.</td></tr><tr><td>operador_rfc</td><td>string</td><td>No</td><td>RFC del operador.</td></tr><tr><td>operador_nombre</td><td>string</td><td>No</td><td>Nombre del operador.</td></tr><tr><td>operador_direccion</td><td>object</td><td>Si</td><td>Domicilio del operador.</td></tr><tr><td>num_licencia_operador</td><td>string</td><td>No</td><td>Número de licencia del operador.</td></tr><tr><td>ubicaciones_intermedias</td><td>array</td><td>No</td><td>Lista de ubicaciones intermedias del recorrido.</td></tr><tr><td>mercancias</td><td>array</td><td>No</td><td>Lista de mercancías incluidas en el traslado.</td></tr></tbody></table>

</details>

### Respuesta 201 Created

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

```json
{
    "id": 112,
    "status": 1,
    "status_display": "Pendientes",
    "almacen": 9,
    "fecha": "2026-09-08",
    "fecha_vencimiento": "2026-10-08",
    "iva": "249.600000",
    "subtotal": "1560.00",
    "total": "1809.600000",
    "uso_cfdi": "",
    "comentarios": "",
    "mostrar_comentarios": false,
    "forma_pago": "99",
    "detalles": [
        {
            "id": 3536050,
            "producto": 125072,
            "cantidad": "3.0000",
            "precio_unitario": "220.0000",
            "importe": "660.000000",
            "iva": "105.600000",
            "ieps": "0.000000",
            "entrega_domicilio": true
        }
    ],
    "creado": "2026-09-08T16:06:34.102774-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,
    "factura_pagada": "No",
    "vendedor": "",
    "saldo": "",
    "mensualidad": null,
    "condicion": "",
    "poliza_texto": "",
    "descuento": "",
    "moneda": "MXN",
    "folio": 1,
    "folio_completo": "",
    "centro_responsabilidad": null,
    "direccion_entrega": {
        "id": 1,
        "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": ""
    },
    "url_pdf": "",
    "cliente": {
        "id": 10,
        "activo": true,
        "tipo_cliente": 1,
        "razon_social": "EMPRESA CLIENTE EJEMPLO",
        "codigo": "1",
        "referencia": "",
        "nombre_comercial": "",
        "sitio_web": "",
        "rfc": "",
        "curp": "",
        "limite_credito": "",
        "representante_legal": "",
        "direccion": {
            "id": 1,
            "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": ""
        },
        "bloquear_vencido": true,
        "dias_cortar_credito": null,
        "dias_credito": null,
        "regimen_fiscal": "",
        "creado": "2023-02-17T10:04:55.740310-07:00",
        "usuario_creado": 23,
        "direccion_txt": "",
        "almacen_precios": null,
        "clasificacion": null,
        "segmentacion": null,
        "monedero": "0"
    },
    "metodo_pago": 1
}
```

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

## Errores HTTP

Posibles códigos de error que puedes encontrar al consumir este recurso.

<table><thead><tr><th width="170.59765625"></th><th width="128.9375"></th><th width="215.58984375"></th><th></th></tr></thead><tbody><tr><td><h4><mark style="color:$warning;"><code>400</code></mark> </h4><p>Solicitud invalida</p></td><td><h4><mark style="color:$danger;"><code>403</code></mark> </h4><p>Sin permiso</p></td><td><h4><mark style="color:$danger;"><code>404</code></mark><br></h4><p>Registro no encontrado</p></td><td><h4><mark style="color:$danger;"><code>500</code></mark> </h4><p>Error interno del servidor</p></td></tr></tbody></table>