Faça sua primeira chamada em menos de 2 minutos

Siga os passos abaixo para gerar seu token de acesso e realizar sua primeira chamada à API da Rede Frota. Em poucos minutos, você já terá sua integração funcionando.

1. Obter credenciais OAuth2

Crie sua conta em nosso Portal Developer e assim que sua conta for aprovada
Aguarde a confirmação pelo Time de integração Rede Frota, você vai receber um e-mail
Você já pode continuar para a sua primeira chamada
Após o e-mail de aprovação, acesse Perfil → Subscriptions para encontrar seu client_id e gerar o client_secret que você usará no próximo passo.

2. Gerar o token JWT

Todas as requisições devem incluir um token JWT, obtido previamente na API de autenticação da Rede Frota.

Request

curl -X POST "https://api-homologacao.redefrota.com.br/auth-sso/api/oauth/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=SEU_CLIENT_ID&client_secret=SEU_CLIENT_SECRET"

Response

{ 
"accessToken": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSl......9SmgxZ4ow",
"expiresIn": 3600,
"refreshToken": null,
"refreshExpiresIn": 0,
"tokenType": "Bearer"
}

3. Consultar transações

Agora utilize o token retornado para fazer sua primeira chamada

Request

curl -X GET "https://api-homologacao.redefrota.com.br/fleet-integration/v1/customers/transactions?\
customer_id=14589&\
start_date=2025-01-01&\
end_date=2025-01-31" \
-H "Authorization: Bearer SEU_TOKEN"

Response 200

Se a requisição for bem-sucedida, a API retornará status 200 OK com a lista de transações:

{
    "previous_page": 3,
    "next_page": 5,
    "current_page": 4,
    "is_last": false,
    "total_pages": 6,
    "total_items": 118,
    "total_items_page": 20,
    "max_items_per_page": 20,
    "paged": true,
    "data": [
        {
            "transaction_id": 8472017,
            "transaction_date": "2025-01-15T10:19:02",
            "plate": "NOP-0N12",
            "fuel_type": "DIESEL S-10",
            "liters": 772,
            "amount": 4855.88,
            "odometer": 353963,
            "supplier_document": "11122233000144",
            "city_name": "Belo Horizonte",
            "driver_document": "787.***.***.98",
            "driver_name": "FELIPE CARDOSO",
            "driver_id": 1014,
            "driver_registration": "",
            "collection_document": null,
            "is_cancelled": false,
            "cancellation_date": null,
            "customer_id": 14589,
            "invoice_key": null
        },
        {
            "transaction_id": 8472018,
            "transaction_date": "2025-01-15T10:14:34",
            "plate": "QRS-3P45",
            "fuel_type": "DIESEL S-10",
            "liters": 300.26,
            "amount": 1891.638,
            "odometer": 369591,
            "supplier_document": "33344455000111",
            "city_name": "Manaus",
            "driver_document": "909.***.***.10",
            "driver_name": "BEATRIZ MENDES",
            "driver_id": 1015,
            "driver_registration": "",
            "collection_document": null,
            "is_cancelled": false,
            "cancellation_date": null,
            "customer_id": 14589,
            "invoice_key": "NFE22220000111100002222333344445555666677778888"
        }
    ]
}

Response 401 - Token inválido/expirado

{
    "type": "https://developer.redefrota.com.br/errors/authentication",
    "title": "Unauthorized",
    "status": 401,
    "detail": "Token de autenticação inválido ou ausente.",
    "instance": "/v1/customers/transactions"
}

Response 400 - Dados de acessos inválidos

{
    "type": "https://docs.redefrota.com.br/errors/validation",
    "title": "Validation Error",
    "status": 400,
    "detail": "Existem erros nos campos enviados.",
    "instance": "/v1/customers/transactions",
    "errors": {
        "invoice_key": [
            "invoice_key não pode ser combinado com start_date ou end_date."
        ]
    }
}

Sua primeira comunicação foi finalizada

A autenticação foi realizada com sucesso
O token JWT é válido
A API está acessível e respondendo normalmente