SupplierInvoice — QuickBooks Online
Entité unifiée FicheTransactions · entité native QuickBooks Online : Purchase.
Page générée, ne pas éditer — voir la version du dataset pour la provenance.
Voir aussi : page SupplierInvoice · Acomba · Avantage · Sage 50 · ProShop.
Opérations
| Opération | Statut | Champs exhaustifs | Flags | Limitations |
|---|---|---|---|---|
| EXTRACT (GET) | Supportée | non | ||
| CREATE (POST) | Supportée | non | auto_fetch: Vendor, Account, PaymentMethod | |
| UPDATE (PUT) | Supportée | non | auto_fetch: Vendor, Account, PaymentMethod | |
| 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 | OK | OK | eq, ne | Id interne QBO. Forcé à null à la création ; OBLIGATOIRE à l'UPDATE (clé). |
NoFacture | DocNumber | OK | OK | OK | eq, ne | |
Référence | DocNumber | X | X | OK | eq, ne | = DocNumber (alias de NoFacture en lecture). |
DateFacture | TxnDate | OK | OK | OK | eq, ne, gt, ge, lt, le | |
TotalFacture | TotalAmt | X | X | OK | eq, ne, gt, ge, lt, le | Calculé par QBO. |
NoteGlobaleExterne01 | PrivateNote | OK | OK | OK | — | |
Devise | CurrencyRef.value | OK | OK | ~ | — | Écriture : défaut CAD. Lecture actuellement inopérante (condition inversée dans le code : n'assigne que si value est vide). |
TermeDePaiement.NomTermeDePaiement | PaymentMethodRef (par PaymentMethod.Name) | OK | OK | OK | — | Terme de paiement OBLIGATOIRE à la création. Résolu par Name (doit être unique dans QBO). |
TermeDePaiement.TypeTerme | PaymentType | OK | OK | OK | — | cash|check|creditcard|expense|unspecified → sinon Other. À la lecture, TermeDePaiement.TypeTerme = PaymentType.ToString(). |
TermeDePaiement.NoTermeDePaiement_NoUniqueSystemeSource | PaymentMethodRef.value | X | X | OK | — | |
TermePaiement | PaymentType | X | X | OK | — | Lecture seule : = purchase.PaymentType.ToString(). Pour l'écriture, utiliser TermeDePaiement. |
CompteRecevable_No | AccountRef (par Account.Name) | OK | OK | X | — | Compte principal OBLIGATOIRE. Résolu par Name. Validé selon le type de paiement : Check → compte Bank ; CreditCard → compte CreditCard. |
InfoClientFacturerA.NoClient | EntityRef (via Vendor.DisplayName) | OK | OK | OK | — | Fournisseur (Payee) résolu par DisplayName. Lecture : = EntityRef.name. |
InfoClientFacturerA.Adresse | RemitToAddr.Line1 | OK | OK | OK | — | |
InfoClientFacturerA.Ville | RemitToAddr.City | OK | OK | OK | — | |
InfoClientFacturerA.CodePostal | RemitToAddr.PostalCode | OK | OK | OK | — | |
InfoClientFacturerA.Province | RemitToAddr.CountrySubDivisionCode | OK | OK | OK | — | |
InfoClientFacturerA.Pays | RemitToAddr.Country | OK | OK | OK | — | |
LigneFacture[].NoCompteGL | Line.AccountBasedExpenseLineDetail.AccountRef (par Account.Name) | OK | OK | OK | — | Compte GL de ligne OBLIGATOIRE type Expense. Écriture : résolu par Name. Lecture : résolu en AcctNum via un fetch des comptes. |
LigneFacture[].NoCompteGL_NoUniqueSystemeSource | Line.AccountBasedExpenseLineDetail.AccountRef.value (Id) | X | X | OK | — | |
LigneFacture[].PrixFinal | Line.Amount | OK | OK | OK | — | |
LigneFacture[].DescriptionLigne | Line.Description | OK | OK | OK | — |
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 |
|---|---|---|---|
InfoClientFacturerA | EntityRef / RemitToAddr | Supportée | Fournisseur (Payee) + adresse de remise. |
TermeDePaiement | PaymentMethodRef / PaymentType | Supportée | |
LigneFacture | Line[] (AccountBasedExpenseLineDetail) | Supportée |
Notes
Facture fournisseur = QBO Purchase (dépense). EXTRACT + CREATE + UPDATE câblés. UPDATE : GET par NoUniqueSystemeSource pour le SyncToken, puis POST OperationEnum.update + sparse=true.
Contraintes fortes à la création : TermeDePaiement obligatoire, compte principal (CompteRecevable_No) obligatoire et cohérent avec le type de paiement, chaque ligne référence un compte GL de type Expense. Le fournisseur est résolu par DisplayName (InfoClientFacturerA.NoClient).
Remarque code : la lecture de la Devise est inopérante (condition inversée) — voir champ Devise. fields_exhaustive: false.