Créer un projet de recherche de numéro SIRET

 

Etape 1 – Créer un Template

API

Création d’un Template de recherche d’informations dans un document:
{
"IdProjectType": 5,
"Title": "Recherche - SIRET",
"Description": "Template de projet de recherche de SIRET",
"Instructions": [
{
"Instruction": "Bonjour,
Le but de ce projet est de récupérer l’état et le numéro de SIRET de plusieurs sociétés.
Vous trouverez un exemple de recherche de SIRET à cette adresse : http://tutoFF.recherche.exemple.com/
Voici le nom de la société à rechercher :",
"Order": 1
}
],
"Columns": [
{
"IdTemplateColumnType": 1,
"Column": 1,
"Order": 2
}
],
"Questions": [
{
"Title": "Est-ce que la société est encore en activité ?",
"Option": "Champ requis",
"Require": true,
"IdTemplateObjectQuestionType": 3,
"Choices": [
"Ouvert",
"Fermé"
],
"Order": 3
},
{
"Title": "Écrire encore le numéro de SIRET",
"Require": false,
"IdTemplateObjectQuestionType": 1,
"Order": 4
}
]
}

Retour JSON:
3178

Lors de la création, vous recevez l’id du template créé. Ici notre template a l’id 3178.

AngularJS

Vous pouvez trouver un exemple de l’utilisation du SDK FouleFactory en cliquant ici.

 

Pour effectuer un test, vous devrez modifier les valeurs « YourLogin » et « YourPass » présent dans le JavaScript en les remplaçant par votre login API et votre mot de passe API.

PHP

<?php
require_once "FouleFactory-SDK-PHP-master/vendor/autoload.php";
use FouleFactoryApiLib\FouleFactoryApiClient;
FouleFactoryApiLib\Configuration::$BASEURI = "http://sandbox-api.foulefactory.com";
$basicAuthUserName = "YourLogin";
$basicAuthPassword = "YourPass";
$apiClient = new FouleFactoryApiClient($basicAuthUserName, $basicAuthPassword);
$clientAccount = $apiClient->getTemplates();
$data = array(
'IdProjectType' => "5",
'Title' => "Recherche - SIRET",
'Description' => "Template de projet de recherche de SIRET",
'Instructions' => array(
array('Instruction' => "Bonjour,
Le but de ce projet est de récupérer l’état et le numéro de SIRET de plusieurs sociétés.
Vous trouverez un exemple de recherche de SIRET à cette adresse : http://tutoFF.recherche.exemple.com/
Voici le nom de la société à rechercher :",
'Order' => "1")
),
'Columns' => array(
array('IdTemplateColumnType' => "1",
'Column' => "1",
'Order' => "2")
),
'Questions' => array(
array('Title' => "Est-ce que la société est encore en activité ?",
'Option' => "Champ requis",
'Require' => "true",
'IdTemplateObjectQuestionType' => "3",
'Choices' => array("Ouvert", "Fermé"),
'Order' => "3"),
array('Title' => "Écrire encore le numéro de SIRET",
'Require' => "false",
'IdTemplateObjectQuestionType' => "1",
'Order' => "4")
)
);
$idTemplate = $clientAccount->createTemplatesCreateTemplate($data);
?>

.NET

public static int CreateTemplate()
{
var fouleFactory = new FouleFactoryApiClient("https://sandbox-api.foulefactory.com", "YourLogin", "YourPass");
var instructions = new List<TemplateInstructionWriterServiceModel>();
instructions.Add(new TemplateInstructionWriterServiceModel
{
Instruction = "Bonjour,\n\nLe but de ce projet est de récupérer l’état et le numéro de SIRET de plusieurs sociétés.\n\nVous trouverez un exemple de recherche de SIRET à cette adresse : http://tutoFF.recherche.exemple.com/ \n\nVoici le nom de la société à rechercher :",
Order = 1
});
var columns = new List<TemplateColumnWriterServiceModel>();
columns.Add(new TemplateColumnWriterServiceModel
{
IdTemplateColumnType = 1,
Column = 1,
Order = 2
});
var questions = new List<TemplateQuestionWriterServiceModel>();
questions.Add(new TemplateQuestionWriterServiceModel
{
Title = "Est-ce que la société est encore en activité ?",
Option = "Champ requis",
Require = true,
IdTemplateObjectQuestionType = 3,
Choices = new List<string> { "Ouvert", "Fermé" },
Order = 3
});
questions.Add(new TemplateQuestionWriterServiceModel
{
Title = "Écrire encore le numéro de SIRET",
Require = false,
IdTemplateObjectQuestionType = 1,
Order = 4
});
var template = new TemplateNewWriterServiceModel
{
IdProjectType = 5,
Title = "Recherche - SIRET",
Description = "Template de projet de recherche de SIRET",
Instructions = instructions,
Columns = columns,
Questions = questions
};
var idTemplate = fouleFactory.Templates.CreateTemplatesCreateTemplate(template);
return ((int)idTemplate);
}

