Blog | Altoviz Developer Hub

Changelog 2025-01-22

Jan 22, 2025 - 1 min read - 76 words

Alex Danvy

Some great new possibilities for API amateurs : Suppliers, receipts and metadata.

New receipts API

You can list, add, edit and delete receipts /v1/Receipts

New suppliers API

You can list, add, edit and delete suppliers /v1/Suppliers

Metadata on Mark as paid

Metadata allow you to store important informations for your app on Altoviz entities. We added the possibility to pass metadata to the mark-as-paid API. Those metadata will be stored on the payment.

Changelog 2024-08-28

Aug 28, 2024 - 2 min read - 415 words

Alex Danvy

Following your feedback, we added a lot of new APIs and extended existing APIs. This post will make a little recap of the new stuff added in the last months.

Introducing “internal id”

You might need to create an integration of the Altoviz services with your product and in case you have common entities, you will have to keep the data in sync. That’s why we added an “internal id” on entites such as contacts, customers, products, quotes and invoices.

As an example, if you have contacts within your app and those contacts have their own unique id, you can set this unique id to the internal id of the Altoviz customer. You wil then be able to get this customer back using your unique id and not the Altoviz one. You no longer have to save Altoviz ids.

Purchase invoices

You can create purchase invoices just by sending a PDF file to the app through the /v1/purchaseinvoices/file API.

Purchase invoices can be downloaded too using the /v1/PurchaseInvoices/Download API.

Sales invoices

Invoices can be updated and deleted as long as they are still in draft mode.

Invoices can be marked as paid. Set the date and payment method method and you’re done. Just one call to this API to finalize and pay an invoice ! /v1/SaleInvoices/Finalize

You can find invoices using your own id (internal Id).

Notes becomes Footer notes and Header notes was added.

You can sort the result, filter by dates, customer or status and even include canceled invoices. v1/SaleInvoices

Sales quotes

Delete a quote

Find quote by internal Id

Sales credits

Just like sales invoices, you can list, add, edit and remove sales credits.

Units

List all available units. If you need to add, edit or remove units, dot it in the app.

Get a customer using an internal Id

You can get a customer by its internal id (the id coming from your app) using the v1/Customers/GetByInternalId API

Get product famillies

You can get a customer family by its internal id (the id coming from your app) using the /v1/CustomerFamilies API

Add and update product images

You can add, update and get product images using the Product images APIs API

Check your key

We added a very simple API to quickly check your API key. Just call /hello with your API key.

API reference documentation lists fields ordered

To make the reference documentation even easier to read, fields are now sorted alphabeticaly.

Changelog 2023-10-19

Oct 19, 2023 - 1 min read - 46 words

Alex Danvy

Support for basic authentication

An additional authentication method is introduced using HTTP basic authenticationa. Read more

New API for units

You can get the units list using the Units API

Classification filter by type

A new type parameter allow to filter the returned classifications.

Changelog 2023-10-05

Oct 5, 2023 - 1 min read - 77 words

Alex Danvy

API key by parameter

An additional authentication method is introduced using a URL parameter. Read more

POST content no longer needs Id

Some API like contact creation or customer update had a useless Id member.

New webhooks

We added more webhooks to give you more control over what happens in the app. Read more

Settings API

A new settings API allows you to get all settings including timezone, logo, vat number, var mode and more.

curl -iH "x-api-key:5b26c099-5d5e-4087-90a0-722f9d5b92ee" https://api.altoviz.com/v1/settings

Changelog 2023-09-21

Sep 21, 2023 - 1 min read - 108 words

Alex Danvy

new API to get VATs

You might need to create an invoice from scratch, without using any existing product, so you will have to spefify the appropriate VAT for each line. Those things are not frequently changing but a better approach than hard coding is to list the VATs.

curl -iH "x-api-key:5b26c099-5d5e-4087-90a0-722f9d5b92ee" https://api.altoviz.com/v1/vats

The result is a list of all existing VAT

[
  { "id": 22, "rate": 0.0, "region": "FR", "label": "0.0% - FR" },
  { "id": 23, "rate": 0.0, "region": "EU", "label": "0.0% - EU" },
  { "id": 24, "rate": 0.0, "region": "IE", "label": "0.0% - IE" },
  { "id": 25, "rate": 20.0, "region": "FR", "label": "20.0% - FR" },
  { "id": 26, "rate": 10.0, "region": "FR", "label": "10.0% - FR" },
  { "id": 27, "rate": 5.5, "region": "FR", "label": "5.500% - FR" },
  { "id": 28, "rate": 2.1, "region": "FR", "label": "2.100% - FR" }
]

REST API reference

new API to get classifications

Classifications are our way to produce accounting registers from user created invoices. You can now get a complete list of existing classifications.

curl -iH "x-api-key:5b26c099-5d5e-4087-90a0-722f9d5b92ee" https://api.altoviz.com/v1/classifications

The result is a list of classification with all the detail. Did you notice the associated VAT ?

[
  {
    "id": 162,
    "label": "Abonnements/Locations",
    "description": "Abonnement ou location de matériel (hors locations mobilières/immobilières), hébergement de site internet...",
    "accountNumber": "6131",
    "defaultVat": {
      "id": 25,
      "rate": 20.0,
      "region": "FR",
      "label": "20.0% - FR"
    },
    "isProduct": false,
    "isService": false,
    "type": "Expense",
    "microBusinessDeclarationType": null
  },
  {
    "id": 154,
    "label": "Accessoires et petits matériels",
    "description": "Biens et équipements dont la valeur est inférieure à 500€ HT : bureau, tablette, téléphone, etc.",
    "accountNumber": "6051",
    "defaultVat": null,
    "isProduct": false,
    "isService": false,
    "type": "Expense",
    "microBusinessDeclarationType": null
  }
]

REST API reference