INTEGRATION DE DKBSIGN

VERSION 5.0

DKBSIGN
DKB SOLUTIONS
SIEGE : Abidjan – Cocody, Riviera 3, Rue E128, Complexe Améthyste, Pavillon Emeraude
0
Intégration DKBSign version 5.0
I. Historique

HISTORIQUE DE REDACTION, VERIFICATION, APPROBATION

Rédaction Vérification Approbation
Nom Date/Visa Nom Date/Visa Nom Date/Visa
ANGORA Loïc 18/06/2020 DKB Solutions 18/06/2020 DKB Solutions 18/06/2020

PERSONNE A CONTACTER

Auteur Direction Mail

ANGORA Loïc Tech loic.angora@dkbsolutions.com

KASSI JAMMES Tech jammes.kassi@dkbsolutions.com

HISTORIQUE DE L’API
Version Auteur Date Commentaires

1.0 Angora Loïc 18/10/17 Création

2.0 Angora Loïc 15/07/18 Ajouts

3.0 Angora Loïc 22/11/18 Ajouts

4.0 Angora Loïc / Balie Marc 14/07/20 Mise à jour de l’api

4.0.1 Angora Loïc 18/04/22 Adaptation

5.0 Angora Loïc 4/07/22 Ajouts de nouvelles

fonctionnalitées

CONFIDENTIALITE

1
Intégration DKBSign version 5.0
Toutes les informations contenues dans ce document sont considérées comme confidentielles.
L’utilisation de celles-ci en dehors du cadre de cette consultation ou la divulgation à des personnes
extérieures est soumise à l’approbation préalable de DKB Solutions.

TABLE DES MATIERES

I. Historique………………………………………………………………………………….2
II. Principe de signature avec DKBSign……………………………………………3
III. Signer avec DKBSign…………………………………………………………………..3
III-1 Prérequis…………………………………………………………………….3
III-2 Signons maintenant ……………………………………………………3
IV. Contrats signés…………………………………………………………………………..7
V. Informations………………………………………………………………………………8
VI. Exemple document signé……………………………………………………………9
VII. Annexe (Liste des codes réponses)…………………………………………..11
VIII. Assistance technique ………………………………………………………………11

2
Intégration DKBSign version 5.0
II. Principe de signature avec DKBSign

Le workflow de la plateforme du client envoie le document PDF à signer par la méthode POST. DKBSign
récupère le document PDF et le signe à l’aide d’un certificat électronique. Puis renvoie le document
signé (non modifiable) à la plateforme du client.

Le protocole HTTPS, en utilisant le certificat SSL, chiffre les données échangées puis la clé de sécurité
cryptée donnée au client nous assure de la fiabilité, de l’authenticité des données et de celle du client.

III. Signer avec DKBSign

III-1 Prérequis
Vous devez rentrer en contact avec DKB Solutions sur le site https://www.dkbsolutions.com ou par
mail info@dkbsolutions.com afin de fournir certaines informations et obtenir :

-Votre certificat électronique

-Votre clé d’api de production, votre clé de sécurité

-Vos URL de productions

III-2 Signons maintenant

Le tableau ci-dessous vous donne l’url, la méthode, les paramètres, les messages de succès et d’erreur
lors de l’appel de l’Api pour la signature. Pour l’ensemble des tests vous pouvez utiliser cette clé de
sécurité : DH9QhgopYgZ0VyQNSVjd9k5b4S2i78ng781407RrlAolzMAeQYwVSYLNA== et cette clé
d’API : test@dkbsign7

3
Intégration DKBSign version 5.0
 NOM DESCRIPTION

TITRE Test connexion avec API

URL https://www.dkbsigns.com/API4/Api_dkbsign4/v1/getOk7/
METHODE GET
HEADERS authorizations : votre clé de sécurité
PARAMETRES Requis : néant
URL
PARAMETRES https://www.dkbsigns.com/API4/Api_dkbsign4/v1/getOk7/
EXEMPLE
REPONSE {
SUCCÈS "code": 807,
"alert": "Bonne connection..",
"version": "API DKBSIGN Version 5.0"
}

4
Intégration DKBSign version 5.0
 NOM DESCRIPTION

