CustomerInvoice — ProShop
Entité unifiée FicheTransactions · entité native ProShop : invoice.
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.
Opérations
| Opération | Statut | Champs exhaustifs | Flags | Limitations |
|---|---|---|---|---|
| EXTRACT (GET) | Supportée | non | Lecture depuis ProShop 'invoices' ; Formats : PROSHOP, SOLINFO|FULLTRANSACTION (lignes produit + taxes), SOLINFO|INVOICEAR (journal GL AR) ; Mode AllRecords/LastModifiedDate REFUSÉ si ActionType=Synchronize (garde-fou) ; Groupes de taxe récupérés dynamiquement depuis Acomba (mapping ProShopAcombaTaxMapping) | |
| CREATE (POST) | Non supportée | — | ||
| 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.
Champs
| Champ unifié | Champ natif | CREATE | UPDATE | EXTRACT | FILTER | Note |
|---|---|---|---|---|---|---|
NoFacture | invoiceId | X | X | OK | in | ID de facture ProShop. Filtrable via mode ListOfExternalIds. |
NoUniqueSystemeSource | invoiceId | X | X | OK | in | |
TypeDoc | — | X | X | OK | — | Constante SI_ExtractContentType.Factures. |
DateFacture | `InvoiceDate | DateIssued` | X | X | OK | — |
DateEcheance | InvoiceDueDate | X | X | X | — | NON mappé (TODO ToFicheTransactions). |
Description | MessageAfterTable | X | X | OK | — | |
Devise | Currency | X | X | OK | eq | Code ISO. Filtrable par égalité. |
EstActif | — | X | X | OK | — | Constante true. |
SousTotalFacture | InvoicedDollars | X | X | OK | — | Source de vérité pour le recalcul de taxe. |
TotalFacture | InvoicedDollars + taxes | X | X | OK | — | Calculé (sous-total + lignes de taxe). |
Reference | `ClientPoNum | CustomerPOPlainText` | X | X | OK | — |
InfoClientFacturerA.NoClient | `SoldTo.CadSystem | SoldTo.Name` | X | X | OK | — |
InfoClientFacturerA.NomClient | `SoldTo.CompanyName | SoldToPlainText` | X | X | OK | — |
Fiche_DerniereModification | lastModifiedTime | X | X | OK | eq, in, gt, ge, lt, le | |
Status | status | X | X | OK | eq | Passthrough. 'Outstanding' = non synchronisé (mode NotMarkedAsSynced). Passe à 'Transfered to Acomba' après push. |
OriginCode | originCode | X | X | OK | eq | Passthrough (drapeau de synchronisation). |
Annee | year | X | X | OK | eq, in | Année fiscale (passthrough). |
LigneFacture[].strNoProduit | Items[].ItemNumber | X | X | OK | — | |
LigneFacture[].NoCompteGL | `Items[].AccountNumber | CustomerDefaultSalesAccount` | X | X | OK | — |
LigneFacture[].DescriptionLigne | `Items[].PartDescription | Items[].PartPlainText` | X | X | OK | — |
LigneFacture[].QteFacture | Items[].Quantity | X | X | OK | — | |
LigneFacture[].PrixFinal | Items[].PricePer | X | X | OK | — | |
LigneFacture[].Montant_SousTotalLigne | Items[].InvoicedDollars | X | X | OK | — | |
ListeDesTaxes[].MontantTaxe | RecordTaxRate (TaxCodeParser) | X | X | OK | — | Format FULLTRANSACTION uniquement (null en INVOICEAR : les taxes y sont des lignes GL). |
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
Facture cliente = 'invoice' ProShop. Lecture seule. Deux formats de sortie : FULLTRANSACTION (lignes produit + ListeDesTaxes) et INVOICEAR (écriture GL : ligne AR + lignes revenu + lignes de taxe, crédits négatifs). Un escompte non nul crée une ligne placeholder DISCOUNT_INVALID (non supporté en v1).
EFFET DE BORD (mark-as-synced) : après un push réussi, MarkInvoiceAsSyncedAsync met le status ProShop à 'Transfered to Acomba' (défaut 'Outstanding') via une mutation updateInvoice — simple drapeau de statut, ce n'est PAS une capacité CRUD. TODO connus : mapper DateEcheance/PaymentTerms ; validation de taxe bloquante (tolérance 0.02$).
fields_exhaustive: false.