Informações técnicas do Brand Protection Program

Nesta página, encontrará toda as informações necessárias para que suas ferramentas possam enviar denúncias por nossa API. Poderá também consultar o status de cada uma delas e dar resposta ao documento enviado pelos vendedores.

Conteúdos

→Faça uma denúncia
→Responder a denúncia
→Referencia de estado de denúncia


Faça uma denúncia

Faça a seguinte chamada GET ao recurso de denúncias para obter os motivos que você ativou.

Chamada:

curl -X GET https://api.mercadolibre.com/moderations/pppi/denounces/$SITE_ID/ITM/options?access_token=$ACCESS_TOKEN

Exemplo:

curl -X GET http://api.mercadolibre.com/moderations/pppi/denounces/MLA/ITM/options?access_token=$ACCESS_TOKEN

Resposta OK (200):

[
   {
      "id":"PPPI2",
      "group":"PPPI",
      "type":"Product",
      "description":"Uso ilegítimo de marca registrada",
      "description_en":"Unlawful use of trademark",
      "sub_text":"Por ejemplo, dice que es mi distribuidor oficial cuando no lo es, incluye mis logos en la descripción o en las imágenes de la publicación.",
      "sub_text_en":"For example, says it is my official distributor when it is not, includes my logos in the description or in the images of the listing."
   },
   "..."
]

Post a denúncia

Chamada:

curl -X POST https://api.mercadolibre.com/moderations/pppi/denounces/items/$ITEM_ID?access_token=$ACCESS_TOKEN

Exemplo:

curl -X POST  https://api.mercadolibre.com/moderations/pppi/denounces/items/MLA123?access_token=$ACCESS_TOKEN
body:
{   "report_reason_id":"PPPI1",
   "comment":"Comment example.",
}
Nota:
Caso deseje fazer denúncias sobre direitos autorais de imagens, você deve indicar no corpo quais são as imagens infratoras. Isso será obrigatório por motivos de relatório: PPPI6 e PPPI7.

Exemplo:

curl -X POST  https://api.mercadolibre.com/moderations/pppi/denounces/items/MLA123?access_token=$ACCESS_TOKEN
body:
{   "report_reason_id":"PPPI1",
   "comment":"Comment example.",
   "photos_denounced": [
      "666591-MLA26622267232_012016",
      "666591-MLA26622267232_012017",
      "666591-MLA26622267232_012018"
   ]
}

Resposta OK (200):

{
  "status": 201,
  "denounce_id": 12547408
}

Responder a denúncia

Faça a seguinte chamada GET para obter informações sobre o status atual da denúncia e poder responder.

Chamada:

curl -X GET https://api.mercadolibre.com/moderations/pppi/case/$DENOUNCE_ID?access_token=$ACCESS_TOKEN

Exemplo:

curl -X GET https://api.mercadolibre.com/moderations/pppi/case/123?access_token=$ACCESS_TOKEN

Resposta OK (200):

{
  "item_info" {
    "title": ,
    "description": ,
    "price": , 
    "pictures": ,
  },
  "user_type": ,
  "reason_text": ,
  "member_name": ,
  "member_quittance": ,
  "seller_name": ,
  "seller_quittance": ,
  "document_url": ,
  "document_name": ,
  "due_date": ,
"current_status": ,
"reject_option_member": [
    {
      "sub_text_en": null,
      "text_en": "The documentation does not correspond to the reported product",
      "id": 1,
      "text_pt": "A documentação não corresponde ao produto denunciado",
      "sub_text_pt": null,
      "text_es": "La documentación no se corresponde con el producto denunciado",
      "sub_text_es": null
    },
    {
      "sub_text_en": null,
      "text_en": "The documentation is illegible",
      "id": 2,
      "text_pt": "A documentação está ilegível",
      "sub_text_pt": null,
      "text_es": "La documentación es ilegible",
      "sub_text_es": null
    },
    {
      "sub_text_en": "The documentation does not prove that they are authorized to use my brands, logos, or that they are official distributors",
      "text_en": "You are not authorized to use this content",
      "id": 3,
      "text_pt": "Não está autorizado a usar este conteúdo",
      "sub_text_pt": "A documentação não comprova que está autorizado a usar minhas marcas, logotipos ou que é um distribuidor oficial",
      "text_es": "No está autorizado a utilizar este contenido",
      "sub_text_es": "La documentación no prueba que está autorizado a usar mis marcas, logos, ni que es un distribuidor oficial"
    }
],
"photos_denounced": [
       {
           "id": "670708-MLA40946169781_022020"
           "status": "REMOVED",
           "src": "http://mla-s2-p.mlstatic.com/670708-MLA40946169781_022020.jpg"
       }
   ],
   "photos_new": [
       {
           "id": "8889-MLA26622267232_012016",
           "src": "http://mla-s2-p.mlstatic.com/670708-MLA40946169781_022020.jpg"
       },
       {
          "id": "792503-MLA40997189396_032020",
           "src": "http://mla-s2-p.mlstatic.com/792503-MLA40997189396_032020-O.jpg"
       }
   ]
}

