Requête de création d'écritures

Disponibilité

Applications : Versions : 8 et +

URL

api/rest/Ecritures/%22Importer%22

Méthode

POST

Paramètres

Cette requête prend des paramètres sous la forme d'un objet JSON.

Paramètres spécifiques

Paramètre	Description	Valeurs possibles	Présence	Valeur par défaut
format	Format d'import	GestimumComptaVariable GestimumComptaFixe GestimumComptaV15 GestimumGescomV15 EBPV5V2000 EBPV3	Obligatoire
fichier_ecritures	Fichier d'écritures à importer		Facultatif	Non
fichier_comptes	Fichier de comptes à importer		Facultatif	Non
tester	Tester seulement, sans réellement importer	Oui Non	Facultatif	Non
simulation	Créer les écritures en simulation	Oui Non	Facultatif	Non
creer_sections_analytiques	Créer les sections analytiques	Oui Non	Facultatif	Non
plan_analytique	Code plan analytique des sections à créer		Facultatif

Formats

Il existe 6 formats :

N°	Format	Nom interne	Type	Séparateur
1	Gestimum Gestion Comptable à largeur variable	GestimumComptaVariable	Largeur variable	Virgule
2	Gestimum Gestion Comptable à largeur fixe	GestimumComptaFixe	Largeur fixe
3	Gestimum Gestion Comptable version 1.5	GestimumComptaV15	Largeur fixe
4	Gestimum Gestion Commerciale version 1.5	GestimumGescomV15	Largeur variable	Virgule
5	EBP versions 5 et 2000	EBPV5V2000	Largeur variable	Virgule
6	EBP version 3	EBPV3	Largeur variable	Virgule

Exemples au format GestimumComptaVariable

Création d'une écriture de 3 lignes

{
    "importer\_ecritures": {
        "societe": {
            "fichier": "DEMO.Gestimum",
            "utilisateur": "DEMO",
            "mot\_passe": "",
            "deconnecter": "Non",
            "exclusif": "Non"
        },
        "parametres": {
            "journal": "Oui",
            "statistiques": "Oui",
            "format": "GestimumComptaVariable",
            "fichier\_ecritures": [
                "1,19/02/2019,VTE,411C25,,Presta,FAC19-1100425,EUR,12000,D,,02/03/2019,,CHQ,EUR",
                "2,19/02/2019,VTE,445710,,Presta,FAC19-1100425,EUR,2400,C",
                "3,19/02/2019,VTE,707100,,Presta,FAC19-1100425,EUR,9600,C"
            ],
            "tester": "Oui"
        }
    }
}

Remarque : le fichier peut contenir plusieurs écritures

Création d'une écriture de 3 lignes avec 2 échéances

{
    "importer\_ecritures": {
        "societe": {
            "fichier": "DEMO.Gestimum",
            "utilisateur": "DEMO",
            "mot\_passe": "",
            "deconnecter": "Oui",
            "exclusif": "Non"
        },
        "parametres": {
            "journal": "Oui",
            "statistiques": "Oui",
            "format": "GestimumComptaVariable",
            "fichier\_ecritures": [
                "1,19/02/2019,VTE,411C25,,Presta,FAC19-1100425,EUR,12000,D,,,,CHQ,EUR",
                "E10/04/2019,CHQ,40,4800",
                "E10/04/2019,CHQ,60,7200",
                "2,19/02/2019,VTE,445710,,Presta,FAC19-1100425,EUR,2400,C",
                "3,19/02/2019,VTE,707100,,Presta,FAC19-1100425,EUR,9600,C"
            ],
            "tester": "Non"
        }
    }
}

Création d'une écriture de 3 lignes avec 1 ventilation analytique

