MyUnisoft Accounting Data API

https://partners.api.myunisoft.fr/
Admin
MyUnisoft Accounting Data (MAD) is a hybrid JSON format API for exporting and importing accounting...
Tokens:194,503
Snippets:978
Trust Score:8.6
Update:6 months ago
Show doc for...
Tokens:
Raw
### API Request Example

Source: https://partners.api.myunisoft.fr/documentation.html

Example of a GET request to the /api/v1/mad/exercices endpoint. Requires 'X-Third-Party-Secret' and 'Authorization' headers. Use this to fetch exercise data.

```bash
curl --location \
--request GET 'https://api.myunisoft.fr/api/v1/mad/exercices?version=1.0.0' \
--header 'X-Third-Party-Secret: xxx-L8vlKfjJ5y7zwFj2J49xo53V' \
--header 'Authorization: Bearer {{API_TOKEN}}'
```

--------------------------------

### HTTP Request Example

Source: https://partners.api.myunisoft.fr/webhooks.html

Example of an HTTP POST request with 'date' and 'signature' headers, as received from MyUnisoft.

```http
POST {{postUrl}} HTTP/1.1
date: 1677163797597
signature: 5c25dcda347d2a278f1fea783c56b18d702d2bcf68b6161fac28dfb33de5751d
```

--------------------------------

### Analytical Axe JSON Example

Source: https://partners.api.myunisoft.fr/MAD/specs/v1.0.0/analytic.html

Example of an analytical axe object containing multiple sections.

```json
{
  "producerId": "1385",
  "code": "IMM",
  "name": "Immeubles",
  "sections": [
    {
      "producerId": "8157",
      "code": "001",
      "name": "IMMEUBLE 1",
      "account": null,
      "additionalProducerProperties": {
        "closed": false
      }
    },
    {
      "producerId": "8164",
      "code": "002",
      "name": "IMMEUBLE 2",
      "account": null,
      "additionalProducerProperties": {
        "closed": false
      }
    },
    {
      "producerId": "8158",
      "code": "003",
      "name": "IMMEUBLE 3",
      "account": null,
      "additionalProducerProperties": {
        "closed": false
      }
    },
    {
      "producerId": "8165",
      "code": "004",
      "name": "IMMEUBLE 4",
      "account": null,
      "additionalProducerProperties": {
        "closed": false
      }
    },
    {
      "producerId": "8156",
      "code": "ATTENTE",
      "name": "Section d'attente",
      "account": null,
      "additionalProducerProperties": {
        "closed": false
      }
    }
  ],
  "additionalProducerProperties": {
    "defaultSectionId": "8156"
  }
}
```

--------------------------------

### Accounting Folder Structure (JSON Example)

Source: https://partners.api.myunisoft.fr/MAD/specs/v1.0.0/accountingFolder.html

An example of the JSON structure representing an accounting folder in MyUnisoft.

```APIDOC
## Accounting Folder JSON Example

### Description
This JSON object represents a production dossier, which can also be considered a company or establishment.

### Request Body
```json
{
  "name": "MyUnisoft",
  "reference": "MYUN",
  "address": {
    "country": "FRANCE",
    "city": "MASSY",
    "fullName": "4 B Rue GALVANI",
    "addressNumber": "4",
    "locatingIndex": "B",
    "addressComplement": null,
    "postalCode": "91300",
    "streetName": "GALVANI",
    "streetType": "Rue"
  },
  "contact": {
    "firstName": "Régis",
    "lastName": "SAMUEL",
    "phoneNumber": "00 00 00 00 00",
    "mobilePhoneNumber": "00 00 00 00 00",
    "mail": null
  },
  "RCS": {
    "producerId": "99",
    "name": "PARIS"
  },
  "SIRET": "84014327500039",
  "capital": 10000
}
```
```

--------------------------------

### Fiscal File API Response Example

Source: https://partners.api.myunisoft.fr/accounting/firm/get_fiscal_file.html

Example JSON structure returned by the fiscal file endpoint.

