CustomerARInvoice — Acomba
Entité unifiée FicheTransactions · entité native Acomba : TransAR.
Page générée, ne pas éditer — voir la version du dataset pour la provenance.
Voir aussi : page CustomerARInvoice.
Opérations
| Opération | Statut | Champs exhaustifs | Flags | Limitations |
|---|---|---|---|---|
| EXTRACT (GET) | Supportée | non | Header InvoiceAR (clés) + GetCard TransAR. Lignes (LigneFacture) seulement si Expand=LigneFacture. ; Un seul filtre indexé à la fois, sauf paires NoFacture+NoClient et NoClient+DateFacture. ; Filtre NoFacture exige obligatoirement un filtre NoClient (eq) en complément. ; Filtres MontantNonPaye, Description, Référence, NoVendeur, NoTerritoire, SousTypeTransaction appliqués en post-extraction (en mémoire, non indexés). | |
| CREATE (POST) | Supportée | non | simulate ; auto_fetch: CompteRecevable | |
| UPDATE (PUT) | Non supportée | non | ||
| 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 |
|---|---|---|---|---|---|---|
NoFacture | InInvoiceNumber | OK | X | OK | eq, in | Numéro de facture. En filtre exige obligatoirement un filtre NoClient (eq). Auto-généré par Acomba si absent au CREATE. |
NoUniqueSystemeSource | CardPos | X | X | OK | eq, in, ge, gt, le, lt | CardPos Acomba (surrogate key). En CREATE renseigné en sortie après AddCard. Filtres de comparaison = scan de plage de CardPos. |
InfoClientFacturerA.NoClient | InCustomerSupplierNumber | OK | X | OK | eq | Filtre via NoClient (eq, index 5/6). Requis au CREATE (sinon MISSING_CUSTOMER); alimente MyCustomer.PKey_CuNumber et InCustomerSupplierNumber. |
DateFacture | InDate | OK | X | OK | ge, gt, le, lt | Date de transaction (index 4/6). |
Référence | InReference | OK | X | OK | eq, ne | Filtre post-extraction (en mémoire); supporte aussi Contains/DoesntContains, non mappables dans le vocabulaire fermé. |
Description | InDescription | OK | X | OK | eq, ne | Filtre post-extraction (en mémoire); supporte aussi Contains/DoesntContains, non mappables dans le vocabulaire fermé. |
CompteRecevable_No | InReceivableOffset | OK | X | OK | — | Compte recevable (offset). Utilisé par l'AUTOFETCH des lignes (ControlCustomer.CCARCharterNumber) pour résoudre le compte AR. |
NoProjet | InProjectNumber | OK | X | X | — | Projet d'entête poussé au CREATE; non relu dans Convertir_TransAR_FicheTransaction (entête). |
TotalFacture | InInvoiceTotal | OK | X | OK | — | EXTRACT lit InInvoiceTotal (signé). CREATE pousse InTransactionTotal en valeur absolue (1re ligne = total). |
SousTotalFacture | InInvoiceSubTotal | OK | X | OK | — | EXTRACT lit InInvoiceSubTotal (signé). CREATE pousse InTransactionSubTotal en valeur absolue. |
SousTypeTransaction | InTransactionType | X | X | OK | eq, in | EXTRACT : ToString() du TransARType. Type déduit au CREATE (TA_Credit si total<0 sinon TA_Invoice), non piloté par ce champ. Filtre post-extraction. |
Fiche_DerniereModification | InTimeModified | X | X | OK | ge, gt, le, lt | Horodatage système. Pas d'index Acomba : filtrage mécanique (fallback index 4). |
EstActif | InTransactionActive | X | X | OK | — | Calculé : InTransactionActive != 0 ET InStatus == 0. |
MontantNonPaye | — | X | X | ? | eq, ne, gt, ge, lt, le | Filtre post-extraction déclaré, mais aucun mapping de population vu dans Convertir_TransAR_FicheTransaction. |
NoVendeur | — | X | X | ? | eq, ne | Filtre post-extraction déclaré, mais non peuplé dans Convertir_TransAR_FicheTransaction. Aussi Contains/DoesntContains (hors vocabulaire). |
NoTerritoire | — | X | X | ? | eq, ne | Filtre post-extraction déclaré, mais non peuplé dans Convertir_TransAR_FicheTransaction. Aussi Contains/DoesntContains (hors vocabulaire). |
TypeDoc | — | X | X | OK | — | Fixé en dur à SI_ExtractContentType.TransactionAR à l'extraction. |
LigneFacture[].NoCompteGL | PACharterNumber[i] | OK | X | OK | — | Compte GL de l'affectation. Valeur 'AUTOFETCH' au CREATE = résolution auto du compte AR via CompteRecevable (ControlCustomer.CCARCharterNumber). |
LigneFacture[].PrixFinal | PAAmount[i] | OK | X | OK | — | Montant. Convention de signe TransAR inversée au CREATE (PAAmount = -PrixFinal); lu tel quel à l'extraction (négatif=Débit, positif=Crédit). |
LigneFacture[].DescriptionLigne | PADescription[i] | OK | X | OK | — | Au CREATE, repli sur Charter.ChDescription si vide. |
LigneFacture[].NoProjet | PAProjectNumber[i] | OK | X | OK | — | Projet de ligne (numéro textuel). CREATE : repli sur NoProjet d'entête si ligne et CP vides. |
LigneFacture[].NoProjet_NoUniqueSystemeSource | PAProjectCP[i] | OK | X | OK | — | CP projet de ligne (prioritaire sur NoProjet textuel au CREATE). |
LigneFacture[].NoCompteGL_NoUniqueSystemeSource | PACharterCP[i] | X | X | OK | — | CP du compte GL. Lecture seule. |
LigneFacture[].NoLigneFacture | — | X | X | OK | — | Index de poste (i) attribué à l'extraction. |
LigneFacture[].TypeLigne | — | X | X | OK | — | Déduit des drapeaux PAIsTax[i]/PAIsShipping[i] (LigneTaxes/LigneTransport/LigneAffectationComptable). |
LigneFacture[].Fiche_DerniereModification | InTimeModified | X | X | OK | — | Reprend l'horodatage de la transaction parente. |
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 |
|---|---|---|---|
LigneFacture | — | Supportée | Affectations comptables GL (TransAR.PA*), PAS des produits (FicheProduit=null). Toujours peuplé pour l'endpoint CustomerARInvoiceLine. |
InfoClientFacturerA | — | Supportée | Sous-objet client minimal par défaut (NoClient + CardPos); complet via lookup AcoSDK.Customer si demandé. Source: InInvoicedToCP/Number sinon InCustomerSupplierCP/Number. |
InfoClientLivrerA | — | Supportée | Sous-objet client minimal par défaut; complet via lookup AcoSDK.Customer. Source: InCustomerSupplierCP/Number. |
Notes
Vue COMPTABLE de la facture client (AcoSDK.TransAR / header InvoiceAR) : les lignes sont des affectations GL (NoCompteGL + montant), pas des produits. À distinguer de CustomerInvoice (facture-facturation, lignes = produits).
CREATE uniquement (CreateArInvoiceFromERPConnectorTask -> CreateArInvoice). Aucun UPDATE ni DELETE routé pour cette entité dans AcombaSDK_GlobalInterfacor.cs (le dispatch CustomerARInvoice appelle toujours la création). DELETE = unsupported (global SDK).
simulate : header SIMULATE_ONLY=TRUE (propagé par OERP_PushInvoice TestOnly:true) valide tout (client, comptes GL, totaux) sans appeler ReserveCardNumber/AddCard — rien n'est créé dans Acomba.
auto_fetch : une ligne avec NoCompteGL='AUTOFETCH' résout automatiquement le compte à recevoir via ControlCustomer.CCARCharterNumber[CompteRecevable].
Conventions CREATE : 1re ligne = total appliqué au compte recevable ; type déduit (TA_Credit si total directeur < 0, sinon TA_Invoice) ; signe PAAmount inversé (= -PrixFinal).
Liste de champs NON exhaustive (fields_exhaustive: false). 'sdk:' à null quand le membre natif AcoSDK n'est pas directement visible (sous-objets construits, champs calculés). Les filtres post-extraction Contains/DoesntContains existent dans le code mais sortent du vocabulaire fermé (eq/ne/in/gt/gte/lt/lte/startswith) et ne sont donc pas listés.