Supplier — Acomba
Entité unifiée Fournisseurs · entité native Acomba : Supplier.
Page générée, ne pas éditer — voir la version du dataset pour la provenance.
Voir aussi : page Supplier · QuickBooks Online · Avantage · Sage 50 · Autotask · ProShop.
Opérations
| Opération | Statut | Champs exhaustifs | Flags | Limitations |
|---|---|---|---|---|
| EXTRACT (GET) | Supportée | non | Un seul filtre à la fois (Filters.Count > 1 => exception). ; Filtre sur Fiche_DerniereModification requiert Acomba >= 0036 (Supplier036 / Key_SuTimeModified), sinon exception. ; Pagination par Skip/Top via lecture par buffer sur index natif. | |
| CREATE (POST) | Supportée | non | ||
| UPDATE (PUT) | Supportée | non | ||
| 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 | SuNumber | OK | OK | OK | eq, in | oui | Clé d'affaires (PKey_SuNumber, index 1). Max 20 caractères. Changement de valeur en UPDATE géré via ChangeSupplierNumber lorsque la clé est NoUniqueSystemeSource (CardPos). |
NoUniqueSystemeSource | CardPos | OK | OK | OK | — | Clé alternative (CardPos Acomba). Interdit en CreateOnly (signifie que le fournisseur existe déjà). Le filtrage EXTRACT par CardPos est présent en code mort (commenté) -> non filtrable actuellement. | |
NomFournisseur | SuName | OK | OK | OK | — | oui | |
ComptePayable | SuAccountPayable | OK | OK | OK | — | ||
CompteRecevableNo | SuReceivable | OK | OK | OK | — | ||
Addresse | SuAddress | OK | OK | OK | — | ||
Ville | SuCity | OK | OK | OK | — | ||
CodePostal | SuPostalCode | OK | OK | OK | — | Validé (format CA X9X9X9 / US 99999) et normalisé (espaces retirés, majuscules) à l'écriture. | |
Pays | SuISOCountryCode | OK | OK | OK | — | Écriture : mappé en code ISO 2 lettres (CANADA->CA, USA/STATES->US, sinon 2 premières lettres). Défaut CA. | |
Province | SuProvince | X | X | OK | — | Lu seulement ; non poussé par UpdateInsertFournisseur. | |
EstActif | SuActive | OK | OK | OK | eq | Natif int 0/1. Filtre eq seulement (index actifs/inactifs 4/5). | |
TermeDePaiement_No | SuPaymentTermNumber | OK | OK | OK | — | ||
TermeDePaiement_NoUniqueSystemeSource | SuPaymentTermCP | X | X | OK | — | Lu seulement (CardPos du terme). En CREATE, SuPaymentTermCP n'est alimenté que depuis le fournisseur DEF. | |
NoCompteGLAchat | SuPurchaseAccountNumber | OK | OK | OK | — | À l'écriture, le compte GL est validé via Charter.GetFromPrimaryKey (erreur si introuvable). | |
NoCompteGLAchat_NoUniqueSystemeSource | SuPurchaseAccountCP | X | X | OK | — | Lu seulement (CardPos du compte d'achat). | |
FournisseurPayerA_No | SuPaidToNumber | X | X | OK | — | Fournisseur 'Payer à'. Lu seulement. | |
FournisseurPayerA_NoUniqueSystemeSource | SuPaidToCP | X | X | OK | — | Lu seulement. | |
NoClientLiaison | SuClientNumber | X | X | OK | — | Numéro de client lié. Lu seulement. | |
NomPersonneContact | SuCareOf | OK | OK | OK | — | ||
SiteWeb | SuWebAddress | OK | OK | OK | — | ||
Langue | SuLanguage | ~ | ~ | OK | — | EXTRACT : LCID natif converti en CultureInfo.DisplayName. ÉCRITURE : SuLanguage n'est pas alimenté depuis la propriété unifiée ; uniquement copié depuis le fournisseur DEF à la création. | |
EmailPrincipal_Adresse | SuEMail[EMail_One] | OK | OK | OK | — | ||
EmailPrincipal_Desc | SuEMailDescription[EMail_One] | OK | OK | OK | — | ||
EmailPrincipal_EstPublicite | SuBatchEMailActive[SBE_MailMerge, EMail_One] | OK | OK | X | — | Poussé à l'écriture (int 0/1) ; non relu par ConvertirFournisseurAcomba. | |
Email2_Adresse | SuEMail[EMail_Two] | OK | OK | OK | — | ||
Email2_Desc | SuEMailDescription[EMail_Two] | OK | OK | OK | — | ||
Email2_EstPublicite | SuBatchEMailActive[SBE_MailMerge, EMail_Two] | OK | OK | X | — | Poussé à l'écriture seulement. | |
Email3_Adresse | SuEMail[EMail_Three] | OK | OK | OK | — | ||
Email3_Desc | SuEMailDescription[EMail_Three] | OK | OK | OK | — | ||
Email3_EstPublicite | SuBatchEMailActive[SBE_MailMerge, EMail_Three] | OK | OK | X | — | Poussé à l'écriture seulement. | |
RepresentantNom | SuSalesRepName | OK | OK | OK | — | ||
RepresentantEmail | SuSalesRepEMail | OK | OK | OK | — | ||
RepresentantTelephone | SuSalesRepPhone | OK | OK | OK | — | ||
RepresentantTelephoneExt | SuSalesRepExtension | OK | OK | OK | — | ||
ListeTelephonique[].Numero | SuPhoneNumber[Ph_Number] | OK | OK | OK | — | Sous-objet collection (4 entrées). Types natifs indexés : Ph_Number (Principal), Ph_Fax (Fax), Ph_User1 (User1), Ph_User2 (User2). Description -> SuPhoneDescription, Extension -> SuPhoneExtention. Numéro normalisé (espaces/()-/ retirés) à l'écriture. | |
Fiche_DerniereModification | SuTimeModified | X | X | OK | ge, gt, le, lt | Horodatage système (lu via Supplier036.Key_SuTimeModified, index 6). Lecture et filtrage par plage seulement. Requiert Acomba >= 0036. |
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.
Expands (sous-objets extractibles)
| Expand unifié | Type natif | Statut | Note |
|---|---|---|---|
AccountPayableSettings | — | Supportée | QuerySettings.Expand contenant 'AccountPayableSettings' : les settings de compte payable sont résolus via AcombaSDK_AccountPayableConfig et attachés dans Fournisseurs.ExtendedProperties["AccountPayableSettings"] (clé = ComptePayable / ErpInternalId). Best-effort : ignoré silencieusement si l'extraction échoue. |
Notes
Dispatch (AcombaSDK_GlobalInterfacor.cs / AcombaSDK_ExtractManager.cs) : EntityType.Supplier. EXTRACT -> GetSupplier.ExtractByQuerySettings (classe GetSupplier définie dans Product/AcombaSDK_Product_Utils.cs). CREATE/UPDATE -> Supplier.SetSupplier.UpdateInsertFournisseur (Payables/SetSupplier.cs). DELETE non implémenté. DTO unifié : Fournisseurs ; objet natif COM : AcoSDK.Supplier (interface AcoSDK.ISupplier ; AcoSDK.Supplier036 pour le filtre date).
UPSERT par NoFournisseur (clé d'affaires) ou NoUniqueSystemeSource (CardPos). Le mode Create/Update est piloté par les headers HTTP globaux (If-None-Match = CREATE-only, If-Match = UPDATE-only), qui déterminent le CreateUpdateMode (CreateOnly / UpdateOnly / CreateOrUpdate). À la création, les valeurs par défaut (compte d'achat, terme de paiement CP, liste de prix, groupe de taxe, langue) sont copiées du fournisseur "DEF" si présent.
Filtrage EXTRACT (ListAllowedFilter, un seul filtre simultané) : NoFournisseur : eq, in Fiche_DerniereModification : gte, gt, lte, lt (Acomba >= 0036) EstActif : eq Tout autre champ => non filtrable ([]). Le filtre commenté sur NoUniqueSystemeSource (CardPos) est inactif.
La liste de champs n'est PAS exhaustive (fields_exhaustive: false) : un champ non listé est unknown, pas
unsupported. Source de vérité : ConvertirFournisseurAcomba (EXTRACT) et UpdateInsertFournisseur (CREATE/UPDATE).
Tous les noms natifs (sdk:) sont confirmés dans le code (membres AcoSDK.Supplier / ISupplier).