```json
{
    "rof_tva": "TVA1",
    "rof_tdfc": "IS1",
    "rof_cfe": "CFE1",
    "rof_cvae": "CVAE1",
    "rof_rcm": "RCM1",
    "rof_groupe": "",
    "acompte_pro_mens": false,
    "exercice_declaration": false,
    "tva_intraco": "FR45530514157",
    "due_date_tva": 21,
    "adherent_code": "",
    "mono_etab": false,
    "close_entries_VAT": false,
    "mail_liasse": "",
    "fiscal_integration": false,
    "head_group_if": false,
    "start_date_if": "",
    "end_date_if": "",
    "adv_legal_form_id": "SARL",
    "adv_name": "Groupe conseil",
    "adv_name_2": "",
    "adv_phone_number": "+33112134567",
    "adv_address_number": "10",
    "adv_street_name": "du Boulevard",
    "adv_postal_code": "75000",
    "adv_city": "PARIS",
    "adv_country": "FRANCE",
    "ecf_legal_form_id": "EURL",
    "ecf_siren": "",
    "ecf_name": "Prestataire",
    "ecf_name_2": "",
    "ecf_address_number": "",
    "ecf_street_name": "de la corniche",
    "ecf_postal_code": "75000",
    "ecf_city": "PARIS",
    "ecf_country": "FRANCE",
    "sie_address_number": "8",
    "sie_street_name": "de l'impasse",
    "sie_name": "SIE de Paris",
    "sie_postal_code": "75000",
    "sie_city": "PARIS",
    "sie_country": "FRANCE",
    "vis_name": "",
    "vis_agreement_number": "",
    "vis_viseur": true,
    "vis_address_number": "",
    "vis_street_name": "",
    "vis_postal_code": "",
    "vis_city": "",
    "vis_country": "",
    "id_pers_physique": null,
    "id_societe_signataire": null,
    "id_societe_comptable": null,
    "fiscal_decl_by_firm": true,
    "id_comptable": 0,
    "assujetti_unique": false,
    "siren_assujetti_unique": "",
    "rof_ts": "",
    "periodicity_ts": 0,
    "holding_name": "",
    "adv_forme_juridique": {
        "id": 1,
        "code": "SARL",
        "label": "Société à Responsabilité Limitée",
        "code_edi": "SRL"
    },
    "ecf_forme_juridique": {
        "id": 4,
        "code": "EURL",
        "label": "Entreprise Unipersonnelle à Responsabilité Limitée",
        "code_edi": "ERL"
    },
    "adv_road_type": {
        "id": 1,
        "label": "Allée",
        "value": "Allée"
    },
    "ecf_road_type": {
        "id": 3,
        "label": "Boulevard",
        "value": "Boulevard"
    },
    "sie_road_type": {
        "id": 2,
        "label": "Avenue",
        "value": "Avenue"
    },
    "sheet_group": {
        "id": 2,
        "label": "IS-BIC-Normal",
        "value": "ISBICN",
        "id_bilan": 1,
        "regime_impot": true,
        "id_regime_impot": 1
    },
    "vat_regime": {
        "id": 4,
        "label": "Réel Normal Mensuel",
        "value": "M"
    },
    "gestion_center": {
        "id": 7,
        "label": "CGA83",
        "value": "CGA83"
    },
    "info_bnc": {
        "info_bnc_id": 1982,
        "membership_year": null,
        "activity_code_pm": null
    },
    "society_status": {
        "id": 1,
        "label": "En activité",
        "value": "En activité",
        "effective_date": "2023-09-14"
    }
}
```

--------------------------------

### Currency Object Example

Source: https://partners.api.myunisoft.fr/MAD/specs/v1.0.0/currency.html

Example of a JSON object representing a currency.

```json
{
  "currency": {
    "code": "EUR"
  }
}
```

--------------------------------

### Example JSON Response for Profile Types

Source: https://partners.api.myunisoft.fr/accounting/firm/user_management.html

This is an example of the JSON response structure when retrieving profile types.

```json
[
  {
    "id": 1,
    "libelle": "Client"
  },
  {
    "id": 2,
    "libelle": "Cabinet"
  }
]
```

--------------------------------

### Bank JSON Example

Source: https://partners.api.myunisoft.fr/MAD/specs/v1.0.0/bank.html

An example of a Bank object in JSON format.

```APIDOC
## Bank JSON Example

### Description
This example demonstrates the structure of a Bank object when sent or received via the API.

### Request/Response Example
```json
{
  "producerId": "1993",
  "RIB": "30007321451234567890043",
  "IBAN": "AL35202111090000000001234567",
  "BIC": "SGSBALTX",
  "account": {
    "producerId": "2567424",
    "number": "5120900000",
    "name": "CIC Lyonnaise de banque"
  },
  "journal": {
    "producerId": "36502",
    "name": "BANQUE CIC",
    "type": "BANQUE",
    "customerReferenceCode": "CIC"
  },
  "additionalProducerProperties": {
    "isDefault": true
  }
}
```
```

--------------------------------

### Account Root Configuration

Source: https://partners.api.myunisoft.fr/MAD/specs/v1.0.0/analytic.html

Example of account root configuration for automatic movement assignment.

```text
622;623;624
```

--------------------------------

### Production folder JSON example

Source: https://partners.api.myunisoft.fr/MAD/specs/v1.0.0/accountingFolder.html

A sample JSON object representing a production folder entity.

```json
{
  "name": "MyUnisoft",
  "reference": "MYUN",
  "address": {
    "country": "FRANCE",
    "city": "MASSY",
    "fullName": "4 B Rue GALVANI",
    "addressNumber": "4",
    "locatingIndex": "B",
    "addressComplement": null,
    "postalCode": "91300",
    "streetName": "GALVANI",
    "streetType": "Rue"
  },
  "contact": {
    "firstName": "Régis",
    "lastName": "SAMUEL",
    "phoneNumber": "00 00 00 00 00",
    "mobilePhoneNumber": "00 00 00 00 00",
    "mail": null
  },
  "RCS": {
    "producerId": "99",
    "name": "PARIS"
  },
  "SIRET": "84014327500039",
  "capital": 10000
}
```

