Ir para o conteúdo
SmartOptic

Catálogo de ótica para lojas

Armações, óculos de sol e lentes — por API e em Excel

430.000 referências, 305 marcas e lentes de contacto. Atributos, fotografias, códigos de barras e preços recomendados: obtenha-os com uma chamada à API ou numa exportação Excel.

API REST
Filtros por marca, modelo, tipo e dezenas de outros campos. Paginação por cursor para a exportação completa, ligações para as fotografias e feed incremental de alterações.
Exportação Excel
Para quem não trabalha com API: escolha marcas, filtros e colunas e receba um ficheiro. Ao marcar a caixa, as fotografias chegam num arquivo separado.

O que está no catálogo

Estes números são lidos diretamente da base de dados e atualizam-se sozinhos — não são valores escritos na página.

430.386
referências no total
59.862
nas coleções atuais
305
marcas
82.796
modelos
275.253
referências com fotografias
324.546
referências de lentes de contacto

O catálogo guarda também os modelos descontinuados: servem para identificar existências e coleções anteriores. Cada referência tem o seu próprio estado.

Como obter os dados

Dois caminhos para equipas diferentes: uma chamada a partir do seu sistema ou um ficheiro que qualquer pessoa abre.

API REST

Para integrar o site, o sistema de inventário ou os anúncios nos marketplaces.

  • Filtros por marca, modelo, tipo, género, forma, material e dezenas de outros campos
  • Paginação por cursor: o catálogo inteiro é descarregado sem falhas nem duplicados
  • Fluxo incremental: recolhe apenas o que mudou desde a última sincronização

Exportação Excel

Para quem precisa de um ficheiro e não de uma integração. Sem programador.

  • Escolha marcas, filtros e colunas e guarde a seleção como modelo
  • Antes de iniciar vê quantas referências entrarão no ficheiro
  • As exportações grandes são preparadas em segundo plano; a ligação aparece na sua conta

Fotografias

Imagens de produto em fundo limpo, prontas para a montra ou o marketplace.

  • Na API: ligações diretas para as imagens em cada referência
  • Nas exportações: um arquivo separado, organizado por marca e modelo
  • Dentro do arquivo há um índice que liga cada código de barras aos seus ficheiros

Que aspeto tem uma resposta

Dados reais do catálogo, não um exemplo da documentação.

Pedido

GET /v1/products?brand=RAY-BAN&has_photo=true&limit=2

Resposta

{
  "data": [
    {
      "ean": "805289003472",
      "brand": "RAY-BAN",
      "model": "RB3136",
      "name": "RB3136 001 58",
      "color": "GOLD",
      "size": "58",
      "gender": "UNISEX",
      "material": "METAL",
      "rrp": 169,
      "currency": "EUR",
      "status": "ACTIVE",
      "images": [
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/805289003472.png"
      ]
    },
    {
      "ean": "8056262017838",
      "brand": "RAY-BAN",
      "model": "RX5425D",
      "name": "RX5425D 2012 54",
      "color": "TORTOISE",
      "size": "54",
      "gender": "UNISEX",
      "material": "ACETATE",
      "rrp": 169,
      "currency": "EUR",
      "status": "ACTIVE",
      "images": [
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8056262017838.jpg"
      ]
    }
  ],
  "meta": {
    "returned": 2,
    "cursor": null
  }
}

O conjunto de campos é definido por si: se precisar apenas do código de barras, do preço e da ligação à fotografia, a resposta terá exatamente isso. A lista completa de campos é devolvida por /v1/meta — o ponto de partida mais prático para construir a integração.

Como começar

Do pedido à primeira chamada costuma passar um dia útil.

  1. Pedido

    Deixe os seus contactos e diga-nos do que precisa: a API, as exportações ou ambas.

  2. Condições e acesso

    Combinamos volume e condições e ativamos o acesso. O pagamento com cartão ainda não é automático: emitimos fatura.

  3. A sua conta

    Recebe uma ligação, define a palavra-passe e gera uma chave de API ou prepara já a primeira exportação.

  4. Integração

    A documentação com exemplos de pedidos prontos está na sua conta. Ajudamos nas questões de integração.

