Saf-t PT Suportado

InvoiceXpress API

clients.invoices

This method allows you to obtain the invoices for a specific client.
Allowing filtering aswell.

You call this method submitting an HTTP GET or POST request to the following URL:

https://screen-name.invoicexpress.net/clients/:client_id/invoices.xml

Optionally you can submit through POST data a filter. This is an example filter on XML:

<?xml version="1.0" encoding="UTF-8"?>
<filter>
 <status type="array">
  <option>draft</option>
  <option>final</option>
  <option>settled</option>
  <option>canceled</option>
  <option>second_copy</option>
 </status>
 <by_type type="array">
  <option>Invoice</option>
  <option>CreditNote</option>
  <option>DebitNote</option>
  <option>Receipt</option>
  <option>CashInvoice</option>
 </by_type>
 <archived type="array">
  <option>only_archived</option>
  <option>non_archived</option>
 </archived>
</filter>

If you do not use any filter, this will be the default filter applied to your results.

Parameters

Parameters are the data you will pass with the call.

api_key

Your secret identifier. Your API Key is on Account Overview in the Account section.
Rules: Required
Where: Query String

page

The required page. Default is 1
Rules: Optional
Where: Query String

per_page

The required results per page. Default is 10
Rules: Optional
Where: Query String

filter/status

Document state.
Rules: Optional.

filter/by_type

Document type.
Rules: Optional.

filter/archived

Document archived status.
Rules: Optional

Return Values

Success

The element “results” is always returned on top of invoices elements (root level).
It contains:
- The current page
- The number of entries fetched on this request. Equal or less than specified by per_page
- The total number of entries available

<?xml version="1.0" encoding="UTF-8"?>
<invoices type="array">
 <results>
  <current_page>1</current_page>
  <entries>10</entries>
  <total_entries>200</total_entries>
 </results>
 <invoice>
  <id>55</id>
  <status>draft</status>
  <sequence_number>draft</sequence_number>
  <date>19/10/2009</date>
  <due_date>19/10/2009</due_date>
  <reference>123456</reference>
  <observations>Computer Processed</observations>
  <retention>5.0</retention>
  <client>
   <id>65</id>
   <name>Client</name>
   <email>client@email.com</email>
   <address></address>
   <postal_code></postal_code>
   <fiscal_id></fiscal_id>
  </client>
  <currency>Euro</currency>
  <items>
   <item>
    <id>19</id>
    <name>Product 1</name>
    <description>Cleaning product</description>
    <unit_price>10.0</unit_price>
    <quantity>1.0</quantity>
    <unit>unit</unit>
    <tax>
     <name></name>
     <value>0.0</value>
    </tax>
    <discount>10.0</discount>
   </item>
   <item>
    <id>20</id>
    <name>Product 2</name>
    <description>Product for beauty</description>
    <unit_price>5.0</unit_price>
    <quantity>1.0</quantity>
    <unit>unit</unit>
    <tax>
     <id>19</id>
     <name>IVA20</name>
     <value>20.0</value>
    </tax>
    <discount>0.0</discount>
   </item>
  </items>
  <sum>15.0</sum>
  <discount>1.0</discount>
  <before_taxes>14.0</before_taxes>
  <taxes>1.0</taxes>
  <total>14.3</total>
 </invoice>
 <invoice>
  <id>56</id>
  <status>draft</status>
  <sequence_number>draft</sequence_number>
  <date>22/10/2009</date>
  <due_date>22/10/2009</due_date>
  <reference>123457</reference>
  <observations>Computer Processed</observations>
  <retention>5.0</retention>
  <client>
   <id>65</id>
   <name>Client</name>
   <email>client@email.com</email>
   <address></address>
   <postal_code></postal_code>
   <fiscal_id></fiscal_id>
  </client>
  <currency>Euro</currency>
  <items>
   <item>
    <id>35</id>
    <name>Product 1</name>
    <description>Cleaning product</description>
    <unit_price>10.0</unit_price>
    <quantity>1.0</quantity>
    <unit>unit</unit>
    <tax>
     <name></name>
     <value>0.0</value>
    </tax>
    <discount>10.0</discount>
   </item>
   <item>
    <id>36</id>
    <name>Product 2</name>
    <description>Beauty product</description>
    <unit_price>5.0</unit_price>
    <quantity>1.0</quantity>
    <unit>unit</unit>
    <tax>
     <id>19</id>
     <name>IVA20</name>
     <value>20.0</value>
    </tax>
    <discount>0.0</discount>
   </item>
  </items>
  <sum>15.0</sum>
  <discount>1.0</discount>
  <before_taxes>14.0</before_taxes>
  <taxes>1.0</taxes>
  <total>14.3</total>
 </invoice>
</invoices>

Error

HTTP: 401 Access denied
The API Key parameter is missing or is incorrect.
HTTP: 404 Not found
Client not found.