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
💡 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
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:
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 |
¿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
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 |
Estructura de "Comprobante":
| Campo alfanumérico. Longitud 1 caracter. Indica si envia una factura de venta (V) o de compra (C). Valores Permitidos: V, C Ejemplo: V |
| Campo fecha en formato dd/mm/aaaa Ejemplo: 20/03/2022 |
Que te devolverá ?
¿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:
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":
| |
| Campo alfanumérico. Longitud 1 caracter. Indica si envia una factura de venta (V) o de compra (C). Valores Permitidos: V, C Ejemplo: V |
| Campo numérico entero. Longitud máxima 4 digitos. Ejemplo: 3 |
| Campo numérico entero. Longitud máxima 8 digitos. La numeración será validada internamente previa generación del comprobante. Ejemplo: 4567 |
| 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 :
Que te devolverá ?
¿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:
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":
| Campo alfanumérico. Longitud mínima: 1 carácter |
| 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 :
Que te devolverá ?
Last updated