# Guide de diagnostic d'exportation de l'API M3

### 1. Configuration initiale

Avant de commencer le dépannage, assurez-vous de bien connaître les entrées attendues pour le point de terminaison M3 avec lequel vous travaillez.

#### 1.1 Accéder à la documentation de l'API M3

* Connectez-vous à **M3**.
* Accédez à la **Section API → Documentation de l'API**.
* Localisez et sélectionnez le point de terminaison pertinent (par exemple, `APS450MI` pour les exportations liées aux factures).
* Choisissez la fonction appropriée (par exemple, `Add`).

#### 1.2 Comprendre les exigences de l'API

* Passez en revue tous les **champs requis** dans la documentation de l'API.
* Faites attention aux champs importants tels que :
  * `DIVI`
  * `ACDT` (date comptable)
  * `CUCD` (code de devise)
  * `SINO` (numéro de facture fournisseur)
* Confirmez les **types de données** des champs, la **casse** et les **règles de formatage** (par exemple, `AAAA-MM-JJ` pour les dates).

### 2. Tester les appels API directement dans M3

Cette étape vérifie que l'API M3 se comporte comme prévu en utilisant des entrées manuelles.

#### 2.1 Générer une demande de test dans M3

* Dans l'outil de documentation de l'API M3 :
  * Remplissez les données de test pour les champs requis.
  * Cliquez sur **Exécuter** pour exécuter la demande.
  * Copiez le **cURL** et le **corps JSON** résultants.

#### 2.2 Déboguer en utilisant Postman

* Ouvrez **Postman** et créez une nouvelle demande **POST**.
* Collez le corps JSON ou le cURL.
* Ajoutez les en-têtes nécessaires (par exemple, autorisation).
* Cliquez sur **Envoyer** et observez le résultat :
  * `200 OK` : La demande a réussi.
  * Erreur : Vérifiez le message pour plus de détails sur ce qui s'est mal passé.

### 3. Comparer l'API M3 avec le mappage DocBits

Une fois que vous avez confirmé que l'API fonctionne avec des données de test, comparez-la à ce que DocBits envoie réellement.

#### 3.1 Exporter des données d'exemple depuis DocBits

* Ouvrez la **documentation de l'API DocBits** :

  Utilisez le point de terminaison **/export/get\_infor\_export\_api\_json**.
* Entrez l'**ID du document** d'un document problématique.
* Exécutez l'exportation pour visualiser la **charge JSON** que DocBits enverra à M3.

#### 3.2 Comparer les charges utiles de l'API

* Placez le **JSON de test M3** et le **JSON d'exportation DocBits** côte à côte.
* Vérifiez :
  * **Noms de champs** : Assurez-vous que les noms correspondent *exactement*, y compris la casse (`DIVI` ≠ `divi`).
  * **Types de données** : Vérifiez que les chaînes, les nombres et les dates sont correctement formatés.
  * **Champs manquants** : Identifiez les champs présents dans la demande de M3 mais absents dans DocBits.

### 4. Dépannage des problèmes courants

| Problème                                   | Cause probable                               | Solution                                                                       |
| ------------------------------------------ | -------------------------------------------- | ------------------------------------------------------------------------------ |
| Erreur de champ manquant                   | Un champ requis n'est pas mappé dans DocBits | Ajoutez le champ manquant dans la configuration d'exportation de DocBits.      |
| Incompatibilité de casse de champ (`DIVI`) | M3 est sensible à la casse                   | Utilisez la casse correcte dans le mappage des champs.                         |
| Format de `accountingDate` invalide        | Date incorrecte ou manquante                 | Ajustez au format attendu par M3 (par exemple, `AAAA-MM-JJ`).                  |
| Erreur API inattendue                      | Champs supplémentaires ou non reconnus       | Comparez avec des charges de travail connues et nettoyez les données inutiles. |

### 5. Si les problèmes persistent

Si le problème n'est pas résolu après avoir suivi les étapes ci-dessus :

1. **Documentez** le problème :
   * Message d'erreur et code d'état
   * Demande M3 d'exemple et JSON d'exportation de DocBits
2. **Résumez** votre dépannage :
   * Ce que vous avez essayé
   * Différences clés observées entre les charges de test et les échecs
3. **Escaladez** vers un développeur :
   * Incluez toutes les données et conclusions
   * Mettez en évidence les zones de problème suspectées


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-fr.docbits.com/overview-and-basics/faq/infor-m3-m3-integration/m3-api-export-diagnostic-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.