[{"data":1,"prerenderedAt":413},["ShallowReactive",2],{"page:\u002Fintegration\u002Fintroduction":3},{"id":4,"title":5,"body":6,"description":403,"download":404,"extension":405,"meta":406,"navigation":407,"path":408,"section":409,"seo":410,"sourceTitle":404,"sourceUpdatedAt":404,"sourceUrl":404,"stem":411,"version":404,"__hash__":412},"docs\u002Fintegration\u002Fintroduction.md","Présentation",{"type":7,"value":8,"toc":394},"minimark",[9,19,27,32,37,41,53,131,142,158,162,196,216,220,300,313,344,348,356,375],[10,11,12,13,18],"p",{},"Raydocs analyse les documents d’une demande et renvoie un dossier structuré au format CDJ Connect, accompagné des liens de téléchargement de ses pièces. Le traitement est asynchrone : le premier appel fournit un identifiant de suivi, puis votre logiciel métier reçoit une ",[14,15,17],"a",{"href":16},"\u002Fintegration\u002Fnotifications","notification facultative par webhook"," ou consulte l’API pour récupérer le résultat une fois le traitement terminé.",[10,20,21,22,26],{},"Découvrez aussi notre ",[14,23,25],{"href":24},"\u002Fintegration\u002Fexperience-utilisateur","parcours utilisateur recommandé"," : une intégration native avec dépôt, suivi et validation manuelle, accompagnée d’une maquette interactive.",[28,29,31],"h2",{"id":30},"le-parcours-complet","Le parcours complet",[33,34],"integration-journey",{"notification-code":35,"polling-code":36},"sequenceDiagram\n  participant LM as Logiciel métier\n  participant API as API Raydocs\n  LM->>API: Envoyer les fichiers + notification_url\n  API-->>LM: 202 · RUN_ID\n  API->>LM: Notification · JSON + download_url\n  LM-->>API: Accusé de réception · 2xx\n  LM->>API: Télécharger via download_url · sans token\n  API-->>LM: Pièce","sequenceDiagram\n  participant LM as Logiciel métier\n  participant API as API Raydocs\n  LM->>API: Envoyer les fichiers\n  API-->>LM: 202 · RUN_ID\n  loop Jusqu’à la fin du traitement\n    LM->>API: GET \u002Fstatus\n    API-->>LM: État du traitement\n  end\n  LM->>API: GET \u002Foutput\n  API-->>LM: JSON + download_url\n  LM->>API: Télécharger via download_url · sans token\n  API-->>LM: Pièce",[28,38,40],{"id":39},"avant-de-commencer","Avant de commencer",[10,42,43,44,48,49,52],{},"Raydocs vous fournit un workflow configuré, son URL de déclenchement et un token dédié. Un ",[45,46,47],"strong",{},"workflow"," est le traitement configuré ; un ",[45,50,51],{},"run"," est une exécution de ce traitement pour une demande.",[54,55,56,69],"table",{},[57,58,59],"thead",{},[60,61,62,66],"tr",{},[63,64,65],"th",{},"Valeur",[63,67,68],{},"Utilisation",[70,71,72,88,101,111,121],"tbody",{},[60,73,74,81],{},[75,76,77],"td",{},[78,79,80],"code",{},"BASE_URL",[75,82,83,84,87],{},"URL de base : ",[78,85,86],{},"https:\u002F\u002Fapi.raydocs.com",".",[60,89,90,95],{},[75,91,92],{},[78,93,94],{},"WEBHOOK_URL",[75,96,97,98,87],{},"URL fournie : ",[78,99,100],{},"https:\u002F\u002Fapi.raydocs.com\u002Fwebhooks\u002Fworkflows\u002F{WEBHOOK_PUBLIC_UUID}",[60,102,103,108],{},[75,104,105],{},[78,106,107],{},"WORKSPACE_ID",[75,109,110],{},"Identifiant de votre espace de travail.",[60,112,113,118],{},[75,114,115],{},[78,116,117],{},"WORKFLOW_ID",[75,119,120],{},"Identifiant du workflow configuré.",[60,122,123,128],{},[75,124,125],{},[78,126,127],{},"RAYDOCS_API_TOKEN",[75,129,130],{},"Token à utiliser côté serveur pour les appels API.",[10,132,133,134,137,138,141],{},"Conservez le ",[78,135,136],{},"RUN_ID"," retourné à l’envoi. Les ",[78,139,140],{},"file_id"," du résultat identifient les fichiers ; ils sont distincts des références métier des pièces.",[10,143,144,145,149,150,153,154,157],{},"Vous pouvez aussi associer le client à la demande grâce aux ",[14,146,148],{"href":147},"\u002Fintegration\u002Fmetadonnees","métadonnées de suivi",". Le champ ",[78,151,152],{},"client_id"," est facultatif, transmis comme chaîne dans ",[78,155,156],{},"_raydocs.metadata",", séparément du contenu métier.",[28,159,161],{"id":160},"choisir-le-suivi-de-la-demande","Choisir le suivi de la demande",[163,164,165,187],"ul",{},[166,167,168,171,172,175,176,179,180,183,184,87],"li",{},[45,169,170],{},"Avec notification par webhook :"," l’option est configurée sur le workflow d’intégration publié ; ajoutez ",[78,173,174],{},"notification_url"," à l’envoi. Raydocs transmet le résultat complet ou l’erreur à votre logiciel métier. Consultez les ",[14,177,178],{"href":16},"notifications de fin de traitement"," pour sécuriser la réception, répondre en ",[78,181,182],{},"2xx"," et dédupliquer avec ",[78,185,186],{},"run_id",[166,188,189,192,193,195],{},[45,190,191],{},"Par polling :"," si ",[78,194,174],{}," est absente, vide ou composée uniquement d’espaces, consultez le statut puis récupérez le résultat. Ce parcours reste aussi la solution de reprise si aucune notification n’arrive.",[10,197,198,199,202,203,207,208,211,212,215],{},"Dans les deux cas, un succès fournit le JSON CDJ Connect et les ",[78,200,201],{},"download_url"," des pièces. ",[14,204,206],{"href":205},"\u002Fintegration\u002Frecuperer-le-resultat#t%C3%A9l%C3%A9charger-directement-les-fichiers","Téléchargez directement les fichiers"," dès réception. Le statut de notification ",[78,209,210],{},"success"," correspond au statut API ",[78,213,214],{},"completed"," ; il ne confirme pas encore l’import dans le logiciel métier.",[28,217,219],{"id":218},"les-appels-api","Les appels API",[54,221,222,235],{},[57,223,224],{},[60,225,226,229,232],{},[63,227,228],{},"Méthode",[63,230,231],{},"Appel",[63,233,234],{},"Rôle",[70,236,237,254,270,285],{},[60,238,239,245,251],{},[75,240,241],{},[242,243],"http-method",{"method":244},"POST",[75,246,247],{},[14,248,250],{"href":249},"\u002Fintegration\u002Fenvoyer-les-documents","Envoyer les documents",[75,252,253],{},"Créer un traitement à partir des fichiers d’une même demande.",[60,255,256,261,267],{},[75,257,258],{},[242,259],{"method":260},"GET",[75,262,263],{},[14,264,266],{"href":265},"\u002Fintegration\u002Fconsulter-le-statut","Consulter le statut",[75,268,269],{},"Suivre le traitement jusqu’à sa fin.",[60,271,272,276,282],{},[75,273,274],{},[242,275],{"method":260},[75,277,278],{},[14,279,281],{"href":280},"\u002Fintegration\u002Frecuperer-le-resultat","Récupérer le résultat",[75,283,284],{},"Obtenir le JSON métier et les liens des fichiers disponibles.",[60,286,287,291,297],{},[75,288,289],{},[242,290],{"method":260},[75,292,293],{},[14,294,296],{"href":295},"\u002Fintegration\u002Fobtenir-un-lien","Obtenir un lien de téléchargement",[75,298,299],{},"Obtenir ou renouveler le lien d’un fichier, si nécessaire.",[10,301,302,303,307,308,312],{},"Consultez l’",[14,304,306],{"href":305},"\u002Fintegration\u002Fauthentification","authentification"," avant votre premier appel, puis les ",[14,309,311],{"href":310},"\u002Fintegration\u002Fbonnes-pratiques","bonnes pratiques"," pour gérer les reprises et les erreurs.",[314,315,316,328,337],"doc-callout",{},[10,317,318,321,322,324,325,87],{},[45,319,320],{},"Téléchargement des fichiers."," Le résultat contient les liens ",[78,323,201],{}," pour télécharger les pièces directement, sans token API. Ces liens sont valides ",[45,326,327],{},"dix minutes",[10,329,330,331,333,334,336],{},"Si un lien expire ou manque, utilisez ",[14,332,296],{"href":295}," avec le ",[78,335,140],{}," du fichier, sans relancer le traitement.",[10,338,339,340,343],{},"Les fichiers eux-mêmes sont ",[45,341,342],{},"disponibles temporairement"," : téléchargez-les et conservez-les dès réception du résultat. Après leur expiration définitive, renouveler le lien ne permet plus de les récupérer.",[28,345,347],{"id":346},"format-et-transport","Format et transport",[10,349,350,351,355],{},"Le ",[14,352,354],{"href":353},"\u002Fformat\u002Fv1-2\u002Fspecification\u002Fintroduction","standard CDJ Connect"," définit les données métier du dossier. Cette API Raydocs définit leur transport : elle livre un JSON et des fichiers individuels, sans générer de ZIP de résultat.",[10,357,358,360,361,360,364,366,367,370,371,374],{},[78,359,140],{},", ",[78,362,363],{},"file_expires_at",[78,365,201],{}," et ",[78,368,369],{},"download_url_expires_at"," relèvent de la convention API Raydocs. Ils ne sont pas des champs standard CDJ Connect 1.2. Dans ce parcours, ",[78,372,373],{},"chemin"," indique où enregistrer la pièce localement ; dans le standard, il désigne son chemin dans le ZIP.",[10,376,377,378,380,381,383,384,383,387,390,391,393],{},"Le champ ",[78,379,174],{}," et l’enveloppe de notification ",[78,382,186],{}," \u002F ",[78,385,386],{},"status",[78,388,389],{},"output"," sont également propres au transport Raydocs. Seul ",[78,392,389],{}," contient le résultat CDJ Connect : cette enveloppe ne fait pas partie du schéma métier et n’est pas imposée aux autres échanges CDJ Connect.",{"title":395,"searchDepth":396,"depth":396,"links":397},"",2,[398,399,400,401,402],{"id":30,"depth":396,"text":31},{"id":39,"depth":396,"text":40},{"id":160,"depth":396,"text":161},{"id":218,"depth":396,"text":219},{"id":346,"depth":396,"text":347},"Envoyer des documents à Raydocs et importer le dossier et ses pièces dans votre logiciel métier.",null,"md",{},true,"\u002Fintegration\u002Fintroduction","Intégration au logiciel métier",{"title":5,"description":403},"integration\u002Fintroduction","f3uOaJEs3r4PxOiwUg6PREzNS5apYOfJD_vjGA0PaZs",1791469623806]