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

  1. Crie sua conta em nosso Portal Developer e assim que sua conta for aprovada

  2. Aguarde a confirmação pelo Time de integração Rede Frota, você vai receber um e-mail

  3. Você já pode continuar para a sua primeira chamada

  4. 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 com notas pendentes

Agora utilize o token retornado para fazer sua primeira chamada como Fornecedor.

Request

curl -X GET "https://api-homologacao.redefrota.com.br/supplier-integration/v1/suppliers/invoices/pending?\
supplier_document=12345678000199&\
customer_document=98765432000188&\
page=1&\
page_size=10" \
-H "Accept: application/json" \
-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 com notas pendentes:

{
    "previous_page": 0,
    "next_page": 2,
    "current_page": 1,
    "is_last": false,
    "total_pages": 5,
    "total_items": 47,
    "total_items_page": 2,
    "max_items_per_page": 10,
    "paged": true,
    "data": [
        {
            "transaction_date": "2025-01-15T14:32:18",
            "transaction_id": 4081505,
            "station_name": "Posto Modelo - Goiânia",
            "customer_name": "Transportadora Exemplo LTDA",
            "quantity": 145.50,
            "value": 882.76,
            "product_name": "Diesel S10",
            "license_plate": "AAA-0102",
            "days_pending": 12,
            "repass_date": null,
            "repass_status": "PENDING"
        },
        {
            "transaction_date": "2025-01-16T09:12:45",
            "transaction_id": 4081506,
            "station_name": "Posto Modelo - Goiânia",
            "customer_name": "Transportadora Exemplo LTDA",
            "quantity": 220.00,
            "value": 1320.00,
            "product_name": "Diesel S10",
            "license_plate": "BXZ-0008",
            "days_pending": 11,
            "repass_date": null,
            "repass_status": "PENDING"
        }
    ]
}

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/suppliers/invoices/pending"
}

Response 400 - Dados inválidos

{
    "type": "https://docs.redefrota.com.br/errors/validation",
    "title": "Validation Error",
    "status": 400,
    "detail": "Existem erros nos campos enviados.",
    "instance": "/v1/suppliers/invoices/pending",
    "errors": {
        "start_date": [
            "O campo start_date é obrigatório quando nenhum outro filtro é informado."
        ]
    }
}

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