# Para Pessoa Física \[PF]

**Configuração de Estabelecimento Individual**

Para estabelecer uma configuração direcionada a pessoas físicas dentro do sistema, é essencial proceder com uma solicitação via método POST. Essa solicitação pode ser executada tanto através do envio de dados em formato JSON quanto por meio do uso de multipart/form-data, adaptando-se assim às especificidades e à forma dos dados a serem transmitidos, incluindo a necessidade de anexar arquivos binários, se for o caso.

**URL para Envio da Solicitação:**

> [`https://api.paylivre.com.br/estabelecimentos`](https://api.zsystems.com.br/estabelecimentos)

**Cabeçalhos de Solicitação Obrigatórios:**

* Content-Type: Deve ser definido como multipart/form-data ou application/json, conforme a natureza dos dados enviados.
* Authorization: Requer a inclusão de um 'Token API', precedido pela indicação Bearer, para autenticação e autorização do acesso.

**Detalhes dos Parâmetros de Solicitação:**

<table data-header-hidden><thead><tr><th width="224"></th><th width="106"></th><th></th></tr></thead><tbody><tr><td><strong>Parâmetro</strong></td><td><strong>Tipo</strong></td><td><strong>Descrição</strong></td></tr><tr><td>tipoEstabelecimentoID</td><td>Inteiro</td><td>1  = para Pessoa Física,<br>2 = para Pessoa Jurídica</td></tr><tr><td>identificadorPlano</td><td>String</td><td>Código que identifica o plano escolhido pelo estabelecimento</td></tr><tr><td>nome</td><td>String</td><td>Nome completo do proprietário ou nome fantasia</td></tr><tr><td>sendMail</td><td>Boolean</td><td>Define se e-mails automáticos serão enviados (true ou false)</td></tr><tr><td>nomeComprovante</td><td>String</td><td>Nome que aparecerá nos comprovantes emitidos</td></tr><tr><td>email</td><td>String</td><td>E-mail de contato do estabelecimento</td></tr><tr><td>telefone</td><td>String</td><td>Telefone fixo do estabelecimento</td></tr><tr><td>celular</td><td>String</td><td>Número de celular do proprietário</td></tr><tr><td>dataNascimento</td><td>Data</td><td>Data de nascimento do proprietário (formato ISO)</td></tr><tr><td>dataNascimento2</td><td>Data</td><td>Data de nascimento do proprietário (formato europeu)</td></tr><tr><td>cpf</td><td>String</td><td>CPF do proprietário</td></tr><tr><td>categoria</td><td>Inteiro</td><td>Identificador da categoria à qual o estabelecimento pertence</td></tr><tr><td>quantidade_pos</td><td>Inteiro</td><td>Número de terminais POS associados ao estabelecimento</td></tr><tr><td>faturamento_estimado</td><td>Decimal</td><td>Valor do faturamento mensal estimado do estabelecimento</td></tr><tr><td>observacao</td><td>String</td><td>Observações adicionais sobre o estabelecimento</td></tr><tr><td>logradouro</td><td>String</td><td>Endereço do estabelecimento</td></tr><tr><td>numero</td><td>String</td><td>Número do endereço</td></tr><tr><td>cidade</td><td>String</td><td>Cidade do estabelecimento</td></tr><tr><td>estado</td><td>String</td><td>Estado do estabelecimento (código ISO 3166-2 de duas letras)</td></tr><tr><td>cep</td><td>String</td><td>Código de Endereçamento Postal</td></tr><tr><td>bairro</td><td>String</td><td>Bairro onde o estabelecimento está localizado</td></tr><tr><td>complemento</td><td>String</td><td>Complemento do endereço</td></tr><tr><td>nome (proprietario)</td><td>String</td><td>Nome do proprietário</td></tr><tr><td>sobrenome</td><td>String</td><td>Sobrenome do proprietário</td></tr><tr><td>email (proprietario)</td><td>String</td><td>E-mail do proprietário</td></tr><tr><td>celular (proprietario)</td><td>String</td><td>Celular do proprietário</td></tr><tr><td>cpf (proprietario)</td><td>String</td><td>CPF do proprietário</td></tr><tr><td>tipoContaBancaria</td><td>Inteiro</td><td>Tipo da conta bancária (1 para Corrente, 2 para Poupança)</td></tr><tr><td>nomeTitular</td><td>String</td><td>Nome do titular da conta bancária</td></tr><tr><td>bancoId</td><td>Inteiro</td><td>Identificador do banco</td></tr><tr><td>agencia</td><td>String</td><td>Número da agência</td></tr><tr><td>conta</td><td>String</td><td>Número da conta bancária</td></tr><tr><td>razaoSocial</td><td>String</td><td>Razão social do estabelecimento, se aplicável</td></tr><tr><td>desativarVendas</td><td>Boolean</td><td>Indica se as vendas estão habilitadas ou desabilitadas</td></tr></tbody></table>

Exemplo de Requisição em JSON:

{% code overflow="wrap" %}

```json
{
        "tipoEstabelecimentoId": "1",
        "identificadorPlano": "",
        "nome": "Laís Betina Aragão",
        "sendMail": "false",
        "nomeComprovante": "Lais Betina",
        "email": "laisbetinaaragao77@gmail.com.br",
        "telefone": ""
        "celular": "51986060368",
        "dataNascimento": "1983-06-07",
        "dataNascimento2": "1983-06-07",
        "cpf": "88029964153",
        "categoria": "27",
        "quantidade_pos": "0",
        "faturamento_estimado": "10000",
        "observacao": "",
        "endereco": {
            "logradouro": "Rua Iracema",
            "numero": "274",
            "cidade": "Cachoeirinha",
            "estado": "RS",
            "cep": "94940130",
            "bairro": "Vila Monte Carlo",
            "complemento": "",
        },
        "enderecoPOS": {
            "logradouro": "",
            "numero": "",
            "cidade": "",
            "estado": "",
            "cep": "",
            "bairro": "",
            "complemento": "",
        },
        "proprietario": {
            "nome": "",
            "sobrenome": "",
            "email": "",
            "celular": "",
            "dataNascimento": "",
            "cpf": "",
            "endereco": {
            "logradouro": "",
            "numero": "",
            "cidade": "",
            "estado": "",
            "cep": "",
            "bairro": "",
            "complemento": ""
            }
        },
        "contaBancaria": {
            "tipoContaBancaria": "1",
            "nomeTitular": "Lais Betina",
            "bancoId": "7",
            "agencia": "0190",
            "conta": "098730-1",
        },
        "desativarVendas": "0",
        "logo": (binary),
        "documentos[]": (binary),
        "documentosAtividade[]": (binary),
        "documentosResidencia[]": (binary),
}
```

{% endcode %}

Exemplo de resultado:

{% code overflow="wrap" %}

```json
{
    "success": true,
    "estabelecimento": {
      "id": 16853,
      "tipo_estabelecimento_id": 1,
      "status_estabelecimento_id": 1,
      "categoria_estabelecimento_id": 1,
      "endereco_id": 79885,
      "razao_social": "",
      "nome_fantasia": "Laís Betina Aragão",
      "ativo": 0,
      "data_nascimento": "1983-06-07T09:00:00.000Z",
      "created": "2020-12-17T19:26:44.000Z",
      "modified": "2020-12-17T19:26:44.000Z",
      "removed": null,
      "tipo_estabelecimento": {
        "id": 1,
        "titulo": "Pessoa Física",
        "created": "2019-01-11T20:38:52.000Z",
        "modified": "2019-01-11T20:38:52.000Z",
        "removed": null
      },
      "status_estabelecimento": {
        "id": 1,
        "titulo": "Aguardando Aprovação",
        "created": "2019-07-22T20:24:19.000Z",
        "modified": "2019-07-22T20:24:19.000Z",
        "removed": null
      },
      "categoria_estabelecimento": {
        "id": 1,
        "titulo": "Padrão",
        "created": "2019-07-25T18:18:17.000Z",
        "modified": "2019-07-25T18:18:17.000Z",
        "removed": null
      },
      "endereco": {
        "id": 79885,
        "logradouro": "Rua Iracema",
        "numero": "274",
        "complemento": "",
        "cep": "94940130",
        "bairro": "Vila Monte Carlo",
        "cidade": "Cachoeirinha",
        "uf": "RS",
        "lat": null,
        "long": null,
        "created": "2020-12-17T19:26:44.000Z",
        "modified": "2020-12-17T19:26:44.000Z",
        "removed": null
      }
    }
}
```

{% endcode %}

Este procedimento permite configurar com precisão e detalhamento o perfil e as informações financeiras de um estabelecimento dentro do marketplace, garantindo uma integração eficaz e a correta administração das transações comerciais e operações bancárias associadas.
