Salt la conținut

Dezvoltatori

Produse personalizate cu laserul, printr-un API REST

Conectați propriul magazin, un marketplace sau un sistem intern la atelierul nostru. Creați design-uri, obțineți oferte exacte, plasați comenzi și urmăriți-le prin webhook-uri.

API-ul se deschide după lansarea pe Shopify. Cereți acces anticipat și spuneți-ne ce construiți.

Partea dumneavoastră, partea noastră

Dumneavoastră alegeți și stabiliți prețurile. Noi facem restul.

Fără design, fără stoc, fără masă de ambalat, fără contracte cu curierii. Vânzarea produselor personalizate înseamnă doar câteva decizii din partea dumneavoastră.

Ce faceți dumneavoastră

Câteva minute pe produs

  1. Alegeți produse din catalogul nostru
  2. Stabiliți prețurile
  3. Trimiteți fiecare comandă cu o singură cerere API

Ce face Gravilo

Pentru fiecare comandă, în fiecare zi

  • Imagini de previzualizare pentru paginile produselor
  • Tăierea și gravarea pe laserele noastre CO2
  • Verificarea fiecărei piese
  • Ambalare fără brandul nostru
  • Livrare în toată UE, cu număr de urmărire
  • Urmărirea trimisă înapoi în magazinul sau sistemul dumneavoastră
  • Coletele returnate păstrate până decideți: trimise înapoi sau distruse

Ce puteți face

Tot ce vă trebuie pentru a vinde produse personalizate

  • Citiți catalogul

    Modele, materiale, dimensiuni, fonturi și prețuri în moneda dumneavoastră, cu toate textele în cinci limbi.

  • Creați design-uri

    Încărcați fotografiile clienților, trimiteți valorile câmpurilor și primiți un design cu imagine de previzualizare. Verificăm noi rezoluția fotografiilor.

  • Obțineți oferte exacte

    Produse, livrare și TVA pentru orice destinație, calculate de același cod care taxează comanda.

  • Plasați și urmăriți comenzi

    O singură cerere per comandă, plătită din soldul preplătit. Urmăriți starea și anulați comanda cât timp încă se poate.

  • Webhook-uri la fiecare pas

    Creată, în așteptare, în producție, expediată, livrată, plus alerte de sold scăzut. Fiecare webhook este semnat cu HMAC-SHA256.

  • Verificați soldul

    Soldul și întregul istoric al tranzacțiilor, ca evidența dumneavoastră să corespundă mereu cu a noastră.

Exemplu

O singură cerere plasează o comandă

Comanda este plătită din sold. Răspunsul conține numărul nostru de comandă și starea ei, iar de acolo urmează webhook-urile.

Cerere
curl https://api.gravilo.eu/v1/orders \
  -H "Authorization: Bearer gvl_live_…" \
  -H "Idempotency-Key: 7d0f9a52-order-1042" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "1042",
    "customer_locale": "de",
    "ship_to": {
      "name": "Lena Schmidt",
      "line1": "Lindenstraße 12",
      "postal_code": "10969",
      "city": "Berlin",
      "country": "DE"
    },
    "items": [
      { "design_id": "0192a5c4-7b1e-7c3d-9f00-5d1e2a3b4c5d", "quantity": 2 }
    ]
  }'
Răspuns
HTTP/1.1 201 Created

{
  "id": "0192a5c4-8f02-7a11-b3c0-1e9d4c7a2b60",
  "number": "GV-001042",
  "external_id": "1042",
  "is_test": false,
  "status": "received",
  "hold_reason": null,
  "billing_status": "charged",
  "placed_at": "2026-10-08T09:41:00Z"
}

Gândit pentru integrare

Previzibil, testabil, documentat

  • Mod de test

    Cheile de test validează și calculează prețul comenzilor fără să taxeze sau să producă ceva.

  • Reîncercări sigure

    Trimiteți un Idempotency-Key la fiecare POST. Aceeași cerere nu creează niciodată două comenzi.

  • OpenAPI 3.1

    O specificație citibilă de mașini și o documentație de referință, generate din schemele cu care API-ul validează datele.

  • Erori clare

    Detalii de eroare (RFC 9457) cu coduri stabile și câmpul exact care trebuie corectat.

Sunteți gata să începeți?

Începeți cu aplicația Shopify sau conectați propriul sistem prin API.