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