Modelos de Dados

{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "name": "Camiseta Premium",
  "description": "Camiseta 100% algodao premium",
  "price_cents": 8990,
  "list_price_cents": 11990,
  "currency": "BRL",
  "sku": "SHIRT-001",
  "status": "A",
  "weight_grams": 250,
  "category_id": "550e8400-e29b-41d4-a716-446655440002",
  "vendor_id": "550e8400-e29b-41d4-a716-446655440003",
  "inventory_count": 150,
  "images": [
    {
      "id": "img_001",
      "url": "https://cdn.venddor.com.br/products/shirt-001.jpg",
      "alt": "Camiseta Premium frente",
      "position": 0
    }
  ],
  "variants": [
    {
      "id": "var_001",
      "name": "P",
      "sku": "SHIRT-001-P",
      "price_cents": 8990,
      "inventory_count": 50
    }
  ],
  "features": {
    "cor": "Azul",
    "tamanho": "P, M, G, GG",
    "material": "100% Algodao"
  },
  "seo": {
    "meta_title": "Camiseta Premium | Loja",
    "meta_description": "Camiseta premium de algodao...",
    "slug": "camiseta-premium"
  },
  "is_featured": false,
  "created_at": "2026-03-01T10:00:00Z",
  "updated_at": "2026-03-15T14:30:00Z"
}

{
  "id": "ord_abc123",
  "order_number": "2026-0042",
  "status": "shipped",
  "customer": {
    "id": "usr_456",
    "name": "Joao Silva",
    "email": "joao@example.com",
    "phone": "+5511999998888"
  },
  "items": [
    {
      "product_id": "prod_789",
      "name": "Camiseta Premium",
      "sku": "SHIRT-001-M",
      "quantity": 2,
      "price_cents": 8990,
      "total_cents": 17980
    }
  ],
  "subtotal_cents": 17980,
  "shipping_cents": 1500,
  "discount_cents": 0,
  "tax_cents": 0,
  "total_cents": 19480,
  "currency": "BRL",
  "payment": {
    "method": "pix",
    "status": "paid",
    "paid_at": "2026-03-27T14:32:00Z"
  },
  "shipping": {
    "method": "correios_pac",
    "tracking_code": "BR123456789",
    "address": {
      "street": "Rua das Flores",
      "number": "123",
      "complement": "Apt 4B",
      "neighborhood": "Centro",
      "city": "Sao Paulo",
      "state": "SP",
      "zip": "01001-000",
      "country": "BR"
    }
  },
  "notes": "",
  "created_at": "2026-03-27T14:30:00Z",
  "updated_at": "2026-03-27T16:00:00Z"
}

{
  "id": "usr_456",
  "email": "joao@example.com",
  "name": "Joao Silva",
  "phone": "+5511999998888",
  "cpf": "123.456.789-00",
  "role": "customer",
  "is_active": true,
  "addresses": [
    {
      "id": "addr_001",
      "label": "Casa",
      "street": "Rua das Flores",
      "number": "123",
      "city": "Sao Paulo",
      "state": "SP",
      "zip": "01001-000",
      "is_default": true
    }
  ],
  "order_count": 5,
  "total_spent_cents": 89500,
  "last_order_at": "2026-03-27T14:30:00Z",
  "created_at": "2026-01-15T10:00:00Z"
}

{
  "id": "cat_001",
  "name": "Vestuario",
  "slug": "vestuario",
  "parent_id": null,
  "position": 1,
  "is_active": true,
  "product_count": 42,
  "children": [
    {
      "id": "cat_002",
      "name": "Camisetas",
      "slug": "camisetas",
      "parent_id": "cat_001",
      "position": 1,
      "product_count": 15
    }
  ],
  "seo": {
    "meta_title": "Vestuario",
    "meta_description": "Roupas e acessorios",
    "slug": "vestuario"
  }
}

{
  "id": "vendor_001",
  "name": "Loja do Joao",
  "slug": "loja-do-joao",
  "email": "joao@lojajoao.com.br",
  "cnpj": "12.345.678/0001-90",
  "status": "A",
  "logo_url": "https://cdn.venddor.com.br/vendors/logo.png",
  "product_count": 85,
  "rating": 4.7,
  "created_at": "2026-01-01T10:00:00Z"
}

// Both of these are accepted on input — they produce the same record:
{ "status": "A" }
{ "status": "active" }

// But the API ALWAYS responds with the canonical letter:
// { "status": "A" }

// Converting centavos to display format
function formatBRL(centavos) {
  return new Intl.NumberFormat('pt-BR', {
    style: 'currency',
    currency: 'BRL',
  }).format(centavos / 100);
}

// Examples:
formatBRL(4990);    // "R$ 49,90"
formatBRL(129999);  // "R$ 1.299,99"
formatBRL(0);       // "R$ 0,00"

550e8400-e29b-41d4-a716-446655440000

"created_at": "2026-03-27T14:30:00Z"
"updated_at": "2026-03-27T16:45:00Z"

// Parsing in JavaScript
const date = new Date(item.created_at);

// Display in Brazilian format
date.toLocaleDateString('pt-BR');  // "27/03/2026"
date.toLocaleTimeString('pt-BR');  // "14:30:00"

// Python
from datetime import datetime
date = datetime.fromisoformat(item['created_at'].replace('Z', '+00:00'))

// Store per-tenant credentials
const tenantTokens = {
  'tenant-uuid-1': { accessToken: '...', refreshToken: '...' },
  'tenant-uuid-2': { accessToken: '...', refreshToken: '...' },
};

// Use the correct token for each tenant
async function callApi(tenantId, endpoint) {
  const { accessToken } = tenantTokens[tenantId];

  return fetch(`https://api.io.venddor.com.br${endpoint}`, {
    headers: {
      'Authorization': `Bearer ${accessToken}`,
      'X-Tenant-ID': tenantId,
    },
  });
}