Consulta avanzada de comprobantes enviados

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

Métodos de búsqueda disponibles:

Todos los comprobantes de una determinada fecha ➡️
Todos los comprobantes de un mismo tipo (Ej: FACTURA A ) entre un determinado rango numérico (Ej: 00000010 al 00000050). ➡️
Todos los comprobantes de una misma external reference ➡️

A partir del 01/04/2022 ésta consulta te devolverá también, todos aquellos comprobantes que se encuentren en cola de procesamiento ( pendientes de procesamiento, o procesados por error).

Cómo llamar a la API?

Consulta de comprobantes avanzada

POST https://www.tusfacturas.app/app/api/v2/facturacion/consulta_avanzada

Estructura general para todo tipo de consulta avanzada

Request Body

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.

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, compuesto por cada comprobante, que tendrá la misma estructura que te entrega la consulta de comprobante simple.

Ej:

{
   "rta":"OK",
   "error":"N",
   "total":3,
   "errores":[
      
   ],
   "comprobantes":[
      {
         "cliente":{
            "documento_tipo":"DNI",
            "documento_nro":"1292963535 ",
            "razon_social":"Pirulo",
            "email":"test@test.com",
            "domicilio":"Av Sta Fe 123"
         },
         "comprobante":{
            "fecha":"06\/01\/2023",
            "tipo":"FACTURA A",
            "operacion":"V",
            "punto_venta":10,
            "numero":603,
            "moneda":"PES",
            "cotizacion":1,
            "periodo_facturado_desde":"06\/01\/2023",
            "periodo_facturado_hasta":"06\/01\/2023",
            "rubro":"Deudores Varios",
            "rubro_grupo_contable":"Ventas",
            "detalle":[
               {
                  "cantidad":1,
                  "producto":{
                     "descripcion":"PRODUCTO DE PRUEBA",
                     "precio_unitario":20000,
                     "alicuota":21,
                     "bonificacion":10000,
                     "impuestos_internos_alicuota":10,
                     "precio_total":10000
                  },
                  "bonificacion_porcentaje":50,
                  "leyenda":"Hola manoala"
               }
            ],
            "bonificacion":0,
            "leyenda_gral":" ",
            "percepciones_iibb":0,
            "percepciones_iva":0,
            "tributos":[
               
            ],
            "exentos":0,
            "nogravados":0,
            "impuestos_internos":500,
            "impuestos_internos_base":5000,
            "impuestos_internos_alicuota":10,
            "total":12600,
            "cae":"73016074427512 ",
            "afip_codigo_barras":"12121212121006000300000000000000201811052 ",
            "afip_qr":"https:\/\/www.afip.gob.ar\/fe\/qr\/?p=eyJ2ZXIiOjEsImZlY2hhIjoiMjadadasdasdaAyMS0wNi0wNSIsImN1aXQiOiIyNzI4NTA1MTQ2NiIsInB0b1Z0YSI6IjEwIiwidGlwb0NtcCI6MSwibnJvQ21wIjoiMDAwMDAwNzgiLCJpbXBvcnRlIjoiMDAwMDAwMDAwMzA4NS41MCIsIm1vbmVkYSI6IlBFUyIs ",
            "vencimiento_cae":"07\/08\/2015",
            "vencimiento_pago":"27\/08\/2015",
            "comprobante_pdf_url":"https://www.dominio.com/00000006.pdf",
            "external_reference":3303,
            "tags":[
               "etiqueta1",
               "etiqueta2"
            ],
            "status":"EMITIDO",
            "ctacte_status":"PAGO PARCIAL",
            "micrositios":{
               "cliente":"https:\/\/servicios.tusfacturas.app\/micrositios\/c\/asdsadsd\/adasdasd\/14228423\/acceder",
               "descarga":"https:\/\/servicios.tusfacturas.app\/micrositios\/descargas\/asdasd\/asdsad\/kZ8Hl9fpUb4xFDK16O\/00000602"
            }
         }
      },
      {
         "cliente":{
            "documento_tipo":"DNI",
            "documento_nro":"1292963535 ",
            "razon_social":"Pirulo",
            "email":"test@test.com",
            "domicilio":"Av Sta Fe 123"
         },
         "comprobante":{
            "fecha":"06\/12\/2022",
            "tipo":"FACTURA A",
            "operacion":"V",
            "punto_venta":10,
            "numero":602,
            "moneda":"PES",
            "cotizacion":1,
            "periodo_facturado_desde":"06\/12\/2022",
            "periodo_facturado_hasta":"06\/12\/2022",
            "rubro":"Deudores Varios",
            "rubro_grupo_contable":"Ventas",
            "detalle":[
               {
                  "cantidad":1,
                  "producto":{
                     "descripcion":"PRODUCTO DE PRUEBA",
                     "precio_unitario":20000,
                     "alicuota":21,
                     "bonificacion":10000,
                     "impuestos_internos_alicuota":10,
                     "precio_total":10000
                  },
                  "bonificacion_porcentaje":50,
                  "leyenda":"Hola manoala"
               }
            ],
            "bonificacion":0,
            "leyenda_gral":" ",
            "percepciones_iibb":0,
            "percepciones_iva":0,
            "tributos":[
               
            ],
            "exentos":0,
            "nogravados":0,
            "impuestos_internos":1000,
            "impuestos_internos_base":10000,
            "impuestos_internos_alicuota":10,
            "total":13100,
            "cae":"72496063743552 ",
            "afip_codigo_barras":"12121212121006000300000000000000201811052 ",
            "afip_qr":"https:\/\/www.afip.gob.ar\/fe\/qr\/?p=eyJ2ZXIiOjEsImZlY2hhIjoiMjadadasdasdaAyMS0wNi0wNSIsImN1aXQiOiIyNzI4NTA1MTQ2NiIsInB0b1Z0YSI6IjEwIiwidGlwb0NtcCI6MSwibnJvQ21wIjoiMDAwMDAwNzgiLCJpbXBvcnRlIjoiMDAwMDAwMDAwMzA4NS41MCIsIm1vbmVkYSI6IlBFUyIs ",
            "vencimiento_cae":"07\/08\/2015",
            "vencimiento_pago":"27\/08\/2015",
            "comprobante_pdf_url":"https://www.dominio.com/00000006.pdf",
            "external_reference":"",
            "tags":[
               
            ],
            "status":"EMITIDO",
            "ctacte_status":"IMPAGA",
            "micrositios":{
               "cliente":"https:\/\/servicios.tusfacturas.app\/micrositios\/c\/asdsadsd\/adasdasd\/14228423\/acceder",
               "descarga":"https:\/\/servicios.tusfacturas.app\/micrositios\/descargas\/asdasd\/asdsad\/kZ8Hl9fpUb4xFDK16O\/00000602"
            }
         }
      },
      {
         "cliente":{
            "documento_tipo":"DNI",
            "documento_nro":"1292963535 ",
            "razon_social":"Pirulo",
            "email":"test@test.com",
            "domicilio":"Av Sta Fe 123"
         },
         "comprobante":{
            "fecha":"02\/11\/2022",
            "tipo":"FACTURA A",
            "operacion":"V",
            "punto_venta":10,
            "numero":601,
            "moneda":"PES",
            "cotizacion":1,
            "periodo_facturado_desde":"02\/11\/2022",
            "periodo_facturado_hasta":"02\/11\/2022",
            "rubro":"Deudores varios",
            "rubro_grupo_contable":"Deudores varios",
            "detalle":[
               {
                  "cantidad":1,
                  "producto":{
                     "descripcion":"Gomas de borrar",
                     "precio_unitario":200,
                     "alicuota":0,
                     "bonificacion":0,
                     "impuestos_internos_alicuota":0,
                     "precio_total":200
                  },
                  "bonificacion_porcentaje":0,
                  "leyenda":""
               }
            ],
            "bonificacion":0,
            "leyenda_gral":" ",
            "percepciones_iibb":0,
            "percepciones_iva":0,
            "tributos":[
               
            ],
            "exentos":0,
            "nogravados":0,
            "impuestos_internos":0,
            "impuestos_internos_base":0,
            "impuestos_internos_alicuota":0,
            "total":200,
            "cae":"72446045034650 ",
            "afip_codigo_barras":"12121212121006000300000000000000201811052 ",
            "afip_qr":"https:\/\/www.afip.gob.ar\/fe\/qr\/?p=eyJ2ZXIiOjEsImZlY2hhIjoiMjadadasdasdaAyMS0wNi0wNSIsImN1aXQiOiIyNzI4NTA1MTQ2NiIsInB0b1Z0YSI6IjEwIiwidGlwb0NtcCI6MSwibnJvQ21wIjoiMDAwMDAwNzgiLCJpbXBvcnRlIjoiMDAwMDAwMDAwMzA4NS41MCIsIm1vbmVkYSI6IlBFUyIs ",
            "vencimiento_cae":"07\/08\/2015",
            "vencimiento_pago":"27\/08\/2015",
            "comprobante_pdf_url":"https://www.dominio.com/00000006.pdf",
            "external_reference":"",
            "tags":[
               
            ],
            "status":"EMITIDO",
            "ctacte_status":"IMPAGA",
            "micrositios":{
               "cliente":"https:\/\/servicios.tusfacturas.app\/micrositios\/c\/asdsadsd\/adasdasd\/14228423\/acceder",
               "descarga":"https:\/\/servicios.tusfacturas.app\/micrositios\/descargas\/asdasd\/asdsad\/kZ8Hl9fpUb4xFDK16O\/00000602"
            }
         }
      }
   ]
}

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.

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.

