API REST pour les données comptables

Chaque document REDA Financials étant un objet personnalisé Salesforce, l’API REST standard est la porte d’entrée de vos intégrations : créez des factures depuis votre CRM ou votre système de facturation, interrogez les soldes pour les charger dans un entrepôt de données, comptabilisez des documents depuis un middleware — le tout avec les points de terminaison que votre équipe connaît déjà.

Le modèle de référence : créer un brouillon, puis comptabiliser

Les points de terminaison en un coup d’œil

Rien ici n’est propre à REDA — ce sont les points de terminaison REST standard de Salesforce, appliqués aux objets refin__ (le package est construit en API v65.0 ; toute version actuelle fonctionne) :

Comptabiliser un brouillon : la requête HTTP

L’appel de comptabilisation est volontairement sans surprise — un seul champ :

PATCH /services/data/v65.0/sobjects/refin__Sales_Invoice__c/a0X8d000001AbCdEAV

{
  "refin__Status__c": "Posted"
}

Un succès renvoie un HTTP 204 No Content — et, derrière, un document entièrement comptabilisé. Un refus revient sous la forme du tableau d’erreurs standard, porteur du message lisible du package ; par exemple, un utilisateur d’intégration sans siège de licence REDA reçoit :

[
  {
    "message": "You must be a licensed REDA Financials user to create, edit, or delete Accounting Transactions. Contact your administrator.",
    "errorCode": "FIELD_CUSTOM_VALIDATION_EXCEPTION",
    "fields": []
  }
]

Pour relire ce que vous avez créé, une simple requête SOQL suffit :

GET /services/data/v65.0/query
    ?q=SELECT Id, Name, refin__Status__c
       FROM refin__Sales_Invoice__c
       WHERE refin__Status__c = 'Draft'

Pour le corps des requêtes d’insertion, récupérez la liste des champs depuis le point de terminaison describe ou le Gestionnaire d’objet plutôt que dans cet article — ce sont les ensembles de champs et les champs obligatoires de votre organisation qui font foi, y compris les champs de dimension supplémentaires ajoutés par votre administrateur.

Ce que la plateforme renseigne pour vous

Lire les données

• SOQL via le point de terminaison query — factures ouvertes, encaissements non imputés, champs de balance âgée (ce sont des champs de formule sur les enregistrements) : tout ce dont votre tableau de bord a besoin.
• Le grand livre lui-même — refin__Accounting_Transaction__c fait foi pour la comptabilisation ; additionnez débits et crédits par compte général et vous reconstituez n’importe quel solde à l’extérieur.
• Les cumuls sont des champs — le solde dû d’une facture, le montant non imputé d’un encaissement, le montant engagé d’une ligne budgétaire : tout s’interroge directement, sans calcul de votre côté.

Les règles à respecter

• Aucun contournement n’existe : les documents comptabilisés sont verrouillés pour les modifications via l’API exactement comme pour les utilisateurs ; les corrections passent par les parcours de décomptabilisation ou d’annulation, soit, par programme, les mêmes transitions de statut.
• Les imputations sont aussi des enregistrements — créer un refin__Cash_Receipt_Application__c impute un encaissement (tous les contrôles de correspondance s’exécutent) ; le supprimer annule l’imputation.
• Respectez les dates de clôture — les opérations d’écriture dans des livres clôturés sont refusées ; votre intégration doit dater les documents dans des périodes ouvertes, comme le ferait tout comptable.
• L’idempotence vous incombe — la clé naturelle est la référence de votre système source (placez-la dans le champ Référence et vérifiez-la avant l’insertion ; côté comptes fournisseurs, la validation des doublons sur la référence fournisseur vous y aide).

Erreurs courantes à éviter

Pour aller plus loin

1. API Bulk (import/export de données) — le même modèle à l’échelle d’une migration.
2. Présentation de l’API — le panorama complet.
3. Soldes d’ouverture et migration des données — le projet REST/Bulk par excellence.

Questions fréquentes