# Consulta avanzada

La **API ARCA/AFIP de TusFacturasAPP** ofrece dos métodos para consultar comprobantes fiscales emitidos desde tu sistema: el método de [**consulta simple**](/api-factura-electronica-afip-facturacion-ventas/api-factura-electronica-afip-consulta-de-comprobantes.md) y el de **consulta avanzada**. Ambos son fundamentales para verificar el estado y obtener los datos de las ventas realizadas.

### 🔹 Consulta avanzada de ventas

Nuestra herramienta de Consulta Avanzada de Ventas está diseñada para ir más allá de una búsqueda simple, permitiéndote **explorar y recuperar información específica** de tus operaciones  de manera profunda.

Podrás aplicar diferentes **filtros** para refinar tus resultados, lo cual te permite obtener **reportes precisos y segmentados**, facilitando un análisis exhaustivo de tus ventas.  

{% hint style="info" %}
⚠️ **Consideraciones importantes:**

* La información obtenida se limita a los comprobantes del punto de venta desde el cual se realiza la solicitud.
* Los resultados se ordenan de forma descendente por fecha de emisión y orden de llegada (del más reciente al más antiguo).
* La consulta te devolverá los resultados paginados, con un límite máximo de ventas por página es de 1.000, dependiendo el método de consulta que utilices
* El uso de éste método **no contabiliza como un request** en tu suscripción
  {% endhint %}

#### Modalidades de búsqueda:

