Ir para o conteúdo

Descontinuação da API de Atendimento do Shopify

Resumo

Shopify anunciou alguns endpoints serão descontinuados em sua API Fulfillment em 30 de junho de 2023.

Os clientes com projetos do Cloud Studio que usam os endpoints obsoletos da API Fulfillment devem fazer alterações na configuração o mais rápido possível, ou as operações que usam os endpoints obsoletos da API começarão a falhar após 30 de junho de 2023.

Nota

O Shopify havia anunciado anteriormente uma data de suspensão de uso de 31 de março de 2023, que posteriormente foi estendida para 30 de junho de 2023.

Projetos Impactados e Ação Necessária do Usuário

Projetos do Cloud Studio usando o conector Shopify são impactados se ambas as condições forem atendidas:

  • A conexão do Shopify está configurado com a versão da API 2022-04.
  • Shopify Create ou Update as atividades associadas a essa conexão são configuradas com endpoints da API de atendimento obsoletos.

Siga estas etapas para determinar se seus projetos que usam o conector da Shopify foram afetados e execute as ações necessárias do usuário:

  1. Verifique a versão da API usada por cada conexão do Shopify em Configurações opcionais > Versão da API.

    Se a seleção for API versão 2022-04, prossiga para a próxima etapa. Caso contrário, o projeto não será impactado.

    Nota

    Não é necessário alterar a versão da API selecionada para uma versão posterior, pois as chamadas para a versão da API 2022-04 serão automaticamente redirecionadas pela Shopify para a próxima versão mais antiga suportada. No entanto, se você optar por alterar a versão da API selecionada neste momento, consulte considerações adicionais em Alterar a versão da API.

  2. Abra cada Shopify Create ou Update atividade que está sendo usada pela conexão e verifique se os seguintes objetos e subobjetos estão selecionados.

    Se presente, altere a seleção de objeto/subobjeto da seguinte forma:

    Atividade do Shopify Objeto obsoleto > Subobjeto Recomendação
    Create Envio e atendimento > Cumprimento Altere a seleção para Envio e atendimento > Entrega para pedido de cumprimento
    Create Envio e atendimento > Entrega concluída

    Nota

    Esses subobjetos não têm um endpoint de API de substituição direta. Para recomendações, consulte o guia de migração do Shopify Migrar para pedidos de atendimento.
    Create Envio e atendimento > Entrega aberta
    Update Envio e atendimento > Cumprimento

  3. Depois que as alterações na configuração forem feitas, você deverá reimplementar as operações afetadas para que as alterações entrem em vigor.

Nota

Projetos do Cloud Studio interagindo diretamente com as APIs do Shopify, como usando o HTTP ou HTTP v2, também pode ser impactado. Recomendamos revisar o guia de migração do Shopify Migrar para pedidos de atendimento para determinar se seus projetos foram afetados e fazer as atualizações apropriadas.

Se a Ação Necessária do Usuário Não For Realizada

Após 30 de junho de 2023, as chamadas de API da Shopify para a versão da API 2022-04 serão redirecionadas pela Shopify para a próxima versão mais antiga compatível, já que a Shopify faz isso automaticamente para chamadas de versões de API não suportadas.

Como as versões da API posteriores a 2022-07 não são compatíveis com os endpoints obsoletos da API Fulfillment, as operações do Cloud Studio implantadas com os endpoints obsoletos da API Shopify começarão a falhar após 30 de junho de 2023. Os erros retornados pela API Shopify serão relatados no registros de operação.