FleetPay / Developers

Sua Operação. Conectada.

Cadastros, repasses e documentos fiscais. Integre os fluxos da FleetPay ao software que sua operação já usa.

01 / OpenAPI 3.1

Comece em Homologação

Cada ambiente tem sua própria credencial. Crie a sua em Configurações → API de Integração e habilite os escopos necessários.

Homologaçãohttps://api.fleetpay.site/v1

Produçãohttps://api.fleetpay.tech/v1

Verifique o Acesso Fiscal

Exemplo de consulta, sem emissão ou pagamento. Requer o escopo fiscal habilitado.

curl https://api.fleetpay.site/v1/fiscal/status \
  --header "Authorization: Bearer $FLEETPAY_API_KEY" \
  --header "Accept: application/json"

Guarde as credenciais no servidor. Nunca inclua chaves no código do navegador.

02 / Acesso

Permissões Explícitas

Toda credencial começa sem acesso. Os escopos habilitados no painel determinam quais operações ela pode executar.

`fiscal`

Documentos e configuração fiscal. Exclusivo de transportadoras.

`operacao`

Liberação e pagamento de parcelas de repasse. Operações que movimentam dinheiro.

`cadastros`

Convites, consulta de agregados e conferência de chave Pix.

`consultas`

Consultas de RNTRC.

API Key ou OAuth2

As duas formas usam Authorization: Bearer. Chaves estáticas começam com fp_hml_ ou fp_prd_, conforme o ambiente. OAuth2 usa client_credentials em POST /oauth/token, fora de /v1. O token expira em uma hora; emita outro ao expirar.

Respostas de Autorização

Credenciais usadas no ambiente incorreto recebem 401. Uma operação fora dos escopos habilitados recebe 403 com error.code: escopo_nao_habilitado.

Simulação e Efeito Regulatório

O contrato atual identifica operações de CIOT e consultas ANTT simuladas em homologação, sem efeito regulatório. Em produção, essas operações recusam a execução enquanto o provedor correspondente estiver indisponível. CT-e e MDF-e usam integração fiscal de homologação; confira o campo environment antes de tratar uma emissão como definitiva.

03 / MCP

O Próximo Caminho de Integração

Conheça as consultas MCP implementadas e seus limites. A integração externa depende de avaliação, habilitação e validação em homologação.

Explorar o MCP ↗