--------------------------------

### API Response for Repartition Keys

Source: https://partners.api.myunisoft.fr/accounting/folder/analytique.html

This is an example of the JSON response when retrieving repartition keys for an axe.

```json
[
  {
    "id_axe": 3744,
    "id_repartion_key": 50,
    "condition": "61",
    "key": "CLE_BUG"
  }
]
```

--------------------------------

### GET /api/v1/wallet

Source: https://partners.api.myunisoft.fr/accounting/firm/user_management.html

Récupère le(s) portefeuille(s) associé(s) au cabinet.

```APIDOC
## GET /api/v1/wallet

### Description
Récupère les informations des portefeuilles liés au cabinet.

### Method
GET

### Endpoint
https://api.myunisoft.fr/api/v1/wallet

### Response
#### Success Response (200)
- **id_wallet** (integer) - Identifiant du portefeuille
- **main_wallet** (boolean) - Indique si c'est le portefeuille principal
- **libelle** (string) - Libellé du portefeuille
- **nb_society** (integer) - Nombre de sociétés dans le portefeuille
- **list_society** (array) - Liste des sociétés associées

#### Response Example
[
  {
    "id_wallet": 1,
    "main_wallet": true,
    "libelle": "TOUTES",
    "nb_society": 4,
    "list_society": [
      {
        "name": "TEST",
        "id_society": 149
      }
    ]
  }
]
```

--------------------------------

### Création et mise à jour d'un dossier

Source: https://partners.api.myunisoft.fr/accounting/firm/create_society.html

Utilisez POST pour créer un dossier ou PUT pour une mise à jour partielle. Le corps de la requête nécessite les informations de base de l'entreprise.

```bash
curl --location \
--request POST 'https://api.myunisoft.fr/api/v1/society' \
--header 'X-Third-Party-Secret: xxx-L8vlKfjJ5y7zwFj2J49xo53V' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{API_TOKEN}}'
```

```json
{
  "member_id": 1,
  "name": "Nom du dossier",
  "siret": "84014327500039",
  "id_type_company": 1,
  "date_engage_letter": "20210728",
  "folder_reference": "Reference",

  "address_number": "54",
  "road_type_id": 9,
  "street_name": "RUE DU LAPIN",
  "postal_code": "75000",
  "city": "PARIS",
  "country": "FRANCE",
  "ape_id": 550,
  "activity": "Programmation informatique",
  "registration_date": "20210728",
}
```

--------------------------------

### Create User with cURL

Source: https://partners.api.myunisoft.fr/accounting/firm/user_management.html

Use this endpoint to create a new user account associated with a schema that has access to the solution. Ensure you include the necessary headers and a JSON payload with user details.

```bash
$ curl --location 'https://api.myunisoft.fr/api/v1/user' \
--header 'X-Third-Party-Secret: nompartenaire-L8vlKfjJ5y7zwFj2J49xo53V' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{API_TOKEN}}' \
--data-raw '{ 
  "civility_code": "Mr",
  "name": "user_name",
  "firstname": "user_firstname",
  "mail": "user@emailexemple.fr",
  "delete_list": [],
  "access_list": [
    {
      "acces_id": "227",
      "wallet_id": 1,
      "wallet_label": "TOUTES",
      "society_id": 0,
      "profil_id": 1,
      "type_id": 2
    }
  ],
  "id_profil": 1
}'
```

--------------------------------

### POST /websites/partners_api_myunisoft_fr/entry

Source: https://partners.api.myunisoft.fr/accounting/folder/import/json.html

Create a new accounting entry. The entry_list must contain lines that are balanced in terms of credit and debit.

```APIDOC
## POST /websites/partners_api_myunisoft_fr/entry

### Description
Creates a new accounting entry in MyUnisoft. It is crucial that all lines within the entry are balanced, with total debits equaling total credits.

### Method
POST

### Endpoint
/websites/partners_api_myunisoft_fr/entry

### Parameters
#### Request Body
- **pj_list** (PJ[]) - Optional - An array containing one or more attachments for the accounting entry.
- **entry_list** (NewEntryLine[]) - Required - An array of lines that constitute the accounting entry. The sum of debits must equal the sum of credits.
- **date_piece** (string) - Required - The date of the accounting entry in YYYY-MM-DD format.
- **period_from** (string) - Optional - The start date of the period in YYYY-MM-DD format.
- **period_to** (string) - Optional - The end date of the period in YYYY-MM-DD format.
- **etablissement_id** (number) - Required - The ID of the company to which the entry belongs.
- **diary_id** (number) - Required - The ID of the journal associated with the accounting entry. Available journals for the company can be retrieved using the GET /diary route.
- **entry_origin_partner_id** (string) - Optional - A unique partner ID for the accounting entry. This ID should ideally have a prefix identifying the partner. The entry can be retrieved later using the GET entry/id?id_origin=ID route. Example: QB-dd661851-022a-44ae-8205-f3f4449eb891
- **json** (string) - Optional - A custom JSON structure attached to the accounting entry for storing additional information.
- **comment** (object) - Optional - A comment attached to the accounting entry. Should contain a 'content' field.
- **id_source** (number) - Optional - An ID to identify the source (origin) of the accounting entry.

### Request Example
```json
{
  "entry_list": [
    {
      "account_id": 10,
      "debit": 100,
      "credit": 0,
      "description": "Example debit line"
    },
    {
      "account_id": 20,
      "debit": 0,
      "credit": 100,
      "description": "Example credit line"
    }
  ],
  "date_piece": "2023-10-27",
  "etablissement_id": 1,
  "diary_id": 5,
  "entry_origin_partner_id": "PARTNER-12345"
}
```

### Response
#### Success Response (200)
- **message** (string) - A success message indicating the entry was created.
- **id** (number) - The ID of the newly created accounting entry.

#### Response Example
```json
{
  "message": "Accounting entry created successfully.",
  "id": 12345
}
```
```

--------------------------------

### API Response for Repartition Key Creation

Source: https://partners.api.myunisoft.fr/accounting/folder/analytique.html

This is an example of the JSON response received after successfully creating a repartition key.

```json
{
  "condition": "6",
  "id_axe": 48,
  "id_repartition_key": 5,
  "key": "PAYS"
}
```

--------------------------------

### Récupérer les plans comptables étalons

Source: https://partners.api.myunisoft.fr/accounting/firm/pcg_etalon.html

Utilisez cette requête pour obtenir la liste des plans comptables étalons disponibles. Nécessite un jeton d'autorisation et le secret tiers dans les en-têtes.

```bash
curl --location \
--request GET 'https://api.myunisoft.fr/api/v1/model/account' \
--header 'Authorization: {{TOKEN}}' \
--header 'X-Third-Party-Secret: {{X-Third-Party-Secret}}'
```

--------------------------------

### Example API Response for Analytical Review

Source: https://partners.api.myunisoft.fr/accounting/folder/analytic_review.html

This is an example of the JSON response structure returned by the API when successfully retrieving analytical review data. It includes balance sheet information and account results.

```json
{
  "balance_sheet": {
    "solde_n_total": 0,
    "solde_n_1_total": 0,
    "solde_n_2_total": 0,
    "variation_n_n_1_total": 0,
    "evo_total": 0,
    "va_total": 0,
    "data": [
        {
          "account_id": 25587189,
          "account_number": "40000000000",
          "label": "FOURNISSEURS ET COMPTES RATTACHES",
          "solde_n": -3933.00,
          "solde_n_1": 0.00,
          "solde_n_2": 0.00,
          "variation_n_n_1": -3933.00,
          "evo": "NA",
          "va": "0.85",
          "id_l_dossier_revision_compte": null,
          "nb_line_entries": 7,
          "nb_docs": 2,
          "nb_acc_docs": 0,
          "nb_da_acc_docs": 0,
          "valid_collab": {
            "status": "to_do",
            "trigram": "",
            "name": "",
            "validation_date": ""
          },
          "valid_rm": {
            "status": "to_validate",
            "trigram": "",
            "name": "",
            "validation_date": ""
          },
          "nb_comments": 0,
          "nb_comments_permanent": 0,
          "hasJustification": false
        },
        {
          "account_id": 11788097,
          "account_number": "401000",
          "label": "FOURNISSEURS",
          "solde_n": 0.00,
          "solde_n_1": 572914.99,
          "solde_n_2": -258000.01,
          "variation_n_n_1": -572914.99,
          "evo": "-100.00",
          "va": "0.00",
          "id_l_dossier_revision_compte": 61816,
          "nb_line_entries": 0,
          "nb_docs": null,
          "nb_acc_docs": 1,
          "nb_da_acc_docs": 0,
          "valid_collab": {
            "status": "to_do",
            "trigram": "B.GA",
            "name": "GARIAZZO Benoit",
            "validation_date": "2025-05-06T12:40:52.407764"
          },
          "valid_rm": {
            "status": "to_validate",
            "trigram": "B.GA",
            "name": "GARIAZZO Benoit",
            "validation_date": "2025-05-06T12:40:52.407764"
          },
          "nb_comments": 0,
          "nb_comments_permanent": 1,
          "hasJustification": false
        }
      ]
  },
  "accounts_results": {
    "solde_n_total": 0,
    "solde_n_1_total": 0,
    "solde_n_2_total": 0,
    "variation_n_n_1_total": 0,
    "evo_total": 0,
    "va_total": 0,
    "data": [
      {
        "account_id": 11788191,
        "account_number": "60100000000000000",
        "label": "ACHATS MATIERES PREMIERES",
        "solde_n": 0.00,
        "solde_n_1": 16314.00,
        "solde_n_2": 255925.00,
        "variation_n_n_1": -16314.00,
        "evo": "-100.00",
        "va": "0.00",
        "id_l_dossier_revision_compte": null,
        "nb_line_entries": 0,
        "nb_docs": null,
        "nb_acc_docs": 0,
        "nb_da_acc_docs": 0,
        "valid_collab": {
          "status": "to_do",
          "trigram": "",
          "name": "",
          "validation_date": ""
        },
        "valid_rm": {
          "status": "to_validate",
          "trigram": "",
          "name": "",
          "validation_date": ""
        },
        "nb_comments": 0,
        "nb_comments_permanent": 0,
        "hasJustification": false
      },
      {
          "account_id": 11788205,
          "account_number": "60700000000000000",
          "label": "ACHATS DE MARCHANDISES",
          "solde_n": -2030.61,
          "solde_n_1": 8332.88,
          "solde_n_2": 0.00,
          "variation_n_n_1": -10363.49,
          "evo": "-124.37",
          "va": "0.44",
          "id_l_dossier_revision_compte": null,
          "nb_line_entries": 8,
          "nb_docs": 0
      }
    ]
  }
}
```

