Como integrar a 99Compras ao ANYMARKET? – Página inicial

A 99Compras é o marketplace de delivery de alimentos e conveniência da 99Food, com atuação nos modelos de mercado, farmácia, pet shop, floricultura, beleza, brinquedos, presentes, utensílios domésticos e demais categorias do modelo Grocery.

Com a integração ao ANYMARKET, você gerencia várias lojas da 99Compras de forma centralizada em uma única conta ANYMARKET (integração multicontas), sincronizando catálogo, preço, estoque e pedidos em um único hub.

Importante: Novas lojas passam pela aprovação do marketplace. Ainda não vende no canal? Cadastre-se aqui.

Pré-requisitos

Antes de iniciar a integração da 99Compras com o ANYMARKET, você precisa ter:

Uma conta ativa na 99Compras para cada loja que deseja integrar.
Uma conta ativa no ANYMARKET.
Catálogo de produtos previamente enviado ao time comercial da 99Compras para cadastro e curadoria. Todo seller que se integra passa por essa etapa com o gerente de contas da 99Compras — é nesse momento que os produtos são catalogados na plataforma. Sem essa curadoria prévia, os produtos enviados pelo ANYMARKET não são publicados.

Como configurar a autenticação

A autenticação com a 99Compras é feita por autorização em lote, diretamente no painel da 99Compras. O processo funciona da seguinte forma:

O time de implantação do ANYMARKET gera uma URL de autorização e disponibiliza para você. Essa URL tem validade de 7 dias corridos.
Acesse a URL e faça login como gerente de loja no painel da 99Compras.
O painel exibe a mensagem "ANYMARKET quer ter acesso às suas lojas". Selecione todas as lojas que deseja autorizar (é possível autorizar várias lojas de uma vez) e confirme.
Após a confirmação, as lojas autorizadas passam a aparecer no aplicativo de gerenciamento do ANYMARKET, prontas para serem vinculadas.
O time de implantação do ANYMARKET conclui a vinculação, gera o token de acesso e configura o módulo com as credenciais necessárias.

A partir desse momento, sua loja está autenticada e apta a receber o envio de catálogo, preço e estoque.

Envio de produtos

Na integração da 99Compras com o ANYMARKET, o envio de produtos segue algumas regras específicas do modelo Grocery:

O match de produtos na 99Compras ocorre exclusivamente pelo código de barras (EAN), com limite de 14 dígitos. Produtos sem EAN válido ou com EAN que não passou pela curadoria prévia da 99Compras não são publicados, o ANYMARKET retorna uma mensagem de erro clara para o seller nesses casos.
Não é necessário fazer vínculo de marca, categoria ou atributos. A categoria é enviada sempre como "Outros" e ajustada pela 99Compras no processo de catalogação.
Os produtos são sempre simples. A integração não suporta produtos com variação.
Nome do produto: até 50 caracteres. Descrição: até 400 caracteres.
Imagens: entre 150x150px e 3000x3000px, até 10MB, nos formatos JPEG ou PNG.
É necessário enviar e ter aprovados 5 produtos para que a loja seja ativada na 99Compras. Loja ativa significa que ela está apta a receber pedidos e a receber envio de preço e estoque.
Ao enviar um produto, o ANYMARKET recebe um identificador para consultar a carga. A 99Compras responde com o resultado do processamento (cadastrado, não cadastrado ou sucesso) e notifica sobre qualquer violação de regras de catalogação. Você tem visibilidade total do status do anúncio.

Preço e estoque

O envio de estoque é feito em uma chamada separada, e não faz parte do payload de envio do produto.
A chamada de estoque só pode ser enviada após o produto estar ativo e aceito na 99Compras. Enviar estoque antes da ativação do produto gera erro.
O envio de preço promocional exige que o valor promocional seja menor que o preço cheio, com diferença mínima de 1%. Caso contrário, a publicação é bloqueada.
Rate limit de estoque: 10 requisições por minuto, por loja.

Fluxo de pedidos

A 99Compras opera com um fluxo de eventos: cada mudança na jornada do pedido dispara um webhook que o ANYMARKET recebe e trata automaticamente. O ANYMARKET é passivo nesse fluxo, não envia chamadas de confirmação, preparo, entrega ou cancelamento pela integração. Toda a operação (conferência, separação e expedição) acontece no BiApp, o aplicativo da loja na 99Compras.

A tabela abaixo mostra como cada evento da 99Compras se reflete no ANYMARKET:

Evento na 99Compras	Ação no ANYMARKET
orderNew	Notificação apenas. O pedido ainda não é criado no ANYMARKET.
orderConfirmed	Cria uma reserva de estoque. O pedido ainda não é importado.
orderReady	Importa o pedido no ANYMARKET com status Faturado. Este é o momento em que a separação está finalizada, o pacote fechado e os itens definidos.
deliveryStatus (TAKEN)	Atualiza o pedido para Enviado quando o entregador retira o pacote.
orderFinish	Atualiza o pedido para Concluído após confirmação de recebimento.
orderCancel	Atualiza o pedido para Cancelado e libera a reserva de estoque, se houver. Pode acontecer em qualquer momento do ciclo.

