Acessar suas políticas de devolução on-line

Esta página contém informações sobre como consultar suas políticas de devolução on-line.

A API Merchant oferece suporte aos seguintes métodos para recuperar políticas de devolução on-line:

Para criar uma política de devolução on-line, você precisa usar a interface do Merchant Center. Para mais informações, consulte Configurar políticas de devolução para anúncios do Shopping e listagens sem custo financeiro. Depois de criar uma política de devolução no Merchant Center, pode levar até 10 dias úteis para que ela seja analisada e disponibilizada.

Como prática recomendada, verifique se a política de devolução pode ser encontrada e acessada por todos os usuários que acessam seu site sem que seja necessário fazer login, se inscrever ou inserir informações pessoais. Além disso, verifique se as políticas de devolução são consistentes no Merchant Center e no seu site.

Recuperar uma política de devolução on-line

Para recuperar uma política de devolução on-line, use o método accounts.onlineReturnPolicies.get.

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/onlineReturnPolicies/{ONLINE_RETURN_POLICY_ID}

Depois que a solicitação for bem-sucedida, a resposta conterá o recurso OnlineReturnPolicy, conforme mostrado no exemplo abaixo:

{
  "onlineReturnPolicies": [
    {
      "returnPolicyId": "ONLINE_RETURN_POLICY_ID",
      "label": "default",
      "countries": [
        "COUNTRY_CODE"
      ],
      "policy": {
        "type": "NO_RETURNS"
      },
      "restockingFee": {
        "fixedFee": {
          "amountMicros": "0",
          "currencyCode": "USD"
        }
      },
      "returnPolicyUri": "RETURN_POLICY_URI"
    }
  ]
}

O valor NO_RETURNS indica que as devoluções não são aceitas no país mencionado.

O campo restockingFee no corpo da resposta representa a taxa de reposição, que pode ser uma taxa fixa ou uma porcentagem do preço do item em micros.

Listar todas as políticas de devolução on-line

Para listar todas as políticas de devolução on-line, use o método accounts.onlineReturnPolicies.list, conforme mostrado na seguinte solicitação:

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/onlineReturnPolicies

Depois que a solicitação for bem-sucedida, a resposta vai conter todas as políticas de devolução on-line da conta, conforme mostrado no exemplo de resposta a seguir:

{
  "onlineReturnPolicies": [
    {
      "returnPolicyId": "7216992546",
      "label": "default",
      "countries": [
        "IN"
      ],
      "policy": {
        "type": "NO_RETURNS"
      },
      "restockingFee": {
        "fixedFee": {
          "amountMicros": "0",
          "currencyCode": "USD"
        }
      },
      "returnPolicyUri": "http://example-pet-store.com/return"
    },
    {
      "returnPolicyId": "7274318400",
      "label": "default",
      "countries": [
        "GB"
      ],
      "policy": {
        "type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
        "days": "15"
      },
      "restockingFee": {
        "fixedFee": {
          "amountMicros": "10000000",
          "currencyCode": "GBP"
        }
      },
      "returnMethods": [
        "AT_A_KIOSK"
      ],
      "itemConditions": [
        "NEW"
      ],
      "returnShippingFee": {
        "type": "FIXED",
        "fixedFee": {
          "amountMicros": "0",
          "currencyCode": "GBP"
        }
      },
      "returnPolicyUri": "http://example-pet-store.com/return-new",
      "processRefundDays": 7,
      "acceptExchange": true
    }
  ]
}

Neste corpo de resposta, o campo returnPolicyId representa o identificador exclusivo da política de devolução on-line.

O campo returnMethods indica os métodos permitidos para retornar itens. AT_A_KIOSK indica que o item pode ser devolvido em um quiosque. Os outros valores possíveis são IN_STORE e BY_MAIL.

O campo processRefundDays especifica o número de dias que o vendedor leva para processar reembolsos.