Skip to main content
POST
/
order
Enviar pedido
curl --request POST \
  --url https://admin-api.sandbox.solomon.com.br/admin/v1/order \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "orderId": "ord_123456789",
  "number": 10234,
  "name": "Pedido #10234",
  "orderStatus": 0,
  "createdAt": "2026-01-10T14:32:10Z",
  "updatedAt": "2026-01-10T14:35:42Z",
  "totalPrice": 249.9,
  "totalDiscounts": 20,
  "shippingPrice": 19.9,
  "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",
  "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": [
    {
      "item_id": "item_1",
      "productId": "prod_123",
      "variantId": "var_azul_42",
      "quantity": 1,
      "price": 199.9,
      "discount": 20,
      "createdAt": "2026-01-10T14:32:10Z",
      "updatedAt": "2026-01-10T14:32:10Z"
    }
  ]
}
'
{
  "success": true,
  "request_id": "<string>",
  "timestamp": "<string>"
}

Authorizations

​
Authorization
string
header
required

API Key para autenticação

Body

application/json

Pedido a ser processado pela Solomon

​
orderId
string
required

ID do pedido

​
name
string
required

Nome do pedido

​
orderStatus
enum<integer>
required

Status do pedido:

  • 0 - Aprovado
  • 1 - Pendente
  • 2 - Cancelado
Available options:
0,
1,
2
Example:

0

​
createdAt
string<date-time>
required

Data de criação do pedido

Example:

"2026-01-10T14:32:10Z"

​
updatedAt
string<date-time>
required

Data de atualização do pedido

Example:

"2026-01-10T14:32:10Z"

​
totalPrice
number
required

Preço total do pedido

​
paymentMethod
enum<integer>
required

Método de pagamento utilizado na transação:

  • 1 - Cartão de crédito
  • 2 - Depósito
  • 3 - Boleto
  • 4 - Pix
  • 15 - Outro
Available options:
1,
2,
3,
4,
15
Example:

1

​
currency
string
required

Moeda do pedido (ISO 4217)

Example:

"BRL"

​
provinceCode
string
required

Código da província

Example:

"SP"

​
countryCode
string
required

Código do país (ISO 3166-1 alpha-2)

Example:

"BR"

​
customer
object
required

Cliente que fez o pedido

​
items
object[]
required

Itens do pedido

​
number
integer

Número do pedido

​
totalDiscounts
number

Desconto total do pedido

​
shippingPrice
number

Preço do frete

​
installments
integer

Número de parcelas

​
discountCode
string

Código de desconto ou cupom aplicado no pedido

​
utmSource
string

UTM Source presente na URL do pedido

​
utmMedium
string

UTM Medium presente na URL do pedido

​
utmCampaign
string

UTM Campaign presente na URL do pedido

​
utmContent
string

UTM Content presente na URL do pedido

​
utmTerm
string

UTM Term presente na URL do pedido

​
userId
string

ID do usuário que fez o pedido (definido pelo cookie server-side)

​
userAgent
string

User agent do navegador onde o pedido foi feito

​
browserIp
string

IP do navegador onde o pedido foi feito (IPv4 ou IPv6)

​
cartToken
string

Token do carrinho do pedido

Response

Pedido recebido e enfileirado para processamento com sucesso

​
success
boolean
​
request_id
string
​
timestamp
string