====== Extraction de donnée via requêtage JSON (jsonpath) ======

===== C’est quoi JSONPath ? =====

JSONPath est un outil qui permet de **chercher des informations dans un fichier JSON** (ex: facture électronique).


----

===== À quoi ça sert ? =====

  * Extraire des identifiants (SIREN, TVA, IBAN…)
  * Lire les montants (HT, TVA, TTC)
  * Vérifier des règles (présence d’un champ, valeur attendue)


----

===== Les bases =====

==== 1. Point de départ ====

<code>
$
</code>

Début du document


----

==== 2. Accéder à un champ ====

<code>
$['rsm:CrossIndustryInvoice']['rsm:ExchangedDocument']['ram:ID']
</code>


----

==== 3. Filtrer ====

<code>
[?(@.champ == "valeur")]
</code>

Permet de sélectionner un élément précis dans une liste

|récupérer les données du vendeur|

<code>
"ram:ID": [
  { "@schemeID": "0008", "#text": "FRxxxxxxxxxxx" },
  { "@schemeID": "0002", "#text": "xxxxxxxxx" },
  { "@schemeID": "0009", "#text": "xxxxxxxxxxxxxx" }
]
</code>

Dans ce cas :

  * 0008 = TVA
  * 0002 = SIREN
  * 0009 = SIRET


----

==== JSONPath ====

<code>
$['rsm:CrossIndustryInvoice']
['rsm:SupplyChainTradeTransaction']
['ram:ApplicableHeaderTradeAgreement']
['ram:SellerTradeParty']
['ram:ID'][?(@['@schemeID']=='0008')]
['#text']
</code>


----

==== Traduction métier ====

“Dans la facture :”

  - Aller dans la facture principale
  - Aller dans la transaction
  - Aller dans les infos vendeur
  - Regarder les identifiants du vendeur
  - Trouver celui avec **schemeID = TVA (0008)**
  - Récupérer la valeur


----

==== Résultat ====

<code>
FRxxxxxxxxxxx
</code>


----

===== A retenir =====

^Élément  ^Signification      ^
|$        |début de la facture|
|[‘champ’]|accéder à un champ |
|[*]      |tous les éléments  |
|[0]      |premier élément    |
|[?()]    |filtre             |
|@        |élément courant    |


----

===== Autres Exemples =====

==== Trouver le nom de la société ====

<code>
$['rsm:CrossIndustryInvoice']
    ['rsm:SupplyChainTradeTransaction']
    ['ram:ApplicableHeaderTradeAgreement']
    ['ram:SellerTradeParty']
    ['ram:Name']
</code>


----

==== Trouver un montant TTC ====

<code>
$['rsm:CrossIndustryInvoice']['rsm:SpecifiedTradeSettlementHeaderMonetarySummation']['ram:GrandTotalAmount']
</code>


----