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 "https://fakeforge.com.br/api/generate?preset=ecom&quantity=100"

Node SDK

import { FakeForge } from "fakeforge-br";

const ff = new FakeForge();
const pedidos = await ff.preset("ecom", 100);

Python SDK

from fakeforge import FakeForge

ff = FakeForge()
pedidos = ff.preset("ecom", 100)

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):

Moda

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

Eletrônicos

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

Alimentos

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

Casa

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

Beleza

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

Distribuição realista de endereços (todas UFs brasileiras). 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

Distribuição 50/40/10 entre cartão/PIX/boleto reflete o mercado BR real. Rode 100 pedidos e sua integração com adquirente é testada em todos os cenários.

Seed de banco staging

Popular 10.000 pedidos com clientes, endereços, carrinhos, payments variados. Plano Dev libera em 1 chamada. 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 (padrão real de retail BR).
  • Frete grátis acima de R$199 (padrão de mercado); 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