Supplier — Avantage
Entité unifiée Fournisseurs · entité native Avantage : FOURNI.DBF.
Page générée, ne pas éditer — voir la version du dataset pour la provenance.
Voir aussi : page Supplier · Acomba · QuickBooks Online · Sage 50 · Autotask · ProShop.
Opérations
| Opération | Statut | Champs exhaustifs | Flags | Limitations |
|---|---|---|---|---|
| EXTRACT (GET) | Supportée | non | Extraction SDK/TCP (ExtractFournisseurs) | |
| CREATE (POST) | Supportée | non | AvantageSDK_Supplier.CreateSupplier (SDK, requête W04) : requiert NoFournisseur et NomFournisseur | |
| UPDATE (PUT) | Supportée | non | AvantageSDK_Supplier.UpdateSupplier (SDK, requête W12) : requiert NoFournisseur ; Champs protégés par Avantage en modification (FDEB, FNUMTPS, FNUMTVQ, FGROS, FDATE, FBAL, FACM, FACA, FACD, FFLOT, FSOLRET, FDEVISE) : refusés ; Seuls les champs renseignés sont poussés ; « ! » remet un champ à zéro ; FINACTIF (EstActif) part toujours dans la requête | |
| DELETE (DELETE) | Non supportée | — |
Un champ absent du tableau est ? (inconnu), pas non supporté. En cas de doute, nous écrire.
NoFournisseur, NomFournisseur.
Les autres champs créables sont facultatifs.
Champs
| Champ unifié | Champ natif | CREATE | UPDATE | EXTRACT | FILTER | Requis | Note |
|---|---|---|---|---|---|---|---|
NoFournisseur | FNUM | OK | ~ | OK | eq, ne, contains | oui | Clé du fournisseur. Requis à la création ET à la modification, mais NON modifiable : en W12 il identifie la fiche à corriger (numéro positionnel) et Avantage le protège en écriture. |
NoUniqueSystemeSource | FNUM | X | X | OK | eq, ne, contains | ||
NomFournisseur | FNOM | OK | OK | OK | eq, ne, contains | oui | Requis à la création, optionnel en modification (non fourni = nom actuel conservé). |
EstActif | FINACTIF | OK | OK | OK | eq, ne | Booléen inversé : EstActif ↔ EstInactif (FINACTIF) ; conversion appliquée au filtre. bool NON nullable qui vaut true par défaut : FINACTIF part donc TOUJOURS dans la requête, et une fiche construite de zéro RÉACTIVE un fournisseur inactif. | |
Addresse | FADR | OK | OK | OK | eq, ne, contains | ||
Ville | FVIL | OK | OK | OK | eq, ne, contains | ||
CodePostal | FCOD | OK | OK | OK | eq, ne, contains | ||
Province | FPROV | OK | OK | OK | eq, ne, contains | ||
Pays | FPAYS | OK | OK | OK | eq, ne, contains | ||
NoEnregistrementTaxeFederale | FNUMTPS | OK | X | OK | eq, ne, contains | ||
NoEnregistrementTaxeProvinciale | FNUMTVQ | OK | X | OK | eq, ne, contains | ||
SiteWeb | FIP | OK | OK | OK | eq, ne, contains | ||
EmailPrincipal_Adresse | FEMAIL | OK | OK | OK | eq, ne, contains | ||
NomPersonneContact | FRESP | OK | OK | OK | eq, ne, contains | ||
DeviseParDefaut | FDEVISE | OK | X | OK | eq, ne, contains | ||
Telephone_Principal.Numero | FTEL | OK | OK | OK | — | FicheTelephonique TypeTel=Principal. | |
Telephone_3.Numero | FTELA | OK | OK | OK | — | ||
Telephone_4.Numero | FTELD | OK | OK | OK | — | ||
Telephone_Telecopieur.Numero | FTELF | OK | OK | OK | — | ||
ExpenseAccountNumber | FGLDEP1..5 | OK | OK | OK | — | 5 comptes GL (composite). | |
FournisseurPayerA_No | FGROS | OK | X | OK | eq, ne, contains | ||
TermeDePaiement_No | FCOND/FDELAI/FNJOUR/FCONDJR/FDELAIJR/FESCTAX | OK | OK | OK | — | Mapping composite (conditions de paiement). | |
InternalNotes | FLIGNE1..5 | OK | OK | OK | — | 5 lignes de notes (composite). | |
Langue | FFRA | OK | OK | OK | eq, ne | FFRA est un booléen Avantage (langue parlée = français). Converti en code ISO minuscule : T -> 'fr', F -> 'en'. Le filtre accepte le code ISO ou un booléen. | |
ComptePayable | FCAP | OK | OK | OK | eq, ne, contains | Numéro de G/L des comptes à payer. | |
NoClientLiaison | FCLIENT | X | X | OK | eq, ne, contains | Client associé (le même tiers vu de l'autre bord) ; pendant de CFOURNI sur la fiche client. LECTURE seule : le SDK accepte FCLIENT en écriture sans erreur mais n'établit jamais l'association — CreateSupplier/UpdateSupplier LÈVENT si ce champ est renseigné. | |
Telephone_Principal.Extension | FEXT | OK | OK | OK | — | Poste du téléphone 1. FicheTelephonique TypeTel=Principal. | |
ExtendedProperties.Adresse2 | FADR2 | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.CodePostalUS | FZIP | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Region | FREG | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.AutreProvinceDescription | FAUTPROV | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Cellulaire | FCELL | OK | OK | OK | eq, ne, contains | Ne peut pas aller dans ListeTelephonique : les 4 valeurs de TypeTelephone sont déjà prises. | |
ExtendedProperties.NoPort | FPORT | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Transport | FTRS | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Remarque | FREM | OK | OK | OK | eq, ne, contains | Distinct de InternalNotes, qui agrège FLIGNE1..5. | |
ExtendedProperties.MessagesAvertissement | MESSCODE | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.NotreNoClientChezFournisseur | FCLINO | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.ActiviteParDefaut | FDEFACT | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.DateDebutAffaires | FDEB | OK | X | OK | eq, ne, gt, ge, lt, le | ||
ExtendedProperties.DateDernierAchat | FDATE | X | X | OK | eq, ne, gt, ge, lt, le | Maintenu par Avantage : lecture seule (refusé en création). | |
ExtendedProperties.NoEntreprise | FNOENT | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.NoAssuranceSociale | FNAS | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.TypeEntite | FCODE | OK | OK | OK | eq, ne, gt, ge, lt, le | 1=Particulier, 3=Société, 4=Société de personnes. | |
ExtendedProperties.NiveauTaxeProvinciale | FNIVTAX | OK | OK | OK | eq, ne, gt, ge, lt, le | Niveau 1 à 21. | |
ExtendedProperties.T4A_NoEntreprise | FNOENT4A | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.T4A_NoIdentificationRevenuQuebec | FNORS | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.T4A_NomFamille | FNOMFAM | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.T4A_Prenom | FPRENOM | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.ModePaiement | FMODPAY | OK | OK | OK | eq, ne, gt, ge, lt, le | 1=virement bancaire, 2=chèque, 3=internet. | |
ExtendedProperties.ModePaiementParVirementBancaire | FMODEPAIE | OK | OK | OK | eq, ne | Ancien flag booléen, redondant avec FMODPAY. | |
ExtendedProperties.Banque_Institution | FINSTITUT | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Banque_Folio | FFOLIO | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Banque_Transit | FTRANSIT | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.NoGlRetenuesAPayer | FRAP | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.SoldeRetenuesAPayer | FSOLRET | X | X | OK | eq, ne, gt, ge, lt, le | Solde calculé par Avantage : lecture seule (refusé en création). | |
ExtendedProperties.EscompteVolume | FESCV | OK | OK | OK | eq, ne, gt, ge, lt, le | ||
ExtendedProperties.EscomptePublicite | FESCP | OK | OK | OK | eq, ne, gt, ge, lt, le | ||
ExtendedProperties.SoldeDu | FBAL | X | X | OK | eq, ne, gt, ge, lt, le | Solde calculé par Avantage : lecture seule (refusé en création). | |
ExtendedProperties.AchatsMois | FACM | X | X | OK | eq, ne, gt, ge, lt, le | Cumul calculé par Avantage : lecture seule (refusé en création). | |
ExtendedProperties.AchatsAnnee | FACA | X | X | OK | eq, ne, gt, ge, lt, le | Cumul calculé par Avantage : lecture seule (refusé en création). | |
ExtendedProperties.AchatsADate | FACD | X | X | OK | eq, ne, gt, ge, lt, le | Cumul calculé par Avantage : lecture seule (refusé en création). | |
ExtendedProperties.DebitFlottant | FFLOT | X | X | OK | eq, ne, gt, ge, lt, le | Calculé par Avantage : lecture seule (refusé en création). | |
ExtendedProperties.Responsable_ComptesFournisseurs_Nom | FCNAME1 | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Responsable_ComptesFournisseurs_Telephone | FCTEL1 | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Responsable_ComptesFournisseurs_Poste | FPOSTE1 | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Responsable_ComptesFournisseurs_Telecopieur | FCFAX1 | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Responsable_ComptesFournisseurs_Courriel | FCMAIL1 | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Responsable_Commandes_Nom | FCNAME2 | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Responsable_Commandes_Telephone | FCTEL2 | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Responsable_Commandes_Poste | FPOSTE2 | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Responsable_Commandes_Telecopieur | FCFAX2 | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Responsable_Commandes_Courriel | FCMAIL2 | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Responsable_Commandes_EnvoiParCourriel | FDOMAIL2 | OK | OK | OK | eq, ne | ||
ExtendedProperties.Responsable_Paiements_Nom | FCNAME3 | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Responsable_Paiements_Telephone | FCTEL3 | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Responsable_Paiements_Poste | FPOSTE3 | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Responsable_Paiements_Telecopieur | FCFAX3 | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Responsable_Paiements_Courriel | FCMAIL3 | OK | OK | OK | eq, ne, contains | ||
ExtendedProperties.Responsable_Paiements_EnvoiParCourriel | FDOMAIL3 | OK | OK | OK | eq, ne | ||
Fiche_DerniereModification | LASTUPD | X | X | OK | eq, ne, gt, ge, lt, le |
Axes : OK supporté · X non supporté · ~ partiel · DEPR déprécié · EXP expérimental · ? inconnu.
Opérateurs en syntaxe $filter : eq égal · ne différent · gt/ge plus grand (ou égal) · lt/le plus petit (ou égal) · in dans une liste (InList) · contains contient · startswith commence par · — non filtrable.
Notes
Fournisseur (FOURNI.DBF), extraction SDK/TCP. Tout champ mappé scalaire est filtrable côté TCP : eq/ne/contains (texte), eq/ne/gt/gte/lt/lte (dates), eq/ne (EstActif, converti) ; pas de in côté SDK. Les champs composites (ExpenseAccountNumber sur FGLDEP1..5, TermeDePaiement_No, InternalNotes sur FLIGNE1..5) restent non filtrables : plusieurs colonnes partagent un même chemin, donc un filtre ne porterait que sur la 1re. Les téléphones (sous-entités FicheTelephonique) ont un mapping présent (extraction OK, colonnes FTEL/FTELA/FTELD/FTELF) mais ne sont PAS filtrables : la lecture (ConvertAvantageSupplierToSolinfo) assigne chaque numéro via un switch sur le type (TypeTelephone), et comme filtre et projection de lecture partagent la même liste de mappings, un filtre ciblant un téléphone est explicitement rejeté par le code (ConvertReadRequestFilterToAvantage → NotSupportedException). CREATE via AvantageSDK_Supplier.CreateSupplier (requête W04) : NoFournisseur et NomFournisseur requis. Les deux écritures (W04 et W12) partagent la même construction de champs, donc les axes create et update d'un champ ne diffèrent QUE par les protections de W12 listées ci-dessous.
UPDATE via AvantageSDK_Supplier.UpdateSupplier (requête W12) : NoFournisseur requis, mais NON modifiable — un W12 identifie la fiche par un numéro positionnel quoté (…,FRN,"0000000ABC",FCHAMP="…"), pas par FNUM="…". Trois règles à connaître :
- Seuls les champs RENSEIGNÉS sont poussés ; les autres restent inchangés dans Avantage. Pour VIDER un champ, lui donner explicitement la valeur « ! » (symbole de remise à zéro d'Avantage).
- EstActif est un bool non nullable valant true par défaut : FINACTIF part toujours dans la requête, donc une fiche construite de zéro réactive un fournisseur inactif. Travailler à partir d'un EXTRACT.
- Les champs que la doc SDK déclare « Protégés (FRN) » (FNUM, FDEB, FNUMTPS, FNUMTVQ, FGROS, FDATE, FBAL, FACM, FACA, FACD, FFLOT, FSOLRET, FDEVISE) sont refusés AVANT l'envoi, avec un message nommant le champ fautif — Avantage rejetterait sinon la requête entière. Ils ne s'écrivent qu'à la création (W04).
Champs ExtendedProperties : les champs de FOURNI.DBF qui n'ont pas d'équivalent sur la classe Fournisseurs sont exposés dans son dictionnaire ExtendedProperties, sous le nom complet "ExtendedProperties.<clé>" en $select/$filter. Chacun déclare son TypeDeValeurExplicite dans le mapping (obligatoire : il n'y a aucune PropertyInfo à réfléchir), ce qui les rend filtrables normalement. La valeur lue est convertie selon ce type (string / decimal? / DateTime? / bool?), et non laissée en string brute. En CREATE comme en UPDATE, seules les clés fournies par l'appelant dans Fournisseurs.ExtendedProperties sont poussées ; les clés calculées par Avantage (SoldeDu, AchatsMois/Annee/ADate, DebitFlottant, SoldeRetenuesAPayer, DateDernierAchat) sont refusées explicitement. Les clés inconnues du mapping (dont les TERME_PAIEMENT_*, traitées à part) sont ignorées.
Non mappés volontairement : FWPASS (mot de passe web — donnée sensible), FTYPE et FLIMIT1..4 (usage futur), FDOMAIL1 (documenté "n/a" pour le fournisseur dans la structure NG10.5, contrairement à FDOMAIL2/FDOMAIL3).
fields_exhaustive: false.