Pedidos

Um pedido (order) é criado a partir de um orçamento. Ao criar o pedido, o CGD envia automaticamente a solicitação para o fornecedor (tenant), que confirmará a disponibilidade e iniciará a operação.

Orçamento obrigatório. Não é possível criar um pedido sem um orçamento prévio. Todos os valores financeiros são derivados do orçamento — o parceiro não informa preços.Um orçamento com status converted não pode ser usado novamente.

Endpoints

Método	Endpoint	Descrição
`POST`	`/orders`	Criar pedido a partir de orçamento
`GET`	`/orders`	Listar pedidos
`GET`	`/orders/{id}`	Buscar pedido por ID

Criar pedido

Campos da requisição

Campo	Tipo	Obrigatório	Descrição
`customer_id`	integer	Sim	ID do cliente no CGD
`quote_id`	integer	Sim	ID do orçamento a ser convertido em pedido

curl -X POST https://gds.fretatech.com.br/api/partner/v1/orders \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": 5,
    "quote_id": 76
  }'

Os valores financeiros (preço, margem, taxa de serviço) são herdados diretamente do orçamento, que por sua vez foi calculado a partir da busca de disponibilidade.

Erros possíveis na criação

HTTP	Mensagem	Causa
`422`	Este orçamento já foi convertido em pedido	O `quote_id` informado já gerou um pedido anteriormente

Resposta

{
  "success": true,
  "data": {
    "id": 120,
    "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "customer": {
      "id": 5,
      "uuid": "6039e108-f7ac-4b19-9a2c-bbf822d6de18",
      "name": "AC DA SILVA",
      "email": "email@email.com.br",
      "phone": null
    },
    "pricing": {
      "cost": 1610801,
      "central_commission_percentage": "10.00",
      "central_commission_value": 161080,
      "service_price": 1771881,
      "central_service_tax_percentage": "0.00",
      "central_service_tax_value": 0,
      "subtotal_amount": 1799881,
      "markup_percentage": "0.00",
      "markup_amount": 0,
      "total_amount": 2195855,
      "service_fee_percentage": "7.00",
      "service_fee_value": 125992,
      "margin_percentage": "15.00",
      "margin_value": 269982
    },
    "status": "A Faturar",
    "sync_status": "pending",
    "items": [
      {
        "id": 215,
        "tenant_id": "fb4a8f4c-617a-45f8-a2e9-0aebbc5cd0f5",
        "vehicle_id": 28,
        "vehicle_name": "Ônibus Semi-Leito 46 Lugares Motor Traseiro - Bela Vista",
        "type": "onewaytrip",
        "service_price": 1771881,
        "total_amount": 2195855,
        "origin_address": {
          "address": "Peruíbe, SP, Brasil",
          "city": "Peruíbe",
          "lat": "-24.3182917",
          "lng": "-46.9940600"
        },
        "destination_address": {
          "address": "Aparecida, SP, Brasil",
          "city": "Aparecida",
          "lat": "-22.8469289",
          "lng": "-45.2316803"
        },
        "start_date": "2026-03-09T07:00:00-03:00",
        "end_date": "2026-03-09T07:00:00-03:00",
        "status": "Programado"
      }
    ],
    "created_at": "2026-03-08T17:45:00-03:00",
    "updated_at": "2026-03-08T17:45:00-03:00"
  },
  "message": "Pedido criado com sucesso"
}

Campos da resposta

Campo	Tipo	Descrição
`id`	integer	ID do pedido
`uuid`	string	UUID do pedido
`status`	string	Status atual do pedido (veja abaixo)
`pricing.cost`	integer	Custo bruto do fornecedor em centavos
`pricing.central_commission_value`	integer	Taxa da Central em centavos
`pricing.service_price`	integer	Preço com taxa Central incluída, em centavos
`pricing.subtotal_amount`	integer	Subtotal (service_price + despesas motorista) em centavos
`pricing.service_fee_value`	integer	Taxa de serviço CGD em centavos
`pricing.margin_value`	integer	Margem do parceiro em centavos
`pricing.total_amount`	integer	Total final em centavos
`items`	array	Itens do pedido (um por trecho da viagem)

Fluxo de status do pedido

A Faturar → Faturado → Confirmado (Pago) → Em Execução → Concluído
                                       ↘
                                      Cancelado (qualquer etapa)

Status	Descrição
`A Faturar`	Pedido criado, aguardando faturamento
`Faturado`	Fatura emitida
`Confirmado (Pago)`	Pagamento confirmado
`Em Execução`	Serviço em execução
`Concluído`	Serviço concluído com sucesso
`Cancelado`	Pedido cancelado

As mudanças de status são notificadas via webhook (order.status_changed). Veja Webhooks.

Listar pedidos

curl -X GET "https://gds.fretatech.com.br/api/partner/v1/orders?status=Confirmado&customer_id=5&date_from=2026-04-01" \
  -H "Authorization: Bearer SUA_API_KEY"

Parâmetros de filtro

Parâmetro	Tipo	Descrição
`status`	string	Filtra por status do pedido
`customer_id`	integer	Filtra por cliente
`date_from`	string	Data inicial de criação (`YYYY-MM-DD`)
`date_to`	string	Data final de criação (`YYYY-MM-DD`)

Buscar pedido por ID

curl -X GET https://gds.fretatech.com.br/api/partner/v1/orders/120 \
  -H "Authorization: Bearer SUA_API_KEY"

Retorna o objeto completo do pedido, incluindo o array items com os serviços vinculados. Use os IDs dos itens para consultar dados operacionais via endpoint de Serviços.

Início

Referência

Endpoints

Criar pedido

Campos da requisição

Erros possíveis na criação

Resposta

Campos da resposta

Fluxo de status do pedido

Listar pedidos

Parâmetros de filtro

Buscar pedido por ID

​Endpoints

​Criar pedido

​Campos da requisição

​Erros possíveis na criação

​Resposta

​Campos da resposta

​Fluxo de status do pedido

​Listar pedidos

​Parâmetros de filtro

​Buscar pedido por ID

Endpoints

Criar pedido

Campos da requisição

Erros possíveis na criação

Resposta

Campos da resposta

Fluxo de status do pedido

Listar pedidos

Parâmetros de filtro

Buscar pedido por ID