TITRE Signer vos documents PDF

URL https://www.dkbsigns.com/API4/Api_dkbsign4/v1/Testdkbsign7
METHODE POST
HEADERS authorizations : votre clé de sécurité
PARAMETRES
URL "Key_Api" : Clé d’API pour vous identifier ;
"Id_cl" : Identifiant du client dans le système du client ;
"signataire" : Nom et prénoms du 1er signataire sur le document PDF ;
"signataire2": Nom et prénoms du 2ème signataire sur le document PDF ;
"posX_signataire2":Position X du 2ème signataire ;
"posY_signataire2":Position Y du 2ème signataire ;
"signataire3": Nom et prénoms du 3ème signataire sur le document PDF ;
"posX_signataire3": Position X du 3ème signataire ;
"posY_signataire3": Position Y du 3ème signataire;
"nbre_signatair": Nombre de signataire sur le document (jusqu’à 3) ;
"Code_ctr": Identifiant du contrat dans le système du client ;
"ctr": Le chemin pour accéder au document (le document ne doit pas être en local) ;
"nom_ctr": Le nom du contrat dans le système du client ;
"posX": Position X du 1er signataire ;
"posY": Position Y du 1er signataire ;
"posX_qr": Position X du qr code ;
"posY_qr": Position Y du qr code ;
"taille_qr": Taille du qr code ;
"img_signataire_png": Le chemin pour accéder à l’image de la signature ;
"posX_Imgsign": Position X de l’image de la signature ;
"posY_Imgsign": Position Y de l’image de la signature ;
"page_sign": Page où vous voulez que la signature soit placée (facultatif) ;
"Largeur_img_signataire_png": Largeur de l’image de la signature ;
"Hauteur_img_signataire_png": Hauteur de l’image de la signature ;
"initial" : mettre des paraphes à chaque page (Facultatif) ;
"qrcodeyes" : rentrez la valeur « 1 » pour mettre un code qr sur le document (valeur facultative)* ;

5
Intégration DKBSign version 5.0
 PARAMETRES {
JSON
EXEMPLE "Key_Api":"test@dkbsign7",
"Id_cl":"0908155815",
"signataire":"kouadio",
"signataire2":"kouame",
"posX_signataire2":"120",
"posY_signataire2":"100",
"signataire3":"kouassi",
"posX_signataire3":"140",
"posY_signataire3":"150",
"nbre_signatair":"3",
"Code_ctr":"tl01",
"ctr":"https://serveur/contrat.pdf",
"nom_ctr":"contrat-tl01",
"posX":100,
"posY":50,
"posX_qr":100,
"posY_qr":10,
"taille_qr":20,
"img_signataire_png":"https://serveur/images/signatur.png",
"posX_Imgsign":10,
"posY_Imgsign":10,
"page_sign":"",
"Largeur_img_signataire_png":40,
"Hauteur_img_signataire_png":16,
"initial":"",
"qrcodeyes":""

}
REPONSE {
SUCCÈS "code": 804,
"message": "Document signe",
"signature_restant": 981
}

* : En scannant ce code qr vous savez si le document signé est authentique ou pas. Donc même après
impression de vos documents signés vous avez toujours un moyen de vérifier leur authenticité.

Cas plusieurs signataires (jusqu’à 3) :

Un signataire :
Vous devez renseigner le paramètre « nbre_signatair » à 1, puis renseigner tous les autres
paramètres sauf ceux concernant les deux autres signataires.
Deux signataires :
Vous devez renseigner le paramètre « nbre_signatair » à 2, puis renseigner tous les autres
paramètres sauf ceux concernant le 3ème signataire.

6
Intégration DKBSign version 5.0
 Trois signataires :

Vous devez renseigner le paramètre « nbre_signatair » à 3, puis renseigner tous les autres paramètres.

IV. Contrat signés

Lorsque votre contrat est signé, vous aurez besoin de le récupérer et de le conserver dans vos archives.
DKBSign conserve les documents signés pendant une durée de trois (05) semaines

NOM DESCRIPTION

TITRE Récupérer les contrats signés

