API Documentation

Operation Table – Abvius API

Introduction

Abvius provides access to its operation table via a secure API. This table represents an invoice / complete accounting transaction, with all the necessary fields for accounting software to record a transaction.

📦 Resource: operation

The operation resource corresponds to an invoice line / accounting entry.

Operation resource structure

{
  "id": "op_0001",
  "invoice_number": "F2025-001",
  "invoice_date": "2025-01-10",
  "amount": 1500.0,
  "currency": "EUR",
  "supplier_name": "Supplier ABC",
  "supplier_code": "SUP_ABC",
  "project_code": "PRJ-EDU-2025",
  "analytic_code": "ANL-TRAINING",
  "journal_code": "ACH",
  "document_number": "OP-2025-0001",
  "status": "validated",
  "created_at": "2025-01-11T09:12:34Z",
  "updated_at": "2025-01-11T10:01:22Z"
}

🔍 GET /operations

Récupère toutes les opérations comptables (factures).

Retrieves the list of accounting operations (invoices) in the operation table.

Query filter parameters: • limit (int) - Maximum number of entries (default: 50) • offset (int) - Offset for pagination • from_date (date) - Minimum invoice date (YYYY-MM-DD) • to_date (date) - Maximum invoice date • project_code (string) - Filter by project code • analytic_code (string) - Filter by analytic code • supplier_code (string) - Filter by supplier • status (string) - draft, validated, exported, etc.

cURL example

curl -X GET "https://api.abvius.org/api/v1/operations?from_date=2025-01-01&to_date=2025-01-31&limit=100" \
  -H "Authorization: Bearer VOTRE_ABVIUS_API_KEY" \
  -H "Content-Type: application/json"

Response example

{
  "data": [
    {
      "id": "op_0001",
      "invoice_number": "F2025-001",
      "invoice_date": "2025-01-10",
      "amount": 1500.0,
      "currency": "EUR",
      "supplier_name": "Supplier ABC",
      "supplier_code": "SUP_ABC",
      "project_code": "PRJ-EDU-2025",
      "analytic_code": "ANL-TRAINING",
      "journal_code": "ACH",
      "document_number": "OP-2025-0001",
      "status": "validated",
      "created_at": "2025-01-11T09:12:34Z",
      "updated_at": "2025-01-11T10:01:22Z"
    }
  ],
  "meta": {
    "count": 1,
    "limit": 100,
    "offset": 0
  }
}

🔎 GET /operations/{id}

Récupère une opération comptable spécifique.

Retrieves a single operation (an invoice / accounting transaction) from its identifier.

cURL example

curl -X GET "https://api.abvius.org/api/v1/operation/op_0001" \
  -H "Authorization: Bearer VOTRE_ABVIUS_API_KEY" \
  -H "Content-Type: application/json"

Response example

{
  "data": {
    "id": "op_0001",
    "document_number": "OP-2025-0001",
    "date": "2025-01-10",
    "journal_code": "ACH",
    "currency": "EUR",
    "reference": "F2025-001",
    "status": "validated",

    "invoice_number": "F2025-001",
    "invoice_date": "2025-01-10",

    "supplier_name": "Fournisseur ABC",
    "supplier_code": "SUP_ABC",

    "project_code": "PRJ-EDU-2025",
    "analytic_code": "ANL-TRAINING",

    "source": "purchases",
    "source_id": "pur_001",

    "lines": [
      {
        "line_number": 1,
        "account_code": "401000",
        "description": "Fournisseur ABC - F2025-001",
        "debit": 0.0,
        "credit": 1500.0,
        "project_code": "PRJ-EDU-2025",
        "analytic_code": "ANL-TRAINING",
        "third_party_code": "SUP_ABC",
        "cost_center": "CC-PARIS"
      },
      {
        "line_number": 2,
        "account_code": "606000",
        "description": "Achat – Formation",
        "debit": 1500.0,
        "credit": 0.0,
        "project_code": "PRJ-EDU-2025",
        "analytic_code": "ANL-TRAINING",
        "third_party_code": null,
        "cost_center": "CC-PARIS"
      }
    ],

    "created_at": "2025-01-11T09:12:34Z",
    "updated_at": "2025-01-11T10:01:22Z"
  }
}

✏️ POST /operations

Crée une nouvelle opération comptable dans Abvius.

Creates a new operation in the operation table. This allows, for example, another system (ERP, internal tool) to send an invoice to Abvius, with all the necessary information for accounting.

cURL example

curl -X POST "https://api.abvius.org/api/v1/operation" \
  -H "Authorization: Bearer VOTRE_ABVIUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "invoice_number": "F2025-002",
    "invoice_date": "2025-01-15",
    "amount": 980.0,
    "currency": "EUR",
    "supplier_name": "Fournisseur XYZ",
    "supplier_code": "SUP_XYZ",
    "project_code": "PRJ-HEALTH-2025",
    "analytic_code": "ANL-LOGISTICS",
    "journal_code": "ACH",
    "document_number": "OP-2025-0002",
    "status": "validated"
  }'

Response example

{
  "data": {
    "id": "op_0002",
    "invoice_number": "F2025-002",
    "invoice_date": "2025-01-15",
    "amount": 980.0,
    "currency": "EUR",
    "supplier_name": "Supplier XYZ",
    "supplier_code": "SUP_XYZ",
    "project_code": "PRJ-HEALTH-2025",
    "analytic_code": "ANL-LOGISTICS",
    "journal_code": "ACH",
    "document_number": "OP-2025-0002",
    "status": "validated",
    "created_at": "2025-01-15T14:32:00Z",
    "updated_at": "2025-01-15T14:32:00Z"
  }
}

API Documentation

Introduction

Authentication

📦 Resource: operation

🔍 GET /operations

🔎 GET /operations/{id}

✏️ POST /operations

Abvius is the first software for
finance, operations and compliance/audit

Product

Company

Support

Service

API Documentation

Introduction

Authentication

📦 Resource: operation

🔍 GET /operations

🔎 GET /operations/{id}

✏️ POST /operations

Abvius is the first software forfinance, operations and compliance/audit

Product

Company

Support

Service

Abvius is the first software for
finance, operations and compliance/audit