Corelații comenzi WMS

Acest endpoint oferă legătura read-only dintre o companie CRM, facturile ei și comenzile create în notsoWMS. Nu expune un feed de facturi pentru întreg tenantul: compania este întotdeauna explicită în URL.

Endpoint

Metodă	Cale	Capabilitate necesară	Descriere
GET	/api/v1/companies/{company}/wms-orders	wms-orders:read	Listează corelațiile factură CRM–comandă WMS pentru companie.

Rezultatul este paginat cu ?page=N și ?per_page=N (implicit 50, maximum 200). Sunt returnate numai facturile care au un wms_order_id; facturile nesincronizate în WMS nu apar în colecție.

Răspuns

{
  "current_page": 1,
  "data": [
    {
      "crm_invoice_id": 8451,
      "crm_invoice_number": "FC-100",
      "company": {
        "id": 291,
        "tax_id": "RO12345678"
      },
      "wms": {
        "instance": "wartung.notsowms.ro",
        "order_id": 12345,
        "order_number": "ORD-20260920-0001",
        "status": "pending",
        "synced_at": "2026-09-20T07:30:00.000000Z"
      }
    }
  ],
  "per_page": 50,
  "total": 1
}

Folosește wms.instance (hostname-ul WMS salvat când comanda a fost creată) împreună cu wms.order_id ca identificator tehnic stabil între sisteme. company.tax_id (client_cui în payloadul trimis spre WMS) este verificarea business recomandată. wms.order_number și emailul clientului sunt valori de afișare sau confirmare, nu chei unice de corelare. Pentru comenzile create înainte de această versiune, wms.instance poate fi null; reconfirmă atunci corelația cu datele istorice ale integrării înainte de a o automatiza.

Pentru integrări noi care creează direct comenzi în WMS, trimite external_order_id și external_source cu identificatorul intern și sursa documentului CRM. CRM salvează hostname-ul WMS rezolvat ca wms_instance; păstrează din răspunsul WMS wms_order_id și wms_order_number. Integrarea CRM curentă salvează aceste valori pe factură și transmite numărul facturii ca invoice_reference.

Exemplu

curl 'https://tenant.notsocrm.ro/api/v1/companies/291/wms-orders?per_page=50' \
  -H 'Authorization: Bearer <slug-tenant>.<cheie>' \
  -H 'Accept: application/json'

O cheie fără capabilitatea wms-orders:read primește:

{ "error": "Missing capability: wms-orders:read" }