Integração · Comércio eletrónico

Conecte Claude e ChatGPT ao Loop Returns

Faça perguntas sobre devoluções no Loop: o que chegou hoje, o que um cliente enviou de volta e o que ele recebe em troca. Pode adicionar notas, marcar, fechar, cancelar ou processar devoluções, pesquisar pedidos, clientes e produtos sincronizados com o Loop, e gerenciar a lista negra e positiva. Também pode verificar envios da Happy Returns.

Ligar Loop Returns gratuitamente

Plano gratuito, sem cartão de crédito. Demora cerca de um minuto.

Experimente pedir

“Quais devoluções estão aguardando revisão?”
A IA lista as devoluções no estado de revisão para as datas que você fornece, ou para as últimas 24 horas se não fornecer nenhuma.
“O que está acontecendo com a devolução do pedido #10452?”
Ela pesquisar a devolução pelo nome do pedido e exibe itens, cliente, resultado e valores.
“Adicione uma nota informando que o cliente enviou fotos dos danos.”
Ela adiciona uma nota interna à devolução. As notas podem ter até 255 caracteres.

O que a sua IA pode fazer

Devoluções

Listar e ler devoluções, adicionar notas, e marcar, fechar, cancelar ou processar uma devolução.

Pedidos, clientes e produtos

Pesquisar pedidos, clientes, produtos e variantes sincronizados com o Loop, e verificar envios da Happy Returns.

Lista negra e positiva

Bloqueie pedidos, emails, produtos ou tags de produto para serem devolvidos, e permita pedidos ou emails fora da política normal.

“Processar a devolução #88213.”
Ela processa a devolução, que emite o reembolso, troca ou crédito de loja. Isso move dinheiro e não pode ser desfeito.
“Bloqueie devoluções do email [email protected].”
Ela adiciona o email à lista negra, para que ele não possa mais ser usado para devolver itens.
“Deixe o pedido #10388 ser devolvido fora da política normal.”
Ela adiciona o pedido à lista positiva.

128 ferramentas para Loop Returns

Estas ferramentas são ativadas quando estabelece a ligação. Pode desativar qualquer uma delas ou exigir a sua aprovação antes de ser executada.