URL https://www.dkbsigns.com/API4/Api_dkbsign4/v1/getTestdocsign7/B01
METHODE GET
HEADERS authorizations : votre clé de sécurité
PARAMETRES Requis :
URL Code_ctr : code du contrat dans le système du client

PARAMETRES https://www.dkbsigns.com/API4/Api_dkbsign4/v1/getTestdocsign7/B01
EXEMPLE
REPONSE {
SUCCÈS "code": 807,
"transac": [
{
"Id_cl": "0708155815",
"Code_ctr": "cl01",
"ctr": "https://chemin_du_contrat/contrat-cl01.pdf",
"sign_trans": "W4RDiQySz/72u1ERs972Yjp4gd6pHdBGYITBu0WFk

}
]
}

7
Intégration DKBSign version 5.0
 NOM DESCRIPTION

TITRE Récupérer les contrats signés à partir de l’identifiant du client

URL https://www.dkbsigns.com/API4/Api_dkbsign4/v1/getTestdocsignnum7/070815581522
METHODE GET
HEADERS authorizations : votre clé de sécurité
PARAMETRES Requis :
URL num : identifiant du client

PARAMETRES https://www.dkbsigns.com/API4/Api_dkbsign4/v1/getTestdocsignnum7/070815581522
EXEMPLE
REPONSE {
SUCCÈS "code": 807,
"transac": [
{
"Id_cl": "070815581522",
"Code_ctr": "Aa01",
"ctr": "https://chemin_du_contrat/Aa01.pdf",
"sign_trans": "pUfOK6Pt4gU2AomsEkSKpAIzoUHX6NQmZNgy5p+os90Z7hcnnSweQNyQb+Xf

}
]
}

V. Informations
Vous avez signés vos documents, puis les avez récupérés. Maintenant si vous voulez obtenir des
informations sur votre compte DKBSign (comme par exemple les informations sur votre certificat
électronique, votre nombre de signature etc...).

Informations générales

8
Intégration DKBSign version 5.0
 NOM DESCRIPTION

TITRE Obtenir les informations concernant son compte DKBSign

URL https://www.dkbsigns.com/API4/Api_dkbsign4/v1/getInfoCertificat7/test@dkbsign7
METHODE GET
HEADERS authorizations : votre clé de sécurité
PARAMETRES Requis :
URL Key_Api : clé d’API pour vous identifier

PARAMETRES https://www.dkbsigns.com/API4/Api_dkbsign4/v1/getInfoCertificat7/test@dkbsign7
EXEMPLE
REPONSE {
SUCCÈS "code": 807,
"Nom": "/C=CI/O=DKB SOLUTIONS/OU=CI-ABJ-2006-B-8567/L=CI-ABJ-2006-B-8567/
CN=dkbsolutions.com",
"Numero_seri": "0x1121F7DC3109E0A27C1C4A5E072AFA6F9921",
"Validite_debut": "19-04-2022 12:03:56",
"Validite_fin": "19-04-2023 12:03:56",
"nbre_doc_sign": "Vous avez signé 1 fois."
}

VI. Exemple document signé

Voici ci-dessous à quoi ressemble un exemple de document signé avec DKBSign.

9
Intégration DKBSign version 5.0
 10
Intégration DKBSign version 5.0
VII. Annexe (Liste des codes réponses)
Lors de l’utilisation de l’api, vous recevez des informations en json contenant des codes. Voici ci-après
la signification de chacun de ces codes :

CODE SIGNIFICATION
800 Token de sécurité invalide
801 Token de sécurité est manquant
802 Votre volume de signature est épuisé
803 Erreur lors de la signature
804 Document signe
805 Erreur non capturé
806 Mauvaise clé d'api
807 Succès de la requête
808 Erreur de la requête

VIII. Assistance technique

Pour toute question technique, vous pouvez nous contacter par téléphone au +(225) 22 47 00 50 ou
sur le site https://www.dkbsolutions.com ou encore par mail support.technique@dkbsolutions.com /
info@dkbsolutions.com

Accessible les jours ouvrés du lundi au vendredi de 09h00 à 17h30 (heure légale ivoirienne).

Tarification de ce numéro : Coût d’un appel local depuis un poste fixe.

11
Intégration DKBSign version 5.0