Aller au contenu

Lire une soumission e-reporting préparée (données structurées prêtes à transmettre)

GET
/v1/e-reporting/{id}
curl --request GET \
--url https://example.com/v1/e-reporting/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
--header 'X-API-Key: <X-API-Key>'

La sérialisation au format spécifique d’une Plateforme Agréée est hors scope (tranche PA).

id
required
string format: uuid

Soumission e-reporting

Media type application/json
object
data
required
object
id
required
string format: uuid
operatingMandateId
required
string format: uuid
periodStart
required
string format: date
periodEnd
required
string format: date
flow
required
string
Allowed values: domestic international
status
required
string
Allowed values: prepared
currency
required
string
totalBaseHt
required
object
amountCents
required

Montant en centimes (bigint sérialisé en string)

string
currency
required
string
Allowed values: EUR GBP
totalTax
required
object
amountCents
required

Montant en centimes (bigint sérialisé en string)

string
currency
required
string
Allowed values: EUR GBP
transactionCount
required
integer
preparedAt
required
string format: date-time
nullable
lines
required
Array<object>
object
transactionDate
required
string format: date
vatRate
required

Taux TVA en % (numeric(5,2))

string
baseHt
required
object
amountCents
required

Montant en centimes (bigint sérialisé en string)

string
currency
required
string
Allowed values: EUR GBP
tax
required
object
amountCents
required

Montant en centimes (bigint sérialisé en string)

string
currency
required
string
Allowed values: EUR GBP
transactionCount
required

Nb de factures contribuant au bucket (jour × taux)

integer
>= 1
Example
{
"data": {
"periodStart": "2026-07-01",
"periodEnd": "2026-07-10",
"flow": "domestic",
"status": "prepared",
"currency": "EUR",
"totalBaseHt": {
"amountCents": "12000",
"currency": "EUR"
},
"totalTax": {
"amountCents": "12000",
"currency": "EUR"
},
"lines": [
{
"transactionDate": "2026-07-02",
"vatRate": "10.00",
"baseHt": {
"amountCents": "12000",
"currency": "EUR"
},
"tax": {
"amountCents": "12000",
"currency": "EUR"
}
}
]
}
}

Non authentifié

Media type application/json
object
code
required

Code machine de l’erreur

string
message
required

Message lisible

string
origin

Origine domaine de l’erreur (optionnel)

object
boundedContext
string
module
string
status
required
integer
traceId
required

Identifiant de corrélation pour le support

string
Example
{
"code": "RESERVATION_NOT_FOUND",
"message": "Réservation introuvable",
"status": 404
}

Permission refusée ou périmètre non vérifiable

Media type application/json
object
code
required

Code machine de l’erreur

string
message
required

Message lisible

string
origin

Origine domaine de l’erreur (optionnel)

object
boundedContext
string
module
string
status
required
integer
traceId
required

Identifiant de corrélation pour le support

string
Example
{
"code": "RESERVATION_NOT_FOUND",
"message": "Réservation introuvable",
"status": 404
}

Ressource introuvable

Media type application/json
object
code
required

Code machine de l’erreur

string
message
required

Message lisible

string
origin

Origine domaine de l’erreur (optionnel)

object
boundedContext
string
module
string
status
required
integer
traceId
required

Identifiant de corrélation pour le support

string
Example
{
"code": "RESERVATION_NOT_FOUND",
"message": "Réservation introuvable",
"status": 404
}