DocumentaçãoAplicativos e integrações
Conectar Shippo para envio
Adicione uma chave de API Shippo, confirme a conexão e desconecte Shippo com segurança.
Conecte Shippo quando quiser que o Runner use sua conta Shippo para envio e cumprimento. A conexão usa uma chave de API fornecida pelo Shippo.
Antes de começar
Caminho de entrada: Projeto → Aplicativos → Aplicativos de loja → Shippo
Você precisa de:
- uma conta Shippo e uma chave de API Shippo atual;
- autoridade para conectar essa conta ao espaço de trabalho Runner; e
- consciência de que desconectar Shippo remove sua chave e a desativa para todos os projetos no espaço de trabalho.
Não cole a chave de API em chat ou documentação.
Controles e resultados Shippo
| Controle | Por que é útil | O que acontece a seguir |
|---|---|---|
| Conectar | Abre a configuração Shippo. | O Runner solicita Chave de API Shippo. |
| Chave de API Shippo | Identifica sua conta Shippo. | O Runner verifica o formato da chave e mostra um erro enquanto o valor é inválido. |
| Ícone de olho | Permite inspecionar o valor para erros de digitação. | Alterna o campo entre texto oculto e visível. Oculte-o novamente antes de compartilhar sua tela. |
| Diálogo Conectar | Envia a chave. | Em caso de sucesso, o Runner fecha o diálogo, limpa o campo e altera o cartão para conectado. |
| Cancelar ou fechar | Sai da configuração sem enviar. | O Runner limpa a chave inserida do diálogo. |
| Excluir ou Desconectar | Inicia a remoção. | O Runner abre Desconectar Shippo? com o impacto em todo o espaço de trabalho. |
| Confirmação Desconectar | Remove a conexão salva. | O Runner remove a chave de API e desativa Shippo para todos os projetos do espaço de trabalho. |
Conectar Shippo
- Abra Projeto → Aplicativos.
- Encontre Shippo e selecione Conectar.
- Copie a chave de API da conta Shippo que você pretende usar.
- Cole-a em Chave de API Shippo.
- Se o Runner relatar uma chave inválida, retorne ao Shippo e copie-a novamente em vez de editar o segredo por adivinhação.
- Selecione Conectar no diálogo.
- Aguarde a mensagem de sucesso e confirme que o cartão mostra seu controle de desconexão conectado.
- Use dados de teste seguro para verificar o fluxo de envio antes de confiar nele para pedidos de clientes.
Desconectar ou substituir a chave
Selecione o controle de desconexão do cartão e leia Desconectar Shippo?. Confirme apenas quando for aceitável remover a chave e desativar Shippo para cada projeto no espaço de trabalho.
Para usar uma chave diferente, desconecte a integração atual, confirme que o cartão não está mais conectado, depois conclua o fluxo de conexão com a chave de substituição.
Se Shippo não se conectar
- Chave de API inválida significa que o valor não corresponde ao formato de chave Shippo aceito.
- Falha ao conectar Shippo significa que o Runner não terminou a conexão do provedor. Mantenha a chave privada, confirme que está atual em Shippo e tente novamente no cartão.
- Se o diálogo fechar mas o cartão não se conectar, atualize os aplicativos antes de enviar novamente.
- Se a desconexão falhar, assuma que a chave existente ainda está ativa.
- Um cartão conectado não prova que taxas, rótulos, transportadoras ou um envio específico funcionam. Verifique essas operações separadamente com dados de teste seguro.