Aller au contenu

Catalogue des événements

Chaque webhook reçoit une enveloppe { id, name, occurredAt, storeId, actor, payload } (voir Ce que KiwiDesk envoie). Cette page décrit le payload de chaque événement. Les noms suivent la forme <domaine>.<objet>.<verbe au passé>.

Conventions des champs : les identifiants sont des UUID, les montants des entiers en centimes (...Cents), les dates des chaînes ISO 8601 en UTC. Un champ | null peut valoir null.

{
"id": "01a1f6a2-3c4d-7e5f-8a9b-0c1d2e3f4a5b",
"name": "repair.ticket.status_changed",
"occurredAt": "2026-11-20T08:20:00.000Z",
"storeId": "01a1bafb-6510-738f-98da-85c97912cce8",
"actor": { "userId": "01a1bafb-5d70-76d8-9d73-7b5aa8a4e504", "apiKeyId": null, "ipAddress": "192.0.2.10" },
"payload": {
"ticketId": "01a1f66e-8ee0-71d2-92fb-a88b1629ab6a",
"ticketNumber": "REP-2026-0215",
"customerId": "01a1f66d-f0ce-7051-8be1-2b9967d3e9b2",
"fromStatus": "IN_REPAIR",
"toStatus": "READY_FOR_PICKUP",
"comment": null
}
}
Événement Libellé Payload
core.store.created Une boutique a été créée. storeId, code, name
core.store.updated Une boutique a été modifiée. storeId, changedFields (noms des champs modifiés)
core.customer.created Un client a été créé. customerId, type (INDIVIDUAL ou BUSINESS), displayName
core.customer.updated Un client a été modifié. customerId, changedFields
core.customer.anonymized Les données personnelles d’un client ont été purgées (droit à l’oubli RGPD). customerId
core.customer.deleted Un client sans pièce comptable a été supprimé définitivement. customerId
core.device.created Un appareil client a été enregistré. deviceId, customerId, imei | null, serialNumber | null
core.device.transferred Un appareil a été transféré à un autre client. deviceId, fromCustomerId, toCustomerId

Quand vous recevez core.customer.anonymized ou core.customer.deleted, effacez de votre côté les données personnelles de ce client : c’est votre part du droit à l’oubli.

Événement Libellé Payload
repair.ticket.created Un ticket de réparation a été créé. ticketId, ticketNumber, customerId, deviceId, status, priority, assignedTechnicianId | null
repair.ticket.status_changed Le statut d’un ticket de réparation a changé. ticketId, ticketNumber, customerId, fromStatus | null, toStatus, comment | null
repair.ticket.assigned Un ticket a été (ré)attribué à un technicien. ticketId, ticketNumber, previousTechnicianId | null, assignedTechnicianId | null
repair.ticket.ready_for_pickup Un appareil réparé est prêt à être récupéré. ticketId, ticketNumber, customerId, totalCents, depositCents, currency
repair.ticket.completed Un appareil a été restitué à son propriétaire. ticketId, ticketNumber, customerId, deviceId, outcome, netCents, taxCents, totalCents, depositCents, currency, completedAt
repair.ticket.cancelled Un ticket de réparation a été annulé. ticketId, ticketNumber, customerId, reason | null
repair.appointment.booked Un rendez-vous a été pris (en ligne ou au comptoir). Voir Rendez-vous
repair.appointment.reminder_due Le rappel d’un rendez-vous est à envoyer. Voir Rendez-vous
  • status, fromStatus, toStatus : WAITING_DEVICE_DROP_OFF, RECEIVED, DIAGNOSING, WAITING_CUSTOMER_APPROVAL, WAITING_PARTS, IN_REPAIR, TESTING_QA, READY_FOR_PICKUP, COMPLETED, UNREPAIRABLE, CANCELLED (voir Statuts).
  • priority : LOW, NORMAL, HIGH, URGENT.
  • outcome de completed : REPAIRED (réparé), UNREPAIRABLE (déclaré irréparable), NOT_REPAIRED (rendu sans réparation, devis refusé).
  • Un passage à « Prêt à récupérer » envoie deux événements : status_changed et ready_for_pickup (qui porte les montants). Abonnez-vous à celui qui vous sert.

