Customer — Autotask
Entité unifiée FicheClient · entité native Autotask : Company.
Page générée, ne pas éditer — voir la version du dataset pour la provenance.
Voir aussi : page Customer · Acomba · QuickBooks Online · Avantage · Sage 300 · ProShop.
Opérations
| Opération | Statut | Champs exhaustifs | Flags | Limitations |
|---|---|---|---|---|
| EXTRACT (GET) | Supportée | non | Lecture depuis AutoTask (Companies, CompanyType=1) ; Aussi via le pont ERPConnectorTask (TaskType.EXTRACT) ; Pagination AutoTask 500/page ; skip > 10000 refusé | |
| CREATE (POST) | Partielle | — | Écriture via SYNC ERP→AutoTask (upsert : lookup par CompanyNumber ou UDF ERPInternalId, puis POST/PATCH) ; En mode UseAccountIdForCustomerNumbering, création impossible sans correspondance existante | |
| UPDATE (PUT) | Partielle | — | Idem CREATE : upsert par SYNC (PATCH si trouvé) | |
| DELETE (DELETE) | Non supportée | — |
Un champ absent du tableau est ? (inconnu), pas non supporté. En cas de doute, nous écrire.
Champs
| Champ unifié | Champ natif | CREATE | UPDATE | EXTRACT | FILTER | Note |
|---|---|---|---|---|---|---|
NoUniqueSystemeSource | Id | X | X | OK | eq, ne, in, gt, ge | Id système AutoTask (long). Clé, non écrite (utilisée pour le PATCH). |
NoUniqueSystemeExterne | UserDefinedFields.ERPConnector_ERPInternalId | OK | OK | OK | eq | UDF de liaison vers l'ID interne ERP. Filtre mono-valeur (bug AutoTask sur UDF multiples). |
NoClient | CompanyNumber | OK | OK | OK | eq, ne, in, contains | Clé métier quand UseAccountIdForCustomerNumbering=false. |
NomClient | CompanyName | OK | OK | OK | eq, ne, in, contains, startswith | Obligatoire. |
Adresse | Address1 | OK | OK | OK | eq, ne, contains | |
Adresse2 | Address2 | OK | OK | OK | eq, ne, contains | |
Ville | City | OK | OK | OK | eq, ne, contains | |
Province | State | OK | OK | OK | eq, ne | |
CodePostal | PostalCode | OK | OK | OK | eq, ne, contains | Sert à déduire la province pour le Canada. |
Pays | Country.CountryCode (lookup CountryID) | OK | OK | OK | eq | Résolu via un lookup Country (CountryID). |
Telephone_Principal.Numero | Phone | OK | OK | OK | contains | Obligatoire ; défaut '999-999-9999' si vide. |
Telephone_Telecopieur.Numero | Fax | OK | OK | OK | — | |
Telephone_3.Numero | AlternatePhone1 | OK | OK | OK | — | |
Telephone_4.Numero | AlternatePhone2 | OK | OK | OK | — | |
SiteWeb | WebAddress | OK | OK | OK | — | |
CommentairesClients | Notes | OK | OK | OK | — | |
EstActif | IsActive | OK | OK | OK | eq, ne | |
Fiche_DerniereModification | lastTrackedModifiedDateTime | X | X | OK | ge, le, gt, lt | Audit, lecture seule côté AutoTask. |
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
Client = AutoTaskCompanies (CompanyType=1). EXTRACT depuis AutoTask (+ pont ERPConnectorTask). Écriture ERP→AutoTask par SYNC (upsert) : lookup par CompanyNumber (ou UDF ERPConnector_ERPInternalId), puis PATCH ou POST. En mode UseAccountIdForCustomerNumbering=true, la création d'un nouveau client est refusée sans correspondance existante. Champs forcés à l'écriture non mappés côté unifié : TaxRegionId (='QUÉBEC'), OwnerResourceID (DefaultOwnerResourceId). CompanyID=0 (société interne AutoTask) est exclu.
Rappel : CREATE/UPDATE = écriture par SYNC (upsert par lot), pas un CRUD unitaire. fields_exhaustive: false.