bitvisual-mcp

Lista os produtos e serviços da BitVisual com modelo de preço (por m², preço fixo, por tiragem ou sob consulta), preço base, limites de medida e prazo de produção. Filtre por categoria se quiser.

{
  "type": "object",
  "properties": {
    "categoria": {
      "type": "string",
      "description": "Opcional. Uma de: Canvas, Wind Banner, Comunicação Visual, Folders e Panfletos, Tags, Adesivos, Cartão de Visita, Lona, Banners, Projetos especiais"
    }
  }
}

Cota o preço oficial de um produto. Para produtos por m² informe largura_cm e altura_cm EM CENTÍMETROS (nunca assuma a unidade — confirme com o cliente antes). Para tiragem informe quantidade. Retorna preço unitário, total, opções/acabamentos disponíveis e link do produto. Não cria pedido.

{
  "type": "object",
  "properties": {
    "produto": {
      "type": "string",
      "description": "slug do produto (campo 'slug' do catalogo)"
    },
    "largura_cm": {
      "type": "number",
      "description": "largura em CENTÍMETROS (obrigatório p/ produtos por m²)"
    },
    "altura_cm": {
      "type": "number",
      "description": "altura em CENTÍMETROS (obrigatório p/ produtos por m²)"
    },
    "quantidade": {
      "type": "number",
      "description": "quantidade de unidades (padrão 1)"
    }
  },
  "required": [
    "produto"
  ]
}

Prazo de produção do produto e opções de entrega/retirada em São Paulo. Informe o CEP de destino para orientação de frete.

{
  "type": "object",
  "properties": {
    "produto": {
      "type": "string",
      "description": "slug do produto"
    },
    "cep": {
      "type": "string",
      "description": "CEP de destino — com ele retorno as opções REAIS de frete (transportadora, preço, prazo)"
    },
    "largura_cm": {
      "type": "number",
      "description": "largura em cm (melhora o cálculo do frete)"
    },
    "altura_cm": {
      "type": "number",
      "description": "altura em cm (melhora o cálculo do frete)"
    },
    "quantidade": {
      "type": "number",
      "description": "quantidade (padrão 1)"
    }
  },
  "required": [
    "produto"
  ]
}

Retorna os requisitos técnicos do arquivo de impressão (formatos, resolução, cores, sangria) e como enviá-lo. Use antes de criar_pedido para orientar o cliente.

{
  "type": "object",
  "properties": {
    "produto": {
      "type": "string",
      "description": "slug do produto (opcional, para dicas específicas)"
    }
  }
}

Cria um pedido REAL na BitVisual e retorna o código PIX copia-e-cola para o cliente pagar. Só funciona para produtos cotáveis (use cotar() antes). Pedidos até R$ 1.000 entram direto; acima disso viram orçamento com atendimento humano. Retirada GRÁTIS na loja (Vila Mariana/SP) ou ENTREGA em todo o Brasil: informe o endereço completo com CEP e o frete real entra no total. ANTES de chamar, confirme com o cliente: produto, medidas em cm, quantidade, total, e-mail e CPF/CNPJ. A produção só começa após o pagamento e o envio da arte.

{
  "type": "object",
  "properties": {
    "produto": {
      "type": "string",
      "description": "slug do produto"
    },
    "largura_cm": {
      "type": "number",
      "description": "largura em CENTÍMETROS (produtos por m²)"
    },
    "altura_cm": {
      "type": "number",
      "description": "altura em CENTÍMETROS (produtos por m²)"
    },
    "quantidade": {
      "type": "number",
      "description": "quantidade (padrão 1)"
    },
    "nome": {
      "type": "string",
      "description": "nome completo do cliente"
    },
    "email": {
      "type": "string",
      "description": "e-mail do cliente (recebe o pedido e acompanha o status)"
    },
    "whatsapp": {
      "type": "string",
      "description": "WhatsApp/telefone do cliente com DDD"
    },
    "cpf_cnpj": {
      "type": "string",
      "description": "CPF (11 dígitos) ou CNPJ (14) do cliente — OBRIGATÓRIO: usado na cobrança PIX e na nota fiscal"
    },
    "observacoes": {
      "type": "string",
      "description": "detalhes do pedido: acabamento escolhido, cores, instruções (opcional)"
    },
    "arte_url": {
      "type": "string",
      "description": "link https do arquivo de arte, se o cliente já tiver (opcional — também pode enviar depois)"
    },
    "cep": {
      "type": "string",
      "description": "CEP de ENTREGA — informe junto com endereço/numero para receber em casa; sem CEP = retirada grátis na loja"
    },
    "endereco": {
      "type": "string",
      "description": "rua/avenida de entrega (obrigatório se informou CEP)"
    },
    "numero": {
      "type": "string",
      "description": "número do endereço de entrega"
    },
    "complemento": {
      "type": "string",
      "description": "complemento (opcional)"
    },
    "bairro": {
      "type": "string",
      "description": "bairro de entrega"
    },
    "cidade": {
      "type": "string",
      "description": "cidade de entrega"
    },
    "estado": {
      "type": "string",
      "description": "UF de entrega, 2 letras (ex.: SP)"
    }
  },
  "required": [
    "produto",
    "quantidade",
    "nome",
    "email",
    "whatsapp",
    "cpf_cnpj"
  ]
}

Consulta o status de um pedido existente. Exige o número do pedido E o e-mail usado na compra (proteção de dados).

{
  "type": "object",
  "properties": {
    "numero": {
      "type": "number",
      "description": "número do pedido (OS)"
    },
    "email": {
      "type": "string",
      "description": "e-mail usado no pedido"
    }
  },
  "required": [
    "numero",
    "email"
  ]
}