Etape 2 – Créer un projet

API

Création d’un projet de recherche d’informations dans un document:
{
"IdTemplate": 3178,
"Title": "Recherche - SIRET",
"EstimatedTimePerTask": "00:01:00",
"MaxEndDate": "2016-09-30",
"NbSupplierPerTask": 1,
"AmountWithoutTaxPerTask": 25,
"AutomaticValidation": false
}

Retour JSON:
{
"IdProject": 11200,
"IdState": 2,
"IdTemplate": 3178,
"IdType": 5,
"Title": "Recherche - SIRET",
"EstimatedTimePerTask": "00:01:00",
"MaxEndDate": "2016-09-30T00:00:00",
"NbSupplierPerTask": 1,
"AmountWithoutTaxPerTask": 25,
"CsvFiles": [],
"TaskLines": [],
"AutomaticValidation": false,
"IdCertification": null,
"UrlNotification": null
}

Votre projet est maintenant créé.

AngularJS

Vous pouvez trouver un exemple de l’utilisation du SDK FouleFactory en cliquant ici.

 

Pour effectuer un test, vous devrez modifier les valeurs « YourLogin » et « YourPass » présent dans le JavaScript en les remplaçant par votre login API et votre mot de passe API.

PHP

<?php
require_once "FouleFactory-SDK-PHP-master/vendor/autoload.php";
use FouleFactoryApiLib\FouleFactoryApiClient;
FouleFactoryApiLib\Configuration::$BASEURI = "http://sandbox-api.foulefactory.com";
$basicAuthUserName = "YourLogin";
$basicAuthPassword = "YourPass";
$apiClient = new FouleFactoryApiClient($basicAuthUserName, $basicAuthPassword);
$clientProject = $apiClient->getProjects();
$data = array(
'IdTemplate' => $idTemplate,
'Title' => "Recherche - SIRET",
'EstimatedTimePerTask' => "00:01:00",
'MaxEndDate' => "2016-09-30",
'NbSupplierPerTask' => "1",
'AmountWithoutTaxPerTask' => "25",
'AutomaticValidation' => false
);
$project = $clientProject->createProjectsCreateProject($data);
?>

.NET

public static int CreateProject(int idTemplate)
{
var fouleFactory = new FouleFactoryApiClient("https://sandbox-api.foulefactory.com", "YourLogin", "YourPass");
ProjectWriterServiceModel project = new ProjectWriterServiceModel
{
IdTemplate = idTemplate,
Title = "Recherche - SIRET",
EstimatedTimePerTask = "00:01:00",
MaxEndDate = DateTime.UtcNow.AddDays(15),
NbSupplierPerTask = 1,
AmountWithoutTaxPerTask = 25,
AutomaticValidation = false
};
var projectJson = fouleFactory.Projects.CreateProjectsCreateProject(project);
FouleFactoryProjectModel projectInfos = JsonConvert.DeserializeObject<FouleFactoryProjectModel>(projectJson.ToString());
return (projectInfos.IdProject);
}

Etape 3 – Ajout de taches

API

Ajout de tache grâce à un fichier CSV contenant du texte:
{
"IdProject": 11200,
"File": "Rm91bGUgRmFjdG9yeQ0KQmFua0tZQw0KR29vZ2xlDQpNaWNyb3NvZnQNCg==",
"Header": false,
"Separator": ";"
}

Le fichier CSV doit être converti en base 64.

Fichier CSV utilisé dans l’exemple ici.

Retour JSON:

{
"IdCsvFile": 11295,
"IdProject": 11200,
"Url": "https://ffpreproddatauser.blob.core.windows.net/0000002277/cb6440317ca448f5aff6bcd55a07876f.csv",
"Normalized": false,
"Header": false,
"Separator": "; "
}

Votre CSV est maintenant ajouté au projet. La transformation du fichier CSV en tache est en cours (normalisation). Vous recevrez un email lorsque le projet sera en ligne.

AngularJS

Vous pouvez trouver un exemple de l’utilisation du SDK FouleFactory en cliquant ici.

 