Post responder a denúncia

Importante:
somente serão atualizados os casos com status DOCUMENTATION_PRESENTED, caso contrário, lançará erro.
Nota:
Para responder à denúncia e rejeitá-la, você deve adicionar no corpo o campo reject_member_id com o ID do motivo da rejeição obtido anteriormente na chamada GET no campo reject_option_member.

Chamada:

curl -X POST https://api.mercadolibre.com/moderations/pppi/case/$DENOUNCE_ID?access_token=$ACCESS_TOKEN
body: {
  "documentation_approved":"false" ,
  "member_quittance": ,
  "reject_member_id": "1"
}

Exemplo de aprovação de denúncia:

curl -X POST https://api.mercadolibre.com/moderations/pppi/case/$DENOUNCE_ID?access_token=$ACCESS_TOKEN
body: {
  "documentation_approved":"true" ,
  "member_quittance": 
  }

Exemplo rechazar denúncia:

curl -X POST https://api.mercadolibre.com/moderations/pppi/case/$DENOUNCE_ID?access_token=$ACCESS_TOKEN
body: {
  "documentation_approved":"false" ,
  "member_quittance": ,
 "reject_member_id": "1"
  }

Resposta:

{
  "item_info" {
    "title": ,
    "description": ,
    "price": , 
    "pictures": ,
  },
  "user_type": ,
  "reason_text": ,
  "member_name": ,
  "member_quittance": ,
  "seller_name": ,
  "seller_quittance": ,
  "document_url": ,
  "document_name": ,
  "due_date": ,
"current_status": ,
"reject_option_member": [
    {
      "sub_text_en": null,
      "text_en": "The documentation does not correspond to the reported product",
      "id": 1,
      "text_pt": "A documentação não corresponde ao produto denunciado",
      "sub_text_pt": null,
      "text_es": "La documentación no se corresponde con el producto denunciado",
      "sub_text_es": null
    },
    {
      "sub_text_en": null,
      "text_en": "The documentation is illegible",
      "id": 2,
      "text_pt": "A documentação está ilegível",
      "sub_text_pt": null,
      "text_es": "La documentación es ilegible",
      "sub_text_es": null
    },
    {
      "sub_text_en": "The documentation does not prove that they are authorized to use my brands, logos, or that they are official distributors",
      "text_en": "You are not authorized to use this content",
      "id": 3,
      "text_pt": "Não está autorizado a usar este conteúdo",
      "sub_text_pt": "A documentação não comprova que está autorizado a usar minhas marcas, logotipos ou que é um distribuidor oficial",
      "text_es": "No está autorizado a utilizar este contenido",
      "sub_text_es": "La documentación no prueba que está autorizado a usar mis marcas, logos, ni que es un distribuidor oficial"
    }
],
"photos_denounced": [
       {
           "id": "670708-MLA40946169781_022020"
           "status": "REMOVED",
           "src": "http://mla-s2-p.mlstatic.com/670708-MLA40946169781_022020.jpg"
       }
   ],
   "photos_new": [
       {
           "id": "8889-MLA26622267232_012016",
           "src": "http://mla-s2-p.mlstatic.com/670708-MLA40946169781_022020.jpg"
       },
       {
          "id": "792503-MLA40997189396_032020",
           "src": "http://mla-s2-p.mlstatic.com/792503-MLA40997189396_032020-O.jpg"
       }
   ]
}

Referências de status de denúncia

Um caso poderia ter qualquer um dos status abaixo:

WAITING_DOCUMENTATION: o vendedor pode enviar sua documentação para contestar a reclamação apresentada pelo Membro. Pausaremos o item durante esse período.
DOCUMENTATION_PRESENTED: significa que o vendedor enviou a documentação e aguarda a resposta do membro. O item será pausado durante esse período.
DOCUMENTATION_NOT_PRESENTED: significa que o vendedor não enviou a documentação antes da data de vencimento. Portanto, excluímos o item.
DOCUMENTATION_APPROVED: significa que o membro aprovou a documentação. O item é publicado novamente.
DOCUMENTATION_NOT_APPROVED: significa que o membro não aprovou a documentação, portanto excluímos o item.
MEMBER_NOT_RESPOND: significa que o membro não respondeu à documentação. O item é publicado novamente.
ROLLBACK: em casos extraordinários, você solicitará o membro e poderemos publicar o item excluído anteriormente.
DISCARD_DUE_RESTRICTION: significa que encerramos o caso automaticamente porque o vendedor foi sancionado e não está ativo na plataforma.

ou registre-se para receber as últimas notícias sobre nossa API