# Notas de venta

## Obtener listado de notas de venta

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

#### 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": 731,
    "next": "https://{clave}.admintotal.com/api/v2/movimientos/notas_venta/",
    "previous": null,
    "results": [
        {
            "id": 25320,
            "status": 1,
            "almacen": 1545,
            "fecha": "2021-11-09",
            "fecha_vencimiento": "2021-11-09",
            "iva": "33.103448",
            "subtotal": "206.90",
            "total": "240.000000",
            "uso_cfdi": "P01",
            "comentarios": "",
            "mostrar_comentarios": true,
            "forma_pago": 0,
            "detalles": [
                {
                    "id": 91874,
                    "producto": 11077,
                    "cantidad": "1.0000",
                    "precio_unitario": "206.8966",
                    "importe": "206.896552",
                    "iva": "33.103448"
                }
            ],
            "creado": "2021-11-09T10:40:50.974804-07:00",
            "xml_timbrado": "",
            "cancelado": false,
            "motivo_cancelacion": "",
            "usuario_cancelacion": null,
            "fecha_cancelacion": null,
            "metodo_pago": "28",
            "monto_efectivo": "0.0000",
            "monto_tarjeta": "0.0000",
            "monto_transferencia": "0.0000",
            "monto_cheque": "0.0000",
            "status_display": "Pendientes",
            "direccion_entrega": {
                "id": 3283,
                "municipio": "",
                "localidad": "",
                "estado": "",
                "calle": ".",
                "colonia": "",
                "cp": "",
                "telefono": "",
                "email": "",
                "numero_e": "",
                "numero_i": "",
                "pais_residencia": "",
                "latitud": "0.00000000",
                "longitud": "0.00000000",
                "referencia": ""
            },
            "folio": 606,
            "folio_completo": "606",
            "url_pdf": "https://{clave}.admintotal.com/admin/pdf_nota_venta/25320/",
            "cliente": {
                "id": 1522,
                "activo": true,
                "tipo_cliente": 1,
                "razon_social": "PUBLICO EN GENERAL",
                "codigo": "",
                "referencia": "",
                "nombre_comercial": "",
                "sitio_web": "",
                "rfc": "XAXX010101000",
                "curp": "",
                "limite_credito": "10000000.00",
                "representante_legal": "",
                "direccion": {
                    "id": 3283,
                    "municipio": "",
                    "localidad": "",
                    "estado": "",
                    "calle": ".",
                    "colonia": "",
                    "cp": "",
                    "telefono": "",
                    "email": "",
                    "numero_e": "",
                    "numero_i": "",
                    "pais_residencia": "",
                    "latitud": "0.00000000",
                    "longitud": "0.00000000",
                    "referencia": ""
                },
                "bloquear_vencido": false,
                "dias_cortar_credito": 10,
                "saldo_pendiente": "1796182.8100",
                "dias_credito": 10
            }
        }
    ]
}
```

{% endtab %}
{% endtabs %}

## Crear nota de venta

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

Para habilitar la auto-facturación de los clientes, es necesario especificar un valores en las propiedades "id\_externo" y "clave\_autofacturacion

#### 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>numero_tarjeta</td><td>integer</td><td>Últimos 4 digitos de la tarjeta</td></tr><tr><td>tipo_tarjeta</td><td>integer</td><td>1: crédito<br>2: débito</td></tr><tr><td>monto_tarjeta</td><td>number</td><td>Monto de tarjeta</td></tr><tr><td>monto_efectivo</td><td>number</td><td>Monto de efectivo</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_entgrega</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"><strong>{
</strong>    "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 la nota de venta</td></tr><tr><td>fecha</td><td>string</td><td>Fecha en formato ISO 8601</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>id_externo</td><td>string</td><td>Identificador externo para esta nota de venta (ejemplo: puede ser el folio del sistema externo que genera esta nota de venta)</td></tr><tr><td>clave_facturacion</td><td>string</td><td>Clave de facturación (6 caracteres recomendado), esta clave la necesita el cliente para auto-facturarse en el portal de facturación (también necesita el id_externo).</td></tr><tr><td>campos_personalizados</td><td>array</td><td><p></p><p>Lista de campos personalizados (se validarán los campos personalizados de venta), ejemplo de estructura:</p><pre class="language-postman_json"><code class="lang-postman_json">[
    {
        "key": "codigo_reservacion",
        "valor": "FKL4646"
    },
    {
        "key": "origen",
        "valor": "Sistema externo"
    }
]
</code></pre></td></tr><tr><td>moneda</td><td>string</td><td>(Opcional) nombre de la moneda de la nota de venta</td></tr><tr><td>tipo_cambio</td><td>string</td><td>(Opcional) tipo de cambio</td></tr></tbody></table>

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

```
```

{% 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/notas-de-venta.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.