Vai al contenuto

Pesquisa pontual por códigos OE / AM no próprio sistema de gestão

Visão geral

Ao integrar o próprio sistema de gestão à Quoting24, é possível retornar em tempo real preços e disponibilidades personalizados para o cliente específico com quem se está conversando ao pesquisar códigos.

Dessa forma, obtêm-se rapidamente as condições comerciais específicas do cliente com quem se está falando.

O objetivo é permitir que a Quoting24, uma vez identificado um código de produto, recupere automaticamente:

  • Disponibilidade e preço líquido do cliente específico
  • Metadados do produto: informações descritivas, marca, eventuais promoções ativas e outros atributos relacionados.
  • O fluxo foi projetado para se integrar de forma transparente às APIs ERP do sistema de gestão do Fornecedor.

Parâmetros de pesquisa

Da Quoting24 ao Fornecedor

Parâmetros obrigatórios

  • Token de autenticação
    Um token único que identifica de forma unívoca os servidores Quoting24.

  • Código de pesquisa
    Preferencialmente um código AM ou OE.
    A pesquisa não deve ser limitada apenas aos códigos de produto exatos, mas também deve:

  • Pesquisar códigos alternativos
  • Pesquisar em bases externas

⚠️ Se este comportamento não for suportado, deve ser comunicado claramente.
No mínimo, a pesquisa deve incluir os dados cadastrais do produto e não apenas os códigos internos exatos.

Identificação do cliente

Deve ser fornecido pelo menos um dos seguintes

  • ID (como cadastrado no Sistema de Gestão) da unidade do seu cliente
  • ID (como cadastrado no Sistema de Gestão) da empresa do seu cliente
  • Número de IVA do cliente
  • ID da categoria de desconto
    Usado para:
  • Clientes não registrados
  • Permitir que o operador modifique dinamicamente as regras de desconto

Parâmetros opcionais

  • ID do operador (opcional, mas recomendado)
    Utilizado para rastrear quem gerou o orçamento.

  • Quantidade
    Pode ser incluída na solicitação se for estritamente necessário.
    Abordagem preferida: gestão da quantidade na resposta, não na solicitação.

  • Marca / Produtor
    Para permitir pesquisas mais precisas.

  • Modo de pesquisa
    Parâmetro de opção para pesquisa exata pontual ou pesquisa com cross (que também produz resultados de produtos alternativos).

Parâmetros de resposta

Do fornecedor à Quoting24

A resposta deve conter uma lista de produtos, cada um com os seguintes campos.

Campos obrigatórios (por produto)

  • Código do produto do fornecedor
    Código interno de pedido, incluindo os prefixos, exatamente como utilizado nos sistemas do Fornecedor.

  • Produtor
    Nome do produtor (ex.: LUK, Magneti Marelli, Brembo).
    Pode ser estruturado em 2 campos:

  • Versão abreviada/precódigo (ex.: MAR)

  • Nome completo (ex.: Magneti Marelli)

  • Preço de venda líquido ao cliente

  • Preço líquido (IVA excluído)
  • Custos de envio excluídos

  • As despesas de envio podem ser retornadas separadamente, se aplicável

  • Disponibilidade
    Valor numérico que representa a quantidade disponível em estoque.

  • Armazém
    Nome do armazém, prateleira ou referência à posição interna.

Campos opcionais

  • Descrição do produto
    Texto livre (ex.: Pastilhas de freio) e/ou categoria merceológica.

  • Código identificativo do Fabricante
    Obrigatório quando o código de produto ERP difere do código do produtor.

  • Preço de tabela
    Não necessário, mas reproduzível se necessário.

  • Promoções

  • Presença de promoção (binário)
  • Texto da promoção (opcional)

  • Se o texto estiver vazio → promoção não ativa

  • Imagem do produto

  • URL da imagem

  • Ou imagem Base64

  • URL da ficha do produto
    Link para a página de detalhes do produto no e-commerce ou no site externo.
    Se a conexão direta não for possível:

  • Fornecer regras de sintaxe URL

  • Ou retornar um URL genérico da página de acesso

  • Preços baseados na quantidade / Descontos
    Se houver descontos por quantidade, retorne os níveis em qualquer formato analisável, por exemplo:

{
  "from": 2,
  "to": 10,
  "price": "50.00"
}