{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/oneplatform/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"French eInvoice - Activation via Organizations API","description":"Integration and usage documentation.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"french-einvoice---activation-via-organizations-api","__idx":0},"children":["French eInvoice - Activation via Organizations API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This integration guide describes the API flow used by a partner organization to activate French eInvoice for a final customer."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The flow mirrors the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/oneplatform/one-platform-knowledge-center/03-products-and-modules/02-namirial-services/01-french-einvoice/french-einvoice-activation-ui"},"children":["Organization Portal guide"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{organizationId}"]}," with the partner organization id;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{customerId}"]}," with the final customer id;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{legalRepresentativeId}"]}," with the legal representative id;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{delegateId}"]}," with the delegate id, when onboarding is completed by a delegate instead of the legal representative;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{contractId}"]}," with the contract id returned by contract creation;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{sagId}"]}," with the Service Activation Group id."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"environment-configuration","__idx":1},"children":["Environment Configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Organizations API endpoint base URL can change depending on the target environment"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Environment"},"children":["Environment"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Base URL"},"children":["Base URL"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Production"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://platform-api.namirial.app"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pre-production"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://platform-api-demo.namirial.app"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Test"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://platform-api-test.namirial.app"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication","__idx":2},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All requests require a bearer token in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}," header."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer \n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/oneplatform/one-platform-knowledge-center/04-api-and-integration/authentication/authentication"},"children":["Authentication"]}," for the OAuth2 client credentials flow used by One Platform integrations."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"flow-at-a-glance","__idx":3},"children":["Flow at a Glance"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"#"},"children":["#"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Step"},"children":["Step"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Method"},"children":["Method"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint"},"children":["Endpoint"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create or reuse final customer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/organizations/{organizationId}/consumers"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create or reuse legal representative"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/organizations/{organizationId}/consumers"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create indirect contract and activation context"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/organizations/{organizationId}/contracts"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add French eInvoice item with onboarding parameters"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/organizations/{organizationId}/contracts/{contractId}/contract-items"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Resolve or create Service Activation Group"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/organizations/{organizationId}/contracts/{contractId}/service-activation-group"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/organizations/{organizationId}/service-activation-groups"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["6"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Confirm Service Activation Group"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/organizations/{organizationId}/service-activation-groups/{sagId}/confirm?sendNotification=true"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For production-grade integrations, search first and reuse existing consumers/contracts when present. The payloads below show the creation path for a new activation."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Recommended lookups:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /v2/organizations/{organizationId}/consumers?taxCode1=&country=FR&customerType=Corporate&exact=true&pageSize=1\nGET /v2/organizations/{organizationId}/consumers?taxCode2=&country=FR&customerType=PrivateIndividual&exact=true&pageSize=1\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"conditional-onboarding-rules","__idx":4},"children":["Conditional Onboarding Rules"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["French eInvoice onboarding uses two conditional rules that must be reflected in API payloads:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Configuration"},"children":["Configuration"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"API field"},"children":["API field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Effect in onboarding"},"children":["Effect in onboarding"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Legal representative onboarding"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Omit ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hasDelegate"]}," or set it to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onboardingExtraParameters"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The recipient reviews and completes onboarding as the legal representative."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delegate onboarding"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hasDelegate: \"true\""]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onboardingExtraParameters"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The recipient reviews and completes onboarding as a delegate instead of the legal representative."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Portail DT enabled"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dt-portal"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["featureIds"]}," and provide ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["adminEmail"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["adminFirstName"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["adminLastName"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onboardingExtraParameters"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The onboarding flow can request or display the Portail DT administrator data."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Portail DT not enabled"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Do not include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dt-portal"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["featureIds"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Portail DT administrator data is not required."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onboardingExtraParameters"]}," is part of the contract item creation payload. The values are string key/value pairs, so boolean-like values are sent as strings."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-create-the-final-customer","__idx":5},"children":["1. Create the Final Customer"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create the final customer as a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Corporate"]}," consumer in the partner organization scope."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v2/organizations/{organizationId}/consumers\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"name\": \"VIDAL SOLUTIONS INFORMATIQUES SAS\",\n \"country\": \"FR\",\n \"type\": \"Customer\",\n \"customerType\": \"Corporate\",\n \"taxCode1\": \"FR43573849262\",\n \"taxCode2\": \"573849262\",\n \"taxCode3\": \"57384926200007\",\n \"emails\": [\"contact@vidal-solutions.fr\"],\n \"phones\": [],\n \"mobilePhones\": [],\n \"metadata\": {\n \"siret_01\": \"57384926200007\"\n },\n \"billable\": true,\n \"address\": \"12 RUE DES ARCHIVES\",\n \"state\": \"ILE-DE-FRANCE\",\n \"city\": \"PARIS\",\n \"postalCode\": \"75004\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Key fields:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Corporate"]}," for the final customer company."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxCode1"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["French VAT / TVA number."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxCode2"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["SIREN."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxCode3"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["SIRET."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata.siret_01"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Additional SIRET metadata used by the activation flow. You can provide an arbitrary number of SIRET entries using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["siret_nn"]}," pattern, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["siret_01"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["siret_02"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["siret_03"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billable"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," to enable address input for the customer."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The identifiers must be consistent when more than one is provided:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxCode3"]}," (SIRET) starts with the 9-digit ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxCode2"]}," (SIREN);"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the last 9 digits of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxCode1"]}," (TVA) equal ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxCode2"]}," (SIREN)."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Store the returned id as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerId"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-create-the-legal-representative","__idx":6},"children":["2. Create the Legal Representative"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create the legal representative as a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PrivateIndividual"]}," consumer."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v2/organizations/{organizationId}/consumers\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"name\": \"Laurent Vidal\",\n \"country\": \"FR\",\n \"type\": \"Customer\",\n \"customerType\": \"PrivateIndividual\",\n \"firstName\": \"Laurent\",\n \"lastName\": \"Vidal\",\n \"taxCode2\": \"T0301KVRTQXKHJY1KCZ2SYKF0NRM2\",\n \"emails\": [\"laurent.vidal@vidal-solutions.fr\"],\n \"phones\": [],\n \"mobilePhones\": [],\n \"metadata\": {},\n \"billable\": false\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a French ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PrivateIndividual"]},", do not send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxCode1"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxCode3"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Store the returned id as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["legalRepresentativeId"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Legal representative taxCode2"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the French eInvoice legal representative, generate ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxCode2"]}," (temporary SIREN) as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["T03"]}," followed by a ULID, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["T0301KVRTQXKHJY1KCZ2SYKF0NRM2"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"3-create-the-indirect-contract","__idx":7},"children":["3. Create the Indirect Contract"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create the final customer contract in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Draft"]}," state. The contract carries the commercial context and recipient. The Service Activation Group can be associated during the contract creation workflow when the API/UI version exposes that capability; otherwise create or retrieve it explicitly before confirmation as shown in step 5."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/organizations/{organizationId}/contracts\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"recipient\": {\n \"email\": \"laurent.vidal@vidal-solutions.fr\"\n },\n \"startDate\": \"2026-06-23\",\n \"legalRepresentativeId\": \"{legalRepresentativeId}\",\n \"billingConsumerId\": \"{customerId}\",\n \"issuerId\": \"8ef6cf04-a0e4-478b-8c24-bd1104605df5\",\n \"legalEntityId\": \"ea5d7839-acb6-4ae8-91b1-79a6e928ef37\",\n \"description\": \"French eInvoice activation - VIDAL SOLUTIONS INFORMATIQUES SAS\",\n \"number\": \"VIDAL-FR-EINV-01\",\n \"metadata\": {\n \"serviceActivationGroupDescription\": \"French eInvoice activation - VIDAL SOLUTIONS INFORMATIQUES SAS\"\n },\n \"type\": \"Indirect\",\n \"resellContractId\": \"2d29844f-1365-46ea-8ebb-18c6d79f05d5\",\n \"createOrganization\": false\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipient.email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Email used by the activation flow."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["legalRepresentativeId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Id from step 2."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billingConsumerId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Final customer id from step 1."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["issuerId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Issuer consumer id for the partner organization."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["legalEntityId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Namirial legal entity that owns the offer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata.serviceActivationGroupDescription"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional integration metadata that keeps the SAG description aligned with the contract creation step. Use the native SAG field instead when your API version exposes one."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Indirect"]}," for partner-issued final customer contracts."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resellContractId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Distribution contract used as resell source."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createOrganization"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," creates a customer-side organization; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," keeps the activation back-office only."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Store the returned id as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contractId"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"4-add-the-french-einvoice-contract-item","__idx":8},"children":["4. Add the French eInvoice Contract Item"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add the service item to the contract."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/organizations/{organizationId}/contracts/{contractId}/contract-items\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"skuId\": \"1089000001\",\n \"startDate\": \"2026-06-27\",\n \"endDate\": \"2027-06-27\",\n \"description\": \"French eInvoice\",\n \"signed\": false,\n \"provisioned\": false,\n \"featureIds\": [\n \"out-b2b\",\n \"in-b2b\",\n \"e-reporting\",\n \"dt-portal\"\n ],\n \"billingModelParameters\": {},\n \"skuParameters\": {},\n \"onboardingExtraParameters\": {\n \"hasDelegate\": \"true\",\n \"adminEmail\": \"camille.martin@vidal-solutions.fr\",\n \"adminFirstName\": \"Camille\",\n \"adminLastName\": \"Martin\"\n },\n \"envelopeParameters\": [],\n \"resellContractItemId\": \"cd7c2a76-f1a2-418f-a5c9-66363eabf444\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["skuId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["French eInvoice SKU. The current activation flow uses ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1089000001"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["featureIds"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Feature set to activate on the item. The default French eInvoice features are ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["out-b2b"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["in-b2b"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["e-reporting"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onboardingExtraParameters.hasDelegate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"true\""]}," when the onboarding subject is a delegate rather than the legal representative. Omit it or set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"false\""]}," for legal-representative onboarding."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onboardingExtraParameters.adminEmail"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Portail DT administrator email. Required only when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["featureIds"]}," includes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dt-portal"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onboardingExtraParameters.adminFirstName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Portail DT administrator first name. Required only when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["featureIds"]}," includes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dt-portal"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onboardingExtraParameters.adminLastName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Portail DT administrator last name. Required only when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["featureIds"]}," includes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dt-portal"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," only when the item is already signed outside One Platform."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisioned"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," only when the item is already provisioned outside One Platform."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resellContractItemId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contract item id from the resell/distribution contract."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["skuParameters"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Service-specific parameters when required by the selected features."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envelopeParameters"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional envelope-specific parameters."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"french-einvoice-features","__idx":9},"children":["French eInvoice Features"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Feature ID"},"children":["Feature ID"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"English label"},"children":["English label"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Italian label"},"children":["Italian label"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"French label"},"children":["French label"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default"},"children":["Default"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Dependency"},"children":["Dependency"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["out-b2b"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Out-B2B Domestic"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fatturazione attiva B2B"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Facturation electronique sortante B2B domestique"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["in-b2b"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["In B2B"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fatturazione passiva B2B"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Facturation electronique entrante B2B"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["e-reporting"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["eReporting"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reportistica elettronica"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Declaration electronique"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dt-portal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Portal DT"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Portale DT"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Portail DT"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requires any of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["out-b2b"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["in-b2b"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["e-reporting"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["editor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Editor"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Editor"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Editeur"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dt-portal"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identification"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["KYC/KYB"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["KYC/KYB"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["KYC/KYB"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dt-portal"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["multiple-mandate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Multiple mandate"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mandato multiplo"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mandat multiple"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["in-b2b"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"graph TD\n OUT[\"out-b2b
Out-B2B Domestic\"]\n IN[\"in-b2b
In B2B\"]\n ER[\"e-reporting
eReporting\"]\n DTP[\"dt-portal
Portal DT\"]\n EDITOR[\"editor
Editor\"]\n ID[\"identification
KYC/KYB\"]\n MM[\"multiple-mandate
Multiple mandate\"]\n\n OUT -->|\"enables\"| DTP\n IN -->|\"enables\"| DTP\n ER -->|\"enables\"| DTP\n DTP -->|\"required by\"| EDITOR\n DTP -->|\"required by\"| ID\n IN -->|\"required by\"| MM\n","diagramHtml":"

enables

enables

enables

required by

required by

required by

out-b2b
Out-B2B Domestic

in-b2b
In B2B

e-reporting
eReporting

dt-portal
Portal DT

editor
Editor

identification
KYC/KYB

multiple-mandate
Multiple mandate

"},"children":["graph TD\n OUT[\"out-b2b
Out-B2B Domestic\"]\n IN[\"in-b2b
In B2B\"]\n ER[\"e-reporting
eReporting\"]\n DTP[\"dt-portal
Portal DT\"]\n EDITOR[\"editor
Editor\"]\n ID[\"identification
KYC/KYB\"]\n MM[\"multiple-mandate
Multiple mandate\"]\n\n OUT -->|\"enables\"| DTP\n IN -->|\"enables\"| DTP\n ER -->|\"enables\"| DTP\n DTP -->|\"required by\"| EDITOR\n DTP -->|\"required by\"| ID\n IN -->|\"required by\"| MM\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"5-resolve-or-create-the-service-activation-group","__idx":10},"children":["5. Resolve or Create the Service Activation Group"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the contract creation flow already created or associated a SAG, retrieve its id from the contract:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /v1/organizations/{organizationId}/contracts/{contractId}/service-activation-group\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If no SAG exists yet, create one containing the contract to activate."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/organizations/{organizationId}/service-activation-groups\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"description\": {\n \"en\": \"French eInvoice activation - VIDAL SOLUTIONS INFORMATIQUES SAS\"\n },\n \"contractIds\": [\n \"{contractId}\"\n ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Store the returned id as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sagId"]},". This replaces the old portal-side \"update SAG\" action: activation data should be supplied during contract and contract-item creation, then the SAG is confirmed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"6-confirm-the-service-activation-group","__idx":11},"children":["6. Confirm the Service Activation Group"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Confirm the SAG to move the contract out of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Draft"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"PUT /v1/organizations/{organizationId}/service-activation-groups/{sagId}/confirm?sendNotification=true\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sendNotification=true"]}," to send the activation email to the recipient. If this parameter is omitted or set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},", the SAG is confirmed but the email is not sent."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The portal confirmation message explains that the recipient will be able to view the contract and fill in missing fields after confirmation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"end-to-end-pseudocode","__idx":12},"children":["End-to-End Pseudocode"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"customer = POST /v2/organizations/{org}/consumers\n { Corporate final customer payload }\n\nlegalRep = POST /v2/organizations/{org}/consumers\n { PrivateIndividual legal representative payload }\n\ncontract = POST /v1/organizations/{org}/contracts\n { Indirect, billingConsumerId, legalRepresentativeId, resellContractId, SAG description metadata }\n\nitem = POST /v1/organizations/{org}/contracts/{contract.id}/contract-items\n { skuId, featureIds, dates, resellContractItemId, onboardingExtraParameters }\n\nsag = GET /v1/organizations/{org}/contracts/{contract.id}/service-activation-group\n or POST /v1/organizations/{org}/service-activation-groups\n { description, contractIds: [contract.id] }\n\nPUT /v1/organizations/{org}/service-activation-groups/{sag.id}/confirm?sendNotification=true\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-concepts","__idx":13},"children":["Related Concepts"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/oneplatform/one-platform-knowledge-center/03-products-and-modules/02-namirial-services/01-french-einvoice/french-einvoice-overview"},"children":["French eInvoice Overview"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/oneplatform/one-platform-knowledge-center/03-products-and-modules/02-namirial-services/01-french-einvoice/french-einvoice-activation-ui"},"children":["French eInvoice - Service Activation (Organization Portal)"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/oneplatform/workflows/french-einvoice-activation"},"children":["French eInvoice - Activation Workflow"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/oneplatform/one-platform-knowledge-center/04-api-and-integration/integration-guides/create-a-contract"},"children":["Create a Contract"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/oneplatform/one-platform-knowledge-center/04-api-and-integration/authentication/authentication"},"children":["Authentication"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/oneplatform/apis/oas/organizations"},"children":["Organizations API"]}]}]}]},"headings":[{"value":"French eInvoice - Activation via Organizations API","id":"french-einvoice---activation-via-organizations-api","depth":1},{"value":"Environment Configuration","id":"environment-configuration","depth":2},{"value":"Authentication","id":"authentication","depth":2},{"value":"Flow at a Glance","id":"flow-at-a-glance","depth":2},{"value":"Conditional Onboarding Rules","id":"conditional-onboarding-rules","depth":2},{"value":"1. Create the Final Customer","id":"1-create-the-final-customer","depth":2},{"value":"2. Create the Legal Representative","id":"2-create-the-legal-representative","depth":2},{"value":"3. Create the Indirect Contract","id":"3-create-the-indirect-contract","depth":2},{"value":"4. Add the French eInvoice Contract Item","id":"4-add-the-french-einvoice-contract-item","depth":2},{"value":"French eInvoice Features","id":"french-einvoice-features","depth":3},{"value":"5. Resolve or Create the Service Activation Group","id":"5-resolve-or-create-the-service-activation-group","depth":2},{"value":"6. Confirm the Service Activation Group","id":"6-confirm-the-service-activation-group","depth":2},{"value":"End-to-End Pseudocode","id":"end-to-end-pseudocode","depth":2},{"value":"Related Concepts","id":"related-concepts","depth":2}],"frontmatter":{"seo":{"title":"French eInvoice - Activation via Organizations API"}},"lastModified":"2026-07-20T14:25:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/oneplatform/one-platform-knowledge-center/04-api-and-integration/integration-guides/french-einvoice-activation","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}