Documents de vente

Chaque vente dans une boutique Wino laisse un document : un ticket en caisse, ou un devis, une facture, un bon de livraison ou un avoir pour les ventes aux professionnels. Cette page explique comment ces documents s'articulent. Ils sont en lecture seule dans l'API. Chaque champ est décrit dans le schéma GraphQL.

En caisse

• Un SalesReceipt est le ticket d'une vente en caisse, avec ses lignes (items), remises, taxes et paiements.
• Un RefundReceipt est le ticket de remboursement d'un ticket de caisse (salesReceipt), avec son motif (reason : CANCELLATION_SALE, CASHING_ERROR, PRODUCT_NOT_COMPLIANT_OR_DAMAGED, OTHER_REASON). Ses montants sont positifs : soustrayez-les de vos ventes.

Documents commerciaux

• Un Quote est une proposition de prix à un client (status : PUBLISHED, puis ACCEPTED). Il peut devenir une facture ou un bon de livraison.
• Une Invoice est une facture de vente, avec une issueDate et une dueDate, ses payments, et un status : DRAFT, UNPAID ou PAID. Elle peut provenir d'un devis (parentQuote) ou d'un ticket de caisse (salesReceipt).
• Un DeliveryNote est un document pour des marchandises livrées à un client (status : DRAFT ou PUBLISHED), éventuellement créé à partir d'un devis ou d'une facture.
• Un CreditNote annule tout ou partie d'une facture (parentInvoice).

Ce que contient chaque document

• Sa boutique, l'appareil sur lequel il a été créé (device) et, souvent, le membre du personnel qui l'a créé (staff).
• Ses lignes (items), ses taxes et ses totaux (totalAmountIncludingTaxes, totalAmountExcludingTaxes…).
• Les devis, factures, bons de livraison et avoirs conservent aussi les informations du client et de la boutique telles qu'imprimées (customerName, shopName…), qui peuvent différer des enregistrements Customer et Shop actuels.

Pour lire les ventes dans vos propres outils, voir Connecter un outil d'analyse.