{
    "importer_ecritures": {
        "societe": {
            "fichier": "DEMO.Gestimum",
            "utilisateur": "DEMO",
            "mot_passe": "",
            "deconnecter": "Non",
            "exclusif": "Non"
        },
        "parametres": {
            "journal": "Oui",
            "statistiques": "Oui",
            "format": "GestimumComptaVariable",
            "fichier_ecritures": [
                "1,19/02/2019,VTE,411C25,,Presta,FAC19-1100425,EUR,12000,D,,02/03/2019,,CHQ,EUR",
                "2,19/02/2019,VTE,445710,,Presta,FAC19-1100425,EUR,2400,C",
                "3,19/02/2019,VTE,707100,,Presta,FAC19-1100425,EUR,9600,C",
                ">P1,S1,100,9600,100,1"
            ],
            "tester": "Oui"
        }
    }
}

Exemple au format EBPV5V2000

Création d'une écriture de 3 lignes et d'1 compte comptable

{
    "importer_ecritures": {
        "societe": {
            "fichier": "DEMO.Gestimum",
            "utilisateur": "DEMO",
            "mot_passe": "",
            "deconnecter": "Non",
            "exclusif": "Non"
        },
        "parametres": {
            "journal": "Oui",
            "statistiques": "Oui",
            "format": "EBPV5V2000",
            "fichier_ecritures": [
                "1,11/02/2019,VTE,411C24,,Presta,FAC19-1100422,12000,D,13/03/2019,,CHQ,EUR",
                "2,11/02/2019,VTE,445710,,Presta,FAC19-1100425,2400,C,,,,",
                "3,11/02/2019,VTE,707100,,Presta,FAC19-1100425,9600,C,,,,"
            ],
            "fichier_comptes": [
                "411BETATEST0404,BETA TEST 0404,BETATEST0404,5 rue Cugnot;ZA du Patis,78120,Rambouillet,FR,,0134840901,0134840902"      
            ],
            "tester":"Oui"
        }
    }
}

Retour

``` { "result": [ { "resultat": "succès", "message": "terminé", "journal": [ "23/09/2019 11:47:22 Ouverture de la société C:\ProgramData\Gestimum\DEMO.Gestimum", "23/09/2019 11:47:25 Société C:\ProgramData\Gestimum\DEMO.Gestimum ouverte", "23/09/2019 11:47:25 Lancement de la tâche ImporterEcritures", "23/09/2019 11:47:25 Ci-dessous le rapport d'import :", "23/09/2019 11:47:25 ############################################################", "23/09/2019 11:47:25 Résumé", "23/09/2019 11:47:25 Lignes d'écritures importables : 3", "23/09/2019 11:47:25 Lignes d'écritures rejetables : 0", "23/09/2019 11:47:25 Lignes d'échéances importables : 0", "23/09/2019 11:47:25 Lignes d'échéances rejetables : 0", "23/09/2019 11:47:25 ERREURS : 0", "23/09/2019 11:47:25 AVERTISSEMENTS : 0", "23/09/2019 11:47:25 ############################################################", "23/09/2019 11:47:25 Fichier d'écritures importé : D:\Temp\ImporterEcritures\2019-09-23-11-47-22-048\Ecritures.txt", "23/09/2019 11:47:25 Légende :", "23/09/2019 11:47:25 ERR : Erreur provoquant le rejet de la ligne", "23/09/2019 11:47:25 AV : Avertissement ne provoquant pas le rejet de la ligne", "23/09/2019 11:47:25 E : Ligne d'écriture", "23/09/2019 11:47:25 S : Section analytique", "23/09/2019 11:47:25 H : Ligne d'échéance", "23/09/2019 11:47:25 Tâche ImporterEcritures terminée", "23/09/2019 11:47:25 Fermeture de la société C:\ProgramData\Gestimum\DEMO.Gestimum" ], "statistiques": { "nombre_erreurs": "0", "nombre_avertissements": "0", "nombre_lignes_écritures_importées": "3", "nombre_lignes_écritures_rejetées": "0", "nombre_lignes_échéances_importées": "0", "nombre_lignes_échéances_rejetées": "0", "nombre_lignes_analytiques_importées": "0", "nombre_lignes_analytiques_rejetées": "0" } } ] } ````