Planos

Distinguem-se pelos limites: pedidos por mês, linhas e fotografias por exportação.

Trial

Gratuito

Pedidos por mês
1.000
Pedidos por minuto
30
Linhas por exportação
1.000
Fotografias por arquivo
200
Exportações por dia
3
Chaves de API
1
Falar connosco

Catalog

Sob consulta

Pedidos por mês
100.000
Pedidos por minuto
120
Linhas por exportação
100.000
Fotografias por arquivo
20.000
Exportações por dia
10
Chaves de API
3
Falar connosco

Pro

Sob consulta

Pedidos por mês
Pedidos por minuto
300
Linhas por exportação
Fotografias por arquivo
100.000
Exportações por dia
30
Chaves de API
10
Falar connosco

Nesta primeira versão emitimos fatura: ainda não há débito automático em cartão. Os limites podem ser aumentados para um trabalho específico sem mudar para o plano superior: diga-nos o volume de que precisa.

O software SmartOptic

Uma aplicação para fornecedores de ótica: receção, preparação, expedição, compras, documentos e agente de IA numa só janela.

Painel e análises
Painel e análises
Catálogo
Catálogo
Receção de mercadoria
Receção de mercadoria
Expedição e embalamento
Expedição e embalamento
Agente de IA
Agente de IA
Documentos e faturas
Documentos e faturas

O software foi feito para os fornecedores e os seus clientes: o fornecedor gere nele o armazém e as encomendas, enquanto as suas lojas recebem uma área própria com catálogo e carrinho. Se for fornecedor, mostramos com todo o gosto.

Desenvolvimento para o setor ótico

O catálogo não é tudo o que fazemos. Tudo o que se segue nasceu de problemas que resolvemos para nós e para os nossos clientes.

Desenvolvimento à medida

Sistemas de armazém e venda, áreas de cliente, trabalho sobre sites existentes. Partimos do problema, não de um produto fechado.

Adoção de IA

Agentes que leem faturas e e-mails, respondem a partir dos seus dados e tiram a rotina às pessoas. Um agente destes funciona dentro do nosso próprio software — não numa apresentação.

Pesquisa inteligente

Pesquisa de catálogo que aguenta gralhas e percebe a intenção, não apenas a correspondência exata. Construída sobre representações vetoriais dos produtos.

Integrações

Marketplaces, transportadoras, sistemas de pagamento e de contabilidade. Movemos os dados entre sistemas para que ninguém tenha de os conferir à mão.

Perguntas frequentes

O catálogo inclui existências?

Não. O catálogo são dados de referência: atributos, fotografias, códigos de barras e preços recomendados. A disponibilidade vive noutro sistema e não faz parte destes dados. Dizemo-lo à partida para não criar expectativas erradas.

Que preços fornecem?

Os preços de venda recomendados, aqueles a que a marca propõe vender. Os preços de compra não são fornecidos nem por API nem nas exportações.

Posso usar as fotografias no meu site?

Sim, é a razão mais comum para contratar o catálogo. A API devolve ligações diretas para as imagens; nas exportações vem um arquivo com os ficheiros e o respetivo índice.

Com que frequência os dados são atualizados?

O catálogo cresce continuamente, à medida que chegam dados das marcas. A API tem um método que devolve apenas o que mudou desde uma data: não é preciso voltar a descarregar tudo.

Como se paga?

Para já emitimos fatura: ainda não há pagamento com cartão no site. Quando houver, os clientes ativos não terão de mudar nada.

Também há lentes de contacto?

Sim, numa secção própria: curva base, potência, cilindro, eixo, adição, embalagem e preço. Não há fotografias de lentes na base — acrescentariam pouco.