Insourcia

Societes ou un dirigeant exerce un mandat direct, le dirigeant etant identifie de facon non ambigue par nom + prenom + date de naissance. C'est le pivot "personne -> entreprises", complement de search_directors (trouver la personne) et get_directors (dirigeants d'une entreprise). Cas d'usage M&A : tracer le perimetre de societes d'un fondateur/dirigeant (holdings, SCI, filiales) sans confondre les homonymes. Parametres TOUS REQUIS : nom, prenom, date_naissance (format YYYY-MM-DD). La date de naissance est obligatoire : c'est elle qui distingue la bonne personne de ses homonymes. L'obtenir au prealable via search_directors ou get_directors (champ date_naissance). Reponse : dirigeant { nom, prenom, date_naissance (mois et annee), annee_naissance } + data[] = entreprises { siren, denomination, role, ville, departement, code_ape, forme_juridique } + pagination { total, returned, limit }. Resultat vide = aucun mandat direct trouve pour cette identite exacte (verifier la date_naissance). Note : ne couvre que les mandats DIRECTS de la personne physique (exclut les dirigeants remontes depuis une PM representee, resolved_from_pm). C'est la difference de perimetre avec search_companies(dirigeant_nom/prenom/naissance), qui filtre plus large (inclut ces remontees, granularite mois) et retourne des entreprises, pas les mandats directs d'un dirigeant. Pour la structure de detention capitalistique d'une entreprise, voir get_company_graph.

search_director_companies

