Skip to main content

​
Comece em três passos

Configure sua integração com a Solomon e envie seus primeiros pedidos e eventos.

​
Passo 1: Configure o acesso à API

Durante o onboarding, na seção de integração de plataforma de vendas, selecione a opção “Plataforma Própria” e aguarde os dois tokens de integração serem gerados exibido na tela.
Para se autenticar na Solomon API, você precisa de uma API Key válida. Para isso:
  1. Acesse a aba de Chaves de API no canto superior direito (clicando no nome da sua loja).
  2. Crie uma nova chave com um nome de identificação, do tipo “Plataforma Própria”
  3. Marque os escopos write_orders e write_products
    Nesse caso, você pode gerar uma API Key tanto para ambiente live quanto para sandbox.
Guarde suas chaves em um local seguro. Elas serão usadas para autenticar todas as requisições feitas.

​
Passo 2: Envie seu primeiro pedido

Faça uma requisição POST para o endpoint de pedidos:
curl -X POST https://admin-api.solomon.com.br/admin/v1/order \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "orderId": "ord_123456789",
    "number": 10234,
    "name": "Pedido #10234",
    "orderStatus": 0,
    "createdAt": "2026-01-10T14:32:10Z",
    "updatedAt": "2026-01-10T14:35:42Z",
    "totalPrice": 249.90,
    "totalDiscounts": 20,
    "shippingPrice": 19.90,
    "paymentMethod": 2,
    "installments": 3,
    "currency": "BRL",
    "discountCode": "WELCOME10",
    "provinceCode": "SP",
    "countryCode": "BR",
    "utmSource": "facebook",
    "utmMedium": "cpc",
    "utmCampaign": "promo_janeiro",
    "utmContent": "video_1",
    "utmTerm": "tenis masculino",
    "userId": "d81a69cf-82d5-4aad-9ecd-5945b3cf3528",
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",
    "browserIp": "189.45.123.10",
    "cartToken": "cart_abcd1234",
    "customer": {
      "customerId": "cus_987654321",
      "name": "Cliente Teste",
      "email": "[email protected]",
      "phone": "+5511999999999",
      "provinceCode": "SP",
      "countryCode": "BR",
      "zip": "12230-000",
      "city": "São José dos Campos",
      "createdAt": "2025-11-02T10:15:00Z",
      "updatedAt": "2026-01-10T14:30:00Z"
    },
    "items": [
      {
        "itemId": "item_1",
        "productId": "prod_123",
        "variantId": "var_azul_42",
        "quantity": 1,
        "price": 199.90,
        "discount": 20.00,
        "createdAt": "2026-01-10T14:32:10Z",
        "updatedAt": "2026-01-10T14:32:10Z"
      }]
  }'
Se a requisição for bem-sucedida, o pedido será registrado na Solomon.

​
Passo 3: Envie um evento com o SDK

Instale o SDK da Solomon:
npm install @solomon/events
Inicialize o SDK no seu frontend ou backend:
import { SolomonSDK } from "@solomon/events";

const solomon = new SolomonSDK({
  companyId: "SEU_COMPANY_ID",
});
Envie um evento de purchase:
solomon.track("CHECKOUT_COMPLETED", {
  items: [{
    item_id: "item_1",
    item_quantity: 1
  }]
}, {
  email: "[email protected]",
  phone: "+5511999999999",
  customer_id: "cus_987654321",
  cart_token: "cart_abcd1234"
});
A Solomon utiliza esses eventos para fazer a atribuição correta de cada pedido.

​
Próximos passos

Agora que você conseguiu enviar seu primeiro pedido, explore outras funcionalidades essenciais:

Enviar e atualizar pedidos

Aprenda como enviar pedidos completos, lidar com atualizações de status e evitar duplicações.

Enviar e atualizar produtos

Envie e mantenha o catálogo de produtos sincronizado com a Solomon.

Enviar eventos do site

Utilize o SDK para rastrear os demais eventos do site, como page view, add to cart e initiate checkout.

Explorar a Referência da API

Entenda como desenvolver soluções de forma técnica com a Solomon.
Need help? See our full documentation or join our community.