@extends('documentation.webservice.squelette')
<!-- ************************************** -->
@section('titre')
{{ __("API") }}
@endsection

@section('menu')
    {{-- <li class="nav-item">
        <a class="nav-link scrollto" href="#app-components">Description de l'API</a>
    </li> --}}
    <li class="nav-item">
        <ul class="nav doc-sub-menu nav flex-column">
            <li class="nav-item">
                <a class="nav-link scrollto" href="#activites">Activités / lots</a>
            </li>
            <li class="nav-item">
                <a class="nav-link scrollto" href="#sites">Sites</a>
            </li>
            <li class="nav-item">
                <a class="nav-link scrollto" href="#statuts">Statuts</a>
            </li>

            <li class="nav-item">
                <a class="nav-link scrollto" href="#interventions">Interventions</a>
            </li>
            <li class="nav-item">
                <a class="nav-link scrollto" href="#interventions_add">Commande  / demande de devis</a>
            </li>
            <li class="nav-item">
                <a class="nav-link scrollto" href="#file_add">Ajout de fichier joint</a>
            </li>
            <li class="nav-item">
                <a class="nav-link scrollto" href="#file_add_base64">Ajout de fichier joint en base64</a>
            </li>
        </ul><!--//nav-->
    </li>
@endsection

@section('contenu')

<section id="activites" class="doc-section">
    <h2 class="section-title">Activités / lots</h2>
    <div class="section-block">
        <h6>Description</h6>
        <p>
           Donne la liste des activités / lots.
        </p>
        <br>
        <h6>Appels possibles</h6>

        <table class="table table-bordered table-compact">
            <thead>
                <tr>
                    <th>Verbe HTTP</th>
                    <th>Adresse</th>
                    <th>Description</th>
                </tr>
            </thead>
            <tbody>
                <tr>
                    <td><button class="btn btn-blue">GET</button></td>
                    <td>/api/activities</td>
                    <td>Liste des activités</td>
                </tr>
                <tr>
                    <td><button class="btn btn-blue">GET</button></td>
                    <td>/api/activity/act_id</td>
                    <td>Détail d'une activité par identifiant "act_id"</td>
                </tr>
                <tr>
                    <td><button class="btn btn-blue">GET</button></td>
                    <td>/api/activity/act_correspondance</td>
                    <td>Détail d'une activité par correspondance "act_correspondance"</td>
                </tr>
            </tbody>
        </table>

        <h6>Exemples</h6>
        <p><code> http://elan_providers/api/activities
            <br>http://elan_providers/api/activity/1
            <br>http://elan_providers/api/activity_bycorresp/x2301</code></p>
            <br>

        <h6>Liste des champs</h6>
        <div class="table-responsive">
            <table class="table table-bordered">
                <thead>
                    <tr>
                        <th>Champ</th>
                        <th>Type</th>
                        <th>Description</th>
                    </tr>
                </thead>
                <tbody>
                    <tr><td>act_id</td><td>INTEGER</td><td>Identifiant interne ELAN de l'activité</td></tr>
                    <tr><td>act_nameFr</td><td>VARCHAR(255)</td><td>Désignation</td></tr>
                    <tr><td>act_active</td><td>INTEGER</td><td>Activité active oui/non (0/1) </td></tr>
                    <tr><td>act_correspondance</td><td>VARCHAR(255)</td><td>Correspondance</td></tr>
                </tbody>
            </table>
        </div><!--//table-responsive-->
        <br>
                <h6>Exemple json retour</h6>
