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.

IMPORTANT
A partir de junho de 2024, os comerciantes do Adobe Commerce não poderão mais transacionar com a integração atual do UPS. Isso ocorre porque as APIs do United Parcel Service (UPS) usadas pela integração nativa do Adobe Commerce atualmente não oferecem suporte ao modelo de segurança OAuth 2.0 necessário. Para saber mais sobre esta alteração, consulte o Guia de Migração da Chave de Acesso ao Portal do Desenvolvedor.
Os comerciantes devem aplicar uma atualização de patch de qualidade ao seu armazenamento para migrar da API SOAP para a API RESTful, que oferece suporte aos protocolos de autenticação OAuth 2.0.
NOTE
A UPS pode usar peso dimensional para determinar algumas taxas de envio. No entanto, o Adobe Commerce suporta apenas o cálculo de custo de envio com base em peso.

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

  1. Na barra lateral do administrador, vá para Stores > Settings>Configuration.

  2. No painel à esquerda, em Sales, escolha Delivery Methods.

  3. Expandir Seletor de expansão a seção UPS.

  4. Defina Enabled for Checkout como Yes.

  5. 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 tipos UPS e UPS XML estão agendados para substituição e UPS 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
  6. 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.

    Habilitar UPS {width="600" modal="regular"}

Etapa 3: completar a descrição do contêiner

  1. Defina Packages Request Type como um dos seguintes:

    • Use origin weight (few requests)
    • Divide to equal weight (one request)
  2. 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
  3. 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
  4. 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.
  5. Insira o Maximum Package Weight permitido pela operadora.

  6. Defina Pickup Method como um dos seguintes:

    • Regular Daily Pickup
    • On Call Air
    • One Time Pickup
    • Letter Center
    • Customer Counter
  7. Insira o Minimum Package Weight permitido pela operadora.

    Descrição do contêiner {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:

  1. Defina Calculate Handling Fee com um dos seguintes métodos:

    • Fixed
    • Percent
  2. Para determinar como a taxa de manuseio de material é aplicada, defina Handling Applied como uma das seguintes opções:

    • Per Order
    • Per Package
  3. Insira o valor de Handling Fee a ser cobrado.

    Para inserir uma porcentagem, use o formato decimal. Por exemplo, digite 0.25 para 25%.

    Taxa de Manuseio {width="600" modal="regular"}

Etapa 5: Especificar métodos permitidos e países aplicáveis

  1. 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.

  2. 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.

  3. 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.

    Métodos permitidos {width="600" modal="regular"}

  4. 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.
  5. 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.

    Países aplicáveis {width="600" modal="regular"}

  6. Para criar um arquivo de log com os detalhes das remessas UPS feitas de sua loja, defina Debug como Yes.

  7. 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.

  8. Clique em Save Config.

Etapa 6: configurar endereço de origem da remessa

  1. Verifique se as Informações da Loja foram concluídas.

  2. Na barra lateral Admin, vá para Stores > Settings>Configuration.

  3. No painel esquerdo, expanda Sales e selecione Shipping Settings.

  4. Expanda Seletor de expansão Origin na página e configure o endereço de origem da remessa.

    Configuração de vendas - opções de endereço de origem da remessa {width="600" modal="regular"}

  5. Clique em Save Config.

NOTE
A Commerce não declara o preço total do pedido à UPS ao calcular as despesas de envio. Esse comportamento não pode ser alterado.
recommendation-more-help
dacea746-44a9-4368-b3fb-3bcff64c6be1