Pour effectuer un test, vous devrez modifier les valeurs « YourLogin » et « YourPass » présent dans le JavaScript en les remplaçant par votre login API et votre mot de passe API.

PHP

<?php
require_once "FouleFactory-SDK-PHP-master/vendor/autoload.php";
use FouleFactoryApiLib\FouleFactoryApiClient;
FouleFactoryApiLib\Configuration::$BASEURI = "http://sandbox-api.foulefactory.com";
$basicAuthUserName = "YourLogin";
$basicAuthPassword = "YourPass";
$apiClient = new FouleFactoryApiClient($basicAuthUserName, $basicAuthPassword);
$clientCsv = $apiClient->getCsvFiles();
$data = array(
'IdProject' => $project->IdProject,
'File' => "Rm91bGUgRmFjdG9yeQ0KQmFua0tZQw0KR29vZ2xlDQpNaWNyb3NvZnQNCg==",
'Header' => false,
'Separator' => ";"
);
$csv = $clientCsv->createCsvFilesCreateCsvFile($data);
?>

.NET

public static void AddCsvFile(int idProject)
{
var fouleFactory = new FouleFactoryApiClient("https://sandbox-api.foulefactory.com", "YourLogin", "YourPass");
CsvFileWriterServiceModel csvFile = new CsvFileWriterServiceModel
{
IdProject = idProject,
File = "Rm91bGUgRmFjdG9yeQ0KQmFua0tZQw0KR29vZ2xlDQpNaWNyb3NvZnQNCg==",
Header = false,
Separator = ";"
};
fouleFactory.CsvFiles.CreateCsvFilesCreateCsvFile(csvFile);
}

Rendu coté Fouleur

sample-recherche-siret-rendu

Etape 4 – Récupération des taches

API

Nous allons récupérer nos taches avec la requête GET /projects/{idProject}/tasks
[
{
"IdTask": 37764,
"IdTaskLine": 27825,
"IdSupplier": null,
"IdTaskState": 2,
"IdTaskType": null,
"UpdateDate": "2016-09-23T15:53:41.52",
"CreateDate": "2016-09-23T15:53:41.457",
"TaskAnswer": []
},
{
"IdTask": 37765,
"IdTaskLine": 27826,
"IdSupplier": null,
"IdTaskState": 2,
"IdTaskType": null,
"UpdateDate": "2016-09-23T15:56:43.403",
"CreateDate": "2016-09-23T15:53:41.467",
"TaskAnswer": []
},
{
"IdTask": 37766,
"IdTaskLine": 27827,
"IdSupplier": null,
"IdTaskState": 2,
"IdTaskType": null,
"UpdateDate": "2016-09-23T15:53:41.533",
"CreateDate": "2016-09-23T15:53:41.483",
"TaskAnswer": []
},
{
"IdTask": 37763,
"IdTaskLine": 27824,
"IdSupplier": 2263,
"IdTaskState": 1005,
"IdTaskType": null,
"UpdateDate": "2016-09-23T15:56:27.51",
"CreateDate": "2016-09-23T15:53:41.433",
"TaskAnswer": [
null,
"Ouvert"
]
}
]

Nous pouvons voir les réponses du contributeur dans TaskAnswer.

AngularJS

Vous pouvez trouver un exemple de l’utilisation du SDK FouleFactory en cliquant ici.

 

Pour effectuer un test, vous devrez modifier les valeurs « YourLogin » et « YourPass » présent dans le JavaScript en les remplaçant par votre login API et votre mot de passe API.

PHP

<?php
require_once "FouleFactory-SDK-PHP-master/vendor/autoload.php";
use FouleFactoryApiLib\FouleFactoryApiClient;
FouleFactoryApiLib\Configuration::$BASEURI = "http://sandbox-api.foulefactory.com";
$basicAuthUserName = "YourLogin";
$basicAuthPassword = "YourPass";
$apiClient = new FouleFactoryApiClient($basicAuthUserName, $basicAuthPassword);
$clientTasks = $apiClient->getProjects();
$tasks = $clientProject->getProjectsGetProjectTasks($project->IdProject);
?>

.NET

public static List<FouleFactoryTaskModel> GetTasks(int idProject)
{
var fouleFactory = new FouleFactoryApiClient("https://sandbox-api.foulefactory.com", "YourLogin", "YourPass");
var tasks = fouleFactory.Projects.GetProjectsGetProjectTasks(idProject);
List<FouleFactoryTaskModel> taskInfos = JsonConvert.DeserializeObject<List<FouleFactoryTaskModel>>(tasks.ToString());
return taskInfos;
}