Buscapé - API de Lojistas - Recursos

A documentação abaixo da integração API possui todos os recursos necessários para que você divulgue seus produtos no site do Buscapé e da Lomadee, e gerencie seu feed de forma inteligente e otimizada.


Com este método você poderá processar on-line suas ofertas para publicar no Buscapé e/ou Lomadee. Esta API tem limitação de 1000 produtos por requisição e o seu processamento é sincrono sendo assim se o processo for cancelando antes da conclusão poderá gerar inconsistências e os produtos já processados poderão ser publicados.

Pode ser utilizado diariamente (através de sistema automático da plataforma/loja) ou quantos vezes houver necessidade de cadastrar novos produtos ou alterar dados buscáveis dos produtos publicados (ex. titulo, descrição, especificação técnica, etc). 

URL
Produção http://api.buscape.com.br/product
Sandbox http://sandbox-api.buscape.com.br/product
HEADERS
Content-Type application/json; charset=utf-8
app-token Token de aplicação
auth-token Token de autenticação
Gerar URL Modelo Básico
Produção http://api.buscape.com.br/product/t1/collection
Sandbox http://sandbox-api.buscape.com.br/product/t1/collection

REQUEST
BODY

[{"groupId":"","sku":"","title":"","barcode":"","category":"","description":"","images":["url1","..."],"isbn":"","link":"","linkLomadee":"","prices":[{"type":"","price":0,"priceLomadee":0, "priceCpa":0, "installment":0,"installmentValue":0}],"productAttributes":{"Atributo 1":"Valor 1","Atributo ...":"Valor ..."},"technicalSpecification":{"Especificação 1":"Valor","Especificação ...":"Valor ..."},"quantity":0,"sizeHeight":0,"sizeLength":0,"sizeWidth":0,"weightValue":0,"declaredPrice":0,"handlingTimeDays":0,"marketplace":false,"marketplaceName":""}]

 


RESPONSE

Status Code: 200

Modelo de resposta de sucesso, isto é, todos os produtos enviados estavam ok e serão processados em breve.

BODY

Status Code: 400

Modelo de resposta mista, isto é, um ou mais produto enviado encontra-se inválido.

BODY

Status Code: 500

Modelo de resposta de erro de formato inválido ou erro desconhecido.

BODY

Com esta API você poderá atualizar dados do inventário dos seus produtos publicados no Buscapé e/ou Lomadee. 

Deve ser utilizado sempre que houver necessidade (através de sistema automático da plataforma/loja) de alterar o preço e/ou o estoque de um produto. Preferencialmente sugerimos deixar acumular um período de no máximo 5 minutos para enviar todas as atualizações ocorridas, mas pode ser disparado a cada atualização também caso haja essa necessidade.

URL
Produção http://api.buscape.com.br/product
Sandbox http://sandbox-api.buscape.com.br/product
HEADERS
Content-Type application/json; charset=utf-8
app-token Token de aplicação
auth-token Token de autenticação
Gerar URL Modelo Básico
Produção http://api.buscape.com.br/product/t1/inventory
Sandbox http://sandbox-api.buscape.com.br/product/t1/inventory

REQUEST
BODY
[{"sku":"","prices":[{"type":"","price":0,"priceLomadee":0, "priceCpa":0, "installment":0,"installmentValue":0}],"quantity":0}]

 


RESPONSE

Status Code: 200

Modelo de resposta de sucesso, isto é, todos os produtos enviados estavam ok e serão processados em breve.

BODY

Status Code: 400

Modelo de resposta mista, isto é, um ou mais produto enviado encontra-se inválido.

BODY

Status Code: 500

Modelo de resposta de erro de formato inválido ou erro desconhecido.

BODY

Com esta API você poderá consultar os produtos enviados. Além dos dados enviados, a API retornará o status atual do produto (publicado ou não) e o histórico de alterações (em desenvolvimento).

URL
Produção http://api.buscape.com.br/product
Sandbox http://sandbox-api.buscape.com.br/product
HEADERS
app-token Token de aplicação
auth-token Token de autenticação
Gerar URL Modelo Básico
Produção http://api.buscape.com.br/product/search
Sandbox http://sandbox-api.buscape.com.br/product/search

REQUEST
PARÂMETROS
Nome Tipo   Descrição
size QueryString Opcional Determina a quantidade de produtos que deve ser retornado por página. (Quando não enviado o valor default será 12 produtos por página)
page QueryString Opcional Determina a página. (Quando não enviado o valor default será 1)

RESPONSE

Status Code: 200

BODY

Com esta API você poderá consultar um produto específico através do seu SKU. Além dos dados enviados, a API retornará o status atual do produto (publicado ou não), o histórico de alterações, os dados publicados, dados estatísticos e de bidagem.

URL
Produção http://api.buscape.com.br/product
Sandbox http://sandbox-api.buscape.com.br/product
HEADERS
app-token Token de aplicação
auth-token Token de autenticação
Gerar URL Modelo Básico
Produção http://api.buscape.com.br/product/search/{sku}
Sandbox http://sandbox-api.buscape.com.br/product/search/{sku}

REQUEST
PARÂMETROS
Nome Tipo   Descrição
sku PathVariable Obrigatório SKU do produto que deseja consultar

RESPONSE

Status Code: 200

BODY