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

boolean : oui = 1,y,o

"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"
	"Stitching2","PC","piqure cheval","piqûre cheval"
	"PerfectBinding","DCC"	BrochageDosCarreColleItem(),
	"PerfectBindingPUR","DCCPUR"	BrochageDosCarreColleItem(PUR? = true),
	"SewnBinding","DCCC"	BrochageDosCarreCousuItem(),
	"Stitching3"	PiqureChevalItem(nbPiqures = 3),
	"Stitching4"	PiqureChevalItem(nbPiqures = 4),
	"OpenEyesStitching2","PB", "piqure bouclette", "piqûre bouclette"	PiqureBoucletteItem(nbPiqures = 2),
	"OpenEyesStitching3"	Piqure 3cBoucletteItem
	"OpenEyesStitching4"	Piqure 4 BoucletteItem
	"WireO","WO"
	"InlineStiching","PL"	Piqure en ligne
	"GluedOnFold","CP"	Collage au pli
	"Free","FreeBinding"
	"Folded","NA"	e
"orientation assemblage"	"portrait","landscape", ""	si vide ou les valeurs donné, à la française
"pliage"	csv2pliage(current,lower_data), "plis portefeuille à 3 plis"
"découpe"	csv2decoupe(current,lower_data), ""
"forme exitante"	csv2decoupeExitante(current,lower_data), ""
"nbr de modèle"	csv2nbModeles(current,lower_data), "4"
"quantité par tirage "	csv2addModeles(current,lower_data), "3500"
"nbr de version (changement/modèle)"	csv2nbVersions(current,lower_data), "1"
"largeur fini"	csv2largeurFini(current,lower_data), "14,8"
"hauteur fini"	csv2hauteurFini(current,lower_data), "21"
"largeur à plat","largeur a plat"	csv2hauteurAplat(current,lower_data), "59,2"
"hauteur à plat","hauteur a plat"	csv2largeurAplat(current,lower_data), "21"
"marque de papier"	csv2marquePapier(current,data), "Couché Moderne sans bois Brillant"
"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"	{