🚚 СДЭК: conexão e chaves de API
Contrato com a СДЭК, chave de API no painel da conta (Account e Secure password), taxas de entrega armazém-armazém/armazém-porta, ambiente de teste EDU, СДЭК Cazaquistão e Bielorrússia.
Onde se configura: Painel de controle → «Envios» → botão «Serviços de entrega» (ou card da unidade → WEB → «Serviços de entrega»).
O que será necessário#
- contrato com a СДЭК para pessoa jurídica ou MEI;
- acesso ao painel da conta em lk.cdek.ru;
- endereço de onde você entrega as encomendas (armazém, loja ou escritório).
Como obter as chaves no painel do serviço#
- Feche um contrato com a СДЭК: solicitação no site cdek.ru («Para empresas» → «Fechar contrato») ou pelo gerente da sua cidade. Sem contrato, as chaves de API não são emitidas.
- Entre no painel da conta lk.cdek.ru com a conta na qual o contrato foi feito.
- Abra a seção «Integração» e crie uma chave para a API (se a chave já existir, use-a).
- Copie dois valores: Account (identificador do cliente) e Secure password (senha secreta). Guarde a Secure password como uma senha: não a envie por mensageiros.
O que preencher no card do serviço#
| Campo | O que preencher |
|---|---|
| Endereço do remetente | endereço do armazém ou da loja de onde a СДЭК retira ou para onde você leva as encomendas |
| Quais taxas de entrega exibir | «armazém-armazém» (você entrega no ponto de retirada, o comprador retira no ponto de retirada), «armazém-porta» (courier até o comprador), «porta-porta» (courier retira com você) |
| account (client_id) | valor de Account do painel da conta |
| secure_password (client_secret) | valor de Secure password do painel da conta |
Verificação#
- Clique em «Salvar».
- Clique em «Verificar conexão»: as taxas de entrega aparecerão abaixo do card. A inscrição «Modo mock» significa que as chaves não estão conectadas e as taxas de entrega são demonstrativas.
- Marque «Ativar …» no card — depois disso o serviço aparecerá para o comprador na finalização do pedido.
Sem chaves e modo de teste#
Sem chaves, o card funciona no ambiente de teste da СДЭК e, se ele estiver indisponível, exibe taxas de entrega demonstrativas: assim é possível ver como a entrega fica na vitrine ainda antes do contrato. A caixa de seleção «Modo de teste (sandbox)» envia as requisições para o ambiente de teste api.edu.cdek.ru — para ele são necessárias chaves de teste separadas, fornecidas pela СДЭК (as chaves de demonstração publicadas na documentação ela rejeita).
Problemas frequentes#
- «Erro de conexão» / invalid_client — as chaves foram trocadas de lugar, copiadas com um espaço ou o «Modo de teste» está ativado com chaves de produção. Desative o modo de teste e insira Account e Secure password novamente.
- Não há taxas de entrega na resposta — a taxa de entrega selecionada não funciona para esse destino — marque também «armazém-porta» ou verifique o endereço do remetente.
- Loja no Cazaquistão ou na Bielorrússia — СДЭК Cazaquistão (cdek.kz) e СДЭК Bielorrússia (cdek.by) são empresas separadas: as chaves do painel da conta russo não funcionam lá, é necessário um contrato e um painel da conta da СДЭК local. O procedimento para obter as chaves é o mesmo.
Links#
- Site do serviço: https://www.cdek.ru/
- Painel da conta: https://lk.cdek.ru/
- Documentação da API: https://apidoc.cdek.ru/