--------------------------------

### GET Request to Retrieve Company Exercises

Source: https://partners.api.myunisoft.fr/accounting/folder/exercices.html

Use this cURL command to make a GET request to the API endpoint for retrieving company exercises. Ensure you include the necessary headers for authentication and identification.

```bash
$ curl --location --request GET 'https://api.myunisoft.fr/api/v1/society/exercice' \
--header 'X-Third-Party-Secret: nompartenaire-L8vlKfjJ5y7zwFj2J49xo53V' \
--header 'Authorization: Bearer {{API_TOKEN}}'
```

--------------------------------

### GET /api/v1/pers_physique

Source: https://partners.api.myunisoft.fr/accounting/firm/users.html

Retrieves the list of physical persons.

```APIDOC
## GET /api/v1/pers_physique

### Description
Retrieves the list of physical persons associated with the authenticated partner.

### Method
GET

### Endpoint
https://api.myunisoft.fr/api/v1/pers_physique

### Request Example
curl --location --request GET 'https://api.myunisoft.fr/api/v1/pers_physique' \
--header 'X-Third-Party-Secret: nompartenaire-L8vlKfjJ5y7zwFj2J49xo53V' \
--header 'Authorization: Bearer {{API_TOKEN}}'

### Response
#### Success Response (200)
- **array_pers_physique** (array) - List of physical person objects.

#### Response Example
{
  "array_pers_physique": [
    {
      "name": "123",
      "actif": true,
      "civility": {
        "id": 1,
        "label": "Monsieur",
        "value": "Mr"
      },
      "firstname": "123123",
      "coordonnee": [
        {
          "id": 11725,
          "type": {
            "id": 2,
            "label": "Tel. fixe",
            "value": "Tel. fixe"
          },
          "value": "123"
        }
      ],
      "company_number": 0,
      "pers_physique_id": 5299,
      "physical_person_type": {
        "id": 2,
        "label": "Interne",
        "value": "Interne"
      }
    }
  ]
}
```

--------------------------------

### GET Request to Retrieve EDI Export

Source: https://partners.api.myunisoft.fr/accounting/folder/export/EDI.html

Use this cURL command to make a GET request to the API endpoint for retrieving an EDI export file. Ensure you replace placeholders with your actual IDs and tokens. Access to this endpoint requires explicit authorization.

```bash
curl --location \
--request GET 'https://api.myunisoft.fr/api/v1/accounting/export/edi?exerciceId={{exerciceId}}' \
--header 'X-Third-Party-Secret: nompartenaire-L8vlKfjJ5y7zwFj2J49xo53V' \
--header 'Authorization: Bearer {{API_TOKEN}}'
```

--------------------------------

### Mettre à jour un compte client/fournisseur

Source: https://partners.api.myunisoft.fr/accounting/folder/account/update.html

Utilisez cette requête PUT pour mettre à jour un compte. Il est obligatoire de renvoyer l'intégralité des informations du compte, pas seulement les champs à modifier. Les champs `account_id` et `account_number` sont obligatoires.

```bash
curl --location --request PUT 'https://api.myunisoft.fr/api/v1/account' \
--header 'X-Third-Party-Secret: nompartenaire-L8vlKfjJ5y7zwFj2J49xo53V' \
--header 'Authorization: Bearer {{API_TOKEN}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "account_number": "411FOOBAR",
    "label": "FOOBAR account"
}'
```

--------------------------------

### GET Request for Company RIB/IBAN

Source: https://partners.api.myunisoft.fr/accounting/folder/RIB.html

Use this `curl` command to make a GET request to the API endpoint for retrieving RIB/IBAN details. Ensure you replace placeholders with your actual secret, society ID, and authorization token. For cabinet access, the `society-id` header is mandatory.

```bash
curl --location --request GET 'https://api.myunisoft.fr/api/v1/rib' \
--header 'X-Third-Party-Secret: X-Third-Party-Secret' \
--header 'society-id: 19' \
--header 'Authorization: Bearer Authorization'
```

