-
Notifications
You must be signed in to change notification settings - Fork 4
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
4 changed files
with
125 additions
and
10 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,107 @@ | ||
--- | ||
prev: | ||
text: 💃 Introduction | ||
link: MAD/introduction.md | ||
next: | ||
text: Écriture et Mouvements (Spec) | ||
link: MAD/specs/v1.0.0/entries.md | ||
--- | ||
|
||
> [!CAUTION] | ||
> Cette API est encore à un stade expérimental et certaines informations peuvent manquer. | ||
# Export des mouvements | ||
|
||
L'API d'export ci-dessous vous permettra de récupérer les mouvements par deux biais distincts; | ||
|
||
- Avec un [exercice](./exercice.md) | ||
- Sur une période données de maximums **12 mois**. | ||
|
||
Il n'est pas possible de mélanger les deux. | ||
|
||
```bash | ||
curl --location \ | ||
--request GET 'https://api.myunisoft.fr/api/v1/mad/movements?idExercice=1&version=1.0.0' \ | ||
--header 'X-Third-Party-Secret: nompartenaire-L8vlKfjJ5y7zwFj2J49xo53V' \ | ||
--header 'Authorization: Bearer {{API_TOKEN}}' \ | ||
--header 'Content-Type: application/json' | ||
``` | ||
|
||
## 🔧 Paramètres de la requête | ||
|
||
Le paramétrage de la route se fait exclusivement par le biais des [querystrings](https://en.wikipedia.org/wiki/Query_string). | ||
|
||
| nom | description | obligatoire | | ||
| --- | --- | :---: | | ||
| version | version du format | ✔️ | | ||
| idExercice | id exercice | ❌ | | ||
| startDate | Date de début d'extraction au format `YYYYMMDD` | ❌ | | ||
| endDate | Date de fin d'extraction au format `YYYYMMDD` | ❌ | | ||
| classAccount | N'incluent que les comptes démarrant par la class/catégorie fournit | ❌ | | ||
|
||
> [!NOTE] | ||
> L'écart maximum entre la date de début et de fin doit être de maximums 12 mois. | ||
> [!IMPORTANT] | ||
> 🔹 Accès cabinet | ||
> L'accès cabinet nécessitera la présence de l'en-tête HTTP `society-id` avec l'id du dossier de production (la société concernée par la demande d'extraction). | ||
## 🔬 Réponse | ||
|
||
Le JSON renvoyé correspondra aux mouvements selon la [spécification suivante](../specs/v1.0.0/entries.md). | ||
|
||
La différence majeure est que les informations liées à l'écriture sont présentes dans un sous-objet `entry`. | ||
|
||
Voici un exemple : | ||
|
||
```json | ||
{ | ||
"producerId": "179953", | ||
"description": "", | ||
"dueDate": null, | ||
"freeNumber": "", | ||
"invoiceNumber": "", | ||
"currency": "EUR", | ||
"value": { | ||
"credit": 3594.3, | ||
"debit": 0, | ||
"amount": 3594.3 | ||
}, | ||
"lettering": { | ||
"state": "none", | ||
"value": null | ||
}, | ||
"entry": { | ||
"producerId": "65771", | ||
"date": "2022-06-30", | ||
"createdAt": 1678132658 | ||
}, | ||
"attachments": {}, | ||
"journal": { | ||
"producerId": "1932", | ||
"customerReferenceCode": "PA", | ||
"name": "JOURNAL PA", | ||
"type": "OD" | ||
}, | ||
"account": { | ||
"producerId": "61440", | ||
"number": "4210000001", | ||
"name": "4210000001" | ||
}, | ||
"payment": null, | ||
"analytics": [] | ||
} | ||
``` | ||
|
||
## 💬 Consulter les mouvements sur l'interface MyUnisoft | ||
|
||
Sur MyUnisoft, il existe plusieurs moyens de récupérer et/ou consulter les écritures: | ||
|
||
- Par le biais de la saisie: `Tenue` > `Saisie/Consultation` > `Saisie` | ||
- Par la **recherche rapide**: accessible via l'icône en forme de loupe en haut à droite. | ||
|
||
![](../../images/quick_search.jpg) | ||
|
||
L'avantage de la première option est qu'elle permet de consulter les factures en attente, ce qui est courant lors d'un import au format JSON nécessitant une étape de validation par le responsable de dossier. | ||
|
||
![](../images/saisie_header.PNG) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,2 @@ | ||
# Écriture et mouvement: comprendre et choisir la bonne abstraction | ||
TBC |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters