---
title: Guia de Integração API TruckPad — Documentação, Autenticação e Primeiros Passos
description: Acesse a documentação das APIs CIOT e VPO e os endpoints de staging. Use login TruckPad / senha TruckPad para iniciar integração.
---
[Pular para o conteúdo](https://ajuda.truckpad.com.br/conhecimento/como-acessar-documentação-e-staging-das-apis-ciot-e-vpo#main-content)
Português - Brasil
Mostrar submenu para traduções
[Mais suporte](https://ajuda.truckpad.com.br/conhecimento/kb-tickets/new?hsLang=pt-br)
Abrir navegação principal
Fechar navegação principal
- Português - Brasil
Mostrar submenu para traduções
- [Mais suporte](https://ajuda.truckpad.com.br/conhecimento/kb-tickets/new)
- Nosso contato
Nosso contato
Como podemos ajudá-lo?
- Não há sugestões porque o campo de pesquisa está em branco.
1. [Central de Conhecimento](https://ajuda.truckpad.com.br/conhecimento?hsLang=pt-br)
2. [Para desenvolvedores](https://ajuda.truckpad.com.br/conhecimento/para-desenvolvedores?hsLang=pt-br)
3. [Nossa API](https://ajuda.truckpad.com.br/conhecimento/para-desenvolvedores?hsLang=pt-br#nossa-api)
# Guia de Integração API TruckPad — Documentação, Autenticação e Primeiros Passos
## Uma das principais vantagens do TruckPad é a possibilidade de integrar nossa plataforma diretamente ao TMS ou ERP utilizado pela sua empresa, tornando o processo de emissão mais rápido, prático e automatizado. Neste artigo, vamos mostrar os primeiros passos para começar essa integração com a nossa API. Você encontrará informações sobre onde acessar a documentação técnica, como funciona a autenticação e quais credenciais são necessárias em cada etapa do processo. A ideia é deixar o caminho o mais simples possível para que seu time de desenvolvimento consiga entender o funcionamento da API e começar a integração com o TruckPad.
> #### **1. Primeiros Passos**
Para iniciar a integração é importante:
- Definir qual API será utilizada: **CIOT** ou **VPO**.
- Acesso à documentação técnica correspondente.
- Credenciais de para autenticação.
- Realizar a autenticação no ambiente de homologação
- Conhecimento básico sobre APIs REST, requisições HTTP e JSON.
Com esses pontos organizados, o você já estará preparado para seguir o procedimento descrito nas próximas seções.
> #### **2. APIs disponíveis**
Atualmente disponibilizamos 2 API’s distintas:
**- API para emissões de CIOT – Código Identificador da Operação de Transporte**
- Emissão de CIOT nos tipos:
- Lotação;
- Fracionado;
- TAC Agregado.
- Emissão e gerenciamento do VPO;
- Integração com as seguintes TAGs:
- Sem Parar;
- ConectCar;
- Veloe;
- Move Mais.
**- API para emissões de VPO – Vale-Pedágio Obrigatório**
**Observação:** as APIs possuem documentações e fluxos próprios. Consulte sempre a documentação correspondente à funcionalidade que deseja integrar, evitando buscar informações de uma API na documentação da outra.
> #### **3. Acesso à documentação técnica**
A documentação técnica das APIs de CIOT e VPO estão disponíveis, no seguinte endereço:
**CIOT - Ambiente de produção**
[https://ciot.api.truckpad.io/docs#/](https://ciot.api.truckpad.io/docs#/)
[https://ciot.api.truckpad.io/redoc](https://ciot.api.truckpad.io/redoc)
**CIOT - Ambiente de homolog**
[https://ciot.api.homolog.truckpad.io/docs#/](https://ciot.api.homolog.truckpad.io/docs#/)
[https://ciot.api.homolog.truckpad.io/redoc](https://ciot.api.homolog.truckpad.io/redoc)
**VPO - Ambiente de produção**
[https://api.truckpad.io/vpo/docs](https://api.truckpad.io/vpo/docs)
**VPO - Ambiente de homolog**
https://api.homolog.truckpad.io/vpo/docs
Para acessar a documentação de **VPO** , utilize as credenciais abaixo:
- **Login:** TruckPad
- **Senha:** TruckPad
> #### **4. Como navegar pela documentação**
Dentro da documentação, o integrador encontrará:
- Endpoints disponíveis;
- Métodos HTTP;
- Parâmetros;
- Headers;
- Payloads;
- Campos obrigatórios;
- Exemplos de request;
- Exemplos de response;
- Códigos de retorno;
- Schemas;
- Regras específicas de cada recurso.
Essa seção funciona como um mapa para quem está entrando na documentação pela primeira vez, facilitando a localização das informações técnicas necessárias para a integração.
> #### **5. Ambiente de homologação**
O ambiente de (**homologação**) é o espaço destinado à realização de testes antes de qualquer integração ir para produção.
Pontos importantes sobre esse ambiente:
- Deve ser utilizado para validar o fluxo de integração antes do go-live.
- Os endpoints de homolog para os recursos CIOT e VPO estão disponíveis na própria documentação.
- Todos os testes devem ser realizados nesse ambiente antes de qualquer chamada em produção.
- As URLs e endpoints devem ser sempre consultados na documentação vigente evite reutilizar links de materiais antigos ou exemplos desatualizados, pois isso pode levar a falhas na integração.
> #### **6. Autenticação da API**
As credenciais utilizadas para acessar a documentação (login e senha "TruckPad") **não** correspondem às credenciais utilizadas para autenticação das requisições da própria API.
O processo de autenticação da API — incluindo geração de token, headers necessários e demais parâmetros — deve ser consultado diretamente na documentação técnica de cada recurso (CIOT ou VPO), já que pode variar conforme o endpoint utilizado.
> #### **7. Fluxo Recomendado para integração**
1. Acessar a documentação
2. Consultar a API desejada (CIOT ou VPO)
3. Identificar o endpoint de homolog
4. Configurar a autenticação
5. Montar a request conforme o schema
6. Executar os testes em staging
7. Validar response e regras de negócio
8. Homologar a integração
9. Solicitar/realizar a configuração para produção
> #### **8. Boas práticas e pontos de atenção**
- Sempre utilizar a documentação vigente.
- Não utilizar endpoints encontrados em materiais antigos.
- Validar os campos obrigatórios antes do envio.
- Não utilizar as credenciais de documentação como credenciais da API.
- Realizar testes em staging antes de ir para produção.
- Validar request e response durante os testes.
- Em caso de erro, registrar endpoint, método HTTP, payload e response para análise.
- [Duvidas Gerais](https://ajuda.truckpad.com.br/conhecimento/duvidas-gerais?hsLang=pt-br#main-content)
- [Webinar](https://ajuda.truckpad.com.br/conhecimento/duvidas-gerais?hsLang=pt-br#webinar)
- [CIOT](https://ajuda.truckpad.com.br/conhecimento/ciot?hsLang=pt-br#main-content)
- [CIOT](https://ajuda.truckpad.com.br/conhecimento/ciot?hsLang=pt-br#ciot)
- [Codigos de erros](https://ajuda.truckpad.com.br/conhecimento/ciot?hsLang=pt-br#codigos-de-erros)
- [Vale-Pedágio obrigatório](https://ajuda.truckpad.com.br/conhecimento/vale-ped%C3%A1gio-obrigat%C3%B3rio?hsLang=pt-br)
- [Plataforma TruckPad](https://ajuda.truckpad.com.br/conhecimento/plataforma-truckpad?hsLang=pt-br#main-content)
- [Integrações existentes](https://ajuda.truckpad.com.br/conhecimento/plataforma-truckpad?hsLang=pt-br#integra%C3%A7%C3%B5es-existentes)
- [Para desenvolvedores](https://ajuda.truckpad.com.br/conhecimento/para-desenvolvedores?hsLang=pt-br#main-content)
- [Nossa API](https://ajuda.truckpad.com.br/conhecimento/para-desenvolvedores?hsLang=pt-br#nossa-api)
- [Atualizações](https://ajuda.truckpad.com.br/conhecimento/atualiza%C3%A7%C3%B5es?hsLang=pt-br#main-content)
- [Plataforma TruckPad](https://ajuda.truckpad.com.br/conhecimento/atualiza%C3%A7%C3%B5es?hsLang=pt-br#plataforma-truckpad)
# TruckPad
[mailto:email@email.com](mailto:email@email.com)
Copyright © 2026, TruckPad