Comptabilite.EcriturePiece
En bref
3 opérations sur 2 chemins. Préfixe /v2. Authentification JWT (voir Démarrer).
Opérations
| Méthode | Chemin | Rôle |
|---|---|---|
POST |
/v2/ecriturepiece |
Créer l'enregistrement |
GET |
/v2/ecriturepiece/{codeJournal}/{numeroPiece} |
Lire l'enregistrement désigné |
DELETE |
/v2/ecriturepiece/{codeJournal}/{numeroPiece} |
Supprimer l'enregistrement |
Rôle déduit
La spécification ne porte ni summary ni description d'opération : la colonne Rôle est déduite mécaniquement de la méthode HTTP et du chemin.
Détail
POST /v2/ecriturepiece
Créer l'enregistrement.
Corps de la requête (application/json)
Schéma EcriturePieceDto - 5 propriétés (détail : Schémas).
Écriture partielle : seules les propriétés présentes dans le corps sont écrites (voir Conventions).
Réponses
| Code | Description | Schéma de data |
|---|---|---|
201 |
Created | ResultatEcriture |
400 |
Bad Request | ProblemDetails |
401 |
Unauthorized | - |
403 |
Forbidden | ProblemDetails |
422 |
Unprocessable Content | ProblemDetails |
503 |
Service Unavailable | ProblemDetails |
Exemple
curl -s -X POST "https://<votre-connecteur>/v2/ecriturepiece" \
-H "Authorization: Bearer <jeton>" \
-H "Content-Type: application/json" \
-d '{"codeJournal": "…", "date": "2026-01-01T00:00:00", "numeroPiece": "…"}'
GET /v2/ecriturepiece/{codeJournal}/{numeroPiece}
Lire l'enregistrement désigné.
Paramètres
| Nom | Emplacement | Type | Obligatoire | Description |
|---|---|---|---|---|
codeJournal |
path | string |
oui | - |
numeroPiece |
path | string |
oui | - |
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | tableau de EcritureDto |
401 |
Unauthorized | - |
403 |
Forbidden | - |
404 |
Not Found | ProblemDetails |
Exemple
curl -s -X GET "https://<votre-connecteur>/v2/ecriturepiece/<codeJournal>/<numeroPiece>" \
-H "Authorization: Bearer <jeton>" \
-H "Accept: application/json"
DELETE /v2/ecriturepiece/{codeJournal}/{numeroPiece}
Supprimer l'enregistrement.
Paramètres
| Nom | Emplacement | Type | Obligatoire | Description |
|---|---|---|---|---|
codeJournal |
path | string |
oui | - |
numeroPiece |
path | string |
oui | - |
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | ResultatEcriture |
401 |
Unauthorized | - |
403 |
Forbidden | ProblemDetails |
422 |
Unprocessable Content | ProblemDetails |
503 |
Service Unavailable | ProblemDetails |
Exemple
curl -s -X DELETE "https://<votre-connecteur>/v2/ecriturepiece/<codeJournal>/<numeroPiece>" \
-H "Authorization: Bearer <jeton>" \
-H "Accept: application/json"
Schémas
Schémas résolus à un niveau : les propriétés qui référencent un autre schéma sont citées par leur nom, sans être dépliées.
EcriturePieceDto
EcriturePieceDto - 5 propriétés
| Propriété | Type | Notes |
|---|---|---|
codeJournal |
string |
nullable, Code journal (JO_Num) - journal de type Général/Trésorerie pour une saisie d'OD. |
date |
string (date-time) |
Date comptable de la pièce. |
numeroPiece |
string |
nullable, Numéro de pièce (EC_Piece) - regroupe les lignes. |
referencePiece |
string |
nullable, Référence de pièce (EC_RefPiece, n° de facture…), optionnelle. |
lignes |
tableau de EcriturePieceLigneDto |
nullable, Lignes de la pièce (au moins deux, équilibrées). |
ProblemDetails
ProblemDetails - 5 propriétés
| Propriété | Type | Notes |
|---|---|---|
type |
string |
nullable |
title |
string |
nullable |
status |
integer (int32) |
nullable |
detail |
string |
nullable |
instance |
string |
nullable |
ResultatEcriture
ResultatEcriture - 4 propriétés
| Propriété | Type | Notes |
|---|---|---|
cle |
string |
nullable |
proprieteCle |
string |
nullable |
resultat |
quelconque | nullable |
entite |
quelconque | nullable |