<pre><code class="language-javascript">
[
{
"act_id": 1,
"act_nameFr": "Electricité",
"act_active": 1,
"act_correspondance": null
},
{
"act_id": 2,
"act_nameFr": "Plomberie",
"act_active": 1,
"act_correspondance": null
},
...</code></pre>

    </div>
</section><!--//doc-section-->

<!--*********************************************************************************************************************************-->
<!--*********************************************************************************************************************************-->
<!--*********************************************************************************************************************************-->

<section id="sites" class="doc-section">
    <h2 class="section-title">Sites</h2>
    <div class="section-block">
        <h6>Description</h6>
        <p>
           Donne la liste des sites.
        </p>
        <br>
        <h6>Appels possibles</h6>
        <table class="table table-bordered table-compact">
            <thead>
                <tr>
                    <th>Verbe HTTP</th>
                    <th>Adresse</th>
                    <th>Description</th>
                </tr>
            </thead>
            <tbody>
                <tr>
                    <td><button class="btn btn-blue">GET</button></td>
                    <td>/api/sites</td>
                    <td>Liste des sites</td>
                </tr>
                <tr>
                    <td><button class="btn btn-blue">GET</button></td>
                    <td>/api/site/sit_id</td>
                    <td>Détail d'un site par identifiant "sit_id"</td>
                </tr>
                <tr>
                    <td><button class="btn btn-blue">GET</button></td>
                    <td>/api/site_bycode/sit_codee</td>
                    <td>Détail d'un site par code</td>
                </tr>
            </tbody>
        </table>

        <h6>Exemples</h6>
        <p><code> http://elan_providers/api/sites
            <br>http://elan_providers/api/site/1
            <br>http://elan_providers/api/site_bycode/698</code></p>
            <br>

        <h6>Liste des champs</h6>
        <div class="table-responsive">
            <table class="table table-bordered">
                <thead>
                    <tr>
                        <th>Champ</th><th>Type</th><th>Description</th>
                    </tr>
                </thead>
                <tbody>
                    <tr><td>sit_id</td><td>INTEGER</td><td>Identifiant interne ELAN du site</td></tr>
                    <tr><td>sit_name</td><td>VARCHAR(255)</td><td>Désignation</td></tr>
                    <tr><td>sit_code</td><td>VARCHAR(30)</td><td>Code du site (code du client) </td></tr>
                    <tr><td>sit_address1</td><td>VARCHAR(255)</td><td>Adresse ligne 1</td></tr>
                    <tr><td>sit_address2</td><td>VARCHAR(255)</td><td>Adresse ligne 2 </td></tr>
                    <tr><td>sit_phone</td><td>VARCHAR(20)</td><td>N° de téléphone du site</td></tr>
                    <tr><td>sit_email</td><td>VARCHAR(255)</td><td>email principal du site</td></tr>
                    <tr><td>sig_id</td><td>INTEGER</td><td>identifiant enseigne de rattachement</td></tr>
                    <tr><td>sit_active</td><td>INTEGER</td><td>actif oui/non (0/1)</td></tr>
                    <tr><td>sit_lat</td><td>FLOAT</td><td>coordonnées latitude</td></tr>
                    <tr><td>sit_lng</td><td>FLOAT</td><td>coordonnées longitude</td></tr>
                    <tr><td>sit_portable</td><td>VARCHAR(20)</td><td>tel portable responsable du site</td></tr>
                    <tr><td>sit_zipCode</td><td>VARCHAR(10)</td><td>code postal</td></tr>
                    <tr><td>sit_city</td><td>VARCHAR(255)</td><td>ville</td></tr>
                    <tr><td>cou_nameFr</td><td>VARCHAR(255)</td><td>pays</td></tr>
                    <tr><td>sig_socialReason</td><td>VARCHAR(255)</td><td>raison sociale enseigne de rattachement</td></tr>
                </tbody>
            </table>
        </div><!--//table-responsive-->
        <br>
                <h6>Exemple json retour</h6>
<pre><code class="language-javascript">
[
{
"sit_id": 3,
"sit_name": "AGDE CC ESPACE GD CAP",
"sit_code": "373",
"sit_address1": "BOULEVARD .....",
"sit_address2": "",
"sit_phone": "04 67 98 90 54",
"sit_email": "",
"sig_id": 3,
"sit_active": 1,
"sit_lat": "43.29878000",
"sit_lng": "3.47443000",
"sit_formattedAddress": "Boulevard Maurice, ........., 34300 Agde, France",
"sit_portable": null,
"sit_zipCode": "34306",
"sit_city": "AGDE",
"cou_nameFr": "FRANCE",
"sig_socialReason": "ENSEIGNE 1"
},
...</code></pre>

    </div>
</section><!--//doc-section-->

<!--*********************************************************************************************************************************-->
<!--*********************************************************************************************************************************-->
<!--*********************************************************************************************************************************-->

<section id="statuts" class="doc-section">
    <h2 class="section-title">Statuts paramétrés</h2>
    <div class="section-block">
        <h6>Description</h6>
        <p>
           Donne la liste des statuts par défaut paramétrés dans l'application. <br>
           Les valeurs de ces statuts par défaut sont utiles pour la création de demandes de devis et de commandes.
        </p>
        <br>
        <h6>Appels possibles</h6>
        <table class="table table-bordered table-compact">
            <thead>
                <tr>
                    <th>Verbe HTTP</th>
                    <th>Adresse</th>
                    <th>Description</th>
                </tr>
            </thead>
            <tbody>
                <tr>
                    <td><button class="btn btn-blue">GET</button></td>
                    <td>/api/status_params</td>
                    <td>Liste des statuts par défaut paramétrés</td>
                </tr>
                <tr>
                    <td><button class="btn btn-blue">GET</button></td>
                    <td>/api/status_param/staPar_id</td>
                    <td>Détail par identifiant "staPar_id"</td>
                </tr>
                <tr>
                    <td><button class="btn btn-blue">GET</button></td>
                    <td>/api/status_param_bycode/staPar_code</td>
                    <td>Détail d'un statut paramétré</td>
                </tr>
            </tbody>
        </table>

        <h6>Exemples</h6>
        <p><code> http://elan_providers/api/status_params
            <br>http://elan_providers/api/status_param/1
            <br>http://elan_providers/api/status_param_bycode/sta_defaut_proreq</code></p>
            <br>

        <h6>Liste des champs</h6>
        <div class="table-responsive">
            <table class="table table-bordered">
                <thead>
                    <tr>
                        <th>Champ</th><th>Type</th><th>Description</th>
                    </tr>
                </thead>
                <tbody>
                    <tr><td>staPar_id</td><td>INTEGER</td><td>Identifiant interne ELAN</td></tr>
                    <tr><td>staPar_type</td><td>VARCHAR(30)</td><td>Type de statut:<br>intervention / provider_quote / provider_request / provider_invoice / customer_quote / customer_invoice</td></tr>
                    <tr><td>staPar_code</td><td>VARCHAR(30)</td><td>Code du paramètre statut interne ELAN</td></tr>
                    <tr><td>staPar_descriptionFr</td><td>VARCHAR(255)</td><td>Description du paramètre</td></tr>
                    <tr><td>staPar_value</td><td>INTEGER</td><td>Valeur du statut (identifiant) </td></tr>
                </tbody>
            </table>
        </div><!--//table-responsive-->
        <br>
                <h6>Exemple json retour</h6>
<pre><code class="language-javascript">
[
{
"staPar_id": 1,
"staPar_type": "intervention",
"staPar_code": "sta_defaut_admin",
"staPar_descriptionFr": "Statut par défaut création de DI en admin",
"staPar_value": "200"
},
...</code></pre>

<div class="callout-block callout-success">
<div class="icon-holder">
<i class="fas fa-thumbs-up"></i>
</div><!--//icon-holder-->
<div class="content">
<h4 class="callout-title">A noter:</h4>
<p>L'utilisation des statuts par défaut est importante lors de la création d'une demande de devis ou de la création d'une commande.<br>
Pour une commande, utiliser la valeur de <b>sta_defaut_client_quo</b> pour une demande de devis et la valeur de <b>sta_defaut_client_req</b> pour une commande.</p>
</div><!--//content-->
</div>

    </div>
</section><!--//doc-section-->
<!--*********************************************************************************************************************************-->
<!--*********************************************************************************************************************************-->
<!--*********************************************************************************************************************************-->

<section id="interventions" class="doc-section">
    <h2 class="section-title">Interventions (consultation)</h2>
    <div class="section-block">
        <h6>Description</h6>
        <p>
           Permet de consulter la liste des interventions et de réaliser une nouvelle demande.<br>
           Dans ELAN, une demande de devis ou une commande est référencée comme "une demande d'intervention".
        </p>
        <br>
        <h6>Appels possibles</h6>

        <table class="table table-bordered table-compact">
            <thead>
                <tr>
                    <th>Verbe HTTP</th>
                    <th>Adresse</th>
                    <th>Description</th>
                </tr>
            </thead>
            <tbody>
                <tr>
                    <td><button class="btn btn-blue">GET</button></td>
                    <td>/api/interventions</td>
                    <td>Liste des interventions</td>
                </tr>
                <tr>
                    <td><button class="btn btn-blue">GET</button></td>
                    <td>/api/intervention/int_id</td>
                    <td>Détail intervention par identifiant "int_id"</td>
                </tr>
                <tr>
                    <td><button class="btn btn-blue">GET</button></td>
                    <td>/api/intervention_bynumber/int_number</td>
                    <td>Détail d'une intervention par numéro</td>
                </tr>
                <tr>
                    <td><button class="btn btn-blue">GET</button></td>
                    <td>/api/intervention_bycustomerref/int_number</td>
                    <td>Détail d'une intervention par N° de référence client</td>
                </tr>
            </tbody>
        </table>

        <h6>Exemples</h6>
        <p><code> http://elan_providers/api/interventions
            <br>http://elan_providers/api/intervention/1
            <br>http://elan_providers/api/intervention_bynumber/23030002
            <br>http://elan_providers/api/intervention_bycustomerref/R8633325</code></p>
            <br>

        <h6>Liste des champs</h6>
        <div class="table-responsive">
            <table class="table table-bordered">
                <thead>
                    <tr>
                        <th>Champ</th><th>Type</th><th>Description</th>
                    </tr>
                </thead>
                <tbody>
                    <tr><td>int_id</td><td>INTEGER</td><td>Identifiant interne de l'intervention dans ELAN</td></tr>
                    <tr><td>int_number</td><td>VARCHAR(30)</td><td>Numéro de DI</td></tr>
                    <tr><td>sta_id</td><td>INTEGER</td><td>Code statut de la DI</td></tr>
                    <tr><td>sta_nameFr</td><td>VARCHAR(255)</td><td>Libellé statut de la DI</td></tr>
                    <tr><td>sig_id</td><td>INTEGER</td><td>Identifiant enseigne de rattachement</td></tr>
                    <tr><td>sig_socialReason</td><td>VARCHAR(255)</td><td>Raison sociale enseigne de rattachement</td></tr>
                    <tr><td>sit_id</td><td>INTEGER</td><td>Identifiant interne ELAN du site</td></tr>
                    <tr><td>sit_name</td><td>VARCHAR(255)</td><td>Désignation</td></tr>
                    <tr><td>sit_code</td><td>VARCHAR(30)</td><td>Code du site (code du client) </td></tr>
                    <tr><td>sit_zipCode</td><td>VARCHAR(10)</td><td>code postal</td></tr>
                    <tr><td>sit_city</td><td>VARCHAR(255)</td><td>ville</td></tr>
                    <tr><td>act_id</td><td>INTEGER</td><td>Identifiant interne ELAN de l'activité</td></tr>
                    <tr><td>act_nameFr</td><td>VARCHAR(255)</td><td>Désignation</td></tr>
                    <tr><td>int_title</td><td>VARCHAR(255)</td><td>Titre de la DI</td></tr>
                    <tr><td>int_desiredPlanningDate</td><td>DATE</td><td>Date de planification souhaitée</td></tr>
                    <tr><td>int_closingDate</td><td>DATE</td><td>Date de clôture</td></tr>
                    <tr><td>int_customerRef</td><td>VARCHAR(255)</td><td>Référence client de la demande d'intervention</td></tr>
                    <tr><td>int_urgency</td><td>INTEGER</td><td>urgence oui/non (0/1)</td></tr>
                    <tr><td>int_createdDate</td><td>DATE</td><td>Date de création de la DI</td></tr>
                    <tr><td>int_planningDate</td><td>FLOAT</td><td>Date de planification de la DI</td></tr>
                    <tr><td>int_achievementDate</td><td>VARCHAR(20)</td><td>Date de réalisation de la DI</td></tr>
                    <tr><td>int_category</td><td>VARCHAR(255)</td><td>Catégorie</td></tr>
                    <tr><td>con_id</td><td>INTEGER</td><td>Identifiant contrat de maintenance préventive</td></tr>
                    <tr><td>con_description</td><td>VARCHAR(255)</td><td>Nom du contrat maintenance préventive</td></tr>

                </tbody>
            </table>
        </div><!--//table-responsive-->
        <br>
                <h6>Exemple json retour</h6>
<pre><code class="language-javascript">
[
{
"int_id": 12,
"int_number": "1811002",
"sta_id": 214,
"sta_nameFr": "Réalisée",
"sig_id": 3,
"sig_socialReason": "JULES SAS",
"sit_id": 324,
"sit_name": "ST-QUENTIN CV R. SELLERIE",
"sit_code": "174",
"sit_zipCode": "02108",
"sit_city": "SAINT QUENTIN",
"act_id": 1,
"act_nameFr": "Electricité",
"int_title": "Interrupteur coincé",
"int_desiredPlanningDate": "2018-11-20",
"int_closingDate": null,
"int_customerRef": "83753",
"int_urgency": 0,
"int_createdDate": "2018-11-19T23:00:00.000000Z",
"int_planningDate": "2018-11-20",
"int_achievementDate": "2018-11-20",
"int_category": "",
"con_id": null,
"con_description": null
},
...</code></pre>

    </div>
</section><!--//doc-section-->
<!--*********************************************************************************************************************************-->
<!--*********************************************************************************************************************************-->
<!--*********************************************************************************************************************************-->

<section id="interventions_add" class="doc-section">
    <h2 class="section-title">Effectuer une commande ou une demande de devis </h2>
    <div class="section-block">
        <h6>Description</h6>
        <p>
           Permet d'ajouter une demande de devis ou de passer une commande dans ELAN. <br>
           La demande sera référencée comme une "Demande d'intervention" dans ELAN avec un statut particulier ("Nouvelle demande de devis" ou "Nouvelle commande").
        </p>
        <br>
        <h6>Appels possibles</h6>

        <table class="table table-bordered table-compact">
            <thead>
                <tr>
                    <th>Verbe HTTP</th>
                    <th>Adresse</th>
                    <th>Description</th>
                </tr>
            </thead>
            <tbody>
                <tr>
                    <td><button class="btn btn-green">POST</button></td>
                    <td>/api/interventions</td>
                    <td>Ajout d'une demande d'intervention</td>
                </tr>
            </tbody>
        </table>
        <br>

        <h6>Exemples</h6>
        <p><code>
            <br>http://elan_providers/api/interventions</code></p>
            <br>

        <h6>Liste des champs attendus dans la requête d'appel</h6>
        <div class="table-responsive">
            <table class="table table-bordered">
                <thead>
                    <tr>
                        <th>Champ</th><th>Type</th><th>Description</th><th>Obligatoire</th>
                    </tr>
                </thead>
                <tbody>
                    <tr><td>sit_id</td><td>INTEGER</td><td>Identifiant interne ELAN du site</td><td><span class="badge btn-red">oui</span></td></tr>
                    <tr><td>act_id</td><td>INTEGER</td><td>Identifiant interne ELAN de l'activité</td><td><span class="badge btn-red">oui</span></td></tr>
                    <tr><td>actDet_id</td><td>INTEGER</td><td>Identifiant interne ELAN de la sous-activité</td><td><span class="badge btn-green">non</span></td></tr>
                    <tr><td>int_title</td><td>VARCHAR(255)</td><td>Titre de la DI</td><td><span class="badge btn-red">oui</span></td></tr>
                    <tr><td>int_description</td><td>TEXTE</td><td>Description de la demande</td><td><span class="badge btn-red">oui</span></td></tr>
                    <tr><td>int_urgency</td><td>INTEGER</td><td>Urgence oui/non, valeurs 0 ou 1 </td><td><span class="badge btn-red">oui</span></td></tr>
                    <tr><td>type_request</td><td>CHAR(1)</td><td>Demande de devis ou commande ? <br>D : demande de devis<br>C : Commande </td><td><span class="badge btn-red">oui</span></td></tr>
                    <tr><td>int_customerRef</td><td>VARCHAR(255)</td><td>Référence client de la demande d'intervention (sans espaces ni caractères spéciaux)
                        <br>
                        <font color="red">Cette référence doit être unique. Vous ne pouvez pas effectuer deux demandes avec la même réference.</font>
                    </td><td><span class="badge btn-red">oui</span></td></tr>

                    <tr><td>int_datePossible</td><td>DATE</td><td>Intervention possible à partir du YYYY-MM-DD</td><td><span class="badge btn-green">non</span></td></tr>
                    <tr><td>int_dateLater</td><td>DATE</td><td>Intervention au plus tard le YYYY-MM-DD</td><td><span class="badge btn-green">non</span></td></tr>
                    <tr><td>int_desiredPlanningDate</td><td>DATE</td><td>Date de planification souhaitée le YYYY-MM-DD</td><td><span class="badge btn-green">non</span></td></tr>
                    <tr><td>int_desiredDateReturn</td><td>DATE</td><td>Date retour souhaitée du devis le YYYY-MM-DD </td><td><span class="badge btn-green">non</span></td></tr>
                    <tr><td>con_id</td><td>INTEGER</td><td>Identifiant contrat de maintenance préventive</td><td><span class="badge btn-green">non</span></td></tr>
                    <tr><td>int_category</td><td>VARCHAR(255)</td><td>Catégorie de la demande</td><td><span class="badge btn-green">non</span></td></tr>

                    <tr><td>equSit_id</td><td>INTEGER</td><td>Identifiant équipement du site</td><td><span class="badge btn-green">non</span></td></tr>
                    <tr><td>equSit_serialNumber</td><td>VARCHAR(255)</td><td>N° de série équipement </td><td><span class="badge btn-green">non</span></td></tr>
                    <tr><td>equSit_internalNumber </td><td>VARCHAR(255)</td><td>N° interne équipement </td><td><span class="badge btn-green">non</span></td></tr>

                </tbody>
            </table>
        </div><!--//table-responsive-->

        Les champs peuvent être envoyés dans le body  en format JSON (Content-Type=application/json) ou en tant que "params".
        <br> <br>
        <h6>Liste des codes retour possibles</h6>
        <div class="table-responsive">
            <table class="table table-bordered">
                <thead>
                    <tr>
                        <th>Code</th>
                        <th>Description</th>
                    </tr>
                </thead>
                <tbody>
                    <tr>
                        <td><span class="badge btn-green">200</span></td>
                        <td>Statut HTTP 200 OK
                            <br> En cas de succès le JSON renvoyé est
                            <div class="alert alert-secondary">
                                {
                                "success": true,
                                "int_number": "22120001",
                                "int_id": 23665
                                }
                                </div>
                        </td>
                    </tr>
                    <tr>
                        <td><span class="badge btn-red">403</span></td>
                        <td>Statut HTTP 403 Forbidden si mauvais token ou mauvaise code-site-ws </td>
                    </tr>
                    <tr>
                        <td><span class="badge btn-red">409</span></td>
                        <td>Statut HTTP 409 Conflict <br>
                            Lors de l'appel, ELAN va vérifier: <br>
                            - si une demande a déjà été faite et si elle a abouti pour le couple sit_id, act_id lors des 30 dernières secondes.<br>
                            - si la réference int_customerRef existe déjà
                            <br>Si c'est le cas, le werservice va renvoyer le statut HTTP 409 Conflict.
                            <br>

                             </td>
                    </tr>
                    <tr>
                        <td><span class="badge btn-red">400</span></td>
                        <td>Statut HTTP 400 Bad Request <br>
                            Lorsque l'on détecte une erreur dans les données : <br>
                                Un champ obligatoire n'est pas renseigné <br>
                                Le code site sit_code n’existe pas <br>
                                Le code activité act_id n’existe pas<br>
                                Le code sous-activité actDet_id n’existe pas (si renseigné) <br>
                                La société de facturation (billing_company) n'est pas effectée par défaut pour le site. <br><br>
                                Exemple:<br><div class="alert alert-secondary">{
                                "error": "NOMCHAMP non reconnu."
                                } <div>
                             </td>
                    </tr>
                </tbody>
            </table>
        </div><!--//table-responsive-->

        <h6>Exemple champs JSON dans le BODY</h6>
        <pre><code class="language-javascript">
{
    "sit_id":"373",
    "act_id":"2",
    "actdET_id":"2",
    "int_title":"Pb plomberie 3",
    "int_description":"Grosse fuite 3",
    "int_urgency":0,
    "type_request":"D",
    "int_customerRef":"W028401443",
    "int_datePossible":"2022-10-16",
    "int_dateLater":"2022-10-20",
    "int_desiredPlanningDate":"2022-10-16",
    "int_desiredDateReturn":"2022-10-16",
    "con_id":"",
    "int_category":"",
    "equSit_id":"",
    "equSit_serialNumber":"",
    "equSit_internalNumber":""
    }</code></pre>

        <div class="callout-block callout-info">
            <div class="icon-holder">
                <i class="fas fa-info-circle"></i>
            </div><!--//icon-holder-->
            <div class="content">
                <h4 class="callout-title">Important</h4>
                <p><b>Les champs sit_id et act_id </b>peuvent être récupérés via les webservices GET.<br>
                    Pour le site, vous devez normalement avoir un code site client, vous pouvez récupérer le
                    sit_id correspondant dans ELAN en appelant le webservice GET ..../api/site_bycode/XXX.
                    Pour l'activité (act_id), vous devrez avoir une table de correspondante pour affecter la bonne valeur.
                    <br><br>
                    Une demande d'intervention doit impérativement être rattachée à une société de facturation.
                    <b>Le site concerné par la demande doit donc avoir une société de facturation affectée par défaut.</b> Dans le cas
                        contraire, le webService va renvoyer une Erreur 400.
                        Ce paramétrage se fait au niveau de la gestion interne Elan providers.

                </p>
            </div><!--//content-->
        </div><!--//callout-block-->

        <div class="callout-block callout-success">
            <div class="icon-holder">
                <i class="fas fa-thumbs-up"></i>
            </div><!--//icon-holder-->
            <div class="content">
                <h4 class="callout-title">A noter</h4>
                <p>Une fois la commande ou la demande de devis effectuée, vous pouvez ajouter un ou plusieurs fichiers joints à la demande (cf paragraphes suivants).<br>
            </div><!--//content-->
        </div>

    </div>
</section><!--//doc-section-->
<!--*********************************************************************************************************************************-->
<!--*********************************************************************************************************************************-->
<!--*********************************************************************************************************************************-->

<section id="file_add" class="doc-section">
    <h2 class="section-title">Ajout de fichier joint </h2>
    <div class="section-block">
        <h6>Description</h6>
        <p>
           Lors d'une commande ou d'une demande de devis, vous avez la possibilité d'ajouter un ou plusieurs fichiers joints. <br>
           Cela peut être des photos ou des documents PDF.
        </p>
        <br>
        <h6>Appels possibles</h6>

        <table class="table table-bordered table-compact">
            <thead>
                <tr>
                    <th>Verbe HTTP</th>
                    <th>Adresse</th>
                    <th>Description</th>
                </tr>
            </thead>
            <tbody>
                <tr>
                    <td><button class="btn btn-green">POST</button></td>
                    <td>/api/intervention_addfile</td>
                    <td>Ajout d'un fichier joint</td>
                </tr>
            </tbody>
        </table>


        <h6>Headers</h6>
        <table class="table table-bordered table-compact">
            <tbody>
                <tr>
                    <td>Content-Type</td>
                    <td>multipart/form-data</td>
                </tr>
            </tbody>
        </table>

        <h6>Exemples</h6>
        <p><code>
            <br>http://elan_providers/api/intervention_addfile</code></p>
            <br>


        <h6>Liste des champs attendus dans la requête d'appel</h6>
        NB : Les champs doivent être passés dans le Body en type "form-data"
        <div class="table-responsive">
            <table class="table table-bordered">
                <thead>
                    <tr>
                        <th>Champ</th><th>Type</th><th>Description</th><th>Obligatoire</th>
                    </tr>
                </thead>
                <tbody>
                    <tr><td>int_id</td><td>INTEGER</td><td>Identifiant intervention</td><td><span class="badge btn-red">oui</span></td></tr>
                    <tr><td>intFil_file</td><td>FILE</td><td>Fichier à ajouter</td><td><span class="badge btn-red">oui</span></td></tr>
                    <tr><td>intFil_description</td><td>VARCHAR(255)</td><td>Description du fichier</td><td><span class="badge btn-red">oui</span></td></tr>
                    <tr><td>intFil_category</td><td>INTEGER</td><td>Catégorie du fichier joint<br>1 : photo / image<br>6 : demande intervention (pdf)<br>3 : autres documents</td><td><span class="badge btn-red">oui</span></td></tr>
                </tbody>
            </table>
        </div><!--//table-responsive-->
        <br>

        <h6>Liste des codes retour possibles</h6>
        <div class="table-responsive">
            <table class="table table-bordered">
                <thead>
                    <tr>
                        <th>Code</th>
                        <th>Description</th>
                    </tr>
                </thead>
                <tbody>
                    <tr>
                        <td><span class="badge btn-green">200</span></td>
                        <td>Statut HTTP 200 OK
                            <br> En cas de succès le JSON renvoyé est
                            <div class="alert alert-secondary">
                                {
                                "success": true,
                                "intFil_id": "123453"
                                }
                                </div>
                        </td>
                    </tr>
                    <tr>
                        <td><span class="badge btn-red">403</span></td>
                        <td>Statut HTTP 403 Forbidden si mauvais token ou mauvaise code-site-ws ou mauvais int_id (non autorisé) </td>
                    </tr>
                    <tr>
                        <td><span class="badge btn-red">409</span></td>
                        <td>Statut HTTP 409 Conflict <br>
                            Lors de l'appel, ELAN va vérifier si un fichier avec le même nom original a déjà été inséré pour cette intervention.
                            <br>Si c'est le cas, le werservice va renvoyer le statut HTTP 409 Conflict.
                            <br>
                            <div class="alert alert-secondary">{
                                "error": "Already inserted."
                                } </div>

                             </td>
                    </tr>
                    <tr>
                        <td><span class="badge btn-red">400</span></td>
                        <td>Statut HTTP 400 Bad Request <br>
                            Lorsque l'on détecte une erreur sur le champ int_id<br>
                             </td>
                    </tr>
                </tbody>
            </table>
        </div><!--//table-responsive-->

    </div>
</section><!--//doc-section-->

<!--*********************************************************************************************************************************-->
<!--*********************************************************************************************************************************-->
<!--*********************************************************************************************************************************-->

<section id="file_add_base64" class="doc-section">
    <h2 class="section-title">Ajout de fichier joint au format BASE64 </h2>
    <div class="section-block">
        <h6>Description</h6>
        <p>
           Lors d'une commande ou d'une demande de devis, vous avez la possibilité d'ajouter un ou plusieurs fichiers joints au format BASE64 <br>
           Cela peut être des photos ou des documents PDF.
        </p>
        <br>
        <h6>Appels possibles</h6>

        <table class="table table-bordered table-compact">
            <thead>
                <tr>
                    <th>Verbe HTTP</th>
                    <th>Adresse</th>
                    <th>Description</th>
                </tr>
            </thead>
            <tbody>
                <tr>
                    <td><button class="btn btn-green">POST</button></td>
                    <td>/api/intervention_addfile_base64</td>
                    <td>Ajout d'un fichier joint</td>
                </tr>
            </tbody>
        </table>


        <h6>Headers</h6>
        <table class="table table-bordered table-compact">
            <tbody>
                <tr>
                    <td>Content-Type</td>
                    <td>multipart/form-data</td>
                </tr>
            </tbody>
        </table>

        <h6>Exemples</h6>
        <p><code>
            <br>http://elan_providers/api/intervention_addfile</code></p>
            <br>


        <h6>Liste des champs attendus dans la requête d'appel</h6>
        NB : Les champs doivent être passés dans le Body en type "form-data"
        <div class="table-responsive">
            <table class="table table-bordered">
                <thead>
                    <tr>
                        <th>Champ</th><th>Type</th><th>Description</th><th>Obligatoire</th>
                    </tr>
                </thead>
                <tbody>
                    <tr><td>int_id</td><td>INTEGER</td><td>Identifiant intervention</td><td><span class="badge btn-red">oui</span></td></tr>
                    <tr><td>intFil_file</td><td>TEXT</td><td>Fichier à ajouter encodé en base64</td><td><span class="badge btn-red">oui</span></td></tr>
                    <tr><td>intFil_description</td><td>VARCHAR(255)</td><td>Description du fichier</td><td><span class="badge btn-red">oui</span></td></tr>
                    <tr><td>intFil_category</td><td>INTEGER</td><td>Catégorie du fichier joint<br>1 : photo / image<br>6 : demande intervention (pdf)<br>3 : autres documents</td><td><span class="badge btn-red">oui</span></td></tr>
                    <tr><td>file_extension</td><td>CHAR(3)</td><td>Extension du fichier joint</td><td><span class="badge btn-red">oui</span></td></tr>
                </tbody>
            </table>
        </div><!--//table-responsive-->
        <br>

        <h6>Liste des codes retour possibles</h6>
        <div class="table-responsive">
            <table class="table table-bordered">
                <thead>
                    <tr>
                        <th>Code</th>
                        <th>Description</th>
                    </tr>
                </thead>
                <tbody>
                    <tr>
                        <td><span class="badge btn-green">200</span></td>
                        <td>Statut HTTP 200 OK
                            <br> En cas de succès le JSON renvoyé est
                            <div class="alert alert-secondary">
                                {
                                "success": true,
                                "intFil_id": "123453"
                                }
                                </div>
                        </td>
                    </tr>
                    <tr>
                        <td><span class="badge btn-red">403</span></td>
                        <td>Statut HTTP 403 Forbidden si mauvais token ou mauvaise code-site-ws ou mauvais int_id (non autorisé) </td>
                    </tr>
                    <tr>
                        <td><span class="badge btn-red">409</span></td>
                        <td>Statut HTTP 409 Conflict <br>
                            Lors de l'appel, ELAN va vérifier si un fichier avec le même nom original a déjà été inséré pour cette intervention.
                            <br>Si c'est le cas, le werservice va renvoyer le statut HTTP 409 Conflict.
                            <br>
                            <div class="alert alert-secondary">{
                                "error": "Already inserted."
                                } </div>

                             </td>
                    </tr>
                    <tr>
                        <td><span class="badge btn-red">400</span></td>
                        <td>Statut HTTP 400 Bad Request <br>
                            Lorsque l'on détecte une erreur sur le champ int_id<br>
                             </td>
                    </tr>
                </tbody>
            </table>
        </div><!--//table-responsive-->

    </div>
</section><!--//doc-section-->

<!--*********************************************************************************************************************************-->
<!--*********************************************************************************************************************************-->
<!--*********************************************************************************************************************************-->

@endsection