Exemple complet — une vente de bout en bout

Cet exemple exécute une vente complète à l’aide des utilitaires de cadrage de Format des trames. Chaque implémentation construit ses chaînes DATA en échappant les valeurs, envoie la commande, et vérifie result avant de passer à la suivante. Les trois langages produisent exactement la même séquence de commandes et les mêmes chaînes DATA — seule l’API série diffère.

Chaque onglet réutilise les utilitaires de framing de Format des trames : le module Python datamega.py (send_command, escape), la classe C# TccProtocol (SendCommand, Escape) ou la classe Java TccProtocol (sendCommand, escape). Copiez d’abord ces utilitaires dans votre projet.

Python (pyserial)


import serial
from datamega import send_command, escape
 
def field(*values):
    """Join values into a DATA string, escaping each value (field commas stay literal)."""
    return ",".join(escape(str(v)) for v in values)
 
def step(port, cmd, data=""):
    reply = send_command(port, cmd, data)
    if not reply.startswith("1"):
        raise RuntimeError(f"cmd {cmd:#x} failed: {reply}")
    return reply
 
port = serial.Serial("COM3", 115200, timeout=3)   # your device's port + settings
 
# 0) Confirm the device and capture verify_url for the QR.
status = send_command(port, 0xC1)
verify_url = status[2:].split(",")[-1]
 
# 1) Start a sales invoice.
step(port, 0xC0, "salesInvoice")
 
# 2) Customer (individual, not taxable). Escape any commas in text values (field() does it).
step(port, 0xC3, field("individual", "John Doe", "", "", "123 Main St, New York", "", "", "0"))
 
# 3) One item: apple, product, unit price 99.99, qty 1, 5 fixed discount, Tax T.
item = step(port, 0x31, field("apple", "", "product", "99.99", "1", "5", "fixed", "T"))
print("item totals (subtotal,net,tax,total):", item.split(",", 1)[1])
 
# 4) Subtotal: no global discount.
totals = step(port, 0x33, field("0", "fixed"))
print("invoice totals:", totals.split(",", 1)[1])
 
# 5) Payment: cash.
step(port, 0x35, "cash")
 
# 6) End invoice -> receipt number + QR data.
end = send_command(port, 0x38)                    # e.g. 1,1,?sign=...^amphmac=...
result, receipt_no, qrcode = end.split(",", 2)
qr_content = (verify_url + qrcode).replace("^amp;", "&").replace("^amp", "&")  # resolve & (see "Building the QR Code")
print("receipt:", receipt_no)
print("QR content:", qr_content)
 
port.close()

C# (System.IO.Ports)

Utilise la classe TccProtocol de Format des trames. Dépendance : dotnet add package System.IO.Ports.


using System;
using System.IO.Ports;   // NuGet: System.IO.Ports
 
internal static class DatamegaSale
{
    // Join values into a DATA string, escaping each value (field commas stay literal).
    static string Field(params string[] values)
    {
        for (int i = 0; i < values.Length; i++) values[i] = TccProtocol.Escape(values[i]);
        return string.Join(",", values);
    }
 
    static string Step(SerialPort port, byte cmd, string data = "")
    {
        string reply = TccProtocol.SendCommand(port, cmd, data);
        if (!reply.StartsWith("1"))
            throw new Exception($"cmd 0x{cmd:X2} failed: {reply}");
        return reply;
    }
 
    static void Main()
    {
        using var port = new SerialPort("COM3", 115200)      // your device's port + settings
        {
            ReadTimeout = 3000,
            WriteTimeout = 3000,
        };
        port.Open();
 
        // 0) Confirm the device and capture verify_url for the QR.
        string status = TccProtocol.SendCommand(port, 0xC1);
        string verifyUrl = status.Substring(2).Split(',')[^1];   // last field of the C1h reply
 
        // 1) Start a sales invoice.
        Step(port, 0xC0, "salesInvoice");
 
        // 2) Customer (individual, not taxable). Commas in text values are escaped by Field().
        Step(port, 0xC3, Field("individual", "John Doe", "", "", "123 Main St, New York", "", "", "0"));
 
        // 3) One item: apple, product, unit price 99.99, qty 1, 5 fixed discount, Tax T.
        string item = Step(port, 0x31, Field("apple", "", "product", "99.99", "1", "5", "fixed", "T"));
        Console.WriteLine("item totals (subtotal,net,tax,total): " + item.Substring(item.IndexOf(',') + 1));
 
        // 4) Subtotal: no global discount.
        string totals = Step(port, 0x33, Field("0", "fixed"));
        Console.WriteLine("invoice totals: " + totals.Substring(totals.IndexOf(',') + 1));
 
        // 5) Payment: cash.
        Step(port, 0x35, "cash");
 
        // 6) End invoice -> receipt number + QR data.
        string end = TccProtocol.SendCommand(port, 0x38);        // e.g. 1,1,?sign=...^amphmac=...
        string[] parts = end.Split(new[] { ',' }, 3);            // result, receipt_NO, qrcode
        string receiptNo = parts[1], qrcode = parts[2];
        string qrContent = (verifyUrl + qrcode).Replace("^amp;", "&").Replace("^amp", "&");
        Console.WriteLine("receipt: " + receiptNo);
        Console.WriteLine("QR content: " + qrContent);
 
        port.Close();
    }
}

