Consulta avanzada

Mediante ésta consulta podrás obtener todos los comprobantes enviados, según determinadas condiciones de búsqueda.

La API ARCA/AFIP de TusFacturasAPP ofrece dos métodos para consultar comprobantes fiscales emitidos desde tu sistema: el método de consulta simple 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.

⚠️ 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

Modalidades de búsqueda:

• Por fecha de emisión

• Por rango numérico

• 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	Campo alfanumérico. Valores permitidos: "F", "EXT_REF", "TN"
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).

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

Consulta simple de ventas

{
   "rta":"OK",
   "error":"N",
   "total":3,
   "errores":[
      
   ],
   "comprobantes":[
      {comprobante_ver_json_respuesta_consulta_simple} ,
      {comprobante_ver_json_respuesta_consulta_simple} ,
      {comprobante_ver_json_respuesta_consulta_simple}   
      ]
}

Detalle de los campos de la respuesta

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

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.

---

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

🔎 Consulta por Fecha de Emisión

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

🚀 Ejemplo del JSON a enviar:

Consulta por fecha de comprobante

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

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

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.

{
	"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}
		]
}

---

🔍 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.

🚀 Ejemplo del JSON a enviar:

Consulta por rango numérico de comprobantes

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

tipo	Campo numérico según tabla de referencia de Tipos de comprobantes(***). Ejemplo: FACTURA B
operacion	Campo alfanumérico. Longitud 1 caracter. Indica si envia una factura de venta (V) o de compra (C). Valores Permitidos: V, C Ejemplo: V
punto_venta	Campo numérico entero. Longitud máxima 4 digitos. Ejemplo: 3
numero_desde	Campo numérico entero. Longitud máxima 8 dígitos. La numeración será validada internamente previa generación del comprobante. Ejemplo: 4567
numero_hasta	Campo numérico entero. Longitud máxima 8 digitos. La numeración será validada internamente previa generación del comprobante. Ejemplo: 4567

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

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

---

🔎 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.

Ejemplo del JSON a enviar:

Consulta por external reference

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	Campo alfanumérico. Longitud 1 caracter. Indica si envia una factura de venta (V) o de compra (C). Valores Permitidos: V, C Ejemplo: V

¿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	Campo alfanumérico. Longitud 1 caracter. Indica si envia una factura de venta (V) o de compra (C). Valores Permitidos: V, C Ejemplo: V

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

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

---

TusFacturasAPP es un software de facturación y un software de gestión diseñado para empresas que facturen en Argentina. Conoce más de TusFacturasAPP.

¿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 [email protected] o contactanos por el chat que tenemos disponible en la web www.tusfacturas.app.