| Cegid Developers

POST/importPerso

Import entries in custom format

Example Value

Schema

{
  "codeIbs": "string",
  "URI": "string",
  "URL": "string",
  "modele": "string",
  "SIRET": "string"
}

API Request/Response

example Code Description Links 200 class response

Media type

application/json Controls Accept header.

Therefore, all responses from the API are in the JSON format and all payloads to the API must be in the JSON format. The request headers must contain Content-Type: application-json.

Parameter

"url": https://api.cegid.com/loop-api-publiques/importPerso

Name	Description	example	mandatory
codeIbs	Code Dossier	CEGID001	Yes
URI	File path in Azure Storage		NO
URL	where the file is located	https://...	YES
SIRET	SIRET number (14 digits)	07955542100027	NO
modele	Import Model		YES

Note to be entered either URL or URI not both at the same time

The URL or URI for authentication to "fichier" must be valid for at least 24 hours (Microsoft recommendation) The objective is to be able to manage the "retry" process ,and track the service disruptions, whether voluntary or involuntary.

Règles établissement

Si le fichier importé (format personnalisé) contient une colonne Etablissement, chaque valeur doit être un SIRET valide du dossier.
Si des lignes d'une même pièce comptable contiennent des SIRET différents, l'import est rejeté.
Si un en-tête SIRET est fourni dans la requête, le fichier doit rester cohérent avec ce SIRET unique.
Si plusieurs établissements (NIC différents) sont présents et valides, l'import est ventilé automatiquement par établissement.

Quelques exemples de messages d'erreurs possibles :

Le codeIbs n'est pas spécifié.
Le chemin d'accès URI ou l'URL du fichier n'est pas spécifié.
Ambiguité sur le chemin d'accès, seul un des deux champs doit être renseigné.
Le dossier {codeIBS} n'existe pas sur le domaine.
Le numéro SIRET est invalide : il doit comporter 14 chiffres et respecter l'algorithme de Luhn
L'établissement correspondant au SIRET {SIRET} n'est pas reconnu pour le dossier {codeIBS}
Une pièce comptable contient des SIRET différents

example :
{
  "codeIbs": "CEGID003",
  "URI": "",
  "URL": "https://looptestcabinetrdd.blob.core.windows.net/api-import-ecritures-dev/005e3c2d-8352-49e5-82f3-8704a079b9f3/842008161FEC20201231.txt?sv=2020-08-04&st=2022-03-25T15%3A23%3A51Z&se=2022-03-26T15%3A23%3A51Z&sr=b&sp=r&sig=Woems51XulQt0XiMMF4lyk9VleNWIGNeqvw86eEC0Pw%3D",
  "modele": "IMPORTPERSO",
  "SIRET": "07955542100027"
}

Response

{
  "accountingImportRequestId": "ca85671e-6f98-4c2e-b075-c5cd9fea57ed"
}