Paciente
=========

Neste documento estão descritos todos os campos necessários para importar dados cadastrais de pacientes para o iClinic.

.. warning::

    Para que a importação seja realizada com sucesso, deve-se enviar um arquivo com os dados organizados e formatados como
    descrito na tabela abaixo. Caso tenha alguma inconsistência nos dados, a importação não poderá ser efetuada.


Descrição dos campos
--------------------

+-----------------------------------+---------------------------+---------------------------------------------------+
|Campo                              |Tipo                       |Descrição                                          |
+===================================+===========================+===================================================+
|patient_code                       |Int                        |Código do paciente                                 |
+-----------------------------------+---------------------------+---------------------------------------------------+
|name *                             |String(128)                |Nome do paciente                                   |
+-----------------------------------+---------------------------+---------------------------------------------------+
|civil_name                         |String(128)                |Nome civil do paciente (informar quando `name`     |
|                                   |                           |for preenchido com nome social)                    |
+-----------------------------------+---------------------------+---------------------------------------------------+
|birth_date *                       |Date                       |Data de nascimento (formato: aaaa-mm-dd)           |
+-----------------------------------+---------------------------+---------------------------------------------------+
|gender                             |String(1)                  |Sexo_ (**apenas sigla**, ex: f)                    |
+-----------------------------------+---------------------------+---------------------------------------------------+
|social_gender                      |String(2)                  |Genero_ (**apenas sigla**, ex: ci)                 |
+-----------------------------------+---------------------------+---------------------------------------------------+
|cpf                                |String(16)                 |CPF do paciente                                    |
+-----------------------------------+---------------------------+---------------------------------------------------+
|rg                                 |String(16)                 |RG (documento de identidade) do paciente           |
+-----------------------------------+---------------------------+---------------------------------------------------+
|rg_issuer                          |String(48)                 |Orgão emissor do RG                                |
+-----------------------------------+---------------------------+---------------------------------------------------+
|mobile_phone                       |String(20)                 |Telefone celular (formato: (99) 99999-9999)        |
+-----------------------------------+---------------------------+---------------------------------------------------+
|home_phone                         |String(20)                 |Telefone residencial (formato: (99) 9999-9999)     |
+-----------------------------------+---------------------------+---------------------------------------------------+
|office_phone                       |String(20)                 |Telefone comercial (formato: (99) 9999-9999)       |
+-----------------------------------+---------------------------+---------------------------------------------------+
|email                              |String(250)                |E-mail do paciente                                 |
+-----------------------------------+---------------------------+---------------------------------------------------+
|email_secondary                    |String(250)                |E-mail secundário                                  |
+-----------------------------------+---------------------------+---------------------------------------------------+
|birth_place                        |String(128)                |Cidade de nascimento (ex: Ribeirão Preto)          |
+-----------------------------------+---------------------------+---------------------------------------------------+
|birth_state                        |String(2)                  |Estado_ de nascimento (**apenas sigla**, ex: SP)   |
+-----------------------------------+---------------------------+---------------------------------------------------+
|zip_code                           |String(10)                 |CEP: (formato: 99999-999)                          |
+-----------------------------------+---------------------------+---------------------------------------------------+
|address                            |String(256)                |Endereço                                           |
+-----------------------------------+---------------------------+---------------------------------------------------+
|number                             |String(10)                 |Número                                             |
+-----------------------------------+---------------------------+---------------------------------------------------+
|complement                         |String(128)                |Complemento                                        |
+-----------------------------------+---------------------------+---------------------------------------------------+
|neighborhood                       |String(128)                |Bairro                                             |
+-----------------------------------+---------------------------+---------------------------------------------------+
|city                               |String(128)                |Cidade                                             |
+-----------------------------------+---------------------------+---------------------------------------------------+
|state                              |String(2)                  |Estado_ (**apenas sigla**, ex: SP)                 |
+-----------------------------------+---------------------------+---------------------------------------------------+
|country                            |String(2)                  |País (**apenas sigla**, ex: BR)                    |
+-----------------------------------+---------------------------+---------------------------------------------------+
|ethnicity                          |String(2)                  |`Cor/Raça`_ (**apenas sigla**)                     |
+-----------------------------------+---------------------------+---------------------------------------------------+
|marital_status                     |String(2)                  |`Estado civil`_ (**apenas sigla**)                 |
+-----------------------------------+---------------------------+---------------------------------------------------+
|religion                           |String(46)                 |Religião                                           |
+-----------------------------------+---------------------------+---------------------------------------------------+
|occupation                         |String(64)                 |Ocupação                                           |
+-----------------------------------+---------------------------+---------------------------------------------------+
|education                          |String(2)                  |Escolaridade_  (**apenas sigla**)                  |
+-----------------------------------+---------------------------+---------------------------------------------------+
|responsible                        |String(128)                |Responsável                                        |
+-----------------------------------+---------------------------+---------------------------------------------------+
|cns                                |String(15)                 |Cartão Nacional de Saúde                           |
+-----------------------------------+---------------------------+---------------------------------------------------+
|observation                        |Text                       |Informações adicionais                             |
+-----------------------------------+---------------------------+---------------------------------------------------+
|died                               |Bool                       |Óbito                                              |
+-----------------------------------+---------------------------+---------------------------------------------------+
|death_info                         |String(128)                |Informações sobre a morte                          |
+-----------------------------------+---------------------------+---------------------------------------------------+
|nationality                        |String(2)                  |Nacionalidade (**apenas sigla**, ex: BR)           |
+-----------------------------------+---------------------------+---------------------------------------------------+
|indication                         |String(2)                  |Indicação_  (**apenas sigla**)                     |
+-----------------------------------+---------------------------+---------------------------------------------------+
|indication_observation             |String(128)                |Observações sobre a indicação                      |
+-----------------------------------+---------------------------+---------------------------------------------------+
|active                             |Bool                       |Cadastro ativo                                     |
+-----------------------------------+---------------------------+---------------------------------------------------+
|receive_email                      |Bool                       |Aceita receber e-mail                              |
+-----------------------------------+---------------------------+---------------------------------------------------+
|healthinsurance_pack               |String(256)                |Dados de Convênio_                                 |
+-----------------------------------+---------------------------+---------------------------------------------------+
|patientrelatedness_mother_names    |String(128)                |Nome da(s) mãe(s)                                  |
+-----------------------------------+---------------------------+---------------------------------------------------+
|patientrelatedness_father_names    |String(128)                |Nome do(s) pai(s)                                  |
+-----------------------------------+---------------------------+---------------------------------------------------+
|tag_names                          |String(128)                |Tag(s) (ex: Prioritário~Desconto20)                |
+-----------------------------------+---------------------------+---------------------------------------------------+
|tag_physician_id                   |Int                        |Identificador do profissional de saúde responsável |
|                                   |                           |pela tag                                           |
+-----------------------------------+---------------------------+---------------------------------------------------+
|picture_filename                   |String(100)                |Nome do arquivo com a foto do paciente na subpasta |
|                                   |                           |"picture"                                          |
+-----------------------------------+---------------------------+---------------------------------------------------+


