Diretório de conectores: transportadoras e agregadores
Conexões diretas (UPS, FedEx, USPS, DHL) e agregadores de uma só chave (Shippo, EasyPost, ShipEngine, ShipStation, Easyship, AfterShip, Sendle): campos exatos e onde obtê-los.
Duas formas de enviar pelo Docklify: conectar uma transportadora diretamente com sua própria conta (tarifas e etiquetas nessa conta) ou um agregador com uma única chave API. Sem credenciais, tudo roda em modo simulação, claramente marcado.
Transportadoras (direto)#
UPS
Tarifas ao vivo, etiquetas e rastreio pela API da UPS, na sua própria conta UPS. O guia completo é «Conectar a UPS»; resumo de campos:
| Campo | Obrigatório? | Onde obter |
|---|---|---|
| Client ID | Obrigatório | UPS Developer Kit → crie um app → credenciais OAuth |
| Client Secret | Obrigatório | A mesma página do app |
| Shipper Number | Obrigatório | Seu número de conta UPS de 6 caracteres; está em qualquer fatura UPS |
A UPS tem credenciais de teste e produção separadas: use conexões separadas e escolha o ambiente certo ao testar.
Ainda sem credenciais? Você pode ensaiar todo o fluxo no Docklify: crie primeiro a conta UPS e deixe os campos de chave vazios; as tarifas da janela de envio, as etiquetas e o rastreio funcionarão em um modo de prática claramente marcado. As tarifas de prática são estimativas apenas para treinamento (com a etiqueta «Simulado»), as etiquetas de prática têm uma grande marca DEMO e não podem ser usadas para enviar, e o rastreio de prática mostra uma linha do tempo de exemplo. Ao salvar credenciais reais, tudo muda automaticamente para dados reais da UPS.
FedEx
Tarifas ao vivo, etiquetas e rastreio pela API da FedEx, na sua própria conta.
| Campo | Obrigatório? | Onde obter |
|---|---|---|
| API Key (Client ID) | Obrigatório | FedEx Developer Portal → My Projects → seu projeto → credenciais API |
| Secret Key (Client Secret) | Obrigatório | A mesma página; exibido uma vez ao criar o projeto |
| Account Number | Obrigatório | Seu número de conta FedEx; está em qualquer fatura |
A FedEx funciona apenas com dados reais — não há modo de prática. Preencha a API Key, a Secret Key e o número da conta acima e salve; tarifas, etiquetas e rastreio passam a rodar na hora na sua conta FedEx. Se as credenciais faltarem ou estiverem incompletas, o Docklify pedirá que você as adicione antes de cotar, comprar uma etiqueta ou rastrear.
USPS
Tarifas, etiquetas e rastreio pelas APIs da USPS. As credenciais OAuth dão tarifas e rastreio; para comprar etiquetas são necessários também CRID / MID / EPS da sua conta de pagamento USPS.
| Campo | Obrigatório? | Onde obter |
|---|---|---|
| Consumer Key | Obrigatório | USPS Developer Portal → Apps → seu app |
| Consumer Secret | Obrigatório | A mesma página do app |
| CRID | Opcional | Seu Customer Registration ID da USPS; necessário para comprar etiquetas |
| MID | Opcional | Seu Mail ID da USPS; do mesmo perfil comercial |
| Conta EPS | Opcional | Seu número de conta EPS da USPS; as etiquetas são cobradas nela |
DHL Express
Tarifas, etiquetas e rastreio pela MyDHL API (Express). As credenciais são emitidas pela DHL; não há página de autosserviço.
| Campo | Obrigatório? | Onde obter |
|---|---|---|
| Usuário | Obrigatório | Emitido pelo seu representante DHL para a MyDHL API (Basic Auth) |
| Senha | Obrigatório | Emitida junto com o usuário |
| Account Number | Obrigatório | Seu número de conta DHL Express; está em qualquer fatura |
Agregadores (uma chave, muitas transportadoras)#
Com um agregador você mantém uma conexão e uma chave; as transportadoras disponíveis dependem das habilitadas na sua conta do agregador. Chaves de teste usam dados de exemplo; as reais criam etiquetas cobradas. O ShipStation não tem sandbox: sua chave é real desde o início.
Shippo
Tarifas, etiquetas e rastreio nas transportadoras da sua conta Shippo, com um único token API.
| Campo | Obrigatório? | Onde obter |
|---|---|---|
| API Token | Obrigatório | Painel Shippo → Settings → API → API tokens. Teste: shippo_test_; real: shippo_live_ |
EasyPost
Tarifas, etiquetas e rastreio nas transportadoras da sua conta EasyPost, com uma única chave API.
| Campo | Obrigatório? | Onde obter |
|---|---|---|
| API Key | Obrigatório | Painel EasyPost → Settings → API Keys. Teste: EZTKtest; produção: EZTKprod |
ShipEngine
Tarifas, etiquetas e rastreio nas transportadoras da sua conta ShipEngine, com uma única chave. Chaves sandbox (TEST_) geram etiquetas de exemplo para praticar todo o fluxo.
| Campo | Obrigatório? | Onde obter |
|---|---|---|
| API Key | Obrigatório | Painel ShipEngine → Settings → API Management → API keys |
ShipStation
Tarifas e etiquetas pela sua conta ShipStation (API V2). Importante: o ShipStation V2 não tem sandbox; etiquetas criadas com esta chave são reais e cobradas.
| Campo | Obrigatório? | Onde obter |
|---|---|---|
| API Key | Obrigatório | ShipStation → Settings → Account → API Settings → API keys (V2) |
Easyship
Tarifas, etiquetas e rastreio nas transportadoras da sua conta Easyship, com um token de acesso. O sandbox da Easyship é um ambiente separado com token próprio.
| Campo | Obrigatório? | Onde obter |
|---|---|---|
| Access Token | Obrigatório | Painel Easyship → Settings → API Integration → token de acesso (produção: prod_) |
AfterShip (Postmen)
Tarifas e etiquetas pela sua conta Postmen (AfterShip Shipping). O Postmen não oferece API de rastreio: use-o para tarifas e etiquetas.
| Campo | Obrigatório? | Onde obter |
|---|---|---|
| API Key | Obrigatório | Painel Postmen → Settings → API (cabeçalho as-api-key) |
| Slug da conta shipper | Opcional | O slug da conta de transportadora no Postmen, se tiver várias |
Sendle
Etiquetas e rastreio com a Sendle (AU / US / CA). A Sendle não tem API de comparação de tarifas: a cotação vem por pedido ao criá-lo.
| Campo | Obrigatório? | Onde obter |
|---|---|---|
| Sendle ID | Obrigatório | Painel Sendle → Settings → API (seu Sendle ID) |
| API Key | Obrigatório | A mesma página de API (Basic Auth com o Sendle ID) |