Skip to content

Latest commit

 

History

History
69 lines (49 loc) · 3.02 KB

entries.md

File metadata and controls

69 lines (49 loc) · 3.02 KB
prev next
text link
💃 Introduction
MAD/introduction.md
text link
Écriture et Mouvements (Spec)
MAD/specs/v1.0.0/entries.md

Export des écritures et mouvements

L'API d'export ci-dessous vous permettra de récupérer les écritures par deux biais distincts;

  • Avec un exercice
  • Sur une période données de maximums 12 mois.

Il n'est pas possible de mélanger les deux.

curl --location \
--request GET 'https://api.myunisoft.fr/api/v1/mad/entries?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.

nom description obligatoire valeurs multiples
version Version du format ✔️ ❌
idExercice Identifiant de l'exercice ❌ ❌
startDate Date de début d'extraction au format YYYY-MM-DD ❌ ❌
endDate Date de fin d'extraction au format YYYY-MM-DD ❌ ❌
dateFilter Modifie la colonne utilisée par les options startDate et endDate. Les valeurs possibles sont document (par défaut), myunisoft (horodatage MyUnisoft), et accounting (date de comptabilisation). ❌ ❌
source Permet de récupérer les écritures liées à une source spécifique. ❌ ❌
journalIds Filtre pour inclure uniquement les écritures associées aux journaux spécifiés. Les IDs peuvent être récupérés via la route MAD journals ❌ ✔️
draft Si présent, l'API retournera uniquement les écritures en attente de validation ❌ ❌
comment Ajoute les commentaires liés aux écritures ❌ ❌

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).

Source

Le paramètre source doit contenir le code correspondant à l'une des sources documentées ici

🔬 Réponse

Le JSON renvoyé correspondra à la spécification suivante.

💬 Consulter les écritures 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.

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.