CustomerOrder — Acomba
Entité unifiée FicheTransactions · entité native Acomba : Invoicing036/Transaction030.
Page générée, ne pas éditer — voir la version du dataset pour la provenance.
Voir aussi : page CustomerOrder · Avantage · Sage 300.
Opérations
| Opération | Statut | Champs exhaustifs | Flags | Limitations |
|---|---|---|---|---|
| EXTRACT (GET) | Supportée | non | Un seul filtre par index Acomba a la fois (NoFacture, NoUniqueSystemeSource, DateFacture, Fiche_DerniereModification), sauf la paire NoFacture + CompteRecevable_No. ; Pagination Skip/Top supportee. La recherche par Fiche_DerniereModification exige une version recente d'Acomba (index 17, Key_InTimeModified). | |
| CREATE (POST) | Supportée | non | simulate | Numerotation des lignes : 990 lignes au total maximum pour les produits (991 a 998 sont reserves par Acomba aux taxes/frais de transport). Le total compte les lignes inscrites PLUS les lignes vides laissees par les trous de numerotation. Depuis v4.6.7, le SDK valide apres conversion et refuse avec un message explicite ; un document plus volumineux doit etre scinde. ; Pas de panachage (refuse depuis v4.6.7) : soit TOUTES les lignes de produits portent un NoLigneFacture, soit AUCUNE. Motif : pour une ligne laissee a 0, le SDK assigne la POSITION de la ligne dans la liste, pas le prochain numero libre - melanger les deux styles fait collisionner les numeros. |
| UPDATE (PUT) | Supportée | non | Meme validation des numeros de lignes qu'au CREATE (990 lignes au total, numeros uniques, v4.6.7). | |
| 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 | Valeurs permises | Note |
|---|---|---|---|---|---|---|---|
NoFacture | PKey_InInvoiceNumber | OK | OK | OK | eq, in | Cle metier (numero de document). En CREATE, sur une commande, le numero est auto-assigne via ReserveCardNumber si absent. Fetch direct par NoFacture (+ CompteRecevable_No optionnel). | |
NoUniqueSystemeSource | CardPos | X | OK | OK | eq, in | Cle surrogate (CardPos Acomba). Sert de cle d'identification pour l'UPDATE (UpdateTransaction -> ReserveCard). Genere par Acomba a la creation. | |
CompteRecevable_No | PKey_InReceivable | X | X | ~ | eq | Utilisable uniquement en complement du filtre NoFacture (paire NoFacture + CompteRecevable_No). Defaut 0 si non fourni. | |
DateFacture | Key_InDate | OK | OK | OK | ge, gt, le, lt | Filtre par plage de dates (index 6). Sert de balise min/max lors de l'extraction. | |
Fiche_DerniereModification | Key_InTimeModified | X | X | OK | ge, gt, le, lt | Horodatage systeme. Lecture et filtrage par plage seulement (index 17). Requiert une version recente d'Acomba. | |
MontantNonPaye | — | X | X | OK | eq, ne, gt, ge, lt, le | Solde. Filtre post-extraction (applique en memoire apres lecture Acomba). Renseigne via l'expand ListeReglement. | |
Description | — | OK | OK | OK | eq, ne | Filtre post-extraction (en memoire). Operateurs Contains/DoesntContains aussi geres dans le code mais sans token dans le vocabulaire ferme. | |
Référence | — | OK | OK | OK | eq, ne | Filtre post-extraction (en memoire). | |
NoVendeur | — | OK | OK | OK | eq, ne | Filtre post-extraction (en memoire). | |
NoTerritoire | — | OK | OK | OK | eq, ne | Filtre post-extraction (en memoire). | |
SousTypeTransaction | — | OK | OK | OK | — | INVOICE_AR | La valeur 'INVOICE_AR' shunte la machinerie commande/taxes vers une creation TransAR directe (voir CustomerARInvoice). |
TypeDoc | Key_InInvoiceType | OK | OK | OK | — | Commandes | Type de document. Pour CustomerOrder, mappe a AcoSDK.InvoicingType.ITp_Order (Commande). |
TotalFacture | — | X | X | OK | — | Calcule par Acomba (taxes incluses). | |
SousTotalFacture | — | X | X | OK | — | Calcule par Acomba. | |
NoCommandeRéférence_NoUniqueSystemeSource | — | OK | X | OK | — | CardPos d'une commande/soumission liee, pour la conversion commande->facture (OrderToInvoice). | |
LigneFacture[] | — | OK | OK | OK | — | Collection de lignes (LigneTransactions). Prix recherche selon le client si PrixFinal/PrixOrig absents; qtes par defaut gerees a la creation. | |
InfoClientFacturerA | — | OK | OK | OK | — | Facturer a (sous-objet client). Si seul NoClient fourni, les coordonnees sont forcees depuis Acomba. | |
InfoClientLivrerA | — | OK | OK | OK | — | Livrer a (sous-objet client). Si seul NoClient fourni, les coordonnees sont forcees depuis Acomba. |
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 |
|---|---|---|---|
ListeReglement | — | Supportée | Va chercher les paiements (ARPayment) et recalcule MontantNonPaye. |
ProductGroup_PurchaseGlAccount | PGPurchaseAccountNumber | Supportée | Ajoute les comptes GL d'achat des groupes de produits aux lignes. |
Notes
CustomerOrder fait partie de la famille de transactions (CustomerInvoice / CustomerOrder / CustomerBid / SupplierOrder) routee de facon UNIFIEE : EXTRACT -> GetInvoices.ExtractByQuerySettings, CREATE/UPDATE -> SetInvoices.CreateTransactionFromERPConnectorTask. Le type Acomba est determine par EntityType (CustomerOrder -> InvoicingType.ITp_Order). L'objet natif n'est pas une classe dediee : c'est l'interface COM Invoicing036 (entete/index) + Transaction030 (detail), filtree par InvoicingType.
CREATE : le payload est enveloppe { "FACTURE": {<FicheTransactions>}, "ListeModePaiements": [...] }. Les paiements ne s'appliquent qu'aux Factures, pas aux Commandes. Le mode simulation (header/param *SIMULATE_ONLY = true) calcule les taxes/totaux sans creer dans Acomba. Gestion BACK-ORDER : une commande de back-order peut etre generee (NoCommande_BackOrder dans ExtendedProperties), son numero est rapporte dans le message de resultat.
UPDATE : via UpdateTransaction (ReserveCard sur NoUniqueSystemeSource/CardPos). Le changement de
NoFacture n'est pas permis par l'API.
DELETE : global au SDK -> NotImplementedException.
Liste de champs NON exhaustive (fields_exhaustive: false) : un champ non liste reste unknown.
Les noms natifs (sdk:) des champs non mappes a une cle d'index COM directe sont null (conversion
effectuee dans Invoice_Utils.ConvertirLaTransactionAcomba / Convertir_FicheTransactionSolinfo_Vers_TransactionAcomba).