¿Cómo realizar una consulta avanzada por fecha?

La búsqueda por fecha te devuelve todos aquellos comprobantes enviados (ya sea porque se han emitido o porque se encuentren en la cola de facturación) en la fecha consultada.

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.

Ejemplo de JSON a enviar para consultar por fecha un comprobante:

Tipo de datos: JSON Charset: UTF-8

{
"usertoken" :  "xxxx",
"apikey"    :  "xxxx",
"apitoken"  :  "xxxx",json
"busqueda_tipo": "F",
 "pagina" : 0,
 "limite": 100 ,
"comprobante":  {
                "fecha":     "23/05/2021",
                "operacion": "V"
        }
}

Detalle de los atributos a enviar:

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

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

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

¿Cómo realizar una 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.

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.

Detalle de los atributos a enviar:

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

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

Ejemplo del JSON a enviar :

{
"usertoken" :  "xxxx",
"apikey"    :  "xxxx",
"apitoken"  :  "xxxx",
"busqueda_tipo": "TN",
 "pagina" : 0,
 "limite": 100 ,
"comprobante": 
	{
			"tipo": "FACTURA A",
			"operacion": "V",
			"punto_venta": "00010",
			"numero_desde": "00000001",
			"numero_hasta": "00000300" 
			 
	}
}

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

¿Cómo realizar una consulta avanzada, por external reference?

Ésta consulta estará disponible a partir del 01/04/2022

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

Detalle de los atributos a enviar:

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

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

Ejemplo del JSON a enviar :

{
"usertoken" :  "xxxx",
"apikey"    :  "xxxx",
"apitoken"  :  "xxxx",
"busqueda_tipo": "EXT_REF",
 "pagina" : 0,
 "limite": 100 ,
"comprobante": {
		"external_reference": "DD2F1F1",
		"operacion": "V"
	}
}

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

AnteriorConsulta simple de comprobantes SiguienteConsultar numeración de comprobantes.

Última actualización hace 1 año