Descrição dos campos json
--------------------------

.. _Convênio:

**Convênio**


+---------------------------+---------------------------+---------------------------------------------------+
|name *                     |String(250)                |Nome do convênio                                   |
+---------------------------+---------------------------+---------------------------------------------------+
|register                   |String(128)                |Número de registro                                 |
+---------------------------+---------------------------+---------------------------------------------------+
|grace_period               |Int                        |Período de carência em dias                        |
+---------------------------+---------------------------+---------------------------------------------------+
|plan                       |String(128)                |Plano do paciente                                  |
+---------------------------+---------------------------+---------------------------------------------------+
|code                       |String(128)                |Número da carteirinha                              |
+---------------------------+---------------------------+---------------------------------------------------+
|expiry_date                |Date                       |Data de validade (formato: aaaa-mm-dd)             |
+---------------------------+---------------------------+---------------------------------------------------+
|undetermined               |Bool                       |Validade indeterminada                             |
+---------------------------+---------------------------+---------------------------------------------------+
|accommodation              |String(128)                |Acomodação (ex: Enfermaria)                        |
+---------------------------+---------------------------+---------------------------------------------------+

Exemplo de conteúdo:

.. code-block:: json

  json::[
    {
        "name": "Unimed Nacional",
        "register": "123456",
        "grace_period": "30",
        "plan": "Corporativo",
        "code": "98745213265985",
        "expiry_date": "2025-11-31",
        "undetermined": "0",
        "accommodation": "Apartamento"
    }
  ]



**Observações:**

* todos os campos marcados com "*" (asterisco) **são obrigatórios**;
* os campos `Bool` devem ser preenchido com valores 1, para sim, ou 0, para não;
* o caractere "~" (til) é usado para separar múltiplos valores nos campos `patientrelatedness_mother_names`, `patientrelatedness_father_names` e `tag_names`;
* os arquivos de foto do paciente devem ser armazenados junto com os arquivos CSV, na subpasta "picture";
* o campo birth_date somente deve conter datas posteriores à 1900-01-01;
* o campo observation deve conter apenas texto, sem tags HTML.

Lista de sigla dos campos
--------------------------

.. _Sexo:

**Sexo**

+---------------+-----------+
|Descrição      |Sigla      |
+===============+===========+
|Feminino       |f          |
+---------------+-----------+
|Masculino      |m          |
+---------------+-----------+


