← Voltar para Importar

Como preparar o arquivo de importação

O arquivo pode ser gerado pela IA da sua empresa a partir dos documentos de checklist existentes. O Cata confere tudo antes de gravar.

Passo a passo

  1. Copie o texto abaixo e cole na ferramenta de IA da sua empresa, junto com os documentos dos checklists. Se a ferramenta aceitar arquivos, envie também o exemplo e o JSON Schema.
  2. Salve a resposta da IA como um arquivo .json. Se a IA listar dúvidas depois de uma linha ---, retire essa parte do arquivo e resolva as dúvidas antes.
  3. Em Importar, escolha o arquivo e clique em Verificar. O Cata mostra o que seria criado e aponta cada erro com o caminho no JSON (por exemplo questions[3].type; a contagem começa em 0).
  4. Se houver erros, peça à IA para corrigi-los colando a lista de erros, e verifique de novo.
  5. Clique em Importar. Cada checklist vira um rascunho; revise e publique em Checklists. Depois, em Escopos, escolha o checklist de cada modelo em cada serviço; o código do checklist fica no escopo.

Arquivos grandes podem ser divididos: perguntas já importadas são reconhecidas pelo código e podem ser usadas pelos checklists dos arquivos seguintes.

Texto para a IA

Você vai converter checklists de vistoria veicular para o formato de importação do sistema Cata.
Vou enviar os documentos (Word, PDF ou planilhas). Responda somente com um único JSON válido, sem comentários e sem texto antes ou depois.

Formato:
{
  "format": "cata-checklist-import/v1",
  "questions": [ ...perguntas... ],
  "checklists": [ ...checklists... ]
}

Perguntas ("questions"): cada pergunta aparece uma só vez no arquivo, mesmo que seja usada em vários checklists.
- "code": identificador permanente, em MAIÚSCULAS, só letras sem acento, números e sublinhado, até 40 caracteres. Ex.: "PINTURA_ESTADO_GERAL". Use o mesmo código para a mesma pergunta em todos os checklists.
- "statement": o texto da pergunta como o vistoriador vai ler, até 300 caracteres.
- "type": um destes valores:
  - "c_nc_a" quando a resposta é Conforme / Não conforme / Ausente;
  - "sim_nao_na" quando a resposta é Sim / Não / Não aplicável;
  - "selecao" quando o vistoriador escolhe uma opção de uma lista (ex.: marca de um equipamento);
  - "texto" quando a resposta é livre (ex.: Km, número de série, observação).
- "options": somente para "selecao", lista com pelo menos duas opções, sem repetir.
- "subitems": somente para "c_nc_a" e "sim_nao_na", opcional. São os detalhes que se abrem quando a resposta é Não conforme ou Não (ex.: "Pontos de ferrugem"). Cada subitem tem até 120 caracteres.

Checklists ("checklists"):
- "name": nome do checklist, até 120 caracteres, sem repetir no arquivo.
- "categories": lista de categorias em ordem. Cada categoria tem "name" e "items".
- "items": os códigos das perguntas, em ordem, por exemplo ["KM", "PINTURA_ESTADO_GERAL"]. Cada pergunta aparece uma só vez em cada checklist. Se uma pergunta for opcional, use {"question": "CODIGO", "required": false}.

Regras:
- Todo código usado em "items" precisa estar em "questions" (ou já existir no Cata).
- Se dois documentos têm a mesma pergunta com palavras um pouco diferentes, use uma única pergunta e um único código.
- Não invente perguntas que não estão nos documentos. Se algo estiver ambíguo, escolha a interpretação mais simples e liste as dúvidas para mim depois do JSON, separadas por uma linha "---".

O que acontece com o que já existe no Cata

  • Pergunta com código novo: é criada na versão v1.
  • Pergunta com código existente e mesmo conteúdo: nada muda.
  • Pergunta com código existente e conteúdo diferente: ganha uma nova versão. Checklists já publicados continuam usando a versão anterior até alguém publicar um rascunho com a nova.
  • Checklist com nome novo: é criado com o rascunho v1.
  • Checklist com nome existente: recebe um novo rascunho com exatamente o conteúdo do arquivo. Se ele já tiver um rascunho aberto, a importação é recusada até esse rascunho ser publicado ou descartado.
  • Erros: se houver qualquer erro, nada é importado.

Exemplo

{
  "format": "cata-checklist-import/v1",
  "questions": [
    { "code": "KM", "statement": "Km", "type": "texto" },
    { "code": "PLAQUETA_ANO", "statement": "Plaqueta do ano de fabricação", "type": "c_nc_a" },
    {
      "code": "PINTURA_ESTADO_GERAL",
      "statement": "Estado geral da pintura",
      "type": "c_nc_a",
      "subitems": ["Condição original", "Apresentando repintura", "Pontos amassados", "Pontos de ferrugem"]
    },
    {
      "code": "RASTREADOR_MARCA",
      "statement": "Marca do rastreador",
      "type": "selecao",
      "options": ["Omnilink", "Sascar", "Onixsat", "Outra"]
    },
    {
      "code": "EXTINTOR_VALIDO",
      "statement": "Extintor dentro da validade?",
      "type": "sim_nao_na",
      "subitems": ["Lacre rompido", "Manômetro fora da faixa"]
    }
  ],
  "checklists": [
    {
      "name": "Vistoria de carro de passeio",
      "categories": [
        { "name": "Identificação", "items": ["KM", "PLAQUETA_ANO"] },
        { "name": "Carroceria", "items": ["PINTURA_ESTADO_GERAL"] },
        {
          "name": "Equipamentos",
          "items": ["EXTINTOR_VALIDO", { "question": "RASTREADOR_MARCA", "required": false }]
        }
      ]
    }
  ]
}