Les deux événements de rendez-vous portent le même payload, avec des données personnelles :

Champ Contenu
appointmentId, reference Identifiant et référence lisible du rendez-vous
source ONLINE (page de prise de rendez-vous) ou STAFF
status REQUESTED ou CONFIRMED
startsAt Début (ISO 8601)
firstName, lastName, phone, email | null Coordonnées saisies
storeName, dateLabel, timeLabel Libellés prêts à afficher ("vendredi 13 novembre", "14:30"), dans le fuseau de la boutique
cancelUrl | null Lien privé d’annulation pour le client
customerId | null, ticketId | null Fiche client et ticket liés, s’il y en a
Événement Libellé Payload
billing.quote.sent Un devis a été numéroté et envoyé au client. quoteId, quoteNumber, customerId, repairTicketId | null, totalCents, currency
billing.quote.accepted Un devis a été accepté par le client. idem quote.sent
billing.invoice.issued Une facture ou un ticket de caisse a été émis (numéroté et scellé). invoiceId, invoiceNumber, type, customerId | null, repairTicketId | null, netCents, taxCents, totalCents, depositsDeductedCents, ticketDepositDeltaCents, currency, issuedAt
billing.invoice.paid Une facture a été entièrement réglée. invoiceId, invoiceNumber, type, customerId | null, repairTicketId | null, totalCents, currency
billing.invoice.reminder_due Une relance de facture impayée est à envoyer. invoiceId, invoiceNumber, customerId, amountDueCents, dueDate (YYYY-MM-DD), level (1 pour la première), manual, currency
billing.payment.recorded Un règlement a été encaissé ou un remboursement versé. paymentId, direction (IN encaissé, OUT remboursé), invoiceId | null, creditNoteId | null, customerId | null, method, amountCents, currency
billing.credit_note.issued Un avoir a été émis sur une facture. creditNoteId, creditNoteNumber, invoiceId, invoiceNumber, invoiceType, customerId | null, repairTicketId | null, totalCents, isFullCancellation, ticketDepositDeltaCents, currency
billing.cash_session.closed Une caisse a été clôturée (Z). sessionId, cashRegisterId, cashRegisterCode, zNumber, grandTotalCents, cashDifferenceCents, currency
  • type et invoiceType : STANDARD, DEPOSIT (facture d’acompte), FINAL (facture de solde d’une réparation), POS_RECEIPT (ticket de caisse).
  • method : CASH, CARD_TPE, BANK_TRANSFER, CHECK, CUSTOMER_CREDIT, GIFT_CARD, REPAIR_BONUS (part payée par le bonus réparation), OTHER.
  • ticketDepositDeltaCents : variation de l’acompte détenu sur le ticket (montant d’une facture d’acompte, négatif pour un avoir qui l’annule, 0 sinon).
Événement Libellé Payload
communications.message.received Un client a envoyé un message (SMS, e-mail ou discussion). messageId, threadId, channel, customerId | null, contextType | null, contextId | null, preview (début du message)
communications.message.status_changed Le statut d’envoi d’un message a changé (envoyé, distribué, en échec). messageId, threadId, channel, status, errorMessage | null
  • channel : SMS, EMAIL, LIVE_CHAT.
  • status : QUEUED, PROPOSED, WAITING_PHONE_PICKUP, SENDING, SENT, DELIVERED, READ, FAILED, CANCELLED.
  • contextType vaut REPAIR_TICKET quand le message est rattaché à un ticket (contextId).
