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

  • El uso de éste método no contabiliza como un request en tu suscripción

Modalidades de búsqueda:

🛠️ 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 en este array sigue la misma estructura que la consulta simple.

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

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

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

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

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.

Last updated