Error

A valid request URL is required to generate request examples

{
  "from": "2026-07-28",
  "to": "2026-07-28",
  "entryCount": 3,
  "totalDebitCents": 3600,
  "totalCreditCents": 3600,
  "balanced": true,
  "fileName": "ecritures_20260728_20260728.csv",
  "content": "Date;Journal;Compte;LibelleCompte;Piece;Libelle;Debit;Credit\r\n2026-07-28;VE;531000;Encaissement espèces;T-1;T-1;36,00;0,00\r\n2026-07-28;VE;707000;Ventes de marchandises;T-1;T-1;0,00;30,00\r\n2026-07-28;VE;445710;TVA collectée;T-1;T-1;0,00;6,00",
  "entries": [
    {
      "journalCode": "VE",
      "journalLabel": "Journal des ventes",
      "entryNumber": "T-1",
      "entryDate": "2026-07-28T10:00:00.000Z",
      "accountNumber": "531000",
      "accountLabel": "Encaissement espèces",
      "entryLabel": "T-1",
      "documentRef": "T-1",
      "debitCents": 3600,
      "creditCents": 0
    },
    {
      "journalCode": "VE",
      "journalLabel": "Journal des ventes",
      "entryNumber": "T-1",
      "entryDate": "2026-07-28T10:00:00.000Z",
      "accountNumber": "707000",
      "accountLabel": "Ventes de marchandises",
      "entryLabel": "T-1",
      "documentRef": "T-1",
      "debitCents": 0,
      "creditCents": 3000
    },
    {
      "journalCode": "VE",
      "journalLabel": "Journal des ventes",
      "entryNumber": "T-1",
      "entryDate": "2026-07-28T10:00:00.000Z",
      "accountNumber": "445710",
      "accountLabel": "TVA collectée",
      "entryLabel": "T-1",
      "documentRef": "T-1",
      "debitCents": 0,
      "creditCents": 600
    }
  ]
}

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "statusCode": 123,
    "fieldErrors": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

Finance

Export a generic accounting file (journal entries / configurable CSV)

Returns balanced double-entry journal entries (écritures comptables) for a date period over the per-ticket sales read model, serialised to a CONFIGURABLE, tool-agnostic ledger CSV importable into the common French accounting tools (Sage, Cegid, EBP, Quadra) WITHOUT a vendor-specific connector. Each ticket books a debit on the encaissement account of its settlement method (PCG 531/512/511/419…) and per-VAT-rate credits on revenue (707) + collected TVA (44571), so Σ débit = Σ crédit. The account mapping is FR-PCG-defaulted but OVERRIDABLE (revenueAccount, vatAccount, roundingAccount, cashAccount, bankAccount) and the CSV delimiter + decimalSeparator are configurable. REQUIRES from and to as YYYY-MM-DD with from <= to; a missing, malformed or inverted period returns 400. format defaults to json (the structured payload); format=csv streams the raw ledger CSV as a text/csv attachment (ecritures_<from>_<to>.csv). Optionally narrow to a single store.

GET

finance

accounting-export

Error

A valid request URL is required to generate request examples

{
  "from": "2026-07-28",
  "to": "2026-07-28",
  "entryCount": 3,
  "totalDebitCents": 3600,
  "totalCreditCents": 3600,
  "balanced": true,
  "fileName": "ecritures_20260728_20260728.csv",
  "content": "Date;Journal;Compte;LibelleCompte;Piece;Libelle;Debit;Credit\r\n2026-07-28;VE;531000;Encaissement espèces;T-1;T-1;36,00;0,00\r\n2026-07-28;VE;707000;Ventes de marchandises;T-1;T-1;0,00;30,00\r\n2026-07-28;VE;445710;TVA collectée;T-1;T-1;0,00;6,00",
  "entries": [
    {
      "journalCode": "VE",
      "journalLabel": "Journal des ventes",
      "entryNumber": "T-1",
      "entryDate": "2026-07-28T10:00:00.000Z",
      "accountNumber": "531000",
      "accountLabel": "Encaissement espèces",
      "entryLabel": "T-1",
      "documentRef": "T-1",
      "debitCents": 3600,
      "creditCents": 0
    },
    {
      "journalCode": "VE",
      "journalLabel": "Journal des ventes",
      "entryNumber": "T-1",
      "entryDate": "2026-07-28T10:00:00.000Z",
      "accountNumber": "707000",
      "accountLabel": "Ventes de marchandises",
      "entryLabel": "T-1",
      "documentRef": "T-1",
      "debitCents": 0,
      "creditCents": 3000
    },
    {
      "journalCode": "VE",
      "journalLabel": "Journal des ventes",
      "entryNumber": "T-1",
      "entryDate": "2026-07-28T10:00:00.000Z",
      "accountNumber": "445710",
      "accountLabel": "TVA collectée",
      "entryLabel": "T-1",
      "documentRef": "T-1",
      "debitCents": 0,
      "creditCents": 600
    }
  ]
}

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "statusCode": 123,
    "fieldErrors": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

Authorizations

Authorization

string

header

required

Authorization: Bearer <token>. Accepts EITHER a Keycloak access token (scopes-in-token) OR an opaque POS session token; both resolve to the same pos.* scope vocabulary the route guards enforce.

Query Parameters

from

string

REQUIRED — inclusive period start (YYYY-MM-DD, from <= to). Missing/inverted → 400.

string

REQUIRED — inclusive period end (YYYY-MM-DD, from <= to). Missing/inverted → 400.

store

string

Optional — narrow the écritures to one store by its canonical id.

format

string

json (default) returns the structured payload; csv streams the raw ledger CSV as a text/csv; charset=utf-8 attachment (ecritures_<from>_<to>.csv). Any other value 400s.

delimiter

string

CSV field delimiter (default ;). One character.

decimalSeparator

string

Euro amount decimal separator, , (default) or ..

revenueAccount

string

Override the revenue (707) account. 3–20 digits.

vatAccount

string

Override the collected-VAT (44571) account. 3–20 digits.

roundingAccount

string

Override the rounding/suspense (471) account. 3–20 digits.

cashAccount

string

Override the cash encaissement (531) account. 3–20 digits.

bankAccount

string

Override the bank encaissement (512) account for card + split payments. 3–20 digits.

Response

For format=json (default): the structured export — balanced entries, totals and the CSV text. For format=csv: this JSON envelope is REPLACED by the raw ledger CSV streamed as a text/csv; charset=utf-8 attachment (Content-Disposition: attachment; filename="ecritures_<from>_<to>.csv") — the content field below is exactly that file body.

from

string

required

string

required

entryCount

integer

required

Required range: -9007199254740991 <= x <= 9007199254740991

totalDebitCents

integer

required

Required range: -9007199254740991 <= x <= 9007199254740991

totalCreditCents

integer

required

Required range: -9007199254740991 <= x <= 9007199254740991

balanced

boolean

required

fileName

string

required

content

string

required

entries

object[]

required

Show child attributes

List finance entries Report cash discrepancies for a period

Ventes & encaissement

Catalogue & stock

Finance

Clients & fidélité

Marketing & promotions

Services

Système

Other

Export a generic accounting file (journal entries / configurable CSV)

Authorizations

Query Parameters

Response