add_cart_itemAltera dadosCriar um novo produto. Obrigatório: id da variante. Resumo da API: Adicionar Item ao Carrinho.
add_return_noteAltera dadosAdicionar uma nota interna (até 255 caracteres) a uma devolução por `return_id` e `content`.
add_to_allowlistAltera dadosPermitir retornos fora da política normal para um `type` (pedido ou e-mail) e `value`, ou seja, um número de pedido ou e-mail do cliente.
add_to_blocklistAltera dadosTornar itens ineligíveis para retorno bloqueando um `type` (pedido, e-mail, produto, tag de produto) e `value`.
approve_draft_return_return_policyVisível para outras pessoasAceitar um retorno em rascunho (id do retorno em rascunho). Tem efeitos visíveis fora deste sistema. Resumo da API: Aceitar Política de Retorno.
attach_orderAltera dadosLigar um pedido. Resumo da API: Criar Link Profundo de Retorno.
attach_product_to_categoryAltera dadosAnexar um produto (id do produto). Resumo da API: Adicionar Produto à Coleção.
cancel_draft_returnElimina dadosCancelar um retorno em rascunho (id do retorno em rascunho). Ação destrutiva; pode exigir aprovação. Resumo da API: Cancelar Retorno em Rascunho.
cancel_returnElimina dadosCancelar um retorno por `return_id`. Isso não pode ser desfeito.
close_returnVisível para outras pessoasFechar uma devolução por `return_id` sem processá-la mais.
create_addressAltera dadosCriar um novo endereço. Obrigatório: canal de vendas, nome, status ou endereço. Resumo da API: Criar Localização.
create_assessAltera dadosCriar um novo assess. Obrigatório: itens. Resumo da API: Avaliar Disposições.
create_carrierAltera dadosCriar um novo carrier. Obrigatório: id do método de retorno ou formato de etiqueta. Resumo da API: Selecionar Método de Retorno Carrier.
create_cartAltera dadosCriar um novo carrinho. Obrigatório: carrinho. Resumo da API: Criar Carrinho.
create_categoryAltera dadosCriar uma nova categoria. Obrigatório: canal de vendas ou nome. Resumo da API: Criar Coleção.
create_createAltera dadosCriar um novo create. Obrigatório: id do pedido. Resumo da API: Criar Retorno em Rascunho (Declarativo).
create_customerAltera dadosCriar um novo cliente. Obrigatório: canal de vendas. Resumo da API: Criar Cliente.
create_destinationAltera dadosCriar um novo destino. Obrigatório: nome, tipo ou endereço. Resumo da API: Criar Destino.
create_draft_returnAltera dadosCriar um novo retorno em rascunho. Obrigatório: nome do pedido ou entrada secundária. Resumo da API: Inicializar Retorno em Rascunho.
create_draft_return_addressAltera dadosCriar um novo endereço para um retorno em rascunho. Obrigatório: rua1, cidade, estado, país, código do país ou CEP. Resumo da API: Definir Endereço.
create_draft_return_credit_typeAltera dadosCriar um novo tipo de crédito para uma devolução rascunho. Obrigatório: tipo de crédito. Resumo da API: Definir Tipo de Crédito.
create_draft_return_customerAltera dadosCriar um novo cliente para uma devolução rascunho. Obrigatório: email. Resumo da API: Definir Cliente.
create_draft_return_paymentAltera dadosCriar um novo pagamento para uma devolução rascunho. Obrigatório: tipo de fonte de pagamento ou id de intenção do provedor. Resumo da API: Criar Intenção de Pagamento.
create_draft_return_productAltera dadosCriar um novo produto para uma devolução rascunho. Obrigatório: id do item da linha de pedido. Resumo da API: Adicionar Item Devolvido.
create_draft_return_product_unfinalize_itemsAltera dadosCriar um novo produto para uma devolução rascunho. Resumo da API: Desfazer Finalização de Itens.
create_gradeAltera dadosCriar um novo grau. Obrigatório: itens. Resumo da API: Avaliar Itens.
create_orderAltera dadosCriar um novo pedido. Obrigatório: nome, canal de vendas, status, impostos incluídos, preço total ou itens da linha. Resumo da API: Criar Pedido.
create_productAltera dadosCriar um novo produto para um produto. Obrigatório: id do variante. Resumo da API: Adicionar Item de Troca Devolvido.
create_product_create_productAltera dadosCriar um novo produto. Obrigatório: nome ou canal de vendas. Resumo da API: Criar Produto.
create_product_variantAltera dadosCriar um novo produto para um produto. Obrigatório: nome. Resumo da API: Criar Variante do Produto.
create_qrAltera dadosCriar um qr novo. Obrigatório: nome ou zip. Resumo da API: Criar Link Profundo de Devolução com Código QR.
create_return_fraud_reportAltera dadosCriar um novo relatório de fraude para uma devolução. Resumo da API: Criar Relatório de Fraude.
create_webhookElimina dadosCriar um novo webhook. Obrigatório: tópico, gatilho ou url. Ação destrutiva; pode exigir aprovação. Resumo da API: Criar Webhook.
delete_addressElimina dadosExcluir permanentemente um endereço por ID de endereço. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir Localização.
delete_allowlistElimina dadosExcluir permanentemente uma lista de permissões por id de lista de permissões. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir Item da Lista de Permissões.
delete_cartElimina dadosExcluir permanentemente um carrinho por cid. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir Carrinho.
delete_categoryElimina dadosApaga permanentemente uma categoria pelo ID de categoria. Ação destrutiva; pode exigir aprovação. Resumo da API: Apagar Coleção.
delete_category_productElimina dadosExcluir permanentemente um produto por id do produto. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir Produto da Coleção.
delete_collection_by_external_idElimina dadosExcluir permanentemente um produto por id do produto. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir Coleção por ID Externo.
delete_customerElimina dadosExcluir permanentemente um cliente por customer id. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir Cliente.
delete_customer_by_external_idElimina dadosExcluir permanentemente um produto por id do produto. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir Cliente por ID Externo.
delete_destinationElimina dadosExcluir permanentemente um destino por id de destino. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir Destino.
delete_draft_return_paymentElimina dadosExcluir permanentemente um pagamento por id do pagamento. Ação destrutiva; pode exigir aprovação. Resumo da API: Remover Intenção de Pagamento.
delete_draft_return_productElimina dadosExcluir permanentemente um produto pelo seu ID de produto. Ação destrutiva; pode exigir aprovação. Resumo da API: Remover Item de Devolução.
delete_inventoryElimina dadosExcluir permanentemente um inventário pelo seu ID de localização. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir Inventário.
delete_inventory_by_external_idsElimina dadosExcluir permanentemente um produto pelo seu ID externo de localização. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir Inventário por IDs Externos.
delete_location_by_external_idElimina dadosExcluir permanentemente uma localização pelo seu ID externo. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir Localização por ID Externo.
delete_orderElimina dadosExcluir permanentemente um pedido por order id. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir Pedido.
delete_order_by_external_idElimina dadosExcluir permanentemente um pedido pelo seu ID externo. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir Pedido por ID Externo.
delete_productElimina dadosExcluir permanentemente um produto pelo seu ID de item do carrinho. Ação destrutiva; pode exigir aprovação. Resumo da API: Remover Item do Carrinho.
delete_product_by_external_idElimina dadosExcluir permanentemente um produto pelo seu ID externo. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir Produto por ID Externo.
delete_product_delete_productElimina dadosExclua permanentemente um produto pelo id do produto. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir Produto.
delete_product_variantElimina dadosExcluir permanentemente uma variante de produto pelo seu ID de produto. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir Variante de Produto.
delete_product_variant_by_external_idElimina dadosExcluir permanentemente uma variante de produto pelo seu ID externo. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir Variante de Produto por ID Externo.
delete_return_fraud_reportsMovimenta dinheiroExcluir permanentemente um relatório de fraude pelo seu ID de devolução. Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: Excluir Relatório de Fraude.
delete_return_removesElimina dadosExcluir permanentemente uma linha de itens pelo seu ID de devolução. Ação destrutiva; pode exigir aprovação. Resumo da API: Remover Itens da Linha.
delete_webhookElimina dadosExclua permanentemente um webhook pelo seu ID. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir Webhook.
flag_returnAltera dadosMarcar uma devolução para revisão por `return_id`.
get_addressObter um endereço único pelo seu ID de endereço. Resumo da API: Obter Localização.
get_allowlistObter um item de lista permitida pelo seu ID de lista. Resumo da API: Obter Item de Lista Permitida.
get_blocklistObter um item de lista bloqueada pelo seu ID de lista. Resumo da API: Obter Item de Lista Bloqueada.
get_bulk_operationObter uma operação em lote pelo seu ID de operação. Resumo da API: Obter Operação em Lote.
get_cartObter um carrinho pelo seu CID. Resumo da API: Obter Carrinho.
get_categoryObter uma categoria pelo ID de categoria. Resumo da API: Obter Coleção.
get_collection_by_external_idObter um produto por seu ID externo. Resumo da API: Obter Coleção por ID Externo.
get_customerObter um cliente pelo Loop `customer_id`.
get_customer_by_external_idObter um cliente pelo seu ID externo. Resumo da API: Obter Cliente por ID Externo.
get_destinationObter detalhes de destino pelo seu ID de destino. Resumo da API: Obter Detalhes do Destino.
get_draft_returnObter uma devolução rascunho pelo seu ID de devolução rascunho. Resumo da API: Obter Devolução Rascunho.
get_happy_returns_shipmentObter uma expedição Happy Returns pelo `happy_returns_shipment_id`.
get_inventoryObter um inventário pelo seu ID de localização. Resumo da API: Obter Inventário.
get_inventory_by_external_idsObter um inventário por seu ID externo de localização. Resumo da API: Obter Inventário por IDs Externos.
get_location_by_external_idObter uma localização pelo seu ID externo. Resumo da API: Obter Localização por ID Externo.
get_orderObter um pedido pelo Loop `order_id`, com itens da linha, cliente e totais.
get_productObter um produto pelo Loop `product_id`.
get_product_2Obter um produto por seu ID de produto. Resumo da API: Obter Pedido por ID Externo.
get_product_by_external_idObter um produto pelo ID do produto. Resumo da API: Obter Produto por ID Externo.
get_product_variantObter um produto para um produto pelo ID do produto 2. Resumo da API: Obter Variante de Produto.
get_product_variant_by_external_idObter uma variante de produto por ID externo. Resumo da API: Obter Variante de Produto por ID Externo.
get_return_detailsObter detalhes completos de uma devolução pelo `return_id`, ou procurá-la pelo `order_id` ou `order_name`: itens, cliente, resultado e valores.
list_addressesListar endereços. Filtros opcionais: ID externo ou ordem de classificação. Os resultados são paginados. Resumo da API: Listar Localizações.
list_allowlistListar entradas da lista de permissões que permitem devoluções fora da política normal.
list_asnsListar ASNs. Filtros opcionais: de ou para. Resumo da API: Aviso de Transporte Avançado.
list_blocklistListar entradas da lista de bloqueio: pedidos, e-mails, produtos ou tags de produto que não podem ser devolvidos.
list_bulk_operation_projectsListar projetos para uma operação em massa. Filtros opcionais: ordem de classificação. Os resultados são paginados. Resumo da API: Listar Tarefas de Operação em Massa.
list_bulk_operationsListar operações em massa. Filtros opcionais: ordem de classificação. Os resultados são paginados.
list_categoriesListar categorias. Filtros opcionais: ID externo ou ordem de classificação. Os resultados são paginados. Resumo da API: Listar Coleções.
list_customersListar clientes sincronizados ao Loop, com paginação e filtro opcional `external_id`.
list_destinationsListar destinos. Resumo da API: Obter Todos os Destinos.
list_draft_return_totalsListar totais para uma devolução rascunho. Resumo da API: Obter Totais de Devolução Rascunho.
list_draft_returnsListar devoluções rascunho. Resumo da API: Listar Devoluções Rascunho (HAL-Forms).
list_happy_returns_shipmentsListar expedições Happy Returns em um intervalo de datas (`from`, `to`).
list_inventoriesListar inventários. Filtros opcionais: ID de localização, ID de variante de produto ou ordem de classificação. Os resultados são paginados.
list_ordersListar pedidos sincronizados ao Loop, com paginação e filtro opcional `external_id`.
list_product_variantsListar as variantes de um produto (`product_id`), opcionalmente por `barcode` ou IDs.
list_productsListar produtos sincronizados ao Loop, filtrados por `tags`, `barcode` ou `external_id`.
list_products_2Listar produtos. Os resultados são paginados. Resumo da API: Listar Itens de Pedido.
list_return_notesListar as notas em uma devolução (`return_id`).
list_returnsListar devoluções em um intervalo de datas (`from`, `to`), opcionalmente por `state` (aberta, fechada, cancelada, expirada, revisão). Sem datas, cobre as últimas 24 horas.
list_samplesListar amostras. Filtros opcionais: tópico, gatilho ou é zapier. Resumo da API: Obter Webhook de Amostra.
list_shipment_productsListar produtos para uma expedição. Os resultados são paginados. Resumo da API: Obter Itens de Expedição.
list_webhooksListar webhooks. Resumo da API: Obter Webhooks.
process_returnAltera dadosProcessar uma devolução por `return_id`, que emite seu reembolso, troca ou crédito da loja. Isso move dinheiro e não pode ser desfeito.
remove_from_blocklistElimina dadosRemover uma entrada da lista de bloqueio por `blocklist_id`.
submit_draft_returnVisível para outras pessoasEnviar uma devolução rascunho (ID de devolução rascunho). Tem efeitos visíveis fora deste sistema. Resumo da API: Enviar Devolução Rascunho.
submit_draft_return_itemsVisível para outras pessoasConcluir uma devolução rascunho (id de devolução rascunho). Tem efeitos visíveis fora deste sistema. Resumo da API: Finalizar Itens.
submit_draft_return_methodVisível para outras pessoasDevolver um rascunho de devolução (id de devolução rascunho). Tem efeitos visíveis fora deste sistema. Resumo da API: Selecionar Método de Devolução.
submit_product_reasonVisível para outras pessoasDevolver um produto (item de retorno id). Tem efeitos visíveis fora deste sistema. Resumo da API: Definir Motivo de Retorno do Item de Retorno.
submit_product_typeVisível para outras pessoasDevolver um produto (item de retorno id). Tem efeitos visíveis fora deste sistema. Resumo da API: Definir Tipo de Retorno do Item de Retorno.
update_addressAltera dadosAtualize um endereço existente identificado pelo ID do endereço. Apenas os campos que você passar são alterados. Resumo da API: Atualizar Localização.
update_addressesVisível para outras pessoasAtualizar um endereço existente. Tem efeitos visíveis fora deste sistema. Resumo da API: Inserir ou Atualizar Localização.
update_cartAltera dadosAtualizar um carrinho existente identificado por cid. Resumo da API: Atualizar Carrinho.
update_categoriesVisível para outras pessoasAtualizar uma categoria existente. Tem efeitos visíveis fora deste sistema. Resumo da API: Inserir ou Atualizar Coleção.
update_categoryAltera dadosAtualizar uma categoria existente identificada pelo id de categoria. Apenas os campos que você passa são alterados. Resumo da API: Atualizar Coleção.
update_customerAltera dadosAtualizar um cliente existente identificado pelo id do cliente. Apenas os campos que você passa são alterados. Resumo da API: Atualizar Cliente.
update_customersVisível para outras pessoasAtualizar um cliente existente. Tem efeitos visíveis fora deste sistema. Resumo da API: Inserir ou Atualizar Cliente.
update_destinationAltera dadosAtualizar um destino existente identificado pelo id do destino. Resumo da API: Atualizar Destino.
update_inventoryAltera dadosAtualizar um inventário existente identificado pelo id de localização. Apenas os campos que você passa são alterados. Resumo da API: Inserir ou Atualizar Inventário.
update_orderAltera dadosAtualizar um pedido existente identificado pelo ID do pedido. Resumo da API: Atualizar Pedido.
update_ordersVisível para outras pessoasAtualizar uma ordem existente. Tem efeitos visíveis fora deste sistema. Resumo da API: Inserir ou Atualizar Ordem.
update_productAltera dadosAtualizar um produto existente identificado pelo id do produto. Apenas os campos que você passa são alterados. Resumo da API: Atualizar Produto.
update_product_upsert_inventory_by_external_idsAltera dadosAtualizar um produto existente identificado pelo id externo de localização. Resumo da API: Inserir ou Atualizar Inventário por IDs Externos.
update_product_user_inputAltera dadosAtualizar uma entrada do usuário existente identificada pelo id de entrada do usuário. Resumo da API: Adicionar Entrada do Usuário do Item de Retorno.
update_product_variantAltera dadosAtualizar um produto existente identificado pelo id do produto 2. Apenas os campos que você passa são alterados. Resumo da API: Atualizar Variante de Produto.
update_productsVisível para outras pessoasAtualizar um produto existente. Tem efeitos visíveis fora deste sistema. Resumo da API: Inserir ou Atualizar Produto.
update_products_upsert_product_variantVisível para outras pessoasAtualizar um produto existente identificado pelo id do produto. Tem efeitos visíveis fora deste sistema. Resumo da API: Inserir ou Atualizar Variante de Produto.
update_products_upsert_product_variant_by_product_external_idVisível para outras pessoasAtualizar um produto existente identificado pelo id externo do produto. Tem efeitos visíveis fora deste sistema. Resumo da API: Inserir ou Atualizar Variante de Produto por ID Externo do Produto.
update_webhookElimina dadosAtualizar um webhook existente identificado pelo ID do webhook. Apenas os campos que você passa são alterados. Ação destrutiva; pode exigir aprovação. Resumo da API: Atualizar Webhook.

