API Sage 300 — adresses clients

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

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

Lire les adresses clients

Une requête GET sur /api/Entity/CustomerAddress, 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/CustomerAddress?$select=ErpInternalId,CustomerId,Code,Id,IsActive&$filter=LastModifiedDate 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/CustomerAddress?$select=ErpInternalId,CustomerId,Code,Id,IsActive&$filter=LastModifiedDate%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/CustomerAddress?$select=ErpInternalId,CustomerId,Code,Id,IsActive&$filter=LastModifiedDate%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/CustomerAddress?$select=ErpInternalId,CustomerId,Code,Id,IsActive&$filter=LastModifiedDate%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/CustomerAddress?$select=ErpInternalId,CustomerId,Code,Id,IsActive&$filter=LastModifiedDate%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 CustomerAddress sur Sage 300, et leurs opérateurs $filter :

Champ	Opérateurs
`CustomerId`	`eq` `ne` `contains`
`Code`	`eq` `ne` `contains`
`Id`	`eq` `ne` `contains`
`IsActive`	`eq` `ne`
`IsPrimary`	`eq` `ne`
`LastModifiedDate`	`eq` `ne` `gt` `ge` `lt` `le`
`Description`	`eq` `ne` `contains`
`AddressLine1`	`eq` `ne` `contains`
`AddressLine2`	`eq` `ne` `contains`
`AddressLine3`	`eq` `ne` `contains`
`AddressLine4`	`eq` `ne` `contains`
`City`	`eq` `ne` `contains`
`State`	`eq` `ne` `contains`
`Country`	`eq` `ne` `contains`
`PostalCode`	`eq` `ne` `contains`
`Territory`	`eq` `ne` `contains`
`ExtendedProperties.ContactName`	`eq` `ne` `contains`
`ExtendedProperties.PhoneNumber`	`eq` `ne` `contains`
`ExtendedProperties.FaxNumber`	`eq` `ne` `contains`
`ExtendedProperties.Email`	`eq` `ne` `contains`
`ExtendedProperties.ContactsPhone`	`eq` `ne` `contains`
`ExtendedProperties.ContactsFax`	`eq` `ne` `contains`
`ExtendedProperties.ContactsEmail`	`eq` `ne` `contains`
`ExtendedProperties.TaxGroup`	`eq` `ne` `contains`
`ExtendedProperties.SpecialInstructions`	`eq` `ne` `contains`
`ExtendedProperties.ShipViaCode`	`eq` `ne` `contains`
`ExtendedProperties.ShipViaDescription`	`eq` `ne` `contains`
`ExtendedProperties.CustomerPriceList`	`eq` `ne` `contains`
`ExtendedProperties.FreeOnBoard`	`eq` `ne` `contains`
`ExtendedProperties.InventoryLocation`	`eq` `ne` `contains`
`ExtendedProperties.Salesperson1`	`eq` `ne` `contains`

Créer des adresses clients

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

HTTP

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

{
  "CustomerId": "VALEUR",
  "Code": "VALEUR",
  "IsActive": true
}

Les champs

Champ	Lire	Créer	Modifier
`ErpInternalId`	✓	—	—
`CustomerId`	✓	✓	✓
`Code`	✓	✓	✓
`Id`	✓	—	—
`IsActive`	✓	✓	✓
`IsPrimary`	✓	✓	✓
`LastModifiedDate`	✓	—	—
`Description`	✓	✓	✓
`AddressLine1`	✓	✓	✓
`AddressLine2`	✓	✓	✓
`AddressLine3`	✓	✓	✓
`AddressLine4`	✓	✓	✓
`City`	✓	✓	✓
`State`	✓	✓	✓
`Country`	✓	✓	✓
`PostalCode`	✓	✓	✓
`Territory`	✓	✓	✓
`ExtendedProperties.ContactName`	✓	✓	✓
`ExtendedProperties.PhoneNumber`	✓	✓	✓
`ExtendedProperties.FaxNumber`	✓	✓	✓
`ExtendedProperties.Email`	✓	✓	✓
`ExtendedProperties.ContactsPhone`	✓	✓	✓
`ExtendedProperties.ContactsFax`	✓	✓	✓
`ExtendedProperties.ContactsEmail`	✓	✓	✓
`ExtendedProperties.TaxGroup`	✓	✓	✓
`ExtendedProperties.SpecialInstructions`	✓	✓	✓
`ExtendedProperties.ShipViaCode`	✓	✓	✓
`ExtendedProperties.ShipViaDescription`	✓	—	—
`ExtendedProperties.CustomerPriceList`	✓	✓	✓
`ExtendedProperties.FreeOnBoard`	✓	✓	✓
`ExtendedProperties.InventoryLocation`	✓	✓	✓
`ExtendedProperties.Salesperson1`	✓	✓	✓

Pour aller plus loin

CustomerAddress sur Sage 300 : la matrice complète (docs.conexio.dev)
Filtrer ($filter) · Paginer · S’authentifier
Toutes les entités de l’API Sage 300
Le connecteur Sage 300 sur conexio.dev