Tratamento de descontos e promoções:

Descontos subsidiados pela loja (campanhas criadas pelo seller no painel da 99Compras ou preços promocionais enviados pelo ANYMARKET) são somados ao valor total do pedido importado.
Descontos subsidiados pela 99Compras (cupons da plataforma e clube de benefícios) não são considerados no valor final do pedido no ANYMARKET, uma vez que a 99Compras banca esses descontos e o seller recebe o valor cheio.

Particularidades da integração

Vínculo automático por EAN: a integração não suporta vínculo manual de anúncios por planilha. Porém, quando o seller já possui um produto publicado e aprovado na 99Compras com EAN válido, o envio desse mesmo produto pelo ANYMARKET faz com que a 99Compras vincule automaticamente o anúncio pelo match do EAN — o código externo é gerado e o envio de preço e estoque passa a funcionar normalmente.
Logística: 100% dos pedidos são entregues pela própria 99Compras. Frete e logística própria estão fora do escopo. Configurações de raio de entrega, tempo e taxa ficam no painel da 99Compras — são tabelas fixas por loja.
Separação e expedição: feitas pelo seller diretamente no BiApp, o aplicativo da 99Compras. O ANYMARKET não gerencia essas etapas.
Alteração de itens do pedido: substituição, troca ou remoção de itens durante a separação é feita exclusivamente no BiApp.
Notinha do consumidor: gerada e disponibilizada dentro do BiApp. Não é nota fiscal e não passa pela integração com o ANYMARKET.
Cancelamento: pode ser feito pela loja, pelo seller ou pelo comprador, e é refletido no ANYMARKET a partir do evento orderCancel.

Dúvidas comuns

Sou seller de restaurante. Posso usar esta integração?
Não. A integração com a 99Compras atende apenas o modelo Grocery (mercado, farmácia, pet shop, floricultura, beleza, brinquedos, presentes, utensílios domésticos e demais categorias do Grocery). Sellers de restaurante não são atendidos por esta integração.

Preciso enviar meu catálogo à 99Compras antes de publicar pelo ANYMARKET?
Sim. Todo seller que se integra passa por uma etapa prévia de catalogação e curadoria com o gerente de contas da 99Compras. Sem essa curadoria, os produtos enviados pelo ANYMARKET não são publicados.

Por que meu produto foi enviado pelo ANYMARKET mas não aparece na 99Compras?
O match de produtos na 99Compras ocorre exclusivamente pelo código de barras (EAN). Se o EAN não estiver correto ou não tiver passado pela curadoria prévia da 99Compras, o produto não é publicado. O ANYMARKET exibe uma mensagem de erro clara nesses casos — verifique o status do anúncio no ANYMARKET para identificar a causa.

Quantos produtos preciso enviar para ativar minha loja na 99Compras?
São necessários 5 produtos enviados e aprovados para que a loja seja ativada e passe a receber pedidos e envio de preço e estoque.

Posso integrar várias lojas da 99Compras no mesmo ANYMARKET?
Sim. A integração é multicontas: uma única conta no ANYMARKET gerencia várias lojas da 99Compras. Todas podem ser autorizadas de uma só vez durante o consentimento na URL de autorização, e cada loja mantém seu próprio token de acesso.

Meu preço promocional não está sendo aceito. Por quê?
O preço promocional precisa ser menor que o preço cheio, com diferença mínima de 1%. Se a diferença for inferior a esse percentual, a 99Compras bloqueia a publicação.

Posso cadastrar produtos com variação?
Não. A 99Compras opera apenas com produtos simples. Produtos com variação não são suportados pela integração.

Onde faço a separação e a expedição dos pedidos?
A separação e a expedição são realizadas no BiApp, o aplicativo da loja na 99Compras. O ANYMARKET não gerencia essas etapas — a entrega é 100% executada pela 99Compras.

Como funciona a nota fiscal dos pedidos da 99Compras?
A 99Compras gera uma notinha do consumidor dentro do BiApp, que não é nota fiscal e não passa pela integração com o ANYMARKET.

Consigo vincular produtos que já existem na 99Compras ao ANYMARKET?
Sim, de forma automática. Quando um produto já está publicado e aprovado na 99Compras com EAN válido, o envio do mesmo produto pelo ANYMARKET faz com que a 99Compras vincule o anúncio automaticamente pelo match de EAN. A partir daí, o envio de preço e estoque passa a funcionar normalmente.

Posso usar frete próprio na 99Compras?
Não. 100% dos pedidos da 99Compras são entregues pela própria 99Compras. Frete e logística própria estão fora do escopo da integração.

Onde configuro raio de entrega, tempo e taxa?
Essas configurações são definidas no painel da 99Compras, por loja. São tabelas fixas gerenciadas diretamente pela 99Compras e não passam pelo ANYMARKET.

A URL de autorização expira. E se eu não conseguir usar dentro do prazo?
A URL de autorização tem validade de 7 dias corridos. Se você não conseguir concluir o consentimento dentro desse prazo, entre em contato com o time de implantação do ANYMARKET para que uma nova URL seja gerada.