CustomerInvoice — QuickBooks Online
Entité unifiée FicheTransactions · entité native QuickBooks Online : Invoice / CreditMemo.
Page générée, ne pas éditer — voir la version du dataset pour la provenance.
Voir aussi : page CustomerInvoice · Acomba · Avantage · Autotask · ProShop.
Opérations
| Opération | Statut | Champs exhaustifs | Flags | Limitations |
|---|---|---|---|---|
| EXTRACT (GET) | Supportée | non | Lit les entités QBO Invoice (pas les CreditMemo en lecture) | |
| CREATE (POST) | Supportée | non | auto_fetch: Customer, Item, TaxCode, TaxRate, Class | |
| UPDATE (PUT) | Non supportée | — | ||
| DELETE (DELETE) | Non supportée | — |
Un champ absent du tableau est ? (inconnu), pas non supporté. En cas de doute, nous écrire.
DateFacture, InfoClientFacturerA, LigneFacture.
Les autres champs créables sont facultatifs.
Champs
| Champ unifié | Champ natif | CREATE | UPDATE | EXTRACT | FILTER | Requis | Valeurs permises | Note |
|---|---|---|---|---|---|---|---|---|
NoUniqueSystemeSource | Id | X | X | OK | eq, ne | Id interne QBO. Forcé à null à la création (throw si fourni). | ||
NoFacture | DocNumber | OK | X | OK | eq, ne | |||
Référence | DocNumber | X | X | OK | eq, ne | = DocNumber (alias de NoFacture en lecture). | ||
DateFacture | TxnDate | OK | X | OK | eq, ne, gt, ge, lt, le | oui | ||
Description | PrivateNote | OK | X | OK | — | |||
NoteGlobaleExterne01 | CustomerMemo.value | OK | X | OK | — | |||
TermePaiement | PaymentType | OK | X | OK | — | cash, check, creditcard, expense, unspecified | Valeurs mappées : cash|check|creditcard|expense|unspecified → sinon Other. | |
Devise | CurrencyRef.value | OK | X | OK | — | Défaut CAD. Doit correspondre à la devise du client, sinon exception. | ||
TotalFacture | Balance | X | X | OK | — | Calculé par QBO. Signe inversé (négatif) quand la transaction est une note de crédit. | ||
SousTypeTransaction | — | X | X | OK | — | Assigné au retour : 'Facture' (Invoice) ou 'Note de crédit' (CreditMemo) selon le signe du total. | ||
Fiche_DerniereModification | MetaData.LastUpdatedTime | X | X | OK | — | |||
InfoClientFacturerA.NoClient | CustomerRef (via Customer.DisplayName) | OK | X | X | — | Identifie le client par DisplayName (FetchCustomerByDisplayName). Alternative : InfoClientFacturerA.NoUniqueSystemeSource. | ||
InfoClientFacturerA.NoUniqueSystemeSource | CustomerRef (via Customer.Id) | OK | X | X | — | Identifie le client par son Id interne QBO. | ||
InfoClientFacturerA.Adresse | BillAddr.Line1 | OK | X | OK | — | Si absent à la création, QBO reprend l'adresse du client. | ||
InfoClientFacturerA.Ville | BillAddr.City | OK | X | OK | — | |||
InfoClientFacturerA.CodePostal | BillAddr.PostalCode | OK | X | OK | — | |||
InfoClientFacturerA.Province | BillAddr.CountrySubDivisionCode | OK | X | OK | — | |||
InfoClientFacturerA.Pays | BillAddr.Country | OK | X | OK | — | |||
InfoClientFacturerA.EmailPrincipal_Adresse | BillEmail.Address | OK | X | OK | — | |||
InfoClientLivrerA.Adresse | ShipAddr.Line1 | X | X | OK | — | Adresse de livraison : lecture seule (non écrite à la création). | ||
InfoClientLivrerA.Ville | ShipAddr.City | X | X | OK | — | |||
InfoClientLivrerA.CodePostal | ShipAddr.PostalCode | X | X | OK | — | |||
InfoClientLivrerA.Province | ShipAddr.CountrySubDivisionCode | X | X | OK | — | |||
InfoClientLivrerA.Pays | ShipAddr.Country | X | X | OK | — | |||
LigneFacture[].strNoProduit | Line.SalesItemLineDetail.ItemRef (par Item.Name) | OK | X | OK | — | Création : résolu par Name (Item). Lecture : renvoie l'Id de l'ItemRef. Désambiguïsation par strNoGroupeProduit si plusieurs Items de même nom. | ||
LigneFacture[].strNoProduit_NoUniqueSystemeSource | Line.SalesItemLineDetail.ItemRef.value (Id) | OK | X | X | — | Alternative : identifier le produit par son Id interne QBO. | ||
LigneFacture[].strNoGroupeProduit | Line.SalesItemLineDetail.ClassRef / ParentRef (désambiguïsation) | OK | X | OK | — | Lecture : = ClassRef.value. Création : sert à distinguer des produits homonymes (via la catégorie parente). | ||
LigneFacture[].QteFacture | Line.SalesItemLineDetail.Qty | OK | X | OK | — | |||
LigneFacture[].PrixFinal | Line.SalesItemLineDetail.UnitPrice | OK | X | OK | — | Si absent à la création, QBO reprend le prix unitaire de l'Item. | ||
LigneFacture[].DescriptionLigne | Line.Description | OK | X | OK | — | Sans produit ni Id produit → ligne DescriptionOnly. | ||
LigneFacture[].Montant_SousTotalLigne | Line.Amount | X | X | OK | — | Création : calculé (Qté × PrixFinal). Lecture : = Line.Amount. | ||
LigneFacture[].Montant_TotalLigne | Line.SalesItemLineDetail.TaxInclusiveAmt | X | X | OK | — | |||
LigneFacture[].NoGroupeTaxe | Line.SalesItemLineDetail.TaxCodeRef (par TaxCode.Name) | OK | X | X | — | Si absent, QBO reprend la taxe de vente de l'Item (SalesTaxCodeRef). | ||
LigneFacture[].NoProjet | Line.SalesItemLineDetail.ClassRef (par Class.Name) | OK | X | X | — | Classe QBO. Si absent, celle de l'Item. | ||
LigneFacture[].NoProjet_NoUniqueSystemeSource | Line.SalesItemLineDetail.ClassRef.value (Id) | OK | X | X | — | |||
LigneFacture[].NoLigneFacture | Line.LineNum | X | X | OK | — | Création : auto-numéroté (i+1). |
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 | Requis | Note |
|---|---|---|---|---|
InfoClientFacturerA | BillAddr / BillEmail / CustomerRef | Supportée | oui | Sous-objet client de facturation. |
InfoClientLivrerA | ShipAddr | Supportée | Adresse de livraison — lecture seule. | |
LigneFacture | Line[] | Supportée | oui |
Notes
BASCULE FACTURE / NOTE DE CRÉDIT : à la création, le total après taxes est calculé (les taxes sont résolues via TaxCode → TaxRate). Si le total est négatif, la transaction est créée comme CreditMemo (signes des montants inversés pour QBO), sinon comme Invoice. Le champ SousTypeTransaction du retour reflète ce choix, et les montants d'une note de crédit sont renvoyés négatifs.
Pas d'UPDATE ni de DELETE (non câblés dans le switch → NotImplementedException).
Le client est OBLIGATOIRE : soit InfoClientFacturerA.NoClient (DisplayName), soit InfoClientFacturerA.NoUniqueSystemeSource (Id). fields_exhaustive: false.