* Por [fecha de emisión](#consulta-por-fecha-de-emision)
* Por [rango numérico](/api-factura-electronica-afip-facturacion-ventas/consulta-avanzada.md#consulta-avanzada-por-rango-de-numeros)
* Por [external Reference](/api-factura-electronica-afip-facturacion-ventas/consulta-avanzada.md#consulta-avanzada-por-external_reference)

### 🛠️ Estructura del request a enviar:

La siguiente estructura es genérica para cualquiera de los métodos de búsqueda disponibles:

| Name           | Type   | Description                                                                                  |
| -------------- | ------ | -------------------------------------------------------------------------------------------- |
| busqueda\_tipo | string | <p>Campo alfanumérico. </p><p>Valores permitidos: "F", "EXT\_REF", "TN"</p>                  |
| comprobante    | object | Objeto atributos, según estructura que se detalla a continuación para cada tipo de búsqueda. |
| usertoken      | string | Tus credenciales de acceso                                                                   |
| apitoken       | string | Tus credenciales de acceso                                                                   |
| apikey         | string | Tus credenciales de acceso                                                                   |
| limite         | int    | Valor entero númerico.                                                                       |
| pagina         | int    | Valor entero númerico.                                                                       |

### Ejemplo del JSON de respuesta:

La respuesta contendrá un array de comprobantes (emitidos o pendientes de emisión).&#x20;

Cada comprobante devuelto en ese array, sigue la misma estructura que obtenes aca:

{% content-ref url="/pages/-LCQn\_uXm5AGLoC2GMMH" %}
[Consulta simple de ventas](/api-factura-electronica-afip-facturacion-ventas/api-factura-electronica-afip-consulta-de-comprobantes.md)
{% endcontent-ref %}

<pre class="language-json"><code class="lang-json">{
   "rta":"OK",
   "error":"N",
   "total":3,
   "errores":[
      
   ],
   "comprobantes":[
      {<a data-footnote-ref href="#user-content-fn-1">comprobante_ver_json_respuesta_consulta_simple</a>} ,
      {comprobante_ver_json_respuesta_consulta_simple} ,
      {comprobante_ver_json_respuesta_consulta_simple}   
      ]
}
</code></pre>

#### Detalle de los campos de la respuesta

Los campos devueltos son genéricos para cualquiera de los métodos de búsqueda disponibles:&#x20;

| Nombre del campo | Info                                                                                                                                                                                                                            |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| error            | Campo alfanumerico. Valores posibles "S" o "N"                                                                                                                                                                                  |
| errores          | Array conteniendo la lista de errores detectados                                                                                                                                                                                |
| total            | Campo numérico, que indica la cantidad de registros encontrados con los parámetros indicados, sin aplicarle la paginación ni limitación. (Dato disponible a partir del 01/04/2022)                                              |
| comprobantes     | Array conteniendo cada uno de los comprobantes encontrados, según estructura que se detalla en la [consulta simple.](/api-factura-electronica-afip-facturacion-ventas/api-factura-electronica-afip-consulta-de-comprobantes.md) |

***

A continuación te mostramos las diferentes opciones de búsqueda avanzada de ventas:

### 🔎 Consulta por Fecha de Emisión&#x20;

Esta consulta retorna todos los comprobantes cuya fecha de emisión coincide exactamente con la fecha solicitada.

#### :rocket: Ejemplo del JSON a enviar:

{% content-ref url="/pages/Fc5UwNn3OEWfvKVVRNV4" %}
[Consulta por fecha de comprobante](/web-services-afip-api-arca/consulta-avanzada-por-fecha.md)
{% endcontent-ref %}

#### ¿Cómo armar el bloque "comprobante" para usar ésta búsqueda?

| `operacion` | <p>Campo alfanumérico. Longitud 1 caracter. Indica si envia una factura de venta (V) o de compra (C).<br>Valores Permitidos: <strong>V, C</strong><br><strong>Ejemplo: V</strong></p> |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `fecha`     | <p>Campo fecha en formato dd/mm/aaaa<br><strong>Ejemplo: 20/03/2022</strong></p>                                                                                                      |

#### Ejemplo del JSON de respuesta:

La respuesta contendrá un array de comprobantes (emitidos o pendientes de emisión). **Cada comprobante en este array sigue la misma estructura que la** [**consulta simple**](/api-factura-electronica-afip-facturacion-ventas/api-factura-electronica-afip-consulta-de-comprobantes.md#ejemplo-del-json-de-respuesta)**.**

```json
{
	"rta": "OK",
	"error": "N",
	"total": 4,
	"errores": [],
	"comprobantes": [
		{comprobante_ver_json_respuesta_consulta_simple},
		{comprobante_ver_json_respuesta_consulta_simple},
		{comprobante_ver_json_respuesta_consulta_simple},
		{comprobante_ver_json_respuesta_consulta_simple}
		]
}

```

#### :arrows\_clockwise: Ver JSON de "Consulta simple"

{% content-ref url="/pages/-LCQn\_uXm5AGLoC2GMMH" %}
[Consulta simple de ventas](/api-factura-electronica-afip-facturacion-ventas/api-factura-electronica-afip-consulta-de-comprobantes.md)
{% endcontent-ref %}

***

### 🔍 Consulta avanzada por rango de números

Este método te permite recuperar todos los comprobantes asociados a un punto de venta dentro de un rango numérico determinado. Podrás obtener tanto comprobantes **ya emitidos** como aquellos que aún se encuentran **en cola de procesamiento**.

#### :rocket: Ejemplo del JSON a enviar:

{% content-ref url="/pages/OjbvjZ2X68mybM2LqlHK" %}
[Consulta por rango numérico de comprobantes](/web-services-afip-api-arca/consulta-avanzada-por-numero.md)
{% endcontent-ref %}

#### ¿Cómo armar el bloque "comprobante" para usar ésta búsqueda?

| `tipo`         | <p>Campo numérico según tabla de referencia de <a href="https://www.tusfacturas.com.ar/api-factura-electronica-afip.html#tabla-comprobantes">Tipos de comprobantes(\*\*\*)</a>.<br><strong>Ejemplo: FACTURA B</strong></p> |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `operacion`    | <p>Campo alfanumérico. Longitud 1 caracter. Indica si envia una factura de venta (V) o de compra (C).<br>Valores Permitidos: <strong>V, C</strong><br><strong>Ejemplo: V</strong></p>                                      |
| `punto_venta`  | <p>Campo numérico entero. Longitud máxima 4 digitos.<br><strong>Ejemplo: 3</strong></p>                                                                                                                                    |
| `numero_desde` | <p>Campo numérico entero. Longitud máxima 8 dígitos. La numeración será validada internamente previa generación del comprobante.<br><strong>Ejemplo: 4567</strong></p>                                                     |
| `numero_hasta` | <p>Campo numérico entero. Longitud máxima 8 digitos. La numeración será validada internamente previa generación del comprobante.<br><strong>Ejemplo: 4567</strong></p>                                                     |

#### Ejemplo del JSON de respuesta:

La respuesta contendrá un array de comprobantes (emitidos o pendientes de emisión). **Cada comprobante en este array sigue la misma estructura que la** [**consulta simple**](/api-factura-electronica-afip-facturacion-ventas/api-factura-electronica-afip-consulta-de-comprobantes.md#ejemplo-del-json-de-respuesta)

```json
{
	"rta": "OK",
	"error": "N",
	"total": 4,
	"errores": [],
	"comprobantes": [
		{comprobante_ver_consulta_simple},
		{comprobante_ver_consulta_simple},
		{comprobante_ver_consulta_simple},
		{comprobante_ver_consulta_simple}
		]
}
```

#### :arrows\_clockwise: Ver JSON de "Consulta simple"

{% content-ref url="/pages/-LCQn\_uXm5AGLoC2GMMH" %}
[Consulta simple de ventas](/api-factura-electronica-afip-facturacion-ventas/api-factura-electronica-afip-consulta-de-comprobantes.md)
{% endcontent-ref %}

***

### 🔎 Consulta avanzada por `external_reference`

Esta consulta permite obtener todos los comprobantes relacionados a un valor específico de `external_reference`, ya sea que estén **emitidos** o **en cola de facturación**.&#x20;

#### Ejemplo del JSON a enviar:

{% content-ref url="/pages/boLGZKBoeyqBKYbbfOFX" %}
[Consulta por external reference](/web-services-afip-api-arca/consulta-avanzada-por-external-reference.md)
{% endcontent-ref %}

La consulta por external refernce cuenta con 2 herramientas:

* Consulta individual de external reference
* Consulta BULK de external reference.

#### ¿Cómo armar el bloque "comprobante" para una búsqueda individual?

| `external_reference` | Campo alfanumérico. Longitud mínima: 1 carácter                                                                                                                                       |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `operacion`          | <p>Campo alfanumérico. Longitud 1 caracter. Indica si envia una factura de venta (V) o de compra (C).<br>Valores Permitidos: <strong>V, C</strong><br><strong>Ejemplo: V</strong></p> |

#### ¿Cómo armar el bloque "comprobante" para una búsqueda BULK?

Podes enviar hasta 100 external reference para consultar, sin embargo puede suceder que jsons muy extensos sean bloqueados a nivel firewall. En ese caso te sugerimos reducir la cantidad de ext. reference a consultar.

| `external_reference` | Array de datos alfanumérico. Ej: \["abc123", "hh33ss", "ssss333kk"]                                                                                                                   |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `operacion`          | <p>Campo alfanumérico. Longitud 1 caracter. Indica si envia una factura de venta (V) o de compra (C).<br>Valores Permitidos: <strong>V, C</strong><br><strong>Ejemplo: V</strong></p> |

#### Ejemplo del JSON de respuesta (ambas herramientas):

La respuesta contendrá un array de comprobantes (emitidos o pendientes de emisión). **Cada comprobante en este array sigue la misma estructura que la** [**consulta simple**](/api-factura-electronica-afip-facturacion-ventas/api-factura-electronica-afip-consulta-de-comprobantes.md#ejemplo-del-json-de-respuesta)

```json
{
	"rta": "OK",
	"error": "N",
	"total": 4,
	"errores": [],
	"comprobantes": [
		{comprobante_ver_consulta_simple},
		{comprobante_ver_consulta_simple},
		{comprobante_ver_consulta_simple},
		{comprobante_ver_consulta_simple}
		]
}

```

#### :arrows\_clockwise: Ver JSON de "Consulta simple"

{% content-ref url="/pages/-LCQn\_uXm5AGLoC2GMMH" %}
[Consulta simple de ventas](/api-factura-electronica-afip-facturacion-ventas/api-factura-electronica-afip-consulta-de-comprobantes.md)
{% endcontent-ref %}

***

TusFacturasAPP es un [software de facturación](https://www.tusfacturas.app/software-de-facturacion-argentina.html) y un [software de gestión](https://www.tusfacturas.app/software-de-gestion-para-pymes.html)  diseñado para empresas que facturen en Argentina. Conoce más de [TusFacturasAPP](https://www.tusfacturas.app).

### ¿Aún te quedan dudas? ¡Contactános!

En caso que requieras asistencia o tengas alguna duda relacionada con tu plan API DEV,  envíanos un mensaje a <api@tusfacturas.app> o [contactanos](https://www.tusfacturas.app/contacto.html) por el chat que tenemos disponible en la web [www.tusfacturas.app](https://www.tusfacturas.app/quiero-probar-api-factura-electronica.html).

[^1]:


---

# 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.tusfacturas.app/api-factura-electronica-afip-facturacion-ventas/consulta-avanzada.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.