Authorization: Bearer lj_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

X-Api-Key: lj_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

curl -H "Authorization: Bearer lj_live_SUA_CHAVE" \
     https://lojexa.com/api/v1/ping

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT",
    "message": "Rate limit excedido. Tente novamente em 60 segundos."
  }
}

{
  "success": true,
  "data": { ... },
  "meta": {
    "total": 100,
    "page": 1,
    "per_page": 50,
    "last_page": 2
  }
}

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_STOCK",
    "message": "Estoque insuficiente para o SKU CAMISETA-M."
  }
}

curl -H "Authorization: Bearer lj_live_SEU_TOKEN" \
     https://lojexa.com/api/v1/ping

{
  "success": true,
  "data": {
    "status": "ok",
    "company": "Loja da Maria",
    "scopes": ["read:products", "write:sales"]
  }
}

curl -H "Authorization: Bearer lj_live_SEU_TOKEN" \
     "https://lojexa.com/api/v1/produtos?per_page=20&search=camiseta"

{
  "success": true,
  "data": [
    {
      "sku_code": "CAMISETA-M-AZUL",
      "name": "Camiseta Basica Azul M",
      "description": "100% algodao",
      "category_name": "Camisetas",
      "barcode": "7891234567890",
      "cost_price": "29.90",
      "sale_price": "49.90",
      "stock_available": 15,
      "stock_reserved": 2,
      "unit": "un",
      "image_url": "https://cdn.exemplo.com/camiseta.jpg",
      "images": ["https://cdn.exemplo.com/camiseta.jpg"],
      "colors": ["Azul"],
      "sizes": ["M"],
      "variation_count": 3,
      "variation": {
        "sku": "CAMISETA-M-AZUL",
        "name": "Azul,M",
        "price": 49.90,
        "stock": 15,
        "attributes": {"color": "Azul", "size": "M"}
      }
    }
  ],
  "meta": {
    "total": 142,
    "page": 1,
    "per_page": 50,
    "last_page": 3
  }
}

curl -H "Authorization: Bearer lj_live_SEU_TOKEN" \
     https://lojexa.com/api/v1/produtos/CAMISETA-M-AZUL

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Produto nao encontrado."
  }
}

curl -X POST \
     -H "Authorization: Bearer lj_live_SEU_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "reference": "PEDIDO-123",
       "channel": "website",
       "customer_name": "Joao Silva",
       "customer_email": "joao@email.com",
       "items": [
         { "sku": "CAMISETA-M-AZUL", "quantity": 2, "unit_price": 49.90 }
       ]
     }' \
     https://lojexa.com/api/v1/vendas

{
  "success": true,
  "data": {
    "sale_id": 456,
    "reference": "PEDIDO-123",
    "status": "confirmed",
    "items_processed": [
      {
        "sku": "CAMISETA-M-AZUL",
        "quantity": 2,
        "stock_after": 13
      }
    ]
  }
}

curl -X POST \
     -H "Authorization: Bearer lj_live_SEU_TOKEN" \
     https://lojexa.com/api/v1/vendas/PEDIDO-123/cancelar

{
  "success": true,
  "data": {
    "reference": "PEDIDO-123",
    "status": "reversed"
  }
}

<?php
$apiKey  = 'lj_live_SUA_CHAVE_AQUI';
$baseUrl = 'https://lojexa.com/api/v1';

// Buscar produtos
$ch = curl_init("$baseUrl/produtos?per_page=100");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer $apiKey",
        'Accept: application/json',
    ],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

foreach ($response['data'] as $produto) {
    echo "{$produto['name']}: {$produto['stock_available']} em estoque\n";
}

// Registrar venda
$venda = [
    'reference' => 'PEDIDO-' . uniqid(),
    'channel'   => 'loja-virtual',
    'items'     => [
        ['sku' => 'CAMISETA-M-AZUL', 'quantity' => 2, 'unit_price' => 49.90],
    ],
];
$ch = curl_init("$baseUrl/vendas");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode($venda),
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer $apiKey",
        'Content-Type: application/json',
    ],
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://lojexa.com/api/v1/',
    'headers'  => ['Authorization' => 'Bearer lj_live_SUA_CHAVE'],
]);

