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:
Por fecha de emisión
Por rango numérico
🛠️ Estructura del request a enviar:
La siguiente estructura es genérica para cualquiera de los métodos de búsqueda disponibles:
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:
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
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