Tester votre intégration

import { EFact } from '@itzenata/efact-node'

const efact = new EFact(process.env.EFACT_SECRET_KEY!)

// 1. Créer : la facture revient déjà normalisée (UBL 2.1) et signée (XAdES)
const invoice = await efact.invoices.create({
  invoiceNumber: `TEST-${Date.now()}`,   // unique par organisation
  invoiceDate: '2026-07-14',
  currency: 'MAD',
  paymentMethod: 'BANK_TRANSFER',
  buyerIce: '002345678901234',
  buyerName: 'Client de test SARL',
  lines: [
    { lineNumber: 1, description: 'Test integration', quantity: 1, unitPrice: 100, vatRate: 20 },
  ],
})
console.log(invoice.status) // 'SIGNED'

// 2. Suivre la clairance : le simulateur répond en quelques secondes
let status = await efact.invoices.retrieveStatus(invoice.id)
while (status.status === 'SIGNED' || status.status === 'TRANSMITTED') {
  await new Promise((r) => setTimeout(r, 2000))
  status = await efact.invoices.retrieveStatus(invoice.id)
}

console.log(status.status)       // 'ACCEPTED'
console.log(status.dgiReference) // référence de clairance
console.log(status.dgiQrPayload) // contenu du QR code

import { EFactValidationError, EFactConflictError } from '@itzenata/efact-node'

// ICE invalide (14 chiffres au lieu de 15) -> 400 VALIDATION_ERROR
try {
  await efact.invoices.create({ ...input, buyerIce: '12345678901234' })
} catch (e) {
  if (e instanceof EFactValidationError) {
    console.log(e.errors) // [{ field: 'buyerIce', message: '...' }]
  }
}

// Numéro de facture déjà utilisé -> 409 INVOICE_NUMBER_EXISTS
try {
  await efact.invoices.create({ ...input, invoiceNumber: 'TEST-DUPLICATE' })
  await efact.invoices.create({ ...input, invoiceNumber: 'TEST-DUPLICATE' })
} catch (e) {
  if (e instanceof EFactConflictError) {
    console.log(e.code) // 'INVOICE_NUMBER_EXISTS'
  }
}

// Modification d'une facture déjà signée -> 409 INVOICE_NOT_EDITABLE
try {
  await efact.invoices.update(invoice.id, { buyerName: 'Autre nom' })
} catch (e) {
  if (e instanceof EFactConflictError) {
    console.log(e.code) // 'INVOICE_NOT_EDITABLE'
  }
}

// Écrivez ce handler dès maintenant : le contrat de REJECTED est stable,
// même si le sandbox ne produit pas encore de rejet à la demande.
const status = await efact.invoices.retrieveStatus(invoice.id)

switch (status.status) {
  case 'ACCEPTED':
    // Facture cleared : archiver dgiReference + QR, marquer payable
    break
  case 'REJECTED':
    // Rejet de clairance : montrer dgiErrorCode / dgiErrorMessage
    // à l'utilisateur, corriger la facture, en émettre une nouvelle
    console.error(status.dgiErrorCode, status.dgiErrorMessage)
    break
  case 'FAILED':
    // Erreur technique irrécupérable : alerter, contacter le support
    break
}

// Une fois ACCEPTED, les artefacts sont téléchargeables :
GET /v1/invoices/{id}/pdf   # PDF de la facture
GET /v1/invoices/{id}/xml   # XML UBL 2.1 signé (original légal)
GET /v1/invoices/{id}/qr    # QR code de clairance (PNG)