UPS (United Parcel Service, serviço de encomendas unificado)
A United Parcel Service (UPS) oferece serviços de transporte nacional e internacional por terra e ar para mais de 220 países.
Etapa 1: Abrir uma Conta de Entrega UPS
Para oferecer esse método de envio aos seus clientes, primeiro abra uma conta na UPS.
Etapa 2: Habilitar UPS para sua loja
-
Na barra lateral do administrador, vá para Stores > Settings>Configuration.
-
No painel à esquerda, em Sales, escolha Delivery Methods.
-
Expandir a seção UPS.
-
Defina Enabled for Checkout como
Yes
. -
Para uma conta REST UPS (padrão), faça o seguinte:
-
Insira suas credenciais de UPS: UPS ClientID como User ID, UPS Client Secret como Password
-
Defina Mode como
Live
para enviar dados ao sistema de envio do UPS através de uma conexão segura. (O modo de desenvolvimento não envia dados por uma conexão segura.) -
Verifique o Gateway URL que é necessário para enviar solicitações. Use uma URL de sandbox (
https://wwwcie.ups.com/
) para o modo de teste e uma URL de produção para solicitações ativas (https://onlinetools.ups.com
). Certifique-se de usar os respectivos endpoints para cada solicitação com o host fornecido. -
Verifique o Tracking URL que é necessário para obter informações de rastreamento. Use uma URL de sandbox (
https://wwwcie.ups.com/
) para o modo de teste e uma URL de produção para solicitações ativas (https://onlinetools.ups.com
). Certifique-se de usar os respectivos endpoints para cada solicitação com o host fornecido. -
Defina Origin of the Shipment para a região de origem da remessa.
-
Se você tiver taxas especiais com UPS, defina Enable Negotiated Rates como
Yes
e insira o Shipper Number de seis dígitos atribuído a você pelo UPS. -
Defina Live Account como um dos seguintes:
Yes
- Executa UPS no modo de produção e oferece UPS como um método de envio para seus clientes. Use os endpoints corretos em URL do gateway e URL de rastreamento.No
- Executa UPS em um modo de teste. Use os endpoints corretos em URL do gateway e URL de rastreamento.
note note NOTE O tipo padrão United Parcel Service está agendado para desativação. Para novas configurações, use o tipo United Parcel Service REST
padrão. O tipo REST também é necessário para gerar rótulos de remessa.
Para a versão 2.4.7, UPS Type foi removido porque os tiposUPS
eUPS XML
estão agendados para substituição eUPS REST
é o padrão. As APIs do United Parcel Service (UPS) usadas pela integração nativa do Adobe Commerce estão temporariamente obsoletas porque, no momento, ele não oferece suporte ao modelo de segurança OAuth 2.0.note important IMPORTANT O UPS descontinuará o suporte para HTTP, que é usado no padrão atual (valor do sistema). Desmarque a caixa de seleção Use system value e modifique a URL para usar HTTPS. Exemplo: https://www.ups.com/using/services/rave/qcostcgi.cgi
-
-
Para Title, insira o nome desta opção de remessa como deseja que ele apareça durante o check-out.
Por padrão, este campo está definido como
United Parcel Service
.{width="600" modal="regular"}
Etapa 3: completar a descrição do contêiner
-
Defina Packages Request Type como um dos seguintes:
Use origin weight (few requests)
Divide to equal weight (one request)
-
Para Container, especifique o tipo de embalagem típico que é usado para remessa:
Customer Packaging
UPS Letter Envelope
Customer Supplied Package
UPS Tube
PAK
UPS Express Box
UPS Worldwide 25 kilo
UPS Worldwide 10 kilo
Pallet
Small Express Box
Medium Express Box
Large Express Box
-
Defina Weight Unit para o sistema usado para medir o peso do produto.
O sistema de peso suportado pela UPS varia de acordo com o país. Em caso de dúvida, pergunte ao UPS qual sistema de peso você deve usar. As opções incluem:
LBS
KGS
-
Defina Destination Type como um dos seguintes:
Residential
- A maioria de suas remessas é B2C (B2C).Commercial
- A maioria de suas remessas é B2B (B2B) de empresa para empresa.
-
Insira o Maximum Package Weight permitido pela operadora.
-
Defina Pickup Method como um dos seguintes:
Regular Daily Pickup
On Call Air
One Time Pickup
Letter Center
Customer Counter
-
Insira o Minimum Package Weight permitido pela operadora.
{width="600" modal="regular"}
Etapa 4: Configurar taxas de manuseio
A taxa de manuseio é opcional e aparece como um custo extra que é adicionado ao custo de envio da UPS. Se quiser incluir uma taxa de manuseio, faça o seguinte:
-
Defina Calculate Handling Fee com um dos seguintes métodos:
Fixed
Percent
-
Para determinar como a taxa de manuseio de material é aplicada, defina Handling Applied como uma das seguintes opções:
Per Order
Per Package
-
Insira o valor de Handling Fee a ser cobrado.
Para inserir uma porcentagem, use o formato decimal. Por exemplo, digite
0.25
para 25%.{width="600" modal="regular"}
Etapa 5: Especificar métodos permitidos e países aplicáveis
-
Para Allowed Methods, escolha cada método de envio UPS que estará disponível para seus clientes.
Os métodos aparecem em UPS durante o check-out. Para selecionar vários métodos, mantenha pressionada a tecla Ctrl (PC) ou a tecla Command (Mac) e clique em cada opção.
-
Se você deseja fornecer uma opção de Envio gratuito por meio do UPS, defina as opções de envio gratuito:
-
Defina Free Method com o método que deseja usar para envio gratuito. Se você não quiser oferecer frete grátis por meio do UPS, escolha
None
. -
Para exigir um valor de pedido mínimo que qualifique um pedido de remessa gratuita com UPS, defina Enable Free Shipping Threshold como
Enable
. Em seguida, insira o valor mínimo em Free Shipping Amount Threshold.
-
-
Se necessário, altere o Displayed Error Message.
Essa caixa de texto é predefinida com uma mensagem padrão, mas você pode inserir uma mensagem diferente que você deseja exibir se o UPS se tornar indisponível.
{width="600" modal="regular"}
-
Defina Ship to Applicable Countries como um dos seguintes:
All Allowed Countries
- Clientes de todos os países especificados na sua configuração de loja podem usar este método de entrega.Specific Countries
- Ao escolher essa opção, a lista Remeter para Países Específicos é exibida. Selecione cada país na lista onde esse método de entrega pode ser usado.
-
Defina Show Method if Not Applicable como um dos seguintes:
Yes
- Lista todos os métodos de envio UPS disponíveis durante o check-out, incluindo os métodos que não se aplicam à remessa.No
- Lista somente os métodos de envio UPS aplicáveis à remessa.
{width="600" modal="regular"}
-
Para criar um arquivo de log com os detalhes das remessas UPS feitas de sua loja, defina Debug como
Yes
. -
Para Sort Order, insira um número para determinar a sequência em que o UPS aparece quando listado com outros métodos de entrega durante o check-out.
0
= primeiro,1
= segundo,2
= terceiro e assim por diante. -
Clique em Save Config.
Etapa 6: configurar endereço de origem da remessa
-
Verifique se as Informações da Loja foram concluídas.
-
Na barra lateral Admin, vá para Stores > Settings>Configuration.
-
No painel esquerdo, expanda Sales e selecione Shipping Settings.
-
Expanda Origin na página e configure o endereço de origem da remessa.
{width="600" modal="regular"}
-
Clique em Save Config.