[PAYLOAD]Use nom commercial (siege) in ul nom complet

Merge pull request #403 from annuaire-entreprises-data-gouv-fr/update-denomination

aio/aio-proxy/aio_proxy/doc/open-api.yml

@@ -539,7 +539,7 @@ paths:
           in: query
           description: >-
             ATTENTION : Ce paramètre ne peut être
-            appelé qu'avec le champs "minimal=True".
+            appelé qu'avec le champ "minimal=True".
 
 
             Permet de ne demander que certains des champs secondaires.
@@ -600,11 +600,13 @@ paths:
                         nom_complet:
                           type: string
                           description: >-
-                            Champs construit depuis les champs de dénomination :
+                            Champ construit depuis les champs de dénomination :
                             denomination de l'unité légale | Nom et prénom | Nom inconnu
-                            (dénomination usuelle : construite à partir des trois
-                            champs de dénomination usuelle de la base SIRENE) (sigle de
-                            l'unité légale).
+                            (dénomination usuelle : Construite en priorité à partir de
+                            la dénomination usuelle de l'établissement siège.
+                            Si cette dernière n'existe pas, elle est construite à
+                            partir des trois champs de dénomination usuelle de l'unité
+                            légale. source : base SIRENE) (sigle de l'unité légale)
                           example: "la poste"
                         nom_raison_sociale:
                           type: string
@@ -657,7 +659,7 @@ paths:
                                 DIRECTION GENERALE DE LA POSTE 9 RUE DU COLONEL
                                 PIERRE AVIA 75015 PARIS 15
                               description: >-
-                                Champs construit depuis les champs d'adresse de la
+                                Champ construit depuis les champs d'adresse de la
                                 base SIRENE : *complement adresse + numéro voie +
                                 indice repetition + type voie + libelle voie +
                                 distribution spéciale + (code postal + libelle
@@ -1031,7 +1033,7 @@ paths:
                                 example: >-
                                   19 RUE DE LA POSTE 31700 CORNEBARRIEU
                                 description: >-
-                                  Champs construit depuis les champs d'adresse de la
+                                  Champ construit depuis les champs d'adresse de la
                                   base SIRENE : *complement adresse + numéro voie +
                                   indice repetition + type voie + libelle voie +
                                   distribution spéciale + (code postal + libelle
@@ -1528,7 +1530,7 @@ paths:
           in: query
           description: >-
             ATTENTION : Ce paramètre ne peut être
-            appelé qu'avec le champs "minimal=True".
+            appelé qu'avec le champ "minimal=True".
 
 
             Permet de ne demander que certains des champs secondaires.
@@ -1588,11 +1590,13 @@ paths:
                         nom_complet:
                           type: string
                           description: >-
-                            Champs construit depuis les champs de dénomination :
+                            Champ construit depuis les champs de dénomination :
                             denomination de l'unité légale | Nom et prénom | Nom inconnu
-                            (dénomination usuelle : construite à partir des trois
-                            champs de dénomination usuelle de la base SIRENE) (sigle
-                            de l'unité légale)
+                            (dénomination usuelle : Construite en priorité à partir de
+                            la dénomination usuelle de l'établissement siège.
+                            Si cette dernière n'existe pas, elle est construite à
+                            partir des trois champs de dénomination usuelle de l'unité
+                            légale. source : base SIRENE) (sigle de l'unité légale)
                           example: "la poste"
                         nom_raison_sociale:
                           type: string
@@ -1645,7 +1649,7 @@ paths:
                                 DIRECTION GENERALE DE LA POSTE 9 RUE DU COLONEL
                                 PIERRE AVIA 75015 PARIS 15
                               description: >-
-                                Champs construit depuis les champs d'adresse de la
+                                Champ construit depuis les champs d'adresse de la
                                 base SIRENE : *complement adresse + numéro voie +
                                 indice repetition + type voie + libelle voie +
                                 distribution spéciale + (code postal + libelle commune |
@@ -2018,7 +2022,7 @@ paths:
                                 example: >-
                                   19 RUE DE LA POSTE 31700 CORNEBARRIEU
                                 description: >-
-                                  Champs construit depuis les champs d'adresse de la
+                                  Champ construit depuis les champs d'adresse de la
                                   base SIRENE : *complement adresse + numéro voie +
                                   indice repetition + type voie + libelle voie +
                                   distribution spéciale + (code postal + libelle

aio/aio-proxy/aio_proxy/response/format_search_results.py

@@ -36,6 +36,7 @@ def get_field(field, default=None):
         "nom_complet": format_nom_complet(
             get_field("nom_complet"),
             get_field("sigle"),
+            get_field("siege")["nom_commercial"],
             get_field("denomination_usuelle_1_unite_legale"),
             get_field("denomination_usuelle_2_unite_legale"),
             get_field("denomination_usuelle_3_unite_legale"),

aio/aio-proxy/aio_proxy/response/formatters/nom_complet.py

@@ -1,24 +1,36 @@
 def format_nom_complet(
     nom_complet,
     sigle=None,
+    nom_commercial_siege=None,
     denomination_usuelle_1=None,
     denomination_usuelle_2=None,
     denomination_usuelle_3=None,
 ):
     """Add `denomination usuelle` fields and `sigle` to `nom_complet`."""
-    all_denomination_usuelle = ""
-    for item in [
-        denomination_usuelle_1,
-        denomination_usuelle_2,
-        denomination_usuelle_3,
-    ]:
-        if item:
-            all_denomination_usuelle += f"{item} "
-    if all_denomination_usuelle:
-        nom_complet = f"{nom_complet} ({all_denomination_usuelle.strip()})"
+    if not nom_complet:
+        return None
+
+    # Handle denomination usuelle
+    if nom_commercial_siege:
+        denomination = nom_commercial_siege
+    else:
+        denomination = " ".join(
+            filter(
+                None,
+                [
+                    denomination_usuelle_1,
+                    denomination_usuelle_2,
+                    denomination_usuelle_3,
+                ],
+            )
+        )
+
+    # Add denomination to nom_complet if it exists
+    if denomination:
+        nom_complet += f" ({denomination.strip()})"
+
+    # Add sigle if it exists
     if sigle:
-        nom_complet = f"{nom_complet} ({sigle})"
-    if nom_complet:
-        return nom_complet.upper()
-    # if nom_complet is null
-    return None
+        nom_complet += f" ({sigle})"
+
+    return nom_complet.upper()