--------------------------------

### GET /api/v1/society

Source: https://partners.api.myunisoft.fr/accounting/society.html

Retrieves a list of all companies (societies) with their details.

```APIDOC
## GET /api/v1/society

### Description
Retrieves a list of all companies (societies) with their details.

### Method
GET

### Endpoint
https://api.myunisoft.fr/api/v1/society

### Headers
- **X-Third-Party-Secret** (string) - Required - Your third-party secret key.
- **Authorization** (string) - Required - Your authentication token.

### Response
#### Success Response (200)
- **row_numbers** (integer) - The total number of companies returned.
- **pages_number** (integer or null) - The total number of pages available (null if not paginated).
- **society_array** (array) - An array of company objects.
  - **ape** (string or null) - The APE code of the company.
  - **city** (string) - The city where the company is located.
  - **name** (string) - The name of the company.
  - **step** (string) - The current step in a process.
  - **insee** (string or null) - The INSEE code of the company.
  - **siret** (string or null) - The SIRET number of the company.
  - **status** (string) - The status of the company.
  - **address** (string) - The full address of the company.
  - **capital** (number) - The company's capital.
  - **country** (string) - The country where the company is located.
  - **secured** (boolean) - Indicates if the company is secured.
  - **analytics** (boolean) - Indicates if analytics are enabled for the company.
  - **member_id** (integer) - The ID of the member associated with the company.
  - **road_type** (string or null) - The type of road (e.g., Rue, Avenue).
  - **complement** (string or null) - Additional address information.
  - **coordonnee** (array) - Array of coordinates (currently empty).
  - **society_id** (integer) - The unique ID of the company.
  - **address_bis** (string or null) - Secondary address information.
  - **companyType** (string) - The type of company.
  - **mail_liasse** (string or null) - Email for tax documents.
  - **postal_code** (string or null) - The postal code of the company.
  - **safe_status** (boolean) - Indicates if the company has a safe status.
  - **street_name** (string or null) - The name of the street.
  - **address_number** (string or null) - The street number.
  - **enable_quantity** (boolean) - Indicates if quantity is enabled.
  - **id_type_company** (integer) - The ID of the company type.
  - **folder_reference** (string or null) - Reference for the company folder.

### Request Example
```bash
curl --location --request GET 'https://api.myunisoft.fr/api/v1/society' \
--header 'X-Third-Party-Secret: {{X-Third-Party-Secret}}' \
--header 'Authorization: {{TOKEN}}'
```

### Response Example
```json
{
  "row_numbers": 6,
  "pages_number": null,
  "society_array": [
    {
      "ape": "6201Z",
      "city": "ARDILLIERES",
      "name": "3A2ID",
      "step": "",
      "insee": "17018",
      "siret": "838006955",
      "status": "",
      "address": "6 Rue DU RUISSEAU 17290 ARDILLIERES FRANCE",
      "capital": 0,
      "country": "FRANCE",
      "secured": true,
      "analytics": false,
      "member_id": 2,
      "road_type": "Rue",
      "complement": null,
      "coordonnee": [],
      "society_id": 60,
      "address_bis": null,
      "companyType": "",
      "mail_liasse": null,
      "postal_code": "17290",
      "safe_status": true,
      "street_name": "DU RUISSEAU",
      "address_number": "6",
      "enable_quantity": false,
      "id_type_company": 1,
      "folder_reference": null
    }
  ]
}
```
```

--------------------------------

### Create or Retrieve Account (Upsert)

Source: https://partners.api.myunisoft.fr/accounting/folder/account/create.html

Use this endpoint to create a new account or retrieve an existing one if it already exists. This is particularly useful for JSON imports where automatic account creation is not handled. The response includes the account ID, which is necessary for subsequent operations.

```bash
curl --location --request POST 'https://api.myunisoft.fr/api/v1/account' \
--header 'X-Third-Party-Secret: nompartenaire-L8vlKfjJ5y7zwFj2J49xo53V' \
--header 'Authorization: Bearer {{API_TOKEN}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "account_number": "411FOOBAR",
    "label": "FOOBAR account"
}'
```

--------------------------------

### GET /api/v1/analytics/axes/:id_axe/sections

Source: https://partners.api.myunisoft.fr/accounting/folder/analytique.html

Retrieves all sections for a specific axis.

```APIDOC
## GET /api/v1/analytics/axes/:id_axe/sections

### Description
Retrieves the list of all sections associated with a specific axis.

### Method
GET

### Endpoint
https://api.myunisoft.fr/api/v1/analytics/axes/:id_axe/sections

### Parameters
#### Path Parameters
- **id_axe** (integer) - Required - The ID of the axis

### Response
#### Success Response (200)
- **Array** (object) - List of sections

### Response Example
[
  {
    "id_section_analytique": 1,
    "code": "TEAM",
    "label": "Section TEAM",
    "id_axe": 41,
    "account": "601000",
    "closed": false,
    "isdefault": false
  }
]
```