Timeline unifiee des evenements d'UNE entreprise (par SIREN). Flux chronologique decroissant qui reunit : - une ligne par annonce BODACC de modification (forme juridique, dirigeants, siege, activite, capital, denomination, dissolution), avec libelle, sous_type et source_url vers l'avis officiel ; - une ligne par depot des comptes (un par exercice) et par immatriculation ; - les cessions (y compris cote cedant d'une vente) et les procedures collectives ; - la radiation, l'augmentation de capital, la creation ; - une ligne par annee de marches publics, les subventions ; - sur 12 mois, les mouvements de dirigeants et changements de groupe ou de note credit (types dirigeant_*, changement_*). Pour plusieurs entreprises, le parametre sirens sert jusqu'a 10 timelines en une requete, 20 evenements par societe et sans pagination. Pour de la prospection cross-SIREN sans liste de depart, utiliser search_events. COUT : 1 appel de quota par societe.

get_events

Cartographie des entites autour d'UNE entreprise (par SIREN) : graphe oriente construit sur les mandats RCS/RNE et les liens de groupe. Pour la structure d'un groupe : holdings, filiales, societes soeurs, dirigeants communs. Complementaire de get_directors (mandats d'une societe) et de search_director_companies (mandats directs d'un dirigeant). Reponse : nodes[] (entreprises "co:<siren>", personnes "pp:<nom>|<prenom>|<AAAA-MM>", parents etrangers "co:ext:<slug>") et edges[] orientees : - mandat_pm : societe dirigeante -> societe dirigee - filiale : mere -> filiale (associe unique RNE) - parent_ultime : parent ultime (GLEIF) -> societe - mandat_pp : personne -> societe dirigee A savoir : - Pas de pourcentage de detention. Les commissaires aux comptes sont exclus. - depth=1 : liens directs. depth=2 (defaut) : expansion depuis les parents et societes dirigeantes, jamais depuis les filiales. - Les dirigeants de la racine tirent leurs autres societes (holdings personnelles, SCI, structures soeurs). expand_persons=false donne un graphe purement capitalistique. Un mandataire professionnel (plus de 50 mandats, ou cabinet comptable) n'est pas etendu : voir meta.truncated.hub_directors. - Plafonds par noeud et max_nodes : meta.truncated signale un graphe partiel. Filtres : include_personnes, include_sci, include_ceased, expand_persons. La racine n'est jamais filtree. Pour plusieurs entreprises, le parametre sirens sert 3 graphes en une requete (2 en depth=2), a depth=1 par defaut : une traversee coute 3 a 5 secondes et ne se parallelise pas.

get_company_graph

Creation d'une recherche sauvegardee pour l'utilisateur, visible dans l'app Insourcia (page /news - Veille). Utiliser cet outil quand l'utilisateur veut SAUVEGARDER une recherche pour la suivre dans le temps (veille marche, suivi d'un secteur, pipeline de cibles) - pas pour une recherche ponctuelle (utiliser search_companies). Fonctionnement : - Les filtres acceptes sont les MEMES que search_companies (query texte libre + filtres geographie/secteur/financier/dirigeants + advanced_filters JSON). Au moins un critere est requis. - Idempotent : si une recherche sauvegardee ACTIVE du meme nom existe deja pour l'utilisateur, elle est renvoyee telle quelle (already_exists=true), sans doublon et sans modifier son alerte. - Alerte quotidienne ACTIVE PAR DEFAUT (enable_alert=false pour s'en passer) : elle notifie l'utilisateur (page /news + email) quand de NOUVELLES societes entrent dans les criteres de la recherche. A la creation, une notification initiale recapitule les 90 derniers jours ; ensuite seules les entrees futures declenchent. Reponse : { id, name, url (page /news), result_count (nombre de societes matchant actuellement, null si indisponible), filters (filtres normalises stockes, absent sur le hit idempotent), already_exists, alert_enabled }.

create_saved_search

Score de risque credit d'UNE entreprise francaise (par SIREN). Retourne le grade de risque (AAA -> D), la probabilite de defaut a 3/6/12 mois (taux du grade, master-scale), la position de la societe dans la fourchette de son grade (bas / milieu / haut) et les facteurs principaux (5 par defaut, jusqu'a 10 avec factors_limit). Chaque facteur porte son sens (aggravant / attenuant), son poids (part de l'ecart au risque moyen, 0 a 1) et la valeur de la societe quand elle est affichable ; other_factors regroupe le reste. Disponible sur tous les plans. Reponses possibles : - entreprise scoree : { scorable:true, risk:{ grade, grade_default_rate, grade_position, factors, other_factors, coverage, as_of, model } } - entreprise non scoree (pas de comptes recents) : { scorable:false, risk:null } - SIREN inconnu : erreur 404. Use case : risque fournisseur, due diligence. Pour scorer un portefeuille, le parametre sirens rend jusqu'a 10 scores en une requete.

get_credit_risk

Fiche complete d'une entreprise francaise identifiee par son SIREN. Pour plusieurs entreprises, le parametre sirens sert jusqu'a 10 fiches en une requete, au lieu d'un appel par societe. COUT : 1 appel de quota par societe, en lot comme a l'unite. Pour comparer beaucoup de societes, search_companies rend les memes champs en include_fields (dont description_activite et site_internet), 20 societes par appel. Contenu : 1. Identite - forme juridique, dates de creation et d'immatriculation, date_cloture_exercice, capital, siege complet, activite (NAF, objet_social, description), effectif, LEI si present ; successeur si radiee. 2. Financier - date_cloture et type_bilan (K consolide, C social, S simplifie : un CA K n'est pas comparable a un CA C), CA, croissance, resultat net, marges, EBITDA, dette nette, effectif moyen. 3. Contact - site web. 4. Gouvernance - dirigeants principaux. 5. IFRS - agregats consolides des cotees. 6. Signaux - cotation, procedures collectives, fusions, modifications de capital, transferts de siege, changements de denomination, ESS, societe a mission, dernier depot, radiation. 7. Score credit - grade AAA a D, probabilites de defaut 3/6/12 mois, facteurs ; detail dans get_credit_risk. Null si non scoree. 8. Cessions - historique (date, type, cedant, cessionnaire, prix). 9. Donnees publiques - marches publics, subventions, brevets, salons. 10. Fonds PE/VC - nom_fonds, siren_fonds (chainable vers get_company), annee d'entree. 11. Estimation financiere (compte de resultat confidentiel seulement) - fourchette de CA, confiance, tranche de marge d'EBE, probabilite de deficit. C'est une ESTIMATION : la presenter comme telle, jamais comme un chiffre depose. Pour approfondir : get_financials (historique), get_directors (mandats), get_events (annonces BODACC), get_company_graph (structure). watch_company met la societe sous surveillance.

get_company

Detail des dirigeants d'une entreprise avec structure hierarchique. Retourne les dirigeants classes par importance (decisionnaires en premier). Deux types d'entrees : - **PP** (personne physique) : nom, prenom, role, annee de naissance, date_debut_mandat, date_fin_mandat - **PM** (personne morale) : denomination, SIREN, role, date_debut_mandat, date_fin_mandat, avec un tableau representants[] listant les personnes physiques qui la representent (nom, prenom, role dans la PM, dates de mandat) Inclut les commissaires aux comptes (role="CAC") avec leur date de debut/fin de mandat. Utile pour identifier le mandataire actif vs sortant. Par defaut, seuls les mandataires actifs sont retournes. Utiliser include_inactive=true pour inclure l'historique. Pour plusieurs entreprises, le parametre sirens sert jusqu'a 10 societes en une requete. Le lot rend les 20 premiers mandataires de CHAQUE societe et signale celles qu'il a tronquees : limit et offset n'ont pas de sens sur dix societes a la fois, et l'appel unitaire reste la pour derouler l'historique complet d'une seule.

get_directors

Historique financier detaille d'une entreprise sur plusieurs exercices. COUT : 1 appel de quota par societe, reponse de ~10 a 45 Kio selon detail et years. Pour le seul dernier exercice (ca, ebitda, resultat_exploitation, resultat_net, effectif_moyen), search_companies le rend en include_fields, 20 societes par appel. Pour plusieurs entreprises, le parametre sirens sert jusqu'a 10 historiques en une requete (3 en detail=full). Le lot part en compact sauf demande explicite, y compris sur Pro, et ne pagine pas. Niveau de detail : - compact (defaut sur free, ~40 champs par exercice) : compte de resultat complet, bilan abrege PCG, ratios (tresorerie, dette nette, BFR, marges, endettement, CAF, delais de paiement), dividendes, effectif moyen. - full (defaut sur Pro, ~140 champs) : tous les postes. Refuse sur free (403). - fields : ajoute quelques champs a compact sans gonfler la reponse, ex fields=["roe","bfr_jours_ca","autonomie_financiere"]. Plus de 130 disponibles : ratios, postes detailles, immobilisations brutes, reserves, croissances (cagr_ebitda_3ans...). type_bilan : K consolide, C social, S simplifie. Quand la fenetre melange plusieurs types, un seul est garde et type_bilan_mixte l'indique ; type_bilan force un type. Les cotees ont en plus un bloc ifrs. Compte de resultat confidentiel : aucun CA ni EBE depose. Par defaut la reponse porte estimation_disponible (exercice + message) sans aucun chiffre estime ; inclure_estimation=true ajoute estimation_financiere (fourchette de CA, confiance, tranche de marge d'EBE, probabilite de deficit), une ESTIMATION et jamais un chiffre depose. dividende_estime est aussi une estimation (dividendes_verses = depose). Rendu : _layout decrit par section l'ordre PCG des lignes, leur libelle (line.label), leur indentation (level) et leur nature (kind) ; exercices[annee][line.key] porte la valeur, null = poste absent. not_applicable_pcg signale un bilan de banque ou d'assurance. Montants en euros.

get_financials

Veille quotidienne de l'utilisateur : le fil d'actualite de ses societes surveillees, tel qu'il apparait sur la page /news de l'app Insourcia. Utiliser cet outil pour repondre a "quoi de neuf sur ma veille ?", "qu'est-ce qui a bouge sur mes societes ?", "resume-moi ma veille de la semaine", ou avant de rediger un point hebdomadaire. Contenu : les alertes reellement delivrees (email/push) ET l'activite des societes des listes de veille (changements de dirigeants, annonces BODACC : procedures collectives, cessions, radiations...), fusionnees et dedupliquees, les plus recentes d'abord. Couvre toutes les listes de l'utilisateur, tous espaces confondus (source.espace indique lequel). Chaque ligne est HYBRIDE : "label" donne la phrase francaise prete a lire (identique a l'app) et "type"/"before"/"after"/"siren"/"date" donnent les champs structures pour filtrer ou raisonner. "date" est le jour de DETECTION (axe de fraicheur) ; "effective_date", quand present, est la date d'effet juridique. unread_only=true ne renvoie que ce que l'utilisateur n'a pas encore lu. "read_key" identifie chaque ligne : la passer a mark_news_read pour la marquer lue. truncated=true signale plus de signaux que la limite demandee ; since_days et event_types permettent de resserrer (pas de pagination sur ce fil). Si counts_are_partial=true, "total" et "unread_count" sont des PLANCHERS et non des totaux : le fil est compose sur une fenetre bornee (les 100 dernieres notifications et les 100 derniers evenements), et cette fenetre etait pleine. hidden_by_plan, quand present, compte les signaux non retournes parce que le plan actuel ne donne acces qu'aux 10 signaux les plus recents, exactement comme la page /news. Un fil ainsi tronque n'est pas complet, et hidden_by_plan dit de combien. Reponse : { news: [...], total, unread_count, last_seen_at, since_days, truncated, url (page /news) }. news vide = aucun signal sur la periode, ce n'est pas une erreur.

get_news

Liste des recherches sauvegardees de l'utilisateur (page /news - Veille de l'app Insourcia). Utiliser cet outil : - AVANT create_saved_search, pour verifier qu'une veille equivalente n'existe pas deja et eviter les doublons de nom. - Pour repondre a "quelles veilles ai-je ?" / "quelles sont mes recherches sauvegardees ?". Reponse : { saved_searches: [{ id, name, filters (filtres normalises stockes), result_count (nombre de societes matchant, null si indisponible), alert_enabled (alerte quotidienne nouvelles societes active ou non), url (page /news), created_at }], total }. Les recherches sont triees de la plus recente a la plus ancienne. Liste vide = aucune veille configuree.

list_saved_searches