Java (jSerialComm)

Utilise la classe TccProtocol de Format des trames. Dépendance (Maven) : com.fazecast:jSerialComm.


import com.fazecast.jSerialComm.SerialPort;   // Maven: com.fazecast:jSerialComm
 
public final class DatamegaSale {
 
    // Join values into a DATA string, escaping each value (field commas stay literal).
    static String field(String... values) {
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < values.length; i++) {
            if (i > 0) sb.append(',');
            sb.append(TccProtocol.escape(values[i]));
        }
        return sb.toString();
    }
 
    static String step(SerialPort port, int cmd, String data) {
        String reply = TccProtocol.sendCommand(port, cmd, data);
        if (!reply.startsWith("1"))
            throw new RuntimeException(String.format("cmd 0x%02X failed: %s", cmd, reply));
        return reply;
    }
 
    public static void main(String[] args) {
        SerialPort port = SerialPort.getCommPort("COM3");        // your device's port + settings
        port.setBaudRate(115200);
        port.setComPortTimeouts(SerialPort.TIMEOUT_READ_SEMI_BLOCKING, 3000, 0);
        if (!port.openPort()) { System.err.println("Cannot open port"); return; }
 
        try {
            // 0) Confirm the device and capture verify_url for the QR.
            String status = TccProtocol.sendCommand(port, 0xC1);
            String[] statusFields = status.substring(2).split(",");
            String verifyUrl = statusFields[statusFields.length - 1];   // last field of the C1h reply
 
            // 1) Start a sales invoice.
            step(port, 0xC0, "salesInvoice");
 
            // 2) Customer (individual, not taxable). Commas in text values are escaped by field().
            step(port, 0xC3, field("individual", "John Doe", "", "", "123 Main St, New York", "", "", "0"));
 
            // 3) One item: apple, product, unit price 99.99, qty 1, 5 fixed discount, Tax T.
            String item = step(port, 0x31, field("apple", "", "product", "99.99", "1", "5", "fixed", "T"));
            System.out.println("item totals (subtotal,net,tax,total): " + item.substring(item.indexOf(',') + 1));
 
            // 4) Subtotal: no global discount.
            String totals = step(port, 0x33, field("0", "fixed"));
            System.out.println("invoice totals: " + totals.substring(totals.indexOf(',') + 1));
 
            // 5) Payment: cash.
            step(port, 0x35, "cash");
 
            // 6) End invoice -> receipt number + QR data.
            String end = TccProtocol.sendCommand(port, 0x38);          // e.g. 1,1,?sign=...^amphmac=...
            String[] parts = end.split(",", 3);                        // result, receipt_NO, qrcode
            String receiptNo = parts[1], qrcode = parts[2];
            String qrContent = (verifyUrl + qrcode).replace("^amp;", "&").replace("^amp", "&");
            System.out.println("receipt: " + receiptNo);
            System.out.println("QR content: " + qrContent);
        } finally {
            port.closePort();
        }
    }
}

Ce que fait l’exemple, étape par étape

C1h confirme que le dispositif est en ligne et capture la verify_url (nécessaire pour le QR).
C0h démarre une facture de vente (salesInvoice).
C3h enregistre le client (les virgules dans l’adresse sont échappées par field() / Field()). Cet exemple envoie recipient_type sous forme texte (individual) ; certains dispositifs attendent la forme numérique (1 = individual, 2 = company) — voir la note recipient_type dans la Référence des commandes.
31h ajoute une ligne article et renvoie ses totaux.
33h applique la remise globale (ici aucune) et renvoie les totaux de la facture.
35h enregistre le paiement (cash).
38h clôture la facture et renvoie receipt_NO + qrcode, à partir desquels on construit le contenu du QR (verify_url + qrcode déséchappé).

Pour un avoir (note de crédit) plutôt qu’une vente, remplacez les étapes 2–4 par la relecture de la facture d’origine (C4h → 41h en boucle → 43h), puis poursuivez avec 35h et 38h. Voir Transaction de facturation.

Deux points pour la relecture d’avoir : les réponses C4h/41h peuvent contenir une adresse avec une virgule échappée, donc découpez puis déséchappez chaque champ (split_fields / Fields / fields, jamais l’inverse) ; et la boucle 41h se termine par result = 2 (« plus d’items »), que le raccourci step() — qui exige result = 1 — ne gère pas : traitez 41h avec sa propre condition d’arrêt.

Étape suivante → FAQ