GET /api/clients.xml

Devuelve un listado de clientes permitiendo el filtrado por algunos atributos del cliente.

El listado por defecto devuelve los 100 primeros clientes de la cuenta. Para listar los clientes siguientes es necesario indicarlo por parámetro.

Obtener la lista de los 100 primeros clientes

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

Obtener la lista de los 100 siguientes clientes

curl -u 03334b0a261a2c355ae2db022a963d8e:x https://[ACCOUNT_NAME].facturadirecta.com/api/clients.xml?start=100


Obtener la lista de los 50 primeros clientes

curl -u 03334b0a261a2c355ae2db022a963d8e:x https://[ACCOUNT_NAME].facturadirecta.com/api/clients.xml?limit=50

Obtener la lista de los 50 siguientes clientes

curl -u 03334b0a261a2c355ae2db022a963d8e:x https://[ACCOUNT_NAME].facturadirecta.com/api/clients.xml?limit=50&start=50

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

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


    1. taxCode: Permite obtener solo los clientes con el número de NIF indicado.
    2. code: Permite obtener solo los clientes con el código de cliente indicado.

    Ejemplos:


    curl -u 03334b0a261a2c355ae2db022a963d8e:x https://[ACCOUNT_NAME].facturadirecta.com/api/clients.xml?taxCode=B12341234

    curl -u 03334b0a261a2c355ae2db022a963d8e:x https://[ACCOUNT_NAME].facturadirecta.com/api/clients.xml?code=430000021