Transportadoras e contas de transportadora: mantenha as transportadoras e as credenciais de suas contas

Crie um perfil por transportadora e guarde abaixo a conta de envio e as credenciais de API de cada Client — tarifas e etiquetas sempre usam a conta certa.

O Docklify mantém as transportadoras em duas camadas. O perfil da transportadora (Master Data → Transportadoras) diz quem ela é: nome, SCAC, métodos de envio e serviços suportados. A conta da transportadora (Master Data → Contas de transportadora) diz como você envia com ela: uma conta por Client, com o número da conta e as credenciais de API para tarifas e etiquetas. Mantenha as camadas separadas: um perfil atende vários Clients, e um Client pode ter várias contas na mesma transportadora.

Etapa 1: Crie um perfil de transportadora#

1. Abra Master Data → Transportadoras e clique em "+ Nova transportadora".
2. Em Informações básicas, informe o Nome (obrigatório) e escolha um Status: ACTIVE, INACTIVE ou EXCEPTION.
3. Em Informações de contato, preencha os Métodos de envio (obrigatório, separados por vírgula, ex.: "Ground, Air") e o Método de envio padrão (obrigatório).
4. Adicione os identificadores e contatos que tiver: Serviço de entrega, SCAC, USDOT, MC Number, SCAC do parceiro, cobertura de CEP, nome do contato, telefone e e-mail. Marque "Proibir carga mista" se esta transportadora nunca deve misturar remessas em uma carga.
5. Em Gerenciamento E-pro, escolha se a transportadora se aplica a todos os armazéns ou apenas a alguns, e clique em Criar.

De volta à lista (Master Data → Transportadoras), você pode filtrar por nome, SCAC, MC Number, USDOT e status, ver quantos serviços cada transportadora tem e usar Exportar para baixar a lista em CSV.

Etapa 2: Adicione os serviços suportados pela transportadora#

1. Abra a transportadora pela lista (clique no nome dela) — a página de edição tem um cartão separado "Serviços suportados" abaixo do formulário.
2. Clique em "+ Adicionar serviço" e preencha uma linha por serviço: Código do serviço (ex.: UPS_GROUND) e Nome do serviço (ex.: UPS Ground) são obrigatórios; o nome em chinês e os dias de trânsito são opcionais.
3. Use a caixa Ativo para ligar ou desligar um serviço sem excluí-lo e clique em "Salvar serviços". O botão ✕ remove a linha (pede confirmação antes).

• Salve primeiro a transportadora e depois adicione os serviços — o cartão de serviços pertence a uma transportadora existente.
• Esses serviços são os que a Estação de Envio oferece ao calcular tarifas e imprimir etiquetas, então mantenha os códigos exatamente como a transportadora os nomeia.

Etapa 3: Crie uma conta de transportadora para um Client#

1. Abra Master Data → Contas de transportadora e clique em "+ Nova conta de transportadora".
2. Em Informações básicas, selecione a Transportadora e o Client dono da conta, e informe o Número da conta (os três são obrigatórios). Nome e Empresa são rótulos opcionais para sua referência.
3. Marque o que se aplica: "É conta de devolução" para uma conta só de devoluções, "Conta House" para sua conta própria e "Modo de teste" enquanto você ainda testa no sandbox da transportadora.
4. Preencha a seção Endereço (linhas, cidade, estado, CEP, país, telefone) — é o endereço vinculado à conta; o Smart Post Hubid e um número de conta de devolução separado também ficam aqui quando a transportadora os usa.
5. Em Credenciais da API, informe as credenciais que a transportadora emitiu para esta conta: API Client ID e API Client Password são obrigatórios ao criar a conta; API Token, Track API Key e Track API Secret são preenchidos quando a transportadora os usa.
6. Clique em Criar. A lista mostra a conta sob o seu Client, com o modo (Modo de teste / Produção) e o status.

As credenciais são armazenadas criptografadas e nunca são exibidas — a lista mostra apenas o API Client ID, nunca uma senha ou segredo. Ao editar uma conta (Master Data → Contas de transportadora → clique no número da conta), um campo de senha já salvo mostra "Senha definida (deixe em branco para manter)": deixe em branco e o valor antigo permanece. A mesma página tem um botão Desativar / Ativar que alterna a conta entre INACTIVE e ACTIVE sem excluí-la.

Etapa 4: Conecte as contas de envio em Integration#

1. Abra Integration → Carriers e clique em "Nova conta". Escolha a transportadora no catálogo pela busca — o catálogo mostra o tipo de cada uma (encomendas, LTL ou FTL) e como ela se conecta.
2. Informe o número da conta, escolha o Modo de etiqueta — "API (tarifas e etiquetas em tempo real)" para calcular e imprimir pela API da transportadora, ou "Offline (conhecimento manual)" para digitar os números — e marque os serviços ativados que esta conta pode usar.
3. Preencha a seção Credenciais (os campos seguem o tipo de acesso da transportadora: chave de API / ID do cliente e segredo, senha da conta ou token de acesso) e marque "Definir como transportadora padrão" se ela deve ser a conta escolhida primeiro. Credenciais salvas nunca são exibidas de novo — deixe um campo em branco para manter o valor salvo.
4. Salve e use as ações da linha na lista: o interruptor Ativado liga ou desliga a conta, "Testar" executa um teste de conexão e registra o horário na coluna Último teste, e Editar / Excluir gerenciam a conta (excluir também remove as credenciais salvas).

Se um resultado tiver o selo "Simulação", aquele teste foi simulado e não chamou a transportadora de verdade — trate-o como um ensaio do fluxo e rode o teste de novo quando as credenciais reais estiverem cadastradas. As contas desta página de Integration são as mesmas que o restante do Docklify lê ao enviar, então há uma única lista para manter atualizada, não duas.

Recursos do Docklify usados neste artigo#

• Perfis de transportadora com filtros e exportação CSV — Master Data → Transportadoras (/master-data/carriers)
• Lista de serviços suportados da transportadora — Master Data → Transportadoras → abrir uma transportadora → Serviços suportados
• Contas de transportadora por Client, com credenciais de API criptografadas — Master Data → Contas de transportadora (/master-data/carrier-accounts)
• Conexões de transportadoras de envio: catálogo, modo de etiqueta, conta padrão e teste de conexão — Integration → Carriers (/integration/carriers)