--------------------------------

### API Response for User Creation

Source: https://partners.api.myunisoft.fr/accounting/firm/user_management.html

This is a sample JSON response received after successfully creating a user via the API.

```json
{
  "civility_code": "Mr",
  "name": "user_name",
  "firstname": "user_firstname",
  "mail": "user@emailexemple.fr",
  "delete_list": [
  ],
  "access_list": [
    {
      "acces_id": 227,
      "wallet_id": 1,
      "wallet_label": "TOUTES",
      "society_id": 0,
      "profil_id": 1,
      "type_id": 2
    }
  ],
  "id_profil": 1,
  "user_id": 356
}
```

--------------------------------

### GET /api/v1/building

Source: https://partners.api.myunisoft.fr/accounting/firm/buildings.html

Retrieves the list of all buildings associated with a company.

```APIDOC
## GET /api/v1/building

### Description
Retrieves the list of all buildings linked to a company via the partner API.

### Method
GET

### Endpoint
https://api.myunisoft.fr/api/v1/building

### Parameters
#### Headers
- **X-Third-Party-Secret** (string) - Required - Partner secret key
- **society-id** (string) - Required - The ID of the company
- **Authorization** (string) - Required - Bearer token for authentication

### Response
#### Success Response (200)
- **building_id** (number) - Unique identifier of the building
- **name** (string) - Name of the building
- **full_address** (string) - Complete address of the building
- **postal_code** (string) - Postal code
- **country** (string) - Country

#### Response Example
[
    {
        "building_id": 95,
        "name": "IMMEUBLE 1",
        "full_address": "1 B Allée DU TEMPS LE FAUBOURG 75000 PARIS ",
        "postal_code": "75000",
        "country": "FRANCE"
    }
]
```

--------------------------------

### GET /api/v1/analytics/axes/:id_axe/repartition_keys

Source: https://partners.api.myunisoft.fr/accounting/folder/analytique.html

Retrieves distribution keys for a specific axis.

```APIDOC
## GET /api/v1/analytics/axes/:id_axe/repartition_keys

### Description
Retrieves all distribution keys for a specific axis.

### Method
GET

### Endpoint
https://api.myunisoft.fr/api/v1/analytics/axes/:id_axe/repartition_keys

### Parameters
#### Path Parameters
- **id_axe** (string) - Required - The ID of the axis.

### Response
#### Success Response (200)
- **id_axe** (integer) - ID of the axis.
- **id_repartion_key** (integer) - ID of the distribution key.
- **condition** (string) - Condition on account numbers.
- **key** (string) - Key/Code of the resource.

#### Response Example
[
  {
    "id_axe": 3744,
    "id_repartion_key": 50,
    "condition": "61",
    "key": "CLE_BUG"
  }
]
```

--------------------------------

### Create Repartition Key using cURL

Source: https://partners.api.myunisoft.fr/accounting/folder/analytique.html

This cURL command demonstrates how to create a new repartition key. Ensure you provide the correct axe ID and the key/condition in the data payload.

```bash
$ curl --location --request POST 'https://api.myunisoft.fr/api/v1/analytics/axes/48/repartition_keys' \
--header 'X-Third-Party-Secret: nompartenaire-L8vlKfjJ5y7zwFj2J49xo53V' \
--header 'Authorization: Bearer {{API_TOKEN}}'
--data-raw '{
  "key": "PAYS",
  "condition": "6"
}'
```

--------------------------------

### GET /api/v1/diary

Source: https://partners.api.myunisoft.fr/accounting/folder/journaux.html

Retrieves the list of journals for a specific company dossier.

```APIDOC
## GET /api/v1/diary

### Description
Retrieves the list of journals (diary) for a company dossier. This endpoint corresponds to the journals list found in the MyUnisoft interface under Paramètres > Dossier > Journaux.

### Method
GET

### Endpoint
https://api.myunisoft.fr/api/v1/diary

### Parameters
#### Headers
- **X-Third-Party-Secret** (string) - Required - Partner secret key
- **Authorization** (string) - Required - Bearer {{API_TOKEN}}
- **society-id** (string) - Required (for cabinet access) - The ID of the company dossier

### Response
#### Success Response (200)
- **code** (string) - Journal code
- **name** (string) - Journal name
- **account** (object) - Associated account details (id, label, number)
- **blocked** (boolean) - Whether the journal is blocked
- **diary_id** (integer) - Unique identifier for the journal
- **diary_type_id** (integer) - ID of the journal type
- **diary_type_code** (string) - Code of the journal type
- **diary_type_name** (string) - Name of the journal type

#### Response Example
[
    {
        "code": "01",
        "name": "JOURNAL D'ACHATS",
        "account": null,
        "blocked": false,
        "diary_id": 32169,
        "diary_type_id": 1,
        "diary_type_code": "ACH",
        "diary_type_name": "Achat"
    }
]
```

--------------------------------

### GET /api/v1/dadp/dossier_revision/models

