Webhook-uri

flowSCMC trimite POST JSON către URL-ul dvs. când apar evenimente. Cookbook: HMAC, retry, 4xx/5xx.

Configurare în aplicație

Autentificați-vă → Administrare → Webhook-uri: creați un webhook cu URL HTTPS și evenimentele dorite.

Format cerere

• Metodă: POST · Content-Type: application/json
• X-Webhook-Event - tipul evenimentului
• User-Agent - 3PL-WMS-Webhook/1.0
• Opțional: X-Webhook-Signature (HMAC), Authorization Bearer/Basic sau header personalizat

{
  "event": "article.created",
  "timestamp": "2026-02-12T14:30:00+00:00",
  "data": { }
}

Tipuri autentificare

Verificați semnătura HMAC pe serverul dvs. înainte de a procesa evenimentul. Retry-urile și dead-letter sunt gestionate în aplicație (Administrare → Webhook-uri → livrări).

Evenimente

• Articole: article.created, article.updated
• SO: sales_order.created|updated|status_changed
• PO / recepții: purchase_order.*, reception.*
• Retururi, stoc, ambalaje: return.*, stock.updated, stock.low, packaging.movement_recorded

Gestionare abonamente REST:

Cookbook: integrare end-to-end

1. În aplicație: Administrare → Webhook-uri → creați URL HTTPS + evenimente (ex. sales_order.created).
2. Setați autentificare hmac (sau signing secret) - primiți header X-Webhook-Signature: sha256=….
3. Endpoint-ul dvs. citește corpul brut, verifică semnătura, apoi răspunde 2xx rapid (< câteva secunde).
4. Procesați asincron (coadă) după ACK - nu blocați HTTP-ul pe ERP lent.
5. Testați din playground-ul de mai jos sau din Administrare → Test / livrări.

Verificare HMAC

Semnătura = HMAC-SHA256 pe corpul JSON exact (byte-cu-byte), prefix sha256=. Secretul e cel configurat pe webhook.

# PHP
$raw = file_get_contents('php://input');
$sig = $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'] ?? '';
$expected = 'sha256=' . hash_hmac('sha256', $raw, $secret);
if (!hash_equals($expected, $sig)) { http_response_code(401); exit; }

// Node.js
const crypto = require('crypto');
const expected = 'sha256=' + crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
if (!crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig))) {
  return res.status(401).end();
}

Retry, timeout, erori

• 2xx - livrare reușită, fără retry.
• 5xx / timeout / rețea - se reîncearcă după backoff.
• 4xx (ex. 401 semnătură, 404 URL greșit) - eșec de livrare; corectați endpoint-ul / secretul și retrimiteți din istoric.
• Istoricul: Administrare → Webhook-uri → livrări (status, răspuns, retry).

Integrările de intrare partenere (eTSM, MDM) folosesc un token Bearer dedicat - vezi documentația eTSM.