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:

  1. Todos los comprobantes de una determinada fecha ➡️

  2. Todos los comprobantes de un mismo tipo (Ej: FACTURA A ) entre un determinado rango numérico (Ej: 00000010 al 00000050). ➡️

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

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

Estructura general para todo tipo de consulta avanzada

Request Body

NameTypeDescription

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",
            "comprobante_ticket_url": "https://www.dominio.com/url",
            "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",
            "comprobante_ticket_url": "https://www.dominio.com/url",
            "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",
            "comprobante_ticket_url": "https://www.dominio.com/url",
            "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 campoInfo

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

¿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:

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

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.

Detalle de los atributos a enviar:

AtributoValores 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

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.

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.

Detalle de los atributos a enviar:

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

Last updated