Criar e gerenciar suas políticas de devolução on-line

Nesta página, você encontra informações sobre como acessar suas políticas de devolução on-line.

A API Merchant é compatível com os seguintes métodos para recuperar políticas de devolução on-line:

Como prática recomendada, verifique se a política de devolução pode ser encontrada e acessada por todos os usuários que visitam seu site sem precisar fazer login, se inscrever ou inserir informações pessoais. Além disso, verifique se as políticas de devolução são consistentes entre o Merchant Center e 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/v1/accounts/{ACCOUNT_ID}/onlineReturnPolicies/{ONLINE_RETURN_POLICY_ID}

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

{
  "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 devoluções não são aceitas no país mencionado.

O campo restockingFee no corpo da resposta representa a taxa de reposição de estoque, 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 solicitação a seguir:

GET https://merchantapi.googleapis.com/accounts/v1/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 na amostra 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
    }
  ]
}

Nesse 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 devolução de 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.

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

Para criar uma política de devolução, use a seguinte solicitação:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/onlineReturnPolicies/{ONLINE_RETURN_POLICY_ID}

{
  "label": "label", "countries": ["US"],
"policy": {"type": "NO_RETURNS"},
"returnPolicyUri": "https://www.uri.com"
}

Confira um exemplo de resposta de uma chamada bem-sucedida:

{
  "name": "accounts/ACCOUNT_ID/onlineReturnPolicies/ONLINE_RETURN_POLICY",
  "returnPolicyId": "ONLINE_RETURN_POLICY",
  "label": "label",
  "countries": ["US"],
  "policy": {
    "type": "NO_RETURNS"
  },
  "returnShippingFee": {
    "type": "FIXED",
    "fixedFee": {
      "amountMicros": "0",
      "currencyCode": ""
    }
  },
  "returnPolicyUri": "https://www.uri.com"
}

Você também pode usar a interface do Merchant Center para criar uma política de devolução. Para mais informações, consulte Configurar sua política 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, ela pode levar até 10 dias úteis para ser analisada e disponibilizada.