CustomerInvoice — Acomba GO
Entité unifiée FicheTransactions · entité native Acomba GO : customertransaction.
Page générée, ne pas éditer — voir la version du dataset pour la provenance.
Voir aussi : page CustomerInvoice · Acomba · QuickBooks Online · Avantage · Autotask · ProShop.
Opérations
| Opération | Statut | Champs exhaustifs | Flags | Limitations |
|---|---|---|---|---|
| EXTRACT (GET) | Supportée | non | Facture client AVEC items (= Invoicing d'Acomba) : LigneFacture[] = PRODUITS ; Retourne les 4 types (soumission/commande/facture/crédit) — filtrer sur SousTypeTransaction eq Soumission|Commande|Facture|Credit ; Scan Synch complet + filtrage C# | |
| CREATE (POST) | Supportée | non | Validé contre l'API réelle 2026-09-15 (facture 4 lignes, taxes TPS+TVQ) ; Requis : DateFacture (dans un exercice existant), client (InfoClientFacturerA.NoClient ou .NoUniqueSystemeSource), LigneFacture[] avec strNoProduit (code item) ou strNoProduit_NoUniqueSystemeSource, QteFacture, PrixFinal (prix UNITAIRE) ; Type : ExtendedProperties[AcombaGo_TransactionType] 0 soumission / 1 commande / 2 facture (défaut) / 3 crédit ; non modifiable ; Vendeur (requis côté ACCEO) : ExtendedProperties[AcombaGo_SellerId] ou NoVendeur_NoUniqueSystemeSource, sinon vendeur du client, sinon 1er user isSeller actif ; Groupe de taxes : ExtendedProperties[AcombaGo_TaxGroupId], sinon celui du client, sinon le groupe par défaut ; TAXES, SOUS-TOTAUX ET TOTAL CALCULÉS PAR LE SDK (taux du groupe, taxe sur taxe via appliedOnTaxCodeId) — l'API ne recalcule rien ; Adresses invoicedTo/deliveredTo (objets complets requis) : construites depuis InfoClientFacturerA / InfoClientLivrerA avec repli sur la fiche client AcombaGo ; province = celle du client ou la 1re province ; NoFacture (transactionNumber) est assigné par AcombaGo — mettre sa clé externe dans Référence (referenceNumber, 20) ; Ligne TypeLigne=LigneSysteme (ou sans produit ni quantité) = ligne de commentaire | |
| UPDATE (PUT) | Supportée | non | Read-merge-write : Detail frais → merge → POST avec id + modifDate/modifTime ; Lignes REMPLACÉES EN BLOC ; type, date, heure et client facturé non modifiables (UPDNOTALLOW) ; Blocages ACCEO : TRX_CLOSED, TRX_PAYMENT (paiements), TRX_RECONCILED, TRXDTL_INVOICED | |
| DELETE (DELETE) | Non supportée | — |
Un champ absent du tableau est ? (inconnu), pas non supporté. En cas de doute, nous écrire.
InfoClientFacturerA.NoClient, LigneFacture[].strNoProduit.
Les autres champs créables sont facultatifs.
Champs
| Champ unifié | Champ natif | CREATE | UPDATE | EXTRACT | FILTER | Requis | Note |
|---|---|---|---|---|---|---|---|
NoFacture | transactionNumber | X | X | OK | eq, in | Assigné par AcombaGo (auto). Résout l'update avec le type. | |
NoUniqueSystemeSource | id | X | X | OK | eq, in | ||
SousTypeTransaction | transactionType | X | X | OK | eq | Soumission / Commande / Facture / Credit. En écriture : ExtendedProperties[AcombaGo_TransactionType]. | |
TypeDoc | transactionType | X | X | OK | — | Soumissions / Commandes / Factures. | |
DateFacture | transactionDate + transactionTime (hh:mm, 08:00 si minuit) | OK | X | OK | gt, ge, lt, le | ||
Référence | referenceNumber | OK | OK | OK | — | Max 20 — la clé externe recommandée. | |
Description | comment | OK | OK | OK | — | Max 500. | |
NoCommandeRéférence | poNumber | OK | OK | OK | — | Max 25 (aussi ExtendedProperties[AcombaGo_PoNumber]). | |
InfoClientFacturerA.NoClient | invoicedTo.itCustomerId (résolu par Search number) / itNumber en lecture | OK | X | OK | — | oui | |
InfoClientFacturerA.NoUniqueSystemeSource | invoicedTo.itCustomerId | OK | X | OK | eq | ||
InfoClientFacturerA.Adresse/Ville/CodePostal/NomPersonneContact | invoicedTo.itAddress/itCity/itPostalCode/itContactName | OK | OK | OK | — | Repli sur la fiche client AcombaGo si vides. | |
InfoClientLivrerA.* | deliveredTo.dt* (dtCustomerId = client facturé, ou ExtendedProperties[AcombaGo_DeliveredToId]) | OK | OK | OK | — | NomClient → dtName (chaîne vide interdite côté ACCEO : ignorée). | |
NoVendeur_NoUniqueSystemeSource | sellerId | OK | OK | OK | — | Requis côté ACCEO ; repli automatique (voir CREATE). | |
TermeDePaiement.NoTermeDePaiement_NoUniqueSystemeSource | termId | OK | OK | OK | — | Repli sur le terme du client. | |
SousTotalFacture | subTotal2 | ~ | ~ | OK | — | CALCULÉ en écriture. Signé (négatif pour un crédit) en lecture. | |
TotalFacture | total | ~ | ~ | OK | — | CALCULÉ en écriture (sous-total + taxes + transport + taxes transport). | |
FraisDeTransport | shippingAmount (+ shippingTaxAmount1..3 calculés) | OK | OK | OK | — | ||
MontantNonPaye | balanceDue | X | X | OK | — | ||
ListeDesTaxes[] | taxAmount1..3 / taxRate1..3 | ~ | ~ | OK | — | Taxe_Numero = position (1..3), Taxe_Description = taux. En écriture, ignoré : recalculé. | |
LigneFacture[].strNoProduit | trxDetail[].dtlCode (+ dtlItemId résolu par item.code) | OK | OK | OK | — | oui | Ou strNoProduit_NoUniqueSystemeSource (dtlItemId direct). |
LigneFacture[].DescriptionLigne | trxDetail[].dtlDescription | OK | OK | OK | — | Max 60 ; repli sur la description FR de l'item. | |
LigneFacture[].QteFacture | trxDetail[].dtlQuantity | OK | OK | OK | — | 1 si 0. | |
LigneFacture[].PrixFinal | trxDetail[].dtlUnitPrice | OK | X | OK | — | Prix UNITAIRE. dtlUnitPrice non modifiable à l'update (UPDNOTALLOW). | |
LigneFacture[].MontantRabais / MontantRabais_pct | trxDetail[].dtlDiscountAmount / dtlDiscountPercentage | OK | OK | OK | — | ||
LigneFacture[].Montant_TotalLigne | trxDetail[].dtlTotal | ~ | ~ | OK | — | Calculé (qté × prix − rabais) si 0. | |
LigneFacture[].Montant_Unitaire_Taxe1..3 | trxDetail[].dtlTaxAmount1..3 | ~ | ~ | OK | — | CALCULÉS en écriture (taux du groupe). ⚠️ Nom unifié « unitaire » mais valeur = taxe de la LIGNE (comme AcombaSDK). | |
LigneFacture[].NoCompteGL_NoUniqueSystemeSource | trxDetail[].dtlSalesAccountId | OK | OK | OK | — | Cascade ACCEO si absent : item > catégorie > livraison > client > compagnie. | |
LigneFacture[].TypeLigne | trxDetail[].dtlItemId (null = commentaire) | OK | OK | OK | — | LigneSysteme = ligne de commentaire, LigneStandard = item. | |
LigneFacture[].MustHideInvoicingLineToFinalPrinting | trxDetail[].dtlIsToPrint (inversé) | OK | OK | OK | — | ||
Fiche_DerniereModification | modifDate + modifTime | X | X | OK | 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
ExtendedProperties : AcombaGo_Id, AcombaGo_ModifDate/Time (jeton), AcombaGo_TransactionType, AcombaGo_TransactionNumber, AcombaGo_SellerId, AcombaGo_TaxGroupId, AcombaGo_TermId, AcombaGo_CustomerId, AcombaGo_DeliveredToId, AcombaGo_PoNumber, AcombaGo_Balance, AcombaGo_IsTransferred, AcombaGo_DiscountAmount/Percentage (escompte d'entête, lecture), AcombaGo_TransactionTime, AcombaGo_Language, AcombaGo_AssociatedTrx (documents liés : soumission→commande→facture, lecture). Non couverts v1 : escompte d'entête en écriture, paymentSchedule, exemptions de taxe (noExemptTax1..3), items par couleur/entrepôt (dtlColorWarehouseId), B/O et lots (non supportés par ACCEO). Contrat : Documentation/AcombaGoAPI/10_Transactions.md §4. fields_exhaustive: false.