Documentație API

Integrează E-BON în sistemul tău POS în câteva minute

REST API WebSocket SDKs
Quick Start OpenAPI Spec
Quick Start

Integrare în 3 pași

De la prima cheie API la primul bon fiscal — în mai puțin de 5 minute.

1

Obține cheia API

Creează un cont și generează o cheie API din portal cu scope-urile necesare.

terminal
curl -X POST https://api.e-bon.ro/api/v1/org/api-keys \
  -H "Authorization: Bearer <JWT_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "POS Principal",
    "scopes": ["devices:read", "commands", "receipts"]
  }'
2

Conectează dispozitivul

Înregistrează casa de marcat specificând protocolul și parametrii de conexiune.

terminal
curl -X POST https://api.e-bon.ro/api/v1/devices \
  -H "x-api-key: ebon_sk_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Casa 1 - Datecs FP700",
    "protocol": "datecs_professional",
    "transport": "tcp",
    "connectionParams": {
      "host": "192.168.1.100",
      "port": 4999
    }
  }'
3

Emite primul bon

Trimite o comandă de printare bon fiscal către dispozitivul conectat.

terminal
curl -X POST https://api.e-bon.ro/api/v1/commands \
  -H "x-api-key: ebon_sk_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "deviceId": "dev_01",
    "type": "print_receipt",
    "payload": {
      "items": [
        { "name": "Cafea", "quantity": 2, "price": 12.50, "vatRate": 21, "department": 1 }
      ],
      "payments": [{ "method": "cash", "amount": 25.00 }]
    }
  }'
Securitate

Autentificare

Două metode de autentificare: chei API pentru integrări POS și JWT pentru portalul web.

Cheie API

Recomandat pentru POS

Transmiteți cheia API în header-ul x-api-key la fiecare cerere. Cheile au scope-uri granulare care controlează accesul la resurse.

Cerere cu API Key
curl -X GET https://api.e-bon.ro/api/v1/devices \
  -H "x-api-key: ebon_sk_live_abc123..."

JWT Bearer Token

Portal web

Obțineți un token JWT prin POST /api/v1/auth/login și transmiteți-l în header-ul Authorization.

Cerere cu JWT
curl -X GET https://api.e-bon.ro/api/v1/org \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIs..."

Scope-uri disponibile

Fiecare cheie API are un set de scope-uri care controlează accesul la resurse.

devicesdevices:readdevices:writecommandsreceiptsreportsall
Referință

Endpoints

Toate endpoint-urile API-ului E-BON, grupate pe resurse. Base URL: https://api.e-bon.ro

Auth

/api/v1/auth

Înregistrare, autentificare și reîmprospătare token JWT.

POST RegisterPOST LoginPOST Refresh

Dispozitive

/api/v1/devices

CRUD complet pentru case de marcat fiscale (AMEF) conectate la platformă.

GET ListPOST CreateGET GetPATCH UpdateDELETE Delete

Bonuri

/api/v1/receipts

Stocare și interogare bonuri fiscale cu paginare cursor-based.

POST CreateGET ListGET Get

Comenzi

/api/v1/commands

Trimiteți comenzi fiscale asincron via WebSocket către dispozitive.

POST SendGET ListGET Status

Rapoarte

/api/v1/reports

Generare rapoarte fiscale: X (totaluri), Z (închidere zi), JE, MF.

GET ListPOST Generate

Format

JSON / UTF-8

Transport

HTTPS obligatoriu

Rate Limit

100 — 10.000 req/min

Instrumente

SDK-uri și instrumente

Accelerează integrarea cu SDK-urile oficiale, colecția Postman sau specificația OpenAPI.

TypeScript SDK

În curând

Client tipizat cu auto-complete, validare Zod și retry-uri automate.

Postman Collection

Disponibil

Colecție pre-configurată cu toate endpoint-urile și variabile de environment.

OpenAPI Spec

Disponibil

Specificație OpenAPI 3.0 completă — importă în orice tool de API.

/docs/openapi.json
@e-bon/sdk — coming soon
import { EBonClient } from '@e-bon/sdk';

const client = new EBonClient({
  apiKey: 'ebon_sk_live_...',
});

// Listează dispozitivele
const devices = await client.devices.list();

// Emite un bon fiscal
const command = await client.commands.send({
  deviceId: 'dev_01',
  type: 'print_receipt',
  payload: {
    items: [{ name: 'Cafea', quantity: 2, price: 12.50, vatRate: 21, department: 1 }],
    payments: [{ method: 'cash', amount: 25.00 }],
  },
});

Ai nevoie de ajutor?

Echipa noastră tehnică este pregătită să te ajute cu integrarea. Răspundem în mai puțin de 24 de ore.

Contactează suportulCreează cont gratuit