Conexio vitrine du développeur

API Avantage — factures clients

Lire les factures clients de Avantage depuis votre application, par une simple requête HTTP : pas de SDK, pas d’ODBC. Conexio relaie l’appel vers Avantage 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,NoCommandeRéférence_NoUniqueSystemeSource,NoCommandeRéférence,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,NoCommandeRéférence_NoUniqueSystemeSource,NoCommandeRéférence,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,NoCommandeRéférence_NoUniqueSystemeSource,NoCommandeRéférence,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,NoCommandeRéférence_NoUniqueSystemeSource,NoCommandeRéférence,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,NoCommandeRéférence_NoUniqueSystemeSource,NoCommandeRéférence,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 Avantage, et leurs opérateurs $filter :

ChampOpérateurs
NoFactureeq ne contains
NoUniqueSystemeSourceeq ne contains
DateFactureeq ne gt ge lt le
NoCommandeRéférence_NoUniqueSystemeSourceeq ne contains
NoCommandeRéférenceeq ne contains
TotalFactureeq ne gt ge lt le
SousTotalFactureeq ne gt ge lt le
Descriptioneq ne contains
NoProjeteq ne contains
InfoClientFacturerA.NoClienteq ne contains
InfoClientFacturerA.NomClienteq ne contains
InfoClientFacturerA.Provinceeq ne contains
InfoClientFacturerA.Villeeq ne contains
InfoClientFacturerA.Adresseeq ne contains
InfoClientLivrerA.NoClienteq ne contains
InfoClientLivrerA.NomClienteq ne contains
InfoClientLivrerA.Provinceeq ne contains
InfoClientLivrerA.Villeeq ne contains
InfoClientLivrerA.Adresseeq ne contains
Fiche_DerniereModificationeq ne gt ge lt le

Les champs

ChampLireCréerModifier
NoFacture✓——
NoUniqueSystemeSource✓——
DateFacture✓——
NoCommandeRéférence_NoUniqueSystemeSource✓——
NoCommandeRéférence✓——
TotalFacture✓——
SousTotalFacture✓——
Description✓——
NoProjet✓——
InfoClientFacturerA.NoClient✓——
InfoClientFacturerA.NomClient✓——
InfoClientFacturerA.Province✓——
InfoClientFacturerA.Ville✓——
InfoClientFacturerA.Adresse✓——
InfoClientLivrerA.NoClient✓——
InfoClientLivrerA.NomClient✓——
InfoClientLivrerA.Province✓——
InfoClientLivrerA.Ville✓——
InfoClientLivrerA.Adresse✓——
Fiche_DerniereModification✓——

Les mêmes factures clients, dans les autres logiciels

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

Pour aller plus loin