Preset vertical

Preset Ecom — pedido completo em 1 chamada

Dev de ecommerce testando checkout, cálculo de frete ou promoção precisa pedido completo coerente: cliente + endereços shipping/billing + carrinho realista (1-5 produtos com SKU, variação, preço, quantidade) + payment (cartão, PIX ou boleto) + totais calculados. O preset ecom entrega tudo com 1 request.

O que vem dentro

  • ✅ Customer — nome, CPF, email, telefone
  • ✅ Shipping address — CEP + logradouro real
  • ✅ Billing address — 70% igual ao shipping
  • ✅ Carrinho — 1-5 produtos com SKU, variação, preço
  • ✅ Payment — cartão (50%), PIX (40%), boleto (10%)
  • ✅ Totais — subtotal + frete (grátis acima R$199) + total

Como chamar

HTTP (curl)

curl -H "X-API-Key: sua_chave" \
  "https://fakeforge.com.br/api/generate?preset=ecom&quantity=100"

Node SDK

import { FakeForge } from "fakeforge-br";

const ff = new FakeForge({ apiKey: process.env.FAKEFORGE_API_KEY });
const pedidos = await ff.preset("ecom", 100);

Python SDK

import os
from fakeforge import FakeForge

ff = FakeForge(api_key=os.environ["FAKEFORGE_API_KEY"])
pedidos = ff.preset("ecom", 100)

Sem conta e no Free, o preset devolve uma amostra de 3 pedidos por chamada. No passe de 7 dias e no Dev, até 2.000 por chamada. Pra gerar no navegador e baixar CSV, JSON ou SQL, use a página Dados relacionados.

Sample output

{
  "preset": "ecom",
  "quantity": 1,
  "data": [
    {
      "customer": {
        "nome": "Rafael Costa Silva",
        "cpf": "739.482.156-08",
        "email": "rafael.costa@outlook.com",
        "telefone": "(31) 99284-7135"
      },
      "shipping_address": {
        "cep": "30130-110",
        "logradouro": "Rua da Bahia, 1032",
        "bairro": "Centro",
        "cidade": "Belo Horizonte",
        "estado": "MG"
      },
      "billing_address": { /* mesmo que shipping em 70% dos casos */ },
      "cart": [
        {
          "sku": "TENCAS-4A2F",
          "name": "Tênis Casual Branco",
          "category": "moda",
          "variation": "41",
          "quantity": 1,
          "unit_price": 249.90,
          "total": 249.90
        },
        {
          "sku": "MOUGAM-8E1C",
          "name": "Mouse Gamer 6400 DPI",
          "category": "eletronicos",
          "variation": "Preto RGB",
          "quantity": 2,
          "unit_price": 129.90,
          "total": 259.80
        }
      ],
      "payment": {
        "method": "credit_card",
        "credit_card": {
          "number": "4532 8891 2947 6103",
          "brand": "visa",
          "cvv": "482",
          "expiry": "11/28",
          "holder_name": "RAFAEL COSTA SILVA"
        }
      },
      "totals": {
        "subtotal": 509.70,
        "shipping": 0,
        "total": 509.70
      }
    }
  ]
}

Catálogo de 40 produtos brasileiros

5 categorias × 8 produtos, com variações reais e preços psicológicos (terminados em .90 ou .99):

Camiseta, Calça Jeans, Tênis, Moletom, Jaqueta, Vestido, Mochila, Boné

Fone Bluetooth, Mouse Gamer, Teclado Mecânico, Webcam, Cabo HDMI, Carregador USB-C, Hub USB, Mousepad

Café 500g, Chocolate 70%, Azeite 500ml, Mel 400g, Chá Verde, Biscoito Integral, Granola, Ração Pet 15kg

Edredom Queen, Panela Antiaderente, Kit Toalhas, Jogo Americano, Luminária LED, Vaso Cerâmica, Tapete, Almofada

Perfume 100ml, Shampoo, Protetor Solar, Batom, Creme Facial, Máscara Argila, Esmalte, Escova Térmica

Casos de uso reais

Teste de cálculo de frete

Endereços de 10 estados, com CEP da cidade. Passe 1000 pedidos pro seu motor de frete e valide se cobra corretamente por região, se aplica frete grátis acima do threshold, se soma correto pra pedido com múltiplos itens.

Teste de checkout multi-payment

Metade dos pedidos no cartão, 40% no PIX e 10% no boleto. Rode 100 pedidos e sua integração com adquirente é testada em todos os cenários.

Seed de banco staging

Pedidos com clientes, endereços, carrinhos e pagamentos variados. No Dev, o preset vai até 2.000 por chamada, ou um arquivo de 10.000 na página Dados relacionados. Perfeito pra ambiente de dev cheio ou demo pra stakeholder.

Teste de promoção e cupom

Cada pedido tem 1-5 itens de categorias variadas com preços realistas. Sua regra de cupom (X% em categoria Y, R$Z de desconto acima de R$W) pode ser testada contra distribuição real, não fixture artificial.

Fixture E2E Playwright / Cypress

Cada pedido tem estrutura consistente. Setup: gera 20 pedidos no beforeAll, cada teste consome 1. Zero flakiness de dados.

Detalhes técnicos

  • SKU derivado do nome + hash da variação (formato consistente entre chamadas pro mesmo par produto/variação).
  • Variações reais por categoria: tamanhos P/M/G/GG, cores, capacidades (100g, 300ml, 15kg), configurações (RGB, sem RGB).
  • Preços psicológicos — 70% terminam em .90, 30% em .99.
  • Frete grátis acima de R$199; abaixo, R$9.90-R$29.90 aleatório.
  • Cartão de crédito passa Luhn, brand random (Visa, Master, Elo, Hipercard, Amex), holder = customer.
  • Boleto tem linha digitável no formato padrão FEBRABAN (5 grupos separados por espaço).

Próximos passos