The Novadesko API

Authentication

All API requests require a token in the HTTP header.

Authorization: Bearer {token}
        

To obtain a token:

curl -X POST https://api.novadesko.com/api/login \
  -H "Content-Type: application/json" \
  -d '{"email":"john@doe.com","password":"secret"}'
        

{
  "email": "john@doe.com",
  "password": "secret"
}
            

{
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOi..."
}
            

Documents

Manage all types of documents: invoices, quotes, credit notes.

• GET /api/{slug} — Lister les documents
• POST /api/{slug} — Créer un document
• GET /api/{slug}/{id} — Détail d’un document
• PUT /api/{slug}/{id} — Modifier
• DELETE /api/{slug}/{id} — Supprimer

curl -H "Authorization: Bearer {token}" https://api.novadesko.com/api/invoices
        

[
  {
    "id": 123,
    "number": "F2024-0001",
    "date": "2024-06-12",
    "client": { "id": 1, "name": "ACME Sarl" },
    "total": 1200.00,
    "status": "paid"
  }
]
            

{
  "client_id": 1,
  "date": "2024-06-12",
  "lines": [
    { "product_id": 15, "qty": 2, "price": 100 }
  ]
}
            

Customers

Manage your customer base.

• GET /api/customers — Lister les clients
• POST /api/customers — Créer un client
• GET /api/customers/{id} — Détail d’un client
• PUT /api/customers/{id} — Modifier
• DELETE /api/customers/{id} — Supprimer

curl -H "Authorization: Bearer {token}" https://api.novadesko.com/api/customers
        

{
  "name": "Société Demo",
  "email": "contact@demo.com",
  "phone": "+33 1 23 45 67 89"
}
            

{
  "id": 2,
  "name": "Société Demo",
  "email": "contact@demo.com",
  "created_at": "2024-06-12T16:10:00Z"
}
            

Suppliers

Manage your suppliers and their information.

• GET /api/suppliers — Lister les fournisseurs
• POST /api/suppliers — Créer un fournisseur
• GET /api/suppliers/{id} — Détail d’un fournisseur

curl -H "Authorization: Bearer {token}" https://api.novadesko.com/api/suppliers
        

{
  "company": "Fournisseur SARL",
  "vat_number": "FR123456789",
  "email": "info@fournisseur.com"
}
            

{
  "id": 5,
  "company": "Fournisseur SARL",
  "created_at": "2024-06-12T16:22:00Z"
}
            

Products

Manage your product catalog.

• GET /api/products — Lister les produits
• POST /api/products — Créer un produit
• GET /api/products/{id} — Détail d’un produit

curl -H "Authorization: Bearer {token}" https://api.novadesko.com/api/products
        

{
  "name": "Abonnement Pro",
  "price": 49.99,
  "category_id": 1
}
            

{
  "id": 42,
  "name": "Abonnement Pro",
  "price": 49.99
}
            

Product Categories

Organize your products into categories.

• GET /api/product-categories — Lister les catégories
• POST /api/product-categories — Créer une catégorie

curl -H "Authorization: Bearer {token}" https://api.novadesko.com/api/product-categories
        

{
  "name": "Services",
  "parent_id": null
}
            

{
  "id": 7,
  "name": "Services"
}
            

Transactions

Track financial flows linked to your documents.

• GET /api/transactions — Lister les transactions
• POST /api/transactions — Enregistrer une transaction

curl -H "Authorization: Bearer {token}" https://api.novadesko.com/api/transactions
        

{
  "document_id": 123,
  "amount": 1200.00,
  "date": "2024-06-12",
  "type": "payment"
}
            

{
  "id": 88,
  "document_id": 123,
  "amount": 1200.00,
  "type": "payment",
  "created_at": "2024-06-12T17:00:00Z"
}
            

Webhooks

Receive real-time notifications for key events.

• POST /webhook — Point d’entrée pour recevoir les notifications

{
  "event": "invoice.paid",
  "data": {
    "id": 123,
    "number": "F2024-0001",
    "amount": 1200.00,
    "client": { "id": 1, "name": "ACME Sarl" }
  }
}