Consulta avanzada

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

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

Parámetros

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 consulta te devolverá un array con cada comprobante encontrado (emitido o pendiente de emisión), que tendrá la misma estructura que te entrega la consulta de comprobante 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}   
      ]
}

Campos de la respuesta

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 comproantes encontrados, según estructura que se detalla en la consulta simple.

📅 Consulta de ventas en una determinada fecha

La búsqueda por fecha te devuelve todos aquellos comprobantes enviados para la fecha consultada. Debes tener en cuenta que la información obtenida, será la relacionada al punto de venta desde el cual estás haciendo la solicitud mediante tus credenciales de acceso y el ordenamiento de los datos que te devuelve es: del último emitido al primero.

A partir del 01/05/2022, está consultá comenzará a ser paginada, con un límite máximo de registros por página de 1,000.

🚀 ¿Cómo enviar una consulta para obtener las ventas en una determinada fecha?

Ejemplo:

Consulta por fecha de comprobante

Parámetros:

Atributo	Valores esperados
busqueda_tipo	Campo alfanumérico esperado: "F"
comprobante	Objeto según se detalla a continuación
pagina	Valor numérico entero. Mínimo esperado: 0
limite	Valor numérico entero. Mínimo esperado: 0 Máximo: 1000

Estructura de "Comprobante":

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

¿Qué te devolverá ?

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

Ésta búsqueda te permite obtener todos los comprobantes enviados, ya sea porque se han emitido o porque se encuentren en la cola de facturación, dentro de un rango numérico. Debés tener en cuenta que la información obtenida, será la relacionada al punto de venta desde el cual estás haciendo la solicitud, mediante tus credenciales de acceso y el ordenamiento de los datos que te devuelve es: del último emitido al primero.

A partir del 01/05/2022, está consultá comenzará a ser paginada, con un límite máximo de registros por página de 1,000.

🚀 ¿Cómo enviar una consulta para obtener las ventas por un rango numérico?

Ejemplo:

Consulta por rango numérico de comprobantes

Parámetros:

Atributo	Valores esperados
busqueda_tipo	Campo alfanumérico esperado: "TN"
comprobante	Objeto según se detalla a continuación
pagina	Valor numérico entero. Mínimo esperado: 0
limite	Valor numérico entero. Mínimo esperado: 0 Máximo: 1000

Estructura de "Comprobante":

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

¿Qué te devolverá ?

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

Ésta búsqueda te permite obtener todos los comprobantes enviados, ya sea porque se han emitido o porque se encuentren en la cola de facturación, de una determinada external_reference. Debes tener en cuenta que la información obtenida, será la relacionada al punto de venta desde el cual estás haciendo la solicitud, mediante tus credenciales de acceso y el ordenamiento de los datos que te devuelve es: del último emitido al primero.

Parámetros:

Atributo	Valores esperados
busqueda_tipo	Campo alfanumérico, valor esperado: "EXT_REF
comprobante	Objeto según se detalla a continuación
pagina	Valor númerico entero. Mínimo esperado: 0
limite	Valor númerico entero. Mínimo esperado: 0 Máximo: 1000

Estructura de "Comprobante":

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 enviar una consulta para obtener las ventas por external reference?

Ejemplo:

Consulta por external reference

¿Qué te devolverá ?

{
	"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 [e-mail] o contactanos por el chat que tenemos disponible en la web www.tusfacturas.app.