= API d'Appel d'offre de Clariprint =


L'API d'Appel d'Offre permet de lancer des calculs en lots.

== API CSV ==

L'api CSV est adaptée pour des données provenant d'un tableur (Excel).

=== Base ===
 * Type de requête : POST
 * url : mon_domaine/optimprokect/csv.wcl

=== Création d'un appel d'offre ===
Données du formulaire :
 * '''key''' : clef API define au niveau du Client Optimproject
 * '''action''' => "creation" 
 * '''callback''' : URL appelée par le système à la fin du calcul (à tester)
 * '''sheets''' : tableau de nom de feuille. ex : sheets[]="A"&sheets[]="B")
 * '''columns''' : tableau des colonne indexé sur les feuilles. ex : columns[A]="projet;code;hauteur;largeur;"
 * '''rows''' : tableau indexe des ligne de calcul (les projet à calculer)
  * la clef d'index contient "<nom de la feuille>!<num de ligne>" : le nom de la feuille doit correspondre à une feuille de '''sheets''', le num de ligne doit juste permette une clef unique. sous un tableur on utilise le numéro de la ligne
  * valeurs : sous la forme d'une liste séparée par un ";" qui doit correspondre au colonnes (columns) définies.

==== Données retournées ====
Données retournées en mode CSV.

Une ligne retournant la clef de session 
{{{
SESSION;<clef de session>
}}}

Pour chaque projet identifié, retourne une ligne
{{{
PROJECT;-;<nom du projet>;CREATE
}}}


=== Demande de résultats ===
Données du formulaire :

 * '''key''' : clef API define au niveau du Client Optimproject
 * '''session''' : le code session
 * '''action''''  :"status"
 * '''nb_responses''' : nombre de résultats retournés par lignes // par default 1

Données retournées :


Pour chaque projet, une ligne de type :
{{{
PROJET;<id clariprint>;<reference>;<OK | CALCUL>;<meilleur tarif>;<mille plus>;<nom du fournisseur>;<rang>;<indice>
}}}

 En mode CALCUL, les autres données sont vides.




== Structures des colonnes ==

laisser vide si pas de certitudes de l'information.

boolean : oui = 1,y,o 

||= Colonne =||= Valeurs possible =||= Informations =||
|| "ref", "reference", "code", "numero" || texte ||  référence du produit / devis
|| "type" || dépliant / folded / feuillet / leaflet / brochure  / book / chemise / folder || type de produit ||
|| "procédé" ||  || vide pour automatique, sinon une liste parmi  : of, ouv, or, oc, n 
|| "quantité totale", "qt" || entier || nombre total d'exemplaires du produit
|| "livré à plat", "flat" || booléen ||pour un dépliant ou une chemise indique si il est livré à plat va
|| "assemblage","binding" || ||  
|| || "PerfectBinding","DCC" ||  Dos Carré Collé
|| || "PerfectBindingPUR","DCCPUR"  ||  Brochage Dos Carré Collé PUR
|| || "SewnBinding","DCCC" || Brochage Dos Carré Cousu
|| || "Stitching2","PC","piqure cheval","piqûre cheval" || 2 agrafes 
|| || "Stitching3" ||  3 agrafes 
|| || "Stitching4" ||  4 agrafes 
|| || "OpenEyesStitching2","PB", "piqure bouclette", "piqûre bouclette"  ||  2 bouclettes
|| || "OpenEyesStitching3"  ||   3 bouclettes
|| || "OpenEyesStitching4" ||  4 bouclettes
|| || "WireO","WO" ||  Spirales
|| || "InlineStiching","PL" ||   Piqûre en ligne
|| || "GluedOnFold","CP" ||   Collage au pli
|| || "Free","FreeBinding" ||  libre, dans liaison
|| || "Folded","NA" || plié non assemblé
|| "orientation assemblage" || "portrait","landscape" || si vide ou les valeurs données, à la française 
|| "pliage" || || code JDF ou voir liste ci-dessous
|| "découpe" || || cf code découpe
|| "forme exitante" || bool || si non, le coût de création de la forme de découpe
|| "nbr de modèle" || entier || // "4" 
|| "quantité par tirage " || entier || quantité par tirage la colonne peut être dupliqué par modèles
|| "nbr de version (changement/modèle)" || nombre de version par modèle si applicable
|| "largeur fini", "width" ||   || en cm
|| "hauteur fini", "height"  || || en cm
|| "largeur à plat","largeur a plat", "flat width" || || en cm, pour dépliant et chemise
|| "hauteur à plat","hauteur a plat", "flat height" || || en cm, pour dépliant et chemise
|| "marque de papier", "brand" || || marque de papier
|| "type de papier", "qualite de papier" || csv2qualitePapier(current,data), // "Couché Moderne sans bois Brillant" 
|| "grammage" || csv2grammagePapier(current,data), // "150" 
|| "encre r" || csvAddEncreRecto(current,lower_data), // "Q" 
|| "encre v" || csvAddEncreVerso(current,lower_data), // "Q" 
|| "r modif version" || csvChangeEncreRecto(current,lower_data), // "Aucune modification" 
|| "v modif version" || csvChangeEncreVerso(current,lower_data), // "Aucune modification" 
|| "finition r" || csvAddFinitionRecto(current,lower_data), // "Vernis Acrylique Satin avec réserve tampon" 
|| "finition v" || csvAddFinitionRecto(current,lower_data), // "Vernis Acrylique Satin" 
|| "trous" || csv2trous(current,lower_data), // "" 
|| "perforation" || csv2perforation(current,lower_data), // "" 
|| "numérotation" || csv2numerotation(current,lower_data), // "" 
|| "rainage" || csv2rainage(current,lower_data), // "Automatique" 
|| "gauffrage hauteur", "gauffrage h" || csv2gauffrageH(current,lower_data), // "" 
|| "gauffrage largeur", "gauffrage l" || csv2gauffrageL(current,lower_data), // "" 
|| "dorure" || csv2dorureM(current,lower_data), // "" 
|| "dorure hauteur", "dorure h" || csv2dorureH(current,lower_data), // "" 
|| "dorure largeur", "dorure l" || csv2dorureL(current,lower_data), // "" 
|| "dorure matière", "dorure matiere" || csv2dorureM(current,lower_data), // "" 
|| "forme de découpe" || csv2decoupeExitante(current,lower_data), // "" 

|| "quantité conditionnee" || csv2conditionnementQ(product,lower_data), // "3500" 
|| "nbr de lot" || csv2conditionnementLot(product,lower_data), // "4" 
|| "emballage" || csv2conditionnementEmballage(product,lower_data), // "film" 
|| "exemplaire" || csv2conditionnementEmballageQt(product,lower_data), // "25" 

|| "nbr de point de livraison" || none, // "1" 
|| "livraison point" || csv2livraison(dev,data), // "FR-08" 
|| "livraison quantité" || csv2livraisonQt(dev,data), // "11900" 


|| "composant","produit" || (if (product % opFrontProduct/ProduitComposite)
												when x := csv2composant(product,lower_data) in (
													product.composants :add x,
													current := x)), // "" 
|| "type de produit" || none, // "" 
|| "nbr de pages","pages" || {