Ir para o conteúdo

Descontinuação da API de Atendimento da Shopify

Resumo

Shopify anunciou está descontinuando alguns endpoints 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 de 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

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

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

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

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

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

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

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

    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 redirecionadas automaticamente pelo Shopify para a versão da API 2022-07. 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 do objeto/subobjeto da seguinte forma:

    Atividade da Shopify Objeto Obsoleto > Subobjeto Recomendação
    Create Envio e atendimento > Preenchimento Altere a seleção para Envio e atendimento > Preenchimento para pedido de atendimento
    Create Envio e processamento > Preenchimento concluído

    Nota

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

  3. Depois que as alterações de configuração forem feitas, você deve reimplantar as operações afetadas para que as alterações entrem em vigor.

Nota

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

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

Após 30 de junho de 2023, as chamadas da API da Shopify para a versão da API 2022-04 serão redirecionadas pela Shopify para a versão da API 2022-07. (A Shopify redireciona automaticamente chamadas de versões de API não suportadas para a próxima versão suportada mais antiga.)

Como 2022-07 não oferece suporte aos endpoints obsoletos da Fulfillment API, 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 da API Shopify serão relatados nos logs de operação.