Configure em três passos

1
Escolha a aplicação
Crie uma conta gratuita no PipMCP e escolha Loop Returns na lista de aplicações.
2
Cole a sua chave
Cole uma chave da API do Loop. Você precisa do Loop Plus ou o add-on Loop Integrations. No Loop Admin vá em Gerenciamento de Devoluções > Ferramentas & integrações > Ferramentas para Desenvolvedores, clique em Gerar chave da API e marque os escopos que a IA deve usar, por exemplo Devoluções, Pedidos e Carrinhos. Nomeie a chave, clique em Gerar e copie-a.
3
Adicione a ligação à sua IA
Receberá uma ligação MCP pessoal. Adicione-a ao Claude, ao ChatGPT ou ao Cursor:
1. Clique no seu nome e depois em Definições › Conectores › Adicionar conector personalizado.
2. Cole a sua ligação no campo URL do servidor MCP remoto.
3. Ative-o no menu + de uma conversa.

Perguntas

O que a IA pode fazer no Loop Returns?

A IA pode listar e ler devoluções e suas notas, pedidos, clientes, produtos e variantes, lista negra e positiva, e envios da Happy Returns. Pode adicionar notas, marcar, fechar, cancelar e processar devoluções, adicionar e remover entradas de lista negra e adicionar entradas de lista positiva.

