{"id":21515,"date":"2022-04-11T13:49:40","date_gmt":"2022-04-11T11:49:40","guid":{"rendered":"https:\/\/help.openbee.com\/open-bee-chorus-pro\/administrators-guide\/administration-as-a-provider\/"},"modified":"2026-05-13T09:37:11","modified_gmt":"2026-05-13T07:37:11","slug":"administration-as-a-provider","status":"publish","type":"page","link":"https:\/\/help.openbee.com\/en\/open-bee-chorus-pro\/administrators-guide\/administration-as-a-provider\/","title":{"rendered":"Administration as a provider"},"content":{"rendered":"\n<p>This section details the configuration required to semi-automatically transmit invoices to local authorities from Open Bee\u2122 Portal : Chorus Pro Connector.  <\/p>\n\n<ul class=\"wp-block-list\">\n<li><a href=\"#Administrationentantquefournisseur-Cr%C3%A9ationducomptetechniquedanstrue\">Creating the technical account in Chorus Pro<\/a><\/li>\n\n\n\n<li><a href=\"#Administrationentantquefournisseur-Configurationd'uncomptefournisseurdanstrue\">Configuration d&#8217;un compte fournisseur dans&nbsp;Open Bee\u2122 Portal : Connecteur Chorus Pro<\/a>\n<ul class=\"wp-block-list\">\n<li><a href=\"#Administrationentantquefournisseur-Ajoutd'unfournisseur\">Adding a Provider<\/a><\/li>\n\n\n\n<li><a href=\"#Administrationentantquefournisseur-Configuration\">Configuration<\/a><\/li>\n\n\n\n<li><a href=\"#Administrationentantquefournisseur-Modedechargementdesfactures\">How invoices are uploaded<\/a><\/li>\n\n\n\n<li><a href=\"#Administrationentantquefournisseur-Crit%C3%A8resdesoumission%C3%A0true\">Chorus Pro Submission Criteria<\/a><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><a href=\"#Administrationentantquefournisseur-Associationautomatiquedesm%C3%A9tadonn%C3%A9es\">Automatic metadata association  <\/a><\/li>\n\n\n\n<li><a href=\"#Administrationentantquefournisseur-G%C3%A9rerlesr%C3%A9cipiendaires\">Managing Recipients<\/a><\/li>\n\n\n\n<li><a href=\"#Administrationentantquefournisseur-G%C3%A9rerlesutilisateurs\">Manage users<\/a><\/li>\n\n\n\n<li><a href=\"#Administrationentantquefournisseur-G%C3%A9rerlescoordonn%C3%A9esbancaires\">Manage bank details<\/a><\/li>\n\n\n\n<li><a href=\"#Administrationentantquefournisseur-Liaisonautomatiquedespi%C3%A8cesjointes\">Automatic attachment linking<\/a><\/li>\n<\/ul>\n\n<h1 class=\"wp-block-heading\" id=\"Administrationentantquefournisseur-Cr&#xE9;ationducomptetechniquedanstrue\">Creating the technical account in Chorus Pro<\/h1>\n\n<p>To allow Open Bee\u2122 Portal : Chorus Pro Connector to interact with the Chorus Pro Portal, it is necessary to create a technical account.<\/p>\n\n<p>If you haven&#8217;t already done so, please follow the steps in the attached guide: <a href=\"https:\/\/communaute.chorus-pro.gouv.fr\/documentation\/creation-dun-compte-technique-pour-un-acces-api-en-production\/#1645413551590-0c993690-7063\" target=\"_blank\" rel=\"noreferrer noopener\">Chorus Technical Account Creation<\/a> \/ <a href=\"https:\/\/communaute.chorus-pro.gouv.fr\/chorus-pro-piste-comment-reussir-son-raccordement-api-oauth2\/\" target=\"_blank\" rel=\"noreferrer noopener\">Track Technical Account Creation<\/a><\/p>\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>The creation of a technical account on the Chorus Pro portal requires a connection with a user with a &#8220;<strong>Main Manager<\/strong>&#8221; attachment on your structure.<\/p>\n<\/blockquote>\n\n<h1 class=\"wp-block-heading\" id=\"Administrationentantquefournisseur-Configurationd'uncomptefournisseurdanstrue\">Setting up a vendor account in Open Bee\u2122 Portal : Chorus Pro Connector<\/h1>\n\n<p>In Open Bee\u2122 Portal, click on the &#8220;<strong>Chorus<\/strong>&#8221; menu. You are directed directly to the &#8220;<strong>Configuration<\/strong>&#8221; tab.<\/p>\n\n<h2 class=\"wp-block-heading\" id=\"Administrationentantquefournisseur-Ajoutd'unfournisseur\">Adding a Provider<\/h2>\n\n<p>Open Bee\u2122 Portal : Chorus Pro Connector allows you to manage multiple locations to submit invoices to Chorus Pro.<\/p>\n\n<p>By default, there is a provider that is already ready to be configured.<\/p>\n\n<p>Click Provider to access the configuration.<\/p>\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2022\/04\/264536247.png\" alt=\"\"\/><\/figure>\n\n<p>If you need to manage multiple locations, you can add a new provider by clicking the &#8220;<strong>Add Provider<\/strong>&#8221; button.<\/p>\n\n<h2 class=\"wp-block-heading\" id=\"Administrationentantquefournisseur-Configuration\">Configuration<\/h2>\n\n<p>When you click on a provider, you see the associated configuration.<\/p>\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2022\/04\/270794803.png\" alt=\"\"\/><\/figure>\n\n<p>Here are the explanations for the different fields<\/p>\n\n<p><strong>Vendor Name<\/strong> : The name you give your vendor.<br\/>This label is free to type, it is used for display, put the name of your institution.<\/p>\n\n<p><strong>Supplier identifier<\/strong> : SIRET number of the supplier.<br\/>As the module allows you to manage several establishments for the sending of invoices, this SIRET number makes it possible to distinguish between them.<\/p>\n\n<p><strong>Automatic submission<\/strong> : allows you to automatically send complete invoices to Chorus Pro.<br\/>If this feature is enabled, full invoices will be automatically sent to Chorus Pro every 10 minutes without the need to log in to Open Bee\u2122 Portal.<\/p>\n\n<p><strong>Send attachments: <\/strong>Enables automatic sending of attachments, see Automatic attachment linking.<\/p>\n\n<p><strong>Username<\/strong> : the identifier of the technical account of your entity previously created in Chorus Pro.<\/p>\n\n<p><strong>Password<\/strong> : the password for the technical account of your entity previously created in Chorus Pro.<\/p>\n\n<p>These credentials will allow Open Bee\u2122 Portal : Chorus Pro Connector to submit invoices to Chorus Pro. Icon<\/p>\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>If you have a login issue during validation (and even though port 5443 is open), we recommend that you reset the technical account password.<br\/>The Chorus Pro documentation for creating the technical account (<a href=\"https:\/\/help.openbee.com\/en\/open-bee-chorus-pro\/installers-guide\/hardware-and-software-requirements\/\">see our prerequisites<\/a>) also explains how to reset the password.<\/p>\n<\/blockquote>\n\n<p><strong>Group and\/or users to be notified<\/strong> : Users or groups entered in this field will be notified on their dashboards and by email during the following events:<\/p>\n\n<ul class=\"wp-block-list\">\n<li>adding a new document awaiting submission to Chorus Pro<\/li>\n\n\n\n<li>document submitted to Chorus Pro<\/li>\n\n\n\n<li>Changing the status of an invoice in Chorus Pro<\/li>\n<\/ul>\n\n<p><strong>Group and\/or users to use Chorus<\/strong> : Users or groups entered in this field will have access to Open Bee\u2122 Portal : Chorus Pro Connector, but not to the configuration part.<\/p>\n\n<p><strong>Authentication mode: <\/strong>Certificate or OAuth &#8211; Track.<br\/>The authentication method with the Chorus Pro API has evolved.<br\/>From now on, the OAuth &#8211; TRACK mode is to be preferred.<br\/>Indeed, since January 2020, new connections with a certificate are no longer possible.<br\/>The OAuth-Track authentication mode allows you to do without an RGS* certificate.<br\/>For connections that existed before January 2020, certificate authentication still works.<br\/>On the Chorus Pro website, there is no end date for the certificate-based authentication mode.<\/p>\n\n<p><strong>Client ID, secret client: <\/strong>These are the OAuth credentials that you find when you log in to the PISTE portal.<\/p>\n\n<p><strong>Certificate Settings<\/strong><strong>:<\/strong> These fields are used to add the certificate used for exchanges with Chorus.<br\/>Add a certificate by clicking Browse.<br\/>You can also choose the format of the certificate, p12 is recommended.<br\/>Finally, please enter the password for the certificate.<\/p>\n\n<h2 class=\"wp-block-heading\" id=\"Administrationentantquefournisseur-Modedechargementdesfactures\">How invoices are uploaded<\/h2>\n\n<p>Remote or Local.<br\/>The default mode is <strong>Remote<\/strong>.<br\/>To display invoices in <strong>Tracking<\/strong> and <strong>Documents to be processed<\/strong>, Open Bee\u2122 Portal : Chorus Pro Connector will query the Chorus Pro API.<br\/>The displayed information is therefore retrieved in real time, e.g. the status value.<br\/>Similarly, if the Chorus Pro API is not available, you will not be able to access these screens.<\/p>\n\n<p>In <strong>Local<\/strong> mode, a run will run each night to retrieve the invoice information.<br\/>This means that the data displayed in the <strong>Tracking<\/strong> screens and in the <strong>Documents to be processed<\/strong> date from the last execution of the processing.<br\/>A message will show you the date and time of the last invoice retrieval.<br\/>You will be able to access the <strong>Tracking<\/strong> and <strong>Documents to be processed<\/strong> screens even when the Chorus Pro API is not available.<\/p>\n\n<h2 class=\"wp-block-heading\" id=\"Administrationentantquefournisseur-Crit&#xE8;resdesoumission&#xE0;true\">Chorus Pro Submission Criteria<\/h2>\n\n<p>Click on the Settings tab to access the criteria for submitting to Chorus Pro.<\/p>\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2022\/04\/264536249.png\" alt=\"\"\/><\/figure>\n\n<p><strong>Groups and\/or users to be administered Chorus<\/strong> :d define the users or groups that have the ability to administer Open Bee\u2122 Portal : Chorus Pro Connector.Criteria<strong>(s) for submission to Chorus Pro:<\/strong><\/p>\n\n<p>This section gives you the opportunity to establish the criteria that allow Open Bee\u2122 Portal : Chorus Pro Connector to determine which documents should be submitted to Chorus Pro.  <\/p>\n\n<p>A criterion is based on:<\/p>\n\n<ul class=\"wp-block-list\">\n<li>or on a classification rule<\/li>\n\n\n\n<li>or on a<\/li>\n<\/ul>\n\n<p>It is possible to create several criteria.<\/p>\n\n<p>All added documents that meet these criteria will undergo automatic character recognition (OCR) processing in the background to facilitate submission to Chorus Pro.  <\/p>\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>It is necessary to add PDF type invoices (Chorus requires the use of PDF type documents) in order to be able to submit them<\/p>\n<\/blockquote>\n\n<h1 class=\"wp-block-heading\" id=\"Administrationentantquefournisseur-Associationautomatiquedesm&#xE9;tadonn&#xE9;es\">Automatic metadata association  <\/h1>\n\n<p>A character recognition process is used to automatically determine some of the information needed for submission in Chorus Pro.<\/p>\n\n<p>However, it is not uncommon for this information to be unrecognized or poorly recognized.<\/p>\n\n<p>When Open Bee\u2122 Portal has metadata corresponding to the information needed to submit the invoice in Chorus Pro, it becomes interesting to favor this metadata rather than that from character recognition.<\/p>\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>Example:<\/p>\n\n\n\n<p>Suppose the recognition process detects an amount of \u20ac1,500 on the invoice.<br\/>An &#8220;amount&#8221; metadata exists in Open Bee\u2122 Portal on this document with a value of \u20ac1,800.  <br\/>If an association has been set up on this Open Bee\u2122 Portal metadata, the value of \u20ac1,800 will be offered to the user in the Chorus Pro submission form.  <\/p>\n<\/blockquote>\n\n<p>To set up the team:  <\/p>\n\n<ol class=\"wp-block-list\">\n<li>Click on the &#8220;<strong>Metadata association<\/strong>&#8221; sub-tab  <\/li>\n\n\n\n<li>Choose the classification rule from which the metadata will be extracted for submission to Chorus Pro  <\/li>\n\n\n\n<li>Associate Chorus Pro submission information with Open Bee\u2122 Portal metadata<\/li>\n<\/ol>\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2022\/04\/250448395.png\" alt=\"\"\/><\/figure>\n\n<h1 class=\"wp-block-heading\" id=\"Administrationentantquefournisseur-G&#xE9;rerlesr&#xE9;cipiendaires\">Managing Recipients<\/h1>\n\n<p>This screen allows you to match a recipient of the Chorus Pro directory to a label on your invoice.<\/p>\n\n<p>For example, if on an invoice, the recipient&#8217;s wording is Mairie d&#8217;Annecy but this wording is not the same in the Chorus Pro directory, you can make this correspondence here.<\/p>\n\n<p>Thus, if the wording of your invoice corresponding to the recipient is present in this recipient management list, it will be automatically replaced by the associated value from the Chorus Pro directory.<\/p>\n\n<p>This feature is very useful in the context of the automatic submission of invoices to Chorus Pro and avoids the need to systematically search for the recipient.<br\/>Similarly, this correspondence may be made for the services of a recipient.<\/p>\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2022\/04\/264536250.png\" alt=\"\"\/><\/figure>\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>In the context of automated invoice mailing, it is advisable to put the recipient&#8217;s SIRET number as the value for the recipient.<\/p>\n\n\n\n<p>For the service, it is preferable to put the Chorus Pro service code, as it is in the Chorus Pro directory.<\/p>\n<\/blockquote>\n\n<p><\/p>\n\n<h1 class=\"wp-block-heading\" id=\"Administrationentantquefournisseur-G&#xE9;rerlesutilisateurs\">Manage users<\/h1>\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>The invoice upload mode must be set to &#8220;Local&#8221; to use this filtering feature by user.<\/p>\n<\/blockquote>\n\n<p>Use this screen to assign one invoice per user and match a Portal user to a label on your invoice.<\/p>\n\n<p>Thus, users configured in this screen will only access invoices that have the corresponding metadata value (&#8220;User Label&#8221;) associated here.<\/p>\n\n<h1 class=\"wp-block-heading\" id=\"Administrationentantquefournisseur-G&#xE9;rerlescoordonn&#xE9;esbancaires\">Manage bank details<\/h1>\n\n<p>If you use several bank details to invoice the public institutions you work with, this screen allows you to associate a metadata value with a bank details already configured on the Chorus Pro portal.<\/p>\n\n<p>This means that you must specify a value on your invoices to identify the bank details to be used and that this value is associated with metadata.<\/p>\n\n<p>You can also select a default bank details.<\/p>\n\n<h1 class=\"wp-block-heading\" id=\"Administrationentantquefournisseur-Liaisonautomatiquedespi&#xE8;cesjointes\">Automatic attachment linking<\/h1>\n\n<p>Before you can automatically send attachments with your invoices, you need to set up automatic dynamic linking in Open Bee\u2122 Portal.<\/p>\n\n<p>In the configuration of the link, the same ranking rule must be used as in the <strong>Criteria(s) for submission to Chorus Pro section.<\/strong><\/p>\n\n<p>You can also choose a metadata that will allow you to activate automatic sending or not.<br\/>For example, on the invoice you can put a label &#8220;PJ&#8221;, and select a text metadata that will have the value PJ to send the attachments.<\/p>\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2022\/04\/270794802.png\" alt=\"\"\/><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>This section details the configuration required to semi-automatically transmit invoices to local authorities from Open Bee\u2122 Portal : Chorus Pro Connector. Creating the technical account in Chorus Pro To allow Open Bee\u2122 Portal : Chorus Pro Connector to interact with the Chorus Pro Portal, it is necessary to create a technical account. If you haven&#8217;t [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":21498,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"templates\/ob-help-products.php","meta":{"footnotes":""},"class_list":["post-21515","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/pages\/21515","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/comments?post=21515"}],"version-history":[{"count":3,"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/pages\/21515\/revisions"}],"predecessor-version":[{"id":21518,"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/pages\/21515\/revisions\/21518"}],"up":[{"embeddable":true,"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/pages\/21498"}],"wp:attachment":[{"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/media?parent=21515"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}