Conectar a Ordoro: verificar suas credenciais de API
Crie uma chave de API no Ordoro em Settings → Account Settings → API Keys, cole seu Client ID e Client Secret no Integration e teste: o teste usa HTTP Basic para listar seus shippers somente para leitura e confirmar que as credenciais funcionam.
Esta conexão do Ordoro verifica se suas credenciais de API do Ordoro funcionam no Integration: ela confere o Client ID e o Client Secret de uma chave de API do Ordoro via HTTP Basic e lê sua lista de shippers. Tenha o escopo claro: esta conexão serve apenas para verificação de credenciais. Ela não cota tarifas, não compra etiquetas nem busca rastreio por número de rastreamento, porque no Ordoro tarifas e etiquetas passam por endpoints por pedido. Um teste aprovado só prova que suas credenciais são utilizáveis, e nada mais.
Pré-requisitos#
- Uma conta do Ordoro à qual você consiga acessar, com acesso a Settings → Account Settings → API Keys.
- Permissão para criar uma chave de API nessa página. Uma chave fornece os dois valores necessários: um Client ID e um Client Secret.
- Não planeje usar aqui seu e-mail e senha de acesso ao Ordoro. Essa forma de autenticação na API foi descontinuada pelo Ordoro e não funcionará nesses campos: veja a primeira entrada da FAQ.
Obter credenciais#
- Faça login no Ordoro e vá a Settings → Account Settings → API Keys.
- Crie uma chave de API nessa página.
- Copie o Client ID da chave que você acabou de criar. Esse Client ID é o nome de usuário da autenticação HTTP Basic.
- Copie o Client Secret dessa mesma chave de API e guarde-o em local seguro. Esse Client Secret é a senha da autenticação HTTP Basic e deve vir da mesma chave que o Client ID acima.
Preencher no Integration#
- Abra Integration → Marketplace → Ordoro → Nova conexão.
- API Key Client ID (client_id): cole o Client ID da sua chave de API do Ordoro, aquele que você copiou de Settings → Account Settings → API Keys. Ele é tratado como segredo e nunca é exibido. Não preencha aqui seu e-mail de acesso ao Ordoro.
- API Key Client Secret (client_secret): cole o Client Secret dessa mesma chave de API. Ele é tratado como segredo e nunca é exibido. Não preencha aqui sua senha de acesso ao Ordoro, nem combine um Secret de outra chave com o Client ID acima.
- É só isso: esta conexão tem apenas esses dois campos. Não há campo de número de conta, domínio de loja nem ambiente para preencher.
Testar a conexão#
Clique em Testar a conexão. O teste primeiro verifica se os dois campos estão preenchidos e depois usa HTTP Basic —seu Client ID como nome de usuário e seu Client Secret como senha— para listar seus shippers somente para leitura (GET /shipper/?limit=1). Se uma lista de shippers voltar, o teste passa. Interprete esse resultado de forma estrita: um teste aprovado só prova que as credenciais da chave de API conseguem autenticar e ler essa lista. Não prova que tarifas, etiquetas, pedidos ou rastreio funcionem por esta conexão. Se o teste falhar, anote o erro e veja a FAQ abaixo.
Mapping / escolher modelo#
Nesta conexão não há mapeamento para configurar nem modelo para escolher. Ela não traz pedidos nem devolve nada, então não há campos de pedido para mapear. Comparação de tarifas, compra de etiquetas e rastreio por número de rastreamento também não fazem parte desta conexão: no Ordoro, tarifas e etiquetas são tratadas por endpoints por pedido que partem de um pedido do Ordoro, e as informações de rastreio ficam no próprio pedido. Use esta conexão para o único trabalho que ela faz —verificar se as credenciais da sua chave de API do Ordoro funcionam— e trate tarifas e etiquetas pelo fluxo por pedido no Ordoro.
Ativar#
Quando o teste passar, ative a conexão para salvá-la no Integration com essas credenciais verificadas, assim você poderá testá-la de novo depois com os mesmos valores. A ativação não inicia nenhum fluxo de dados: por esta conexão não se trazem pedidos, não se cotam tarifas, não se compram etiquetas nem se sincroniza rastreio. Se depois você criar uma nova chave de API no Ordoro, atualize aqui os dois campos com os valores da nova chave e teste de novo antes de confiar na conexão.
Perguntas frequentes#
Preenchi meu e-mail e senha do Ordoro, mas o teste falha
Esses dois campos não aceitam suas credenciais de acesso. Autenticar-se na API do Ordoro com e-mail e senha foi descontinuado pelo Ordoro, então um e-mail de acesso no campo Client ID e uma senha de acesso no campo Client Secret são rejeitados sempre.
Vá a Ordoro → Settings → Account Settings → API Keys, crie uma chave de API, coloque seu Client ID no campo client_id e o Client Secret dessa mesma chave no campo client_secret, e teste de novo.
O teste falha com 401
O Ordoro não aceitou o par Client ID e Client Secret. As causas habituais são erro ao digitar ou copiar, os dois valores trocados entre os campos, espaços extras copiados junto com um valor, ou um Client ID combinado com o Client Secret de outra chave de API.
Abra a única chave de API que você quer usar em Ordoro → Settings → Account Settings → API Keys, copie novamente os dois valores dessa mesma chave sem espaços extras, certifique-se de que o Client ID está em client_id e o Client Secret em client_secret, e teste de novo.
O teste passou, mas aqui não consigo cotar tarifas, comprar uma etiqueta nem rastrear um envio
Esse é o escopo real desta conexão, não uma falha da sua configuração. No Ordoro, tarifas e etiquetas são tratadas por endpoints por pedido, então não há nenhuma chamada independente de tarifa ou etiqueta que esta conexão possa fazer, e as informações de rastreio ficam no pedido do Ordoro em vez de atrás de uma busca por número de rastreamento. Esta conexão só verifica credenciais com uma lista de shippers somente para leitura.
Trate um teste aprovado como prova de que suas credenciais funcionam, e nada mais. Para tarifas e etiquetas, siga o fluxo por pedido no Ordoro, partindo do pedido do Ordoro; para rastreio, veja as informações de envio desse pedido no Ordoro.
O teste diz que faltam credenciais
Um ou ambos os campos estão vazios. O teste verifica primeiro os campos e informa credenciais faltantes em vez de informar sucesso, então uma conexão incompleta nunca pode parecer conectada.
Preencha os dois campos —o Client ID de uma chave de API do Ordoro em client_id e o Client Secret dessa mesma chave em client_secret—, salve e teste de novo.