GET /api/invoices.xml

Devuelve un listado de facturas permitiendo el filtrado por múltiples atributos.

Obtener la lista de facturas

curl -u 03334b0a261a2c355ae2db022a963d8e:x https://[ACCOUNT_NAME].facturadirecta.com/api/invoices.xml


Opciones de paginación de lista y límites de elementos

Por defecto la llamada devuelve los 100 primeros elementos. Para obtener la lista de más elementos o bien paginar las llamadas deben utilizarse los siguientes parámetros:


  1. limit: Indica el número de entradas que devolverá la llamada (por defecto son 100 y se pueden listar hasta un máximo de 250 entradas en una sola llamda)
  2. start: Indica la posición del primer elemento que se devolverá en la llamada (por defecto es el elemento de la posición 0)
Opciones de filtrado de facturas

Para focalizar más la consulta de facturas, puedes utilizar las siguientes opciones de filtrado:

  1. client: Permite obtener solo las facturas de un cliente (especificado por su ID)
  2. fromDate: Permite obtener las facturas desde la fecha indicada (en formato AAAAMMDD)
  3. toDate: Permite obtener las facturas hasta la fecha indicada (en formato AAAAMMDD)
  4. invoiceSerial: Permite obtener las facturas de una única serie
  5. invoiceNumber: Permite obtener las facturas con un determinado número (se refiere al número de factura dentro de una serie, para buscar por número de factura incluyendo serie debe utilizarse el parámetro invoiceNumberFormatted)
  6. invoiceNumberFormatted: Permite obtener las facturas con un determinado número y serie tal y como se representan en el documento en formato PDF
  7. tag: Permite obtener las facturas que tengan asignada la etiqueta con texto indicado (Se puede incluir más de un parámetro tag en la petición)
  8. tagCond: Cuando la consulta contiene más de un parámetro tag indica si la consulta mostrará las facturas que tengan todas las etiquetas indicadas (valor 'and' del parámetro) o cualquiera de ellas (valor 'or' del parámetro)

Ejemplos:


curl -u 03334b0a261a2c355ae2db022a963d8e:x https://[ACCOUNT_NAME].facturadirecta.com/api/invoices.xml?client=52\&fromDate=20110101\&toDate=20110331


curl -u 03334b0a261a2c355ae2db022a963d8e:x https://[ACCOUNT_NAME].facturadirecta.com/api/invoices.xml?client=52\&fromDate=20110101\&toDate=20110331\&tag=Etiqueta 1\&tag=Etiqueta 2\&tagCond=and

curl -u 03334b0a261a2c355ae2db022a963d8e:x https://[ACCOUNT_NAME].facturadirecta.com/api/invoices.xml?client=52\&fromDate=20110101\&toDate=20110331\&tag=Etiqueta 1\&tag=Etiqueta 2\&tagCond=or