Skip to main content

Changelog 2023-09-21

· 2 min read
Alex Danvy
Alex Danvy
CEO

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