> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solomon.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar Pedido

> Envia um pedido para ser processado assincronamente pela Solomon



## OpenAPI

````yaml post /order
openapi: 3.1.0
info:
  title: Solomon Admin API
  description: API aberta para integração com a Solomon
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://admin-api.sandbox.solomon.com.br/admin/v1
  - url: https://admin-api.solomon.com.br/admin/v1
security:
  - ApiKeyAuth: []
paths:
  /order:
    post:
      summary: Enviar pedido
      description: Envia um pedido para ser processado assincronamente pela Solomon
      requestBody:
        description: Pedido a ser processado pela Solomon
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Order'
            example:
              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: cliente_teste@email.com
                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'
        required: true
      responses:
        '202':
          description: Pedido recebido e enfileirado para processamento com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Success'
        '400':
          description: Erro de validação dos dados do pedido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Erro interno do servidor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Order:
      required:
        - orderId
        - name
        - orderStatus
        - createdAt
        - updatedAt
        - totalPrice
        - paymentMethod
        - currency
        - provinceCode
        - countryCode
        - customer
        - items
      type: object
      properties:
        orderId:
          description: ID do pedido
          type: string
        number:
          description: Número do pedido
          type: integer
        name:
          description: Nome do pedido
          type: string
        orderStatus:
          description: |-
            Status do pedido:
             * 0 - Aprovado
             * 1 - Pendente
             * 2 - Cancelado
          type: integer
          enum:
            - 0
            - 1
            - 2
          example: 0
        createdAt:
          description: Data de criação do pedido
          type: string
          format: date-time
          pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$
          example: '2026-01-10T14:32:10Z'
        updatedAt:
          description: Data de atualização do pedido
          type: string
          format: date-time
          pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$
          example: '2026-01-10T14:32:10Z'
        totalPrice:
          description: Preço total do pedido
          type: number
        totalDiscounts:
          description: Desconto total do pedido
          type: number
        shippingPrice:
          description: Preço do frete
          type: number
        paymentMethod:
          description: |-
            Método de pagamento utilizado na transação:
             * 1 - Cartão de crédito
             * 2 - Depósito
             * 3 - Boleto
             * 4 - Pix
             * 15 - Outro
          type: integer
          enum:
            - 1
            - 2
            - 3
            - 4
            - 15
          example: 1
        installments:
          description: Número de parcelas
          type: integer
        currency:
          description: Moeda do pedido (ISO 4217)
          type: string
          pattern: ^[A-Z]{3}$
          example: BRL
        discountCode:
          description: Código de desconto ou cupom aplicado no pedido
          type: string
        provinceCode:
          description: Código da província
          type: string
          example: SP
          pattern: ^[A-Z]{2}$
        countryCode:
          description: Código do país (ISO 3166-1 alpha-2)
          type: string
          pattern: ^[A-Z]{2}$
          example: BR
        utmSource:
          description: UTM Source presente na URL do pedido
          type: string
        utmMedium:
          description: UTM Medium presente na URL do pedido
          type: string
        utmCampaign:
          description: UTM Campaign presente na URL do pedido
          type: string
        utmContent:
          description: UTM Content presente na URL do pedido
          type: string
        utmTerm:
          description: UTM Term presente na URL do pedido
          type: string
        userId:
          description: ID do usuário que fez o pedido (definido pelo cookie server-side)
          type: string
        userAgent:
          description: User agent do navegador onde o pedido foi feito
          type: string
        browserIp:
          description: IP do navegador onde o pedido foi feito (IPv4 ou IPv6)
          type: string
        cartToken:
          description: Token do carrinho do pedido
          type: string
        origin:
          description: |-
            Origem do pedido:
             * 0 - Web
             * 1 - Marketplace
             * 2 - App
          type: integer
          enum:
            - 0
            - 1
            - 2
          example: 0
        customer:
          description: Cliente que fez o pedido
          type: object
          required:
            - customerId
            - name
            - email
            - provinceCode
            - countryCode
            - zip
            - city
          properties:
            customerId:
              description: ID do cliente
              type: string
            name:
              description: Nome do cliente
              type: string
            email:
              description: Email do cliente
              type: string
            phone:
              description: Telefone do cliente
              type: string
            provinceCode:
              description: Código da província do cliente
              type: string
              example: SP
              pattern: ^[A-Z]{2}$
            countryCode:
              description: Código do país do cliente (ISO 3166-1 alpha-2)
              type: string
              pattern: ^[A-Z]{2}$
              example: BR
            zip:
              description: CEP do cliente
              type: string
            city:
              description: Cidade do cliente
              type: string
            createdAt:
              description: Data de criação do cliente
              type: string
              format: date-time
              pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$
              example: '2026-01-10T14:32:10Z'
            updatedAt:
              description: Data de atualização do cliente
              type: string
        items:
          description: Itens do pedido
          type: array
          items:
            type: object
            required:
              - itemId
              - productId
              - variantId
              - quantity
              - price
              - createdAt
              - updatedAt
            properties:
              itemId:
                description: ID do item do pedido
                type: string
              productId:
                description: ID do produto
                type: string
              variantId:
                description: ID da variante
                type: string
              quantity:
                description: Quantidade do item
                type: integer
              price:
                description: Preço do item
                type: number
              discount:
                description: Desconto do item
                type: number
              createdAt:
                description: Data de criação do item
                type: string
                format: date-time
                pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$
                example: '2026-01-10T14:32:10Z'
              updatedAt:
                description: Data de atualização do item
                type: string
    Success:
      type: object
      properties:
        success:
          type: boolean
        request_id:
          type: string
        timestamp:
          type: string
    Error:
      type: object
      properties:
        success:
          type: boolean
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
        request_id:
          type: string
        timestamp:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      description: API Key para autenticação

````