// Listar produtos
$response = $client->get('produtos', [
    'query' => ['per_page' => 100, 'search' => 'camiseta'],
]);
$data = json_decode($response->getBody(), true);

// Registrar venda
$response = $client->post('vendas', [
    'json' => [
        'reference' => 'PEDIDO-123',
        'items'     => [
            ['sku' => 'CAMISETA-M', 'quantity' => 1, 'unit_price' => 49.90],
        ],
    ],
]);
$result = json_decode($response->getBody(), true);

const API_KEY = 'lj_live_SUA_CHAVE_AQUI';
const BASE_URL = 'https://lojexa.com/api/v1';

async function getProdutos(search = '') {
    const url = new URL(`${BASE_URL}/produtos`);
    if (search) url.searchParams.set('search', search);
    url.searchParams.set('per_page', '100');

    const res = await fetch(url.toString(), {
        headers: {
            'Authorization': `Bearer ${API_KEY}`,
            'Accept': 'application/json',
        }
    });
    if (!res.ok) throw new Error(`HTTP ${res.status}`);
    const data = await res.json();
    return data.data;
}

async function registrarVenda(pedidoId, itens) {
    const res = await fetch(`${BASE_URL}/vendas`, {
        method: 'POST',
        headers: {
            'Authorization': `Bearer ${API_KEY}`,
            'Content-Type': 'application/json',
        },
        body: JSON.stringify({
            reference: pedidoId,
            channel: 'website',
            items: itens,
        }),
    });
    const data = await res.json();
    // 409 = ja processado, tratar como sucesso
    if (!data.success && data.error?.code !== 'ALREADY_PROCESSED') {
        throw new Error(data.error?.message || 'Erro desconhecido');
    }
    return data;
}

// Uso:
const produtos = await getProdutos('camiseta');
console.log(produtos);

const resultado = await registrarVenda('PEDIDO-001', [
    { sku: 'CAMISETA-M-AZUL', quantity: 2, unit_price: 49.90 }
]);

import requests

API_KEY = 'lj_live_SUA_CHAVE_AQUI'
BASE_URL = 'https://lojexa.com/api/v1'
HEADERS = {
    'Authorization': f'Bearer {API_KEY}',
    'Accept': 'application/json',
}

# Buscar todos os produtos
response = requests.get(
    f'{BASE_URL}/produtos',
    headers=HEADERS,
    params={'per_page': 100},
)
response.raise_for_status()
produtos = response.json()['data']

for p in produtos:
    print(f"{p['name']}: {p['stock_available']} unidades")

# Registrar venda
venda = requests.post(
    f'{BASE_URL}/vendas',
    headers=HEADERS,
    json={
        'reference': 'PEDIDO-123',
        'channel': 'loja-virtual',
        'items': [
            {'sku': 'CAMISETA-M', 'quantity': 1, 'unit_price': 49.90}
        ],
    },
)
print(venda.json())

{
  "event": "sale.confirmed",
  "company_id": 42,
  "timestamp": "2026-05-08T14:30:00Z",
  "data": {
    "sale_id": 9934,
    "reference": "PEDIDO-9934",
    "status": "confirmed",
    "items_processed": [
      { "sku": "CAMISETA-P", "quantity": 2, "stock_after": 13 }
    ]
  }
}

<?php
$webhookSecret = $_ENV['LOJEXA_WEBHOOK_SECRET'];
$sig           = $_SERVER['HTTP_X_LOJEXA_SIGNATURE'] ?? '';
$payload       = file_get_contents('php://input');
$expected      = 'sha256=' . hash_hmac('sha256', $payload, $webhookSecret);

// hash_equals() previne timing attacks
if (!hash_equals($expected, $sig)) {
    http_response_code(401);
    exit;
}

$event = json_decode($payload, true);

switch ($event['event']) {
    case 'sale.confirmed':
        // Venda confirmada — atualizar seu sistema
        processarVenda($event['data']);
        break;
    case 'sale.reversed':
        // Venda cancelada — reverter no seu sistema
        reverterVenda($event['data']);
        break;
}

http_response_code(200); // Sempre responder 200