O processo de ligação da conta de transportadora DHL valida as suas credenciais e garante que a sua conta está corretamente configurada para obter tarifas e gerar etiquetas de envio. Quando liga a sua conta DHL, a Zonos efetua uma chamada de tarifação de teste para verificar se a ligação está a funcionar corretamente antes de guardar as suas credenciais.
Para se registar na DHL Express ou efetuar a configuração através do seu Zonos Dashboard, siga os passos deste guia.
Valida que forneceu os tipos de credenciais corretos para a DHL
Efetua uma chamada de tarifação em tempo real à API da DHL para confirmar que as credenciais são válidas
Guarda a sua conta ligada na Zonos para futuras tarifações de envios e criação de etiquetas
Devolve os detalhes da conta ligada, incluindo as informações da sua conta DHL e o tipo de tarifa
Depois de ligada, a sua conta de transportadora DHL pode ser utilizada para obter tarifas de envio em tempo real com base nas suas tarifas negociadas (se aplicável) e para criar etiquetas de envio DHL.
Ligar via API
Ligar a conta de transportadora DHL
Ligue de forma segura a sua conta de transportadora DHL para aceder a tarifas de envio negociadas e criar etiquetas diretamente através da Zonos.
Introdução
O processo de ligação da conta de transportadora DHL valida as suas credenciais e garante que a sua conta está corretamente configurada para obter tarifas e gerar etiquetas de envio. Quando liga a sua conta DHL, a Zonos efetua uma chamada de tarifação de teste para verificar se a ligação está a funcionar corretamente antes de guardar as suas credenciais.
Para se registar na DHL Express ou efetuar a configuração através do seu Zonos Dashboard, siga os passos deste guia.
Como funciona a ligação da conta de transportadora DHL
Ao ligar a sua conta de transportadora DHL:
Depois de ligada, a sua conta de transportadora DHL pode ser utilizada para obter tarifas de envio em tempo real com base nas suas tarifas negociadas (se aplicável) e para criar etiquetas de envio DHL.
Ligar a sua conta DHL
Utilize a mutação
carrierAccountConnectpara ligar a sua conta de transportadora DHL com as suas credenciais.Mutação
Utilize esta mutação para ligar a sua conta de transportadora DHL e validar as suas credenciais.
mutation CarrierAccountConnect($input: CarrierAccountConnectInput!) {carrierAccountConnect(input: $input) {errorscarrierAccount {credentialProvideridintegrationTypeorganizationrateTypecarrier {idcodename}credentials {typevalue}}}}Variáveis
A mutação requer o código de transportadora DHL, o tipo de tarifa e as credenciais da sua conta DHL.
{"input": {"carrierCode": "DHL","rateType": "NEGOTIATED","credentials": [{"type": "API_KEY","value": "actual_api_key_value"},{"type": "API_PASSWORD","value": "actual_api_password_value"},{"type": "ACCOUNT_NUMBER","value": "actual_account_number_value"}]}}A DHL requer os seguintes tipos de credenciais:
API_KEY- A sua chave de API da DHLAPI_PASSWORD- A sua palavra-passe de API da DHLACCOUNT_NUMBER- O seu número de conta DHLPode encontrar estas credenciais no portal da sua conta DHL ou contactando o seu representante de conta DHL.
Exemplos de resposta
Ligação bem-sucedida
Quando as credenciais são válidas e a DHL devolve tarifas com êxito:
{"data": {"carrierAccountConnect": {"errors": [],"carrierAccount": {"credentialProvider": "ORGANIZATION","id": "carrier_account_123","integrationType": "REST","organization": "organization_id","rateType": "NEGOTIATED","carrier": {"id": "carrier_123","code": "dhl","name": "DHL"},"credentials": [{"type": "API_KEY","value": "actual_api_key_value"},{"type": "API_PASSWORD","value": "actual_api_password_value"},{"type": "ACCOUNT_NUMBER","value": "actual_account_number_value"}]}}}}Erro: tipo de credencial não suportado
Se fornecer um tipo de credencial que a DHL não suporta:
{"data": {"carrierAccountConnect": {"errors": ["Credential type SITE_ID is not supported by carrier DHL"],"carrierAccount": null}}}Erro: credenciais inválidas
Se os tipos de credenciais forem válidos, mas não se autenticarem com êxito na DHL:
{"data": {"carrierAccountConnect": {"errors": ["Failed to get rating from DHL API"],"carrierAccount": null}}}O que acontece após a ligação
Depois de a sua conta de transportadora DHL ser ligada com êxito:
Próximos passos
Depois de ligar a sua conta de transportadora DHL:
CarrierAccountConnectInput
carrierAccountConnect
Esta página foi útil?