> For the complete documentation index, see [llms.txt](https://ajuda.celk.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.celk.com.br/manual-do-usuario/celk-saude/geral/configuracoes/importacao-q-ware-1101.md).
# Importação Q-Ware (1101)
Confira nas abas abaixo as explicações e orientações referentes a esta tela.
{% tabs %}
{% tab title="Visão Geral" %}
**O que é e para que serve a tela Importação Q-Ware (1101)?**
A funcionalidade Importação Q-Ware (1101) permite importar para o sistema Celk Saúde o arquivo gerado pelo sistema Q-Ware, em cidades que utilizam essa ferramenta integradora de uso proprietário, contendo a relação de usuários beneficiários do programa Auxílio Brasil.
O objetivo é possibilitar o monitoramento dos registros de atendimento desses pacientes, garantindo o acompanhamento das condicionantes de saúde no semestre vigente.
Durante a importação, o sistema:
* Lê o arquivo no formato CSV;
* Valida se o layout está conforme o padrão definido;
* Identifica pacientes existentes pelo CPF;
* Atualiza dados quando necessário;
* Cadastra pacientes não encontrados;
* Registra os dados importados para controle e acompanhamento por semestre;
* Gera relatório de inconsistências quando houver erros.
O processamento mantém histórico das importações realizadas, permitindo auditoria, controle e rastreabilidade por semestre.
**A página de consulta permite:**
* Visualizar a quantidade importada;
* Quantidade de novos cadastros;
* Quantidade de atualizações;
* Data de envio e processamento;
* Situação da importação.
**Ações disponíveis:**
**➡️Cancelar**
* Disponível conforme situação;
* Atualiza a situação para “Cancelado”;
* Registra usuário e data/hora do cancelamento.
**➡️Relatório de Erros**
* Disponível conforme situação;
* Apresenta inconsistências encontradas;
* Exibe Nome do paciente, CPF do registro e descrição da inconsistência.
O relatório permanece disponível na página de consulta para auditoria posterior.
{% endtab %}
{% tab title="Itens de Configuração" %}
**Quais são os principais itens de configuração envolvidos?**
Para que a importação ocorra corretamente, devem ser observadas as seguintes regras:
* O arquivo deve estar no formato CSV;
* Não é aplicado filtro para o tipo de arquivo selecionado, porém o conteúdo deve respeitar o layout definido;
* É obrigatório informar Ano e Semestre no momento da importação;
* O sistema deve validar o layout do arquivo antes do processamento.
**Layout do arquivo Q-Ware:**
| Campo no Arquivo | Campo no Sistema | Regra |
| ------------------- | ------------------ | --------------------------------- |
| NU\_NIS\_INTEGRANTE | NIS | Atualizar se diferente |
| NM\_INTEGRANTE | Nome | Obrigatório |
| DT\_NASCIMENTO | Data de Nascimento | Obrigatório |
| CD\_SEXO | Sexo | 1 = Masculino / 2 = Feminino |
| NM\_MAE | Nome da Mãe | Se vazio, marcar mãe desconhecida |
| CD\_RACA\_COR | Raça/Cor | Mesmo código utilizado no sistema |
| NU\_CPF | CPF | Utilizado para localizar paciente |
**Campos não utilizados no processo:**
CD\_FAMILIAR, DT\_ULTIMA\_ALTERACAO\_PESSOA, CD\_INEP, NU\_SERIE\_ESCOLAR, IN\_PA, CD\_TIPO\_INTEGRANTE.
**Regras de atualização:**
* O paciente será localizado pelo CPF (\);
* Se encontrado:
* Atualizar o NIS apenas se for diferente do valor já existente;
* Atualizar o campo Beneficiário do Bolsa Família para “Sim”;
* Se não encontrado:
* Realizar cadastro como Paciente Simplificado (tela 294);
* Utilizar a cidade da unidade em que o usuário estiver logado como cidade do endereço;
* Aplicar as regras de preenchimento conforme layout.
Todos os pacientes importados ficam vinculados ao semestre informado, permitindo acompanhamento e manutenção posterior.
{% endtab %}
{% tab title="Relação Configuração e Processos" %}
**Qual a relação desta tela com outras configurações e processos do sistema?**
A Importação Q-Ware está relacionada ao:
* Cadastro de Paciente Simplificado (294), utilizado para criação de novos registros quando o CPF não for encontrado;
* Monitoramento das condicionantes de saúde do programa Auxílio Brasil (tela 1102);
* Exportacao Q-Ware (1103), exportando os dados registrados na tela 1102.
{% endtab %}
{% tab title="Dependências" %}
**Essa tela possui alguma dependência?**
A importação depende de:
* Município precisa utilizar a ferramenta integradora Q-Ware, de uso proprietário.
* Layout compatível com o padrão definido.
* CPF válido para identificação do paciente.
* Cadastro adequado de pacientes no sistema.
{% endtab %}
{% endtabs %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://ajuda.celk.com.br/manual-do-usuario/celk-saude/geral/configuracoes/importacao-q-ware-1101.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.