🏢Para Pessoa Jurídica [PJ]

Implementação de Registro para Estabelecimentos de Pessoa Jurídica

Para registrar um estabelecimento voltado para o segmento de pessoas jurídicas, é imprescindível a realização de uma solicitação através do método POST. Essa ação pode ser concretizada tanto por meio da submissão de dados em estrutura JSON quanto pela utilização do formato multipart/form-data, a escolha do método depende do tipo e da estruturação dos dados a serem enviados, incluindo a possibilidade de anexar arquivos binários, se necessário.

Endereço para Envio da Solicitação:

https://api.zsystems.com.br/estabelecimentos

Cabeçalhos Requeridos para a Solicitação:

• Content-Type: Deve ser ajustado para multipart/form-data ou application/json, dependendo do formato dos dados fornecidos.

• Authorization: Necessita da inclusão de um 'Token API', antecedido pela palavra Bearer, como forma de autenticação e autorização.

Detalhamento dos Parâmetros para Solicitação:

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

Exemplo de Requisição em JSON:

{
  "tipoEstabelecimentoId": "2",
  "nome": "",
  "sendMail": "false",
  "nomeComprovante": "Danilo/Isabel",
  "email": "[e-mail]",
  "telefone": "1725849273"
  "celular": "17983722026",
  "dataNascimento": "",
  "dataNascimento2": "",
  "cpf": "",
  "categoria": "23",
  "quantidade_pos": "0",
  "faturamento_estimado": "100000",
  "observacao": "",
  "endereco": {
    "logradouro": "Rua Silvio Pelicer",
    "numero": "608",
    "cidade": "São José do Rio Preto",
    "estado": "SP",
    "cep": "15056024",
    "bairro": "Condomínio Village Rio Preto",
    "complemento": "",
  },
  "enderecoPOS": {
    "logradouro": "",
    "numero": "",
    "cidade": "",
    "estado": "",
    "cep": "",
    "bairro": "",
    "complemento": "",
  },
  "proprietario": {
    "nome": "Isabel",
    "sobrenome": "Benedita Araújo",
    "email": "[e-mail]",
    "celular": "(67) 9 8590-5327",
    "dataNascimento": "06/04/1998",
    "cpf": "045.036.078-47",
    "endereco": {
      "logradouro": "Rua Oulivenca",
      "numero": "306",
      "cidade": "Campo Grande",
      "estado": "MS",
      "cep": "79034451",
      "bairro": "Parque dos Novos Estados",
      "complemento": ""
    }
  },
  "contaBancaria": {
    "tipoContaBancaria": "1",
    "nomeTitular": "Isabel Benedita",
    "bancoId": "6",
    "agencia": "0590",
    "conta": "012855-3",
  },
  "desativarVendas": "0",
  "razaoSocial": "Danilo e Isabel Telecom Ltda",
  "nomeFantasia": "Danilo e Isabel Telecom Ltda",
  "cnpj": "63792040000133",
  "logo": (binary),
  "documentos[]": (binary),
  "documentosProprietario[]": (binary),
  "documentosAtividade[]": (binary),
  "documentosResidencia[]": (binary),
}

Exemplo de resultado:

{
    "success": true,
    "estabelecimento": {
      "id": 16842,
      "tipo_estabelecimento_id": 2,
      "status_estabelecimento_id": 1,
      "categoria_estabelecimento_id": 1,
      "endereco_id": 79412,
      "razao_social": "Danilo e Isabel Telecom Ltda",
      "nome_fantasia": "Danilo e Isabel Telecom Ltda",
      "ativo": 0,
      "data_nascimento": null,
      "created": "2020-12-17T15:23:27.000Z",
      "modified": "2020-12-17T15:23:28.000Z",
      "removed": null,
      "tipo_estabelecimento": {
        "id": 2,
        "titulo": "Pessoa Jurídica",
        "created": "2019-01-11T20:38:59.000Z",
        "modified": "2019-01-11T20:38:59.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": 79412,
        "logradouro": "Rua Silvio Pelicer",
        "numero": "608",
        "complemento": "",
        "cep": "15056024",
        "bairro": "Condomínio Village Rio Preto",
        "cidade": "São José do Rio Preto",
        "uf": "SP",
        "lat": null,
        "long": null,
        "created": "2020-12-17T15:23:27.000Z",
        "modified": "2020-12-17T15:23:27.000Z",
        "removed": null
      }
    }
}

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.