Événement Libellé Payload
inventory.item.created Article créé itemId, sku, name, kind (PART, ACCESSORY, CONSUMABLE, PRODUCT), isSellable
inventory.item.updated Article modifié itemId, changedFields
inventory.item.archived Article archivé itemId, sku
inventory.stock.changed Quantité modifiée storeId, itemId, sku, movementId, movementType, quantity (signée), onHand, reserved, available, status
inventory.stock.low Seuil d’alerte atteint ou rupture storeId, itemId, sku, name, available, reorderPoint, status
inventory.purchase_order.ordered Commande fournisseur envoyée purchaseOrderId, number, storeId, supplierId, lineCount, totalCents
inventory.purchase_order.received Commande fournisseur réceptionnée purchaseOrderId, number, storeId, supplierId, quantity (unités de cette réception), status
inventory.transfer.sent Transfert envoyé transferId, number, fromStoreId, toStoreId, quantity
inventory.transfer.received Transfert réceptionné idem transfer.sent
inventory.count.completed Inventaire terminé countId, number, storeId, countedLines, varianceUnits, varianceValueCents (écarts signés)
  • status du stock : IN_STOCK, LOW, OUT.
  • movementType : INITIAL, PURCHASE_RECEIPT, MANUAL_IN, MANUAL_OUT, ADJUSTMENT, LOSS, SALE, SALE_RETURN, REPAIR_CONSUMPTION, REPAIR_RETURN, REFURB_CONSUMPTION, TRANSFER_OUT, TRANSFER_IN, HARVEST_IN, RELOCATION.
  • Commande fournisseur, status : DRAFT, ORDERED, PARTIALLY_RECEIVED, RECEIVED, CLOSED, CANCELLED.

inventory.stock.changed est fréquent (une vente, une pièce posée…) : pour synchroniser un site marchand, préférez-le à une lecture complète du stock, et gardez available comme quantité vendable.

Événement Libellé Payload
refurbishing.unit.created Appareil reconditionné enregistré unitId, number, storeId, acquisitionType, deviceLabel
refurbishing.unit.status_changed Statut d’un appareil reconditionné modifié unitId, number, storeId, fromStatus, toStatus, comment | null
refurbishing.buyback.completed Appareil racheté à un particulier buybackId, number, storeId, unitId, customerId, type (BUYBACK ou TRADE_IN), priceCents, paymentMethod
refurbishing.warranty.claim_opened Retour SAV ouvert sur un appareil reconditionné claimId, number, unitId, unitNumber, customerId | null
refurbishing.warranty.claim_resolved Retour SAV clôturé claimId, number, unitId, resolution (REPAIR, EXCHANGE, REFUND, REJECTED)
  • acquisitionType : BUYBACK, SUPPLIER, TRADE_IN, ABANDONED, OTHER.
  • Statuts d’un appareil : RECEIVED, DIAGNOSING, WAITING_PARTS, IN_REFURBISHMENT, QUALITY_CHECK, READY_FOR_SALE, RESERVED, SOLD, PARTS_DONOR, SCRAPPED, RETURNED_TO_SUPPLIER, QUARANTINE, LOST.
  • paymentMethod du rachat : CASH, BANK_TRANSFER, CHECK, STORE_VOUCHER.

Ces événements existent dans KiwiDesk (temps réel de l’interface, enchaînements internes) mais ne peuvent pas être souscrits : core.settings.updated, core.user.created, core.user.deactivated, repair.ticket.public_updated, repair.parts.changed, refurbishing.parts.changed, inventory.parts.available, inventory.parts.consumed, billing.items.sold, billing.cash_session.opened, communications.message.proposed, communications.conversation.updated.

  • Un événement n’arrive pas : vérifiez qu’il est coché sur le webhook et que le webhook vise la boutique de l’événement ; consultez son Historique des envois.
  • Un champ attendu manque : le payload reste court par choix ; lisez l’objet complet par l’API avec l’identifiant reçu.