Prix spéciaux et clients exemptés

L'entrepreneur général paie le prix 2, le client résidentiel le prix 1. La coopérative d'habitation a un rabais de 10 % sur les matériaux, et un organisme exempté de TVQ vous a remis son certificat. Dans Acomba, tout cela est réglé une fois pour toutes sur la fiche du client. Mais quand la soumission vient d'une boutique en ligne ou d'un CRM qui recalcule ses propres prix et taxes, chaque cas particulier devient une source d'erreur.

Dans cette recette, nous allons laisser Acomba appliquer ses propres règles : régler la fiche tarifaire du client une fois, puis créer les soumissions sans prix, et laisser Acomba fixer le prix, le rabais et les taxes de chaque client.

Ce que vous allez apprendre

lire les niveaux de prix d'Acomba et leur nom dans votre dossier ;

régler le niveau de prix, le rabais, le groupe de taxes et les exemptions d'un client ;

créer une soumission sans prix et obtenir le prix et les taxes propres au client ;

reconnaître un client exempté et un client sans groupe de taxes.

Avant de commencer

une clé API en écriture ;

les modules Facturation et Inventaire actifs ;

vos produits avec leurs prix par niveau, et leur groupe de produits ;

un dossier de test pour le premier essai : cette recette écrit dans Acomba.

Comment Acomba fixe le prix et les taxes

Avant de régler quoi que ce soit, voyons la logique d'Acomba. Quand une ligne de produit n'a pas de prix, Acomba prend le prix du niveau de prix du client (Prix 1 à 4, Suggéré, Quantité, ou un coûtant). Si le client a droit à un rabais, il applique le pourcentage du groupe de produits de l'article (ou le pourcentage global du rabais). Les taxes viennent du groupe de taxes du client (à défaut, de celui de son compte recevable), moins les taxes dont il est exempté.

Étape 1 : lire les niveaux de prix

Commençons par la grille de prix. Les niveaux portent le nom que vous leur avez donné dans Acomba ; chacun correspond à un champ de prices sur la fiche produit.

cURL

Réponse 200 (extrait)

Les champs de prices (regular, promo…) ne sont que des noms techniques : promo est le niveau 2 d'Acomba, pas un prix promotionnel. Fiez-vous à name.

Étape 2 : régler la fiche tarifaire du client

La grille est connue ; réglons le client. Le niveau de prix va de 0 (Prix 1) à 8 : 0 à 3 pour Prix 1 à 4, 4 pour Suggéré, 5 pour Quantité, 6 à 8 pour les coûtants. Le rabais se désigne par son numéro.

cURL

Réponse 200

Pour un organisme exempté, inscrivez la taxe et le numéro de certificat dans une des cinq positions d'exemption :

cURL

Pour retirer l'exemption, renvoyez la même position avec "tax_code": "". Pour un client hors Québec, donnez-lui plutôt un autre groupe de taxes ("tax_group_code": "TPS").

Étape 3 : vérifier le rabais

Avant de créer des soumissions, vérifions ce que vaut le rabais du client. Sa fiche donne, par groupe de produits, le pourcentage qui s'appliquera.

cURL

Réponse 200 (extrait)

effective_percent est le pourcentage appliqué aux articles du groupe : celui du groupe s'il est actif, sinon le pourcentage global.

Étape 4 : créer la soumission sans prix

Le client est réglé ; créons sa soumission. Les lignes n'ont ni unit_price ni selling_price : Acomba fixe le prix selon le client.

cURL

Réponse 200

Relisez la soumission (GET /api/invoicing/quotes/by-id/18801) : chaque ligne porte unit_price (prix du niveau), discount_percent et selling_price (après rabais), et taxes.breakdown les taxes du client.

Le script complet

Assemblons le tout : pour chaque demande, ce script affiche le profil tarifaire du client, crée la soumission sans prix et montre le prix et les taxes qu'Acomba a appliqués.

Python

JavaScript (Node.js)

Exemple de sortie :

Rénovations Beaulieu inc. (1042) : Prix 1, aucun rabais, taxes TPS et TVQ
  COIN-10       3 ×    30.00 $         =      90.00 $
  PEINT-H      10 ×    90.00 $         =     900.00 $
  Soumission SOUM-2101 : TPS 49.50 $ · TVQ 98.75 $ · total 1,138.25 $
Habitations Les Saules (2077) : Prix 1, aucun rabais, taxes TPS et TVQ (défaut du compte recevable), exempté : TVQ (certificat 1234567890)
  COIN-10       3 ×    30.00 $         =      90.00 $
  PEINT-H      10 ×    90.00 $         =     900.00 $
  Soumission SOUM-2102 : TPS 49.50 $ · TVQ 0.00 $ · total 1,039.50 $

Bon à savoir

Un prix envoyé l'emporte. unit_price, selling_price ou discount_percent envoyés sur une ligne remplacent ceux d'Acomba ; omettez-les pour appliquer la fiche du client.

Pas de groupe, pas de rabais. Le rabais d'un client ne s'applique qu'aux articles qui ont un groupe de produits, et seulement si les rabais sont permis dans la configuration clients.

Client sans groupe de taxes. Acomba applique le groupe de son compte recevable (GET /api/customers/control, receivables[].tax_group), et l'API fait de même.

L'exemption reste sur la fiche du client. Acomba ne la garde pas sur la soumission ou la facture : une taxe exemptée y apparaît à 0 $, et exempted vaut null à la relecture.

Les taxes s'arrondissent sur le total de la pièce, comme dans Acomba.

Numéros de documents : 12 caractères au plus dans la démo (invoice_number_length dans la configuration clients) ; un code plus long est refusé (422).

Codes d'erreur : voir Codes d'erreur.

Et voilà

Vos soumissions prennent maintenant le bon prix et les bonnes taxes pour chaque client, sans que votre boutique ou votre CRM recalcule quoi que ce soit : le niveau de prix, le rabais par groupe, le groupe de taxes et les exemptions sont réglés une fois sur la fiche du client, et Acomba les applique. Vous savez aussi lire la grille de prix sous ses vrais noms et reconnaître un client exempté.

Pour aller plus loin

De la soumission à la commande : convertir la soumission acceptée sans rien ressaisir.

Synchronisation CRM : créer le client et sa fiche tarifaire depuis votre CRM.

Commande en ligne, facture et paiement : les mêmes règles de prix pour une commande de votre boutique.

Comment Acomba fixe le prix et les taxes#

Étape 1 : lire les niveaux de prix#

Étape 2 : régler la fiche tarifaire du client#

Étape 3 : vérifier le rabais#

Étape 4 : créer la soumission sans prix#

Le script complet#

Bon à savoir#

Et voilà#

Comment Acomba fixe le prix et les taxes

Étape 1 : lire les niveaux de prix

Étape 2 : régler la fiche tarifaire du client

Étape 3 : vérifier le rabais

Étape 4 : créer la soumission sans prix

Le script complet

Bon à savoir

Et voilà