Create

simplified-invoices.create

Creates a new simplified-invoice. Only available in Portugal.

Creating new clients or items along with the simplified-invoice

This method also allows to create a new client and/or new items in the same request with the following behavior:

• If the client name does not exist a new one is created.
• If items do not exist with the given names, new ones will be created.
• If item name already exists, the item is updated with the new values.

Taxes

Regarding item taxes, if the tax name is not found, the default tax is applyed to that item. Portuguese accounts should also send the IVA exemption reason if the simplified-invoice contains exempt items (IVA 0%)

Usage

You call this method by submitting an HTTP POST request to the following URL with the XML data of the new simplified-invoice on the request body:

https://{account-name}.app.invoicexpress.com/simplified_invoices.xml

XML example to be submitted with invoice data:

Header

Content-Type: application/xml; charset=utf-8

Body

<simplified_invoice>
 <date>07/05/2015</date>
 <due_date>08/05/2015</due_date>
 <client>
  <name>Ricardo Pereira</name>
  <code>100</code>
 </client>
 <items type="array">
  <item>
   <name>Product 1</name>
   <description>Cleaning product</description>
   <unit_price>10.0</unit_price>
   <quantity>1.0</quantity>
  </item>
  <item>
   <name>Product 2</name>
   <description>Beauty product</description>
   <unit_price>5.0</unit_price>
   <quantity>1.0</quantity>
   <tax>
    <name>IVA23</name>
   </tax>
  </item>
 </items>
</simplified_invoice>

Parameters

IVA Exemption Codes

Return Values

These are the results that will be returned on success and error.

Success

<simplified_invoice>
  <id>541090</id>
  <status>draft</status>
  <archived>false</archived>
  <type>SimplifiedInvoice</type>
  <sequence_number>draft</sequence_number>
  <atcud>N/D<atcud>
  <date>07/05/2015</date>
  <due_date>08/05/2015</due_date>
  <reference></reference>
  <observations></observations>
  <retention></retention>
  <permalink>http://www.app.invoicexpress.com/documents/54109072cfff8e9c8f551b0b3be5d90ab78faa6af28d75</permalink>
  <client>
    <id>233429</id>
    <name>Ricardo Pereira</name>
    <code>100</code>
  </client>
  <currency>Euro</currency>
  <items type="array">
    <item>
      <name>Product 1</name>
      <description>Cleaning product</description>
      <unit_price>10.0</unit_price>
      <unit></unit>
      <quantity>1.0</quantity>
      <tax>
        <id>31321</id>
        <name>IVA23</name>
        <value>23.0</value>
      </tax>
      <discount>0.0</discount>
      <subtotal>10.0</subtotal>
      <tax_amount>2.3</tax_amount>
      <discount_amount>0.0</discount_amount>
      <total>12.3</total>
    </item>
    <item>
      <name>Product 2</name>
      <description>Beauty product</description>
      <unit_price>5.0</unit_price>
      <unit></unit>
      <quantity>1.0</quantity>
      <tax>
        <id>31321</id>
        <name>IVA23</name>
        <value>23.0</value>
      </tax>
      <discount>0.0</discount>
      <subtotal>5.0</subtotal>
      <tax_amount>1.15</tax_amount>
      <discount_amount>0.0</discount_amount>
      <total>6.15</total>
    </item>
  </items>
  <sum>15.0</sum>
  <discount>0.0</discount>
  <before_taxes>15.0</before_taxes>
  <taxes>3.45</taxes>
  <total>18.45</total>
</simplified_invoice>

Error

Possible Errors for HTTP: 422

<errors>
 <error>Your current plan does not allow you to do this</error>
</errors>

<errors>
 <error>Items element should be of type array</error>
</errors>

<errors>
  <error>Country Germani was not found</error>
</errors>

<errors>
  <error>Option to generate MB reference is set, but EasyPay for
   this account is not activated</error>
</errors>

<errors>
 <error>Retention must be a number between 0 and 99.99</error>
 <error>SimplifiedInvoice items is invalid</error>
 <error>Client is invalid</error>
 <error>Due date must be later than date</error>
 <error>email must be an email address</error>
 <error>discount is not a number</error>
 <error>quantity must be a number greater than 0</error>
 <error>unit_price must be a number</error>
 <error>Unit kg is not included in the list of accepted units</error>
</errors>