Source: https://partners.api.myunisoft.fr/accounting/folder/dossiers_de_r%C3%A9vision.html

Retrieves the list of revision model templates for a company.

```APIDOC
## GET /api/v1/dadp/dossier_revision/models

### Description
Retrieves the list of available revision model templates. Use the `id_review_model` field from the response for further operations.

### Method
GET

### Endpoint
https://api.myunisoft.fr/api/v1/dadp/dossier_revision/models

### Parameters
#### Headers
- **X-Third-Party-Secret** (string) - Required - Partner secret key
- **society-id** (string) - Required - ID of the company (required for cabinet access)
- **Authorization** (string) - Required - Bearer token

### Response
#### Success Response (200)
- **models** (array) - List of revision models

#### Response Example
[
  {
    "id_review_model": 10,
    "label": "Dossier de révision - test",
    "code": "TEST"
  }
]
```

--------------------------------

### GET /api/v1/dadp/dossier_revision_list

Source: https://partners.api.myunisoft.fr/accounting/folder/dossiers_de_r%C3%A9vision.html

Retrieves the list of revision folders for a specific company.

```APIDOC
## GET /api/v1/dadp/dossier_revision_list

### Description
Retrieves the list of revision folders associated with a company. Use the `id_dossier_revision` field from the response for further operations.

### Method
GET

### Endpoint
https://api.myunisoft.fr/api/v1/dadp/dossier_revision_list

### Parameters
#### Headers
- **X-Third-Party-Secret** (string) - Required - Partner secret key
- **society-id** (string) - Required - ID of the company (required for cabinet access)
- **Authorization** (string) - Required - Bearer token

### Response
#### Success Response (200)
- **dossier_revision_list** (array) - List of revision folders

#### Response Example
{
  "dossier_revision_list": [
    {
      "id_dossier_revision": 109913,
      "exercise": "N+1",
      "start_date": "2024-01-01",
      "end_date": "2024-12-31"
    }
  ]
}
```

--------------------------------

### Exemple de réponse JSON

Source: https://partners.api.myunisoft.fr/accounting/firm/pcg_etalon.html

Structure de la réponse retournée par l'API contenant la liste des plans comptables avec leurs identifiants, labels et descriptions.

```json
{
  "list": [
    {
      "id": 4,
      "label": "Etalon Association MYUNISOFT",
      "description": "Plan comptable Association"
    },
    {
      "id": 2022,
      "label": "Etalon BIC MYUNISOFT 2025",
      "description": "Plan comptable BIC ANC 2022-06"
    },
    {
      "id": -100,
      "label": "Etalon MYUNISOFT",
      "description": "Plan comptable crée par défaut par MyUnisoft"
    }
  ]
}
```

--------------------------------

### Récupérer la liste des utilisateurs

Source: https://partners.api.myunisoft.fr/accounting/firm/users.html

Utilisez cette requête cURL pour obtenir la liste de tous les comptes utilisateurs du schéma ayant accès à la solution. Assurez-vous d'inclure votre secret tiers et un token d'authentification valide.

```bash
$ curl --location --request GET 'https://api.myunisoft.fr/api/v1/users_v2' \
--header 'X-Third-Party-Secret: nompartenaire-L8vlKfjJ5y7zwFj2J49xo53V' \
--header 'Authorization: Bearer {{API_TOKEN}}'
```

--------------------------------

### GET /vat-parameters

Source: https://partners.api.myunisoft.fr/accounting/firm/pcg_etalon.html

Retrieves the configuration settings for VAT rates and accounts.

```APIDOC
## GET /vat-parameters

### Description
Retrieves the configuration for VAT, including rates, codes, and associated accounting accounts.

### Response
#### Success Response (200)
- **vat** (object) - VAT rate details
- **code** (string) - VAT code
- **model_id** (integer) - Model identifier
- **vat_type** (object) - Type of VAT
- **account_ded** (string) - Deductible account
- **account_coll** (string) - Collected account
- **vat_exigility** (object) - VAT exigibility details

#### Response Example
[
  {
    "vat": {
      "id": 4,
      "rate": 20
    },
    "code": "01",
    "model_id": 1,
    "vat_type": {
      "id": 1,
      "code": "BIEN",
      "label": "Biens et services"
    },
    "account_ded": "445660",
    "account_coll": "445712",
    "vat_exigility": {
      "id": 1,
      "code": "DEB",
      "label": "Débit (facturation)"
    },
    "param_vat_etalon_id": 1
  }
]
```

--------------------------------

### Récupérer les taux de change

Source: https://partners.api.myunisoft.fr/accounting/folder/import/json.html

Endpoint permettant d'obtenir les taux de conversion actuels pour différentes devises.

```bash
$ curl --location --request GET 'https://api.myunisoft.fr/api/v1/currencies' \
--header 'Authorization: Bearer {{API_TOKEN}}' \
--header 'X-Third-Party-Secret: {{X-Third-Party-Secret}}'
```
Tokens:
Raw