Conexio vitrine du développeur

API QuickBooks Online — transactions financières

Lire et créer les transactions financières de QuickBooks Online depuis votre application, par une simple requête HTTP : pas de SDK, pas d’ODBC. Conexio relaie l’appel vers QuickBooks Online et vous répond en JSON — entité FinancialTransaction.

✓ Lire (GET)✓ Créer (POST)✗ Modifier (PUT)

Lire les transactions financières

Une requête GET sur /api/Entity/FinancialTransaction, avec les modificateurs $select, $filter et $top. L’en-tête ALLOW_PAGINATION renvoie { Data, ResultsCount, TotalCount }.

HTTP
GET https://gateway.conexio.dev/api/Entity/FinancialTransaction?$select=NoFacture,DateFacture,NoteGlobaleExterne01,TermeDePaiement.NomTermeDePaiement,InfoClientFacturerA.NoClient&$filter=DateFacture ge '2026-01-01'&$top=10
Authorization: Basic base64(CODE_LICENCE:CLE_API)
COMPANY_CODE: VOTRE_COMPAGNIE
ALLOW_PAGINATION: true
curl
curl 'https://gateway.conexio.dev/api/Entity/FinancialTransaction?$select=NoFacture,DateFacture,NoteGlobaleExterne01,TermeDePaiement.NomTermeDePaiement,InfoClientFacturerA.NoClient&$filter=DateFacture%20ge%20'2026-01-01'&$top=10' \
  -u "$CONEXIO_LICENCE:$CONEXIO_API_KEY" \
  -H 'COMPANY_CODE: VOTRE_COMPAGNIE' \
  -H 'ALLOW_PAGINATION: true'
JavaScript (fetch)
const response = await fetch("https://gateway.conexio.dev/api/Entity/FinancialTransaction?$select=NoFacture,DateFacture,NoteGlobaleExterne01,TermeDePaiement.NomTermeDePaiement,InfoClientFacturerA.NoClient&$filter=DateFacture%20ge%20'2026-01-01'&$top=10", {
  headers: {
    Authorization: "Basic " + btoa(`${CODE_LICENCE}:${CLE_API}`),
    COMPANY_CODE: "VOTRE_COMPAGNIE",
    ALLOW_PAGINATION: "true",
  },
})
const { Data, TotalCount } = await response.json()
C# et Python
C# (HttpClient)
var http = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://gateway.conexio.dev/api/Entity/FinancialTransaction?$select=NoFacture,DateFacture,NoteGlobaleExterne01,TermeDePaiement.NomTermeDePaiement,InfoClientFacturerA.NoClient&$filter=DateFacture%20ge%20'2026-01-01'&$top=10");
request.Headers.Authorization = new AuthenticationHeaderValue("Basic",
    Convert.ToBase64String(Encoding.UTF8.GetBytes($"{codeLicence}:{cleApi}")));
request.Headers.Add("COMPANY_CODE", "VOTRE_COMPAGNIE");
request.Headers.Add("ALLOW_PAGINATION", "true");
var json = await (await http.SendAsync(request)).Content.ReadAsStringAsync();
Python (requests)
import requests

response = requests.get(
    "https://gateway.conexio.dev/api/Entity/FinancialTransaction?$select=NoFacture,DateFacture,NoteGlobaleExterne01,TermeDePaiement.NomTermeDePaiement,InfoClientFacturerA.NoClient&$filter=DateFacture%20ge%20'2026-01-01'&$top=10",
    auth=(CODE_LICENCE, CLE_API),
    headers={"COMPANY_CODE": "VOTRE_COMPAGNIE", "ALLOW_PAGINATION": "true"},
)
data = response.json()["Data"]

Filtrer

Les champs filtrables de FinancialTransaction sur QuickBooks Online, et leurs opérateurs $filter :

ChampOpérateurs
NoUniqueSystemeSourceeq ne
Référenceeq ne
DateFactureeq ne gt ge lt le
TotalFactureeq ne gt ge lt le

Créer des transactions financières

Un POST sur la même adresse, avec l’élément en JSON :

HTTP
POST https://gateway.conexio.dev/api/Entity/FinancialTransaction
Authorization: Basic base64(CODE_LICENCE:CLE_API)
COMPANY_CODE: VOTRE_COMPAGNIE
Content-Type: application/json

{
  "NoFacture": "VALEUR",
  "DateFacture": "2026-01-01",
  "NoteGlobaleExterne01": "VALEUR"
}

Les champs

ChampLireCréerModifier
NoUniqueSystemeSource✓——
NoFacture✓✓—
Référence———
DateFacture✓✓—
TotalFacture———
NoteGlobaleExterne01✓✓—
Devise✓✓—
CompteRecevable_No—✓—
TermeDePaiement.NomTermeDePaiement✓✓—
InfoClientFacturerA.NoClient✓✓—
InfoClientFacturerA.NoUniqueSystemeSource✓——
LigneFacture[].NoCompteGL✓✓—
LigneFacture[].NoCompteGL_NoUniqueSystemeSource✓——
LigneFacture[].PrixFinal✓✓—
LigneFacture[].DescriptionLigne✓✓—

Pour aller plus loin