Conexio vitrine du développeur

API Acomba — commandes fournisseurs

Lire, créer et modifier les commandes fournisseurs de Acomba depuis votre application, par une simple requête HTTP : pas de SDK, pas d’ODBC. Conexio relaie l’appel vers Acomba et vous répond en JSON — entité SupplierOrder.

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

Lire les commandes fournisseurs

Une requête GET sur /api/Entity/SupplierOrder, 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/SupplierOrder?$select=NoFacture,DateFacture,EstActif,Description,DateExpirationDocument&$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/SupplierOrder?$select=NoFacture,DateFacture,EstActif,Description,DateExpirationDocument&$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/SupplierOrder?$select=NoFacture,DateFacture,EstActif,Description,DateExpirationDocument&$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/SupplierOrder?$select=NoFacture,DateFacture,EstActif,Description,DateExpirationDocument&$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/SupplierOrder?$select=NoFacture,DateFacture,EstActif,Description,DateExpirationDocument&$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 SupplierOrder sur Acomba, et leurs opérateurs $filter :

ChampOpérateurs
NoFactureeq in
NoUniqueSystemeSourceeq in
CompteRecevable_Noeq
DateFacturege gt le lt
Fiche_DerniereModificationge gt le lt
Référenceeq ne

Créer des commandes fournisseurs

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

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

{
  "TypeDoc": "VALEUR"
}

Les champs

ChampLireCréerModifier
NoFacture✓✓✓
NoUniqueSystemeSource✓✓✓
CompteRecevable_No✓✓—
TypeDoc requis✓✓✓
SousTypeTransaction✓——
DateFacture✓✓✓
Fiche_DerniereModification✓——
EstActif✓——
Référence✓✓✓
Description✓✓✓
DateExpirationDocument✓✓✓
SousTotalFacture✓——
TotalFacture✓——
MontantNonPaye✓——
FraisDeTransport✓✓✓
Montant_MonnaieRecu✓✓✓
Montant_Retrait—✓✓
Montant_ChangeRemit—✓✓
NoVendeur✓✓✓
NoVendeur_NoUniqueSystemeSource✓✓✓
NoTerritoire✓✓✓
NoTerritoire_NoUniqueSystemeSource✓✓✓
NoProjet✓✓✓
NoProjet_NoUniqueSystemeSource✓✓✓
NoModeExpedition_NoUniqueSystemeSource✓——
NoSoumissionRéférence✓✓✓
NoCommandeRéférence✓✓✓
NoCommandeRéférence_NoUniqueSystemeSource—✓✓
CodeUsagerCreation✓——
TermeDePaiement.NoTermeDePaiement✓✓✓
InfoClientFacturerA.NoClient✓✓✓
InfoClientFacturerA.NoUniqueSystemeSource✓✓✓
InfoClientFacturerA.NomClient✓✓✓
InfoClientFacturerA.Adresse✓✓✓
InfoClientFacturerA.Ville✓✓✓
InfoClientFacturerA.CodePostal✓✓✓
InfoClientFacturerA.Pays✓✓✓
InfoClientFacturerA.NomPersonneContact✓✓✓
InfoClientFacturerA.ListeTelephonique[].Numero✓✓✓
InfoClientLivrerA.NoClient✓✓✓
InfoClientLivrerA.NoUniqueSystemeSource✓✓✓
InfoClientLivrerA.NomClient✓✓✓
InfoClientLivrerA.Adresse✓✓✓
InfoClientLivrerA.Ville✓✓✓
InfoClientLivrerA.CodePostal✓✓✓
InfoClientLivrerA.Pays✓✓✓
InfoClientLivrerA.NomPersonneContact✓✓✓
InfoClientLivrerA.ListeTelephonique[].Numero✓✓✓
LigneFacture[].strNoProduit✓✓✓
LigneFacture[].strNoProduit_NoUniqueSystemeSource✓✓✓
LigneFacture[].strNoGroupeProduit✓✓✓
LigneFacture[].strNoGroupeProduit_NoUniqueSystemeSource✓✓✓
LigneFacture[].DescriptionLigne✓✓✓
LigneFacture[].QteCommande✓✓✓
LigneFacture[].QteFacture✓✓✓
LigneFacture[].PrixOrig✓✓✓
LigneFacture[].PrixFinal✓✓✓
LigneFacture[].PrixCoutant✓✓✓
LigneFacture[].MontantRabais_pct✓✓✓
LigneFacture[].NoProduitFournisseur_NoUniqueSystemeSource✓✓✓
LigneFacture[].NoProjet_NoUniqueSystemeSource✓✓✓
LigneFacture[].NoSerieProduit_NoUniqueSystemSource✓✓✓
LigneFacture[].MustHideInvoicingLineToFinalPrinting—✓✓

Les mêmes commandes fournisseurs, dans les autres logiciels

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

Pour aller plus loin