.. _Genero:

**Gênero**

+---------------+-----------+
|Descrição      |Sigla      |
+===============+===========+
|Agênero        |ag         |
+---------------+-----------+
|Cisgênero      |ci         |
+---------------+-----------+
|Não-binário    |nb         |
+---------------+-----------+
|Transgênero    |ts         |
+---------------+-----------+


.. _Estado:

**Estado**

+--------------------+------------+
|Descrição           |Sigla       |
+====================+============+
|Acre                |AC          |
+--------------------+------------+
|Alagoas             |AL          |
+--------------------+------------+
|Amapá               |AP          |
+--------------------+------------+
|Amazonas            |AM          |
+--------------------+------------+
|Bahia               |BA          |
+--------------------+------------+
|Ceará               |CE          |
+--------------------+------------+
|Distrito Federal    |DF          |
+--------------------+------------+
|Espírito Santo      |ES          |
+--------------------+------------+
|Goiás               |GO          |
+--------------------+------------+
|Maranhão            |MA          |
+--------------------+------------+
|Mato Grosso         |MT          |
+--------------------+------------+
|Mato Grosso do Sul  |MS          |
+--------------------+------------+
|Minas Gerais        |MG          |
+--------------------+------------+
|Pará                |PA          |
+--------------------+------------+
|Paraíba             |PB          |
+--------------------+------------+
|Paraná              |PR          |
+--------------------+------------+
|Pernambuco          |PE          |
+--------------------+------------+
|Piauí               |PI          |
+--------------------+------------+
|Rio de Janeiro      |RJ          |
+--------------------+------------+
|Rio Grande do Norte |RN          |
+--------------------+------------+
|Rio Grande do Sul   |RS          |
+--------------------+------------+
|Rondônia            |RO          |
+--------------------+------------+
|Roraima             |RR          |
+--------------------+------------+
|Santa Catarina      |SC          |
+--------------------+------------+
|São Paulo           |SP          |
+--------------------+------------+
|Sergipe             |SE          |
+--------------------+------------+
|Tocantins           |TO          |
+--------------------+------------+


.. _Cor/Raça:

**Cor/Raça**

+---------------+-----------+
|Descrição      |Sigla      |
+===============+===========+
|Amarela        |ye         |
+---------------+-----------+
|Branca         |wh         |
+---------------+-----------+
|Negra          |bl         |
+---------------+-----------+
|Parda          |br         |
+---------------+-----------+

.. _Estado civil:

**Estado civil**

+---------------+-----------+
|Descrição      |Sigla      |
+===============+===========+
|Solteiro       |si         |
+---------------+-----------+
|Casado         |ma         |
+---------------+-----------+
|Separado       |se         |
+---------------+-----------+
|Divorciado     |di         |
+---------------+-----------+
|Viúvo          |wi         |
+---------------+-----------+
|União Estável  |st         |
+---------------+-----------+

.. _Escolaridade:

**Escolaridade**

+-----------------------------------+---------+
|Descrição                          |Sigla    |
+===================================+=========+
|Nenhuma                            |n        |
+-----------------------------------+---------+
|Ensino fundamental                 |f        |
+-----------------------------------+---------+
|Ensino fundamental incompleto      |fn       |
+-----------------------------------+---------+
|Ensino médio                       |s        |
+-----------------------------------+---------+
|Ensino médio incompleto            |sn       |
+-----------------------------------+---------+
|Ensino superior                    |h        |
+-----------------------------------+---------+
|Ensino superior incompleto         |hn       |
+-----------------------------------+---------+
|Pós graduação                      |p        |
+-----------------------------------+---------+
|Mestrado                           |m        |
+-----------------------------------+---------+
|Doutorado                          |d        |
+-----------------------------------+---------+


.. _Indicação:

**Indicação**

+-----------------------------------+---------+
|Descrição                          |Sigla    |
+===================================+=========+
|Guia médico                        |pg       |
+-----------------------------------+---------+
|Encaminhamento médico              |pf       |
+-----------------------------------+---------+
|Indicação de paciente              |pi       |
+-----------------------------------+---------+
|Internet                           |in       |
+-----------------------------------+---------+
|Hospital                           |ho       |
+-----------------------------------+---------+
|Outros                             |ot       |
+-----------------------------------+---------+


Arquivos
---------

.. note::
    Faça o download do arquivo de exemplo (:download:`Cadastros de paciente<_static/patient.csv>`, :download:`Todos os arquivos<_static/importacao-iclinic.zip>`).


Modelos
---------

- :doc:`Prontuário <../records>`

- :doc:`Agendamento <../schedulings>`

- :doc:`Anexo <../attachments>`