API QuickBooks Online — factures clients

Lire et créer les factures clients 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é CustomerInvoice.

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

Lire les factures clients

Une requête GET sur /api/Entity/CustomerInvoice, 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/CustomerInvoice?$select=NoFacture,DateFacture,Description,NoteGlobaleExterne01,TotalFacture&$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/CustomerInvoice?$select=NoFacture,DateFacture,Description,NoteGlobaleExterne01,TotalFacture&$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/CustomerInvoice?$select=NoFacture,DateFacture,Description,NoteGlobaleExterne01,TotalFacture&$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/CustomerInvoice?$select=NoFacture,DateFacture,Description,NoteGlobaleExterne01,TotalFacture&$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/CustomerInvoice?$select=NoFacture,DateFacture,Description,NoteGlobaleExterne01,TotalFacture&$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 CustomerInvoice sur QuickBooks Online, et leurs opérateurs $filter :

Champ	Opérateurs
`NoUniqueSystemeSource`	`eq` `ne`
`NoFacture`	`eq` `ne`
`Référence`	`eq` `ne`
`DateFacture`	`eq` `ne` `gt` `ge` `lt` `le`

Créer des factures clients

Un POST sur la même adresse, avec l’élément en JSON (les champs obligatoires sur QuickBooks Online) :

HTTP

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

{
  "DateFacture": "2026-01-01"
}

Les champs

Champ	Lire	Créer	Modifier
`NoUniqueSystemeSource`	✓	—	—
`NoFacture`	✓	✓	—
`Référence`	✓	—	—
`DateFacture` requis	✓	✓	—
`Description`	✓	✓	—
`NoteGlobaleExterne01`	✓	✓	—
`TermePaiement`	✓	✓	—
`Devise`	✓	✓	—
`TotalFacture`	✓	—	—
`SousTypeTransaction`	✓	—	—
`Fiche_DerniereModification`	✓	—	—
`InfoClientFacturerA.NoClient`	—	✓	—
`InfoClientFacturerA.NoUniqueSystemeSource`	—	✓	—
`InfoClientFacturerA.Adresse`	✓	✓	—
`InfoClientFacturerA.Ville`	✓	✓	—
`InfoClientFacturerA.CodePostal`	✓	✓	—
`InfoClientFacturerA.Province`	✓	✓	—
`InfoClientFacturerA.Pays`	✓	✓	—
`InfoClientFacturerA.EmailPrincipal_Adresse`	✓	✓	—
`InfoClientLivrerA.Adresse`	✓	—	—
`InfoClientLivrerA.Ville`	✓	—	—
`InfoClientLivrerA.CodePostal`	✓	—	—
`InfoClientLivrerA.Province`	✓	—	—
`InfoClientLivrerA.Pays`	✓	—	—
`LigneFacture[].strNoProduit`	✓	✓	—
`LigneFacture[].strNoProduit_NoUniqueSystemeSource`	—	✓	—
`LigneFacture[].strNoGroupeProduit`	✓	✓	—
`LigneFacture[].QteFacture`	✓	✓	—
`LigneFacture[].PrixFinal`	✓	✓	—
`LigneFacture[].DescriptionLigne`	✓	✓	—
`LigneFacture[].Montant_SousTotalLigne`	✓	—	—
`LigneFacture[].Montant_TotalLigne`	✓	—	—
`LigneFacture[].NoGroupeTaxe`	—	✓	—
`LigneFacture[].NoProjet`	—	✓	—
`LigneFacture[].NoProjet_NoUniqueSystemeSource`	—	✓	—
`LigneFacture[].NoLigneFacture`	✓	—	—

Les mêmes factures clients, dans les autres logiciels

Même requête, même JSON : seule la compagnie change.