A IA vê minha chave da API do Loop Returns?

Não. Suas credenciais do Loop Returns são criptografadas em repouso e nunca mostradas à IA. Após você salvá-las, elas não são mostradas novamente, nem mesmo para você. A IA só vê os resultados das ferramentas que ela chama.

Posso controlar o que a IA é autorizada a fazer?

Sim. Você escolhe quais ferramentas estão ativadas, para começar em modo de leitura apenas. Processar um retorno emite reembolso, troca ou crédito da loja, e cancelar um retorno não pode ser desfeito. Ambos podem exigir sua aprovação antes de executar. Todas as chamadas de ferramenta são registradas.

Funciona com o ChatGPT?

Sim. No ChatGPT, vá em Configurações › Aplicações & Conectores › Avançado e ative o Modo Desenvolvedor, depois adicione seu link do PipMCP. O Modo Desenvolvedor requer um plano pago do ChatGPT: Plus, Pro, Business ou Enterprise. O mesmo link funciona também no Claude (Configurações › Conectores › Adicionar conector personalizado), Cursor e outros clientes MCP.

Qual é o custo?

O PipMCP tem um plano gratuito sem necessidade de cartão de crédito. Planos pagos cobram por tarefa concluída. Você também precisa de uma conta Loop Returns própria.

Por que algumas ferramentas retornam um erro 401?

As chaves da API do Loop são escopadas. Se sua chave não incluir um escopo necessário para uma ferramenta, por exemplo, Orders, o Loop retorna um erro 401 para essa ferramenta. Gere uma chave com os escopos das ferramentas que você ativa no PipMCP.