Nesta página, você encontra informações sobre como visualizar suas políticas de devolução on-line.
A API Merchant aceita os seguintes métodos para recuperar políticas de devolução on-line:
- accounts.onlineReturnPolicies.get
- accounts.onlineReturnPolicies.list
- accounts.onlineReturnPolicies.create
Como prática recomendada, garanta que sua política de devolução seja detectável e acessível a todos os usuários que acessam seu site, sem exigir que eles façam login, se inscrevam ou insiram 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 atual
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 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 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 seguinte solicitação:
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 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
}
]
}
No corpo da 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"
}
Veja 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"
}
Também é possível 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, pode levar até 10 dias úteis para que ela seja analisada e disponibilizada.