Cadastrar loja - Parcele+

Cadastrar loja.

curl --request POST \
  --url https://api.parcelemais.com.br/integration/v1/establishment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "documento": "12345678000199",
  "razaoSocial": "Loja Centro LTDA",
  "nomeFantasia": "Loja Centro",
  "modeloDesembolso": 1,
  "responsavel": {
    "nome": "Maria Souza",
    "email": "maria.souza@lojacentro.com.br",
    "celular": "+5511999998888"
  },
  "contaBancaria": {
    "banco": "341",
    "agencia": "1234",
    "digitoAgencia": "",
    "conta": "56789",
    "digitoConta": "0",
    "tipoConta": 1
  },
  "endereco": {
    "rua": "Av. Paulista",
    "numero": "1578",
    "complemento": "Loja 3",
    "bairro": "Bela Vista",
    "cidade": "São Paulo",
    "estado": "SP",
    "cep": "01310100"
  }
}
'

import requests

url = "https://api.parcelemais.com.br/integration/v1/establishment"

payload = {
    "documento": "12345678000199",
    "razaoSocial": "Loja Centro LTDA",
    "nomeFantasia": "Loja Centro",
    "modeloDesembolso": 1,
    "responsavel": {
        "nome": "Maria Souza",
        "email": "maria.souza@lojacentro.com.br",
        "celular": "+5511999998888"
    },
    "contaBancaria": {
        "banco": "341",
        "agencia": "1234",
        "digitoAgencia": "",
        "conta": "56789",
        "digitoConta": "0",
        "tipoConta": 1
    },
    "endereco": {
        "rua": "Av. Paulista",
        "numero": "1578",
        "complemento": "Loja 3",
        "bairro": "Bela Vista",
        "cidade": "São Paulo",
        "estado": "SP",
        "cep": "01310100"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    documento: '12345678000199',
    razaoSocial: 'Loja Centro LTDA',
    nomeFantasia: 'Loja Centro',
    modeloDesembolso: 1,
    responsavel: {
      nome: 'Maria Souza',
      email: 'maria.souza@lojacentro.com.br',
      celular: '+5511999998888'
    },
    contaBancaria: {
      banco: '341',
      agencia: '1234',
      digitoAgencia: '',
      conta: '56789',
      digitoConta: '0',
      tipoConta: 1
    },
    endereco: {
      rua: 'Av. Paulista',
      numero: '1578',
      complemento: 'Loja 3',
      bairro: 'Bela Vista',
      cidade: 'São Paulo',
      estado: 'SP',
      cep: '01310100'
    }
  })
};

fetch('https://api.parcelemais.com.br/integration/v1/establishment', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.parcelemais.com.br/integration/v1/establishment",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'documento' => '12345678000199',
    'razaoSocial' => 'Loja Centro LTDA',
    'nomeFantasia' => 'Loja Centro',
    'modeloDesembolso' => 1,
    'responsavel' => [
        'nome' => 'Maria Souza',
        'email' => 'maria.souza@lojacentro.com.br',
        'celular' => '+5511999998888'
    ],
    'contaBancaria' => [
        'banco' => '341',
        'agencia' => '1234',
        'digitoAgencia' => '',
        'conta' => '56789',
        'digitoConta' => '0',
        'tipoConta' => 1
    ],
    'endereco' => [
        'rua' => 'Av. Paulista',
        'numero' => '1578',
        'complemento' => 'Loja 3',
        'bairro' => 'Bela Vista',
        'cidade' => 'São Paulo',
        'estado' => 'SP',
        'cep' => '01310100'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.parcelemais.com.br/integration/v1/establishment"

	payload := strings.NewReader("{\n  \"documento\": \"12345678000199\",\n  \"razaoSocial\": \"Loja Centro LTDA\",\n  \"nomeFantasia\": \"Loja Centro\",\n  \"modeloDesembolso\": 1,\n  \"responsavel\": {\n    \"nome\": \"Maria Souza\",\n    \"email\": \"maria.souza@lojacentro.com.br\",\n    \"celular\": \"+5511999998888\"\n  },\n  \"contaBancaria\": {\n    \"banco\": \"341\",\n    \"agencia\": \"1234\",\n    \"digitoAgencia\": \"\",\n    \"conta\": \"56789\",\n    \"digitoConta\": \"0\",\n    \"tipoConta\": 1\n  },\n  \"endereco\": {\n    \"rua\": \"Av. Paulista\",\n    \"numero\": \"1578\",\n    \"complemento\": \"Loja 3\",\n    \"bairro\": \"Bela Vista\",\n    \"cidade\": \"São Paulo\",\n    \"estado\": \"SP\",\n    \"cep\": \"01310100\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.parcelemais.com.br/integration/v1/establishment")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"documento\": \"12345678000199\",\n  \"razaoSocial\": \"Loja Centro LTDA\",\n  \"nomeFantasia\": \"Loja Centro\",\n  \"modeloDesembolso\": 1,\n  \"responsavel\": {\n    \"nome\": \"Maria Souza\",\n    \"email\": \"maria.souza@lojacentro.com.br\",\n    \"celular\": \"+5511999998888\"\n  },\n  \"contaBancaria\": {\n    \"banco\": \"341\",\n    \"agencia\": \"1234\",\n    \"digitoAgencia\": \"\",\n    \"conta\": \"56789\",\n    \"digitoConta\": \"0\",\n    \"tipoConta\": 1\n  },\n  \"endereco\": {\n    \"rua\": \"Av. Paulista\",\n    \"numero\": \"1578\",\n    \"complemento\": \"Loja 3\",\n    \"bairro\": \"Bela Vista\",\n    \"cidade\": \"São Paulo\",\n    \"estado\": \"SP\",\n    \"cep\": \"01310100\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.parcelemais.com.br/integration/v1/establishment")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"documento\": \"12345678000199\",\n  \"razaoSocial\": \"Loja Centro LTDA\",\n  \"nomeFantasia\": \"Loja Centro\",\n  \"modeloDesembolso\": 1,\n  \"responsavel\": {\n    \"nome\": \"Maria Souza\",\n    \"email\": \"maria.souza@lojacentro.com.br\",\n    \"celular\": \"+5511999998888\"\n  },\n  \"contaBancaria\": {\n    \"banco\": \"341\",\n    \"agencia\": \"1234\",\n    \"digitoAgencia\": \"\",\n    \"conta\": \"56789\",\n    \"digitoConta\": \"0\",\n    \"tipoConta\": 1\n  },\n  \"endereco\": {\n    \"rua\": \"Av. Paulista\",\n    \"numero\": \"1578\",\n    \"complemento\": \"Loja 3\",\n    \"bairro\": \"Bela Vista\",\n    \"cidade\": \"São Paulo\",\n    \"estado\": \"SP\",\n    \"cep\": \"01310100\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "estabelecimentoId": "9c0969d7-561e-4fae-88e7-790968fd1ddf"
}

{
  "tipo": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "titulo": "Requisição inválida.",
  "status": 400,
  "detalhe": "O campo 'cpf' é obrigatório.",
  "instancia": "/v1/order",
  "erros": {
    "cpf": [
      "O campo 'cpf' é obrigatório."
    ]
  },
  "correlationId": "0HN7E4B8Q9K3D:00000001"
}

POST

establishment

Cadastrar loja.

curl --request POST \
  --url https://api.parcelemais.com.br/integration/v1/establishment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "documento": "12345678000199",
  "razaoSocial": "Loja Centro LTDA",
  "nomeFantasia": "Loja Centro",
  "modeloDesembolso": 1,
  "responsavel": {
    "nome": "Maria Souza",
    "email": "maria.souza@lojacentro.com.br",
    "celular": "+5511999998888"
  },
  "contaBancaria": {
    "banco": "341",
    "agencia": "1234",
    "digitoAgencia": "",
    "conta": "56789",
    "digitoConta": "0",
    "tipoConta": 1
  },
  "endereco": {
    "rua": "Av. Paulista",
    "numero": "1578",
    "complemento": "Loja 3",
    "bairro": "Bela Vista",
    "cidade": "São Paulo",
    "estado": "SP",
    "cep": "01310100"
  }
}
'

import requests

url = "https://api.parcelemais.com.br/integration/v1/establishment"

payload = {
    "documento": "12345678000199",
    "razaoSocial": "Loja Centro LTDA",
    "nomeFantasia": "Loja Centro",
    "modeloDesembolso": 1,
    "responsavel": {
        "nome": "Maria Souza",
        "email": "maria.souza@lojacentro.com.br",
        "celular": "+5511999998888"
    },
    "contaBancaria": {
        "banco": "341",
        "agencia": "1234",
        "digitoAgencia": "",
        "conta": "56789",
        "digitoConta": "0",
        "tipoConta": 1
    },
    "endereco": {
        "rua": "Av. Paulista",
        "numero": "1578",
        "complemento": "Loja 3",
        "bairro": "Bela Vista",
        "cidade": "São Paulo",
        "estado": "SP",
        "cep": "01310100"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    documento: '12345678000199',
    razaoSocial: 'Loja Centro LTDA',
    nomeFantasia: 'Loja Centro',
    modeloDesembolso: 1,
    responsavel: {
      nome: 'Maria Souza',
      email: 'maria.souza@lojacentro.com.br',
      celular: '+5511999998888'
    },
    contaBancaria: {
      banco: '341',
      agencia: '1234',
      digitoAgencia: '',
      conta: '56789',
      digitoConta: '0',
      tipoConta: 1
    },
    endereco: {
      rua: 'Av. Paulista',
      numero: '1578',
      complemento: 'Loja 3',
      bairro: 'Bela Vista',
      cidade: 'São Paulo',
      estado: 'SP',
      cep: '01310100'
    }
  })
};

fetch('https://api.parcelemais.com.br/integration/v1/establishment', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.parcelemais.com.br/integration/v1/establishment",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'documento' => '12345678000199',
    'razaoSocial' => 'Loja Centro LTDA',
    'nomeFantasia' => 'Loja Centro',
    'modeloDesembolso' => 1,
    'responsavel' => [
        'nome' => 'Maria Souza',
        'email' => 'maria.souza@lojacentro.com.br',
        'celular' => '+5511999998888'
    ],
    'contaBancaria' => [
        'banco' => '341',
        'agencia' => '1234',
        'digitoAgencia' => '',
        'conta' => '56789',
        'digitoConta' => '0',
        'tipoConta' => 1
    ],
    'endereco' => [
        'rua' => 'Av. Paulista',
        'numero' => '1578',
        'complemento' => 'Loja 3',
        'bairro' => 'Bela Vista',
        'cidade' => 'São Paulo',
        'estado' => 'SP',
        'cep' => '01310100'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.parcelemais.com.br/integration/v1/establishment"

	payload := strings.NewReader("{\n  \"documento\": \"12345678000199\",\n  \"razaoSocial\": \"Loja Centro LTDA\",\n  \"nomeFantasia\": \"Loja Centro\",\n  \"modeloDesembolso\": 1,\n  \"responsavel\": {\n    \"nome\": \"Maria Souza\",\n    \"email\": \"maria.souza@lojacentro.com.br\",\n    \"celular\": \"+5511999998888\"\n  },\n  \"contaBancaria\": {\n    \"banco\": \"341\",\n    \"agencia\": \"1234\",\n    \"digitoAgencia\": \"\",\n    \"conta\": \"56789\",\n    \"digitoConta\": \"0\",\n    \"tipoConta\": 1\n  },\n  \"endereco\": {\n    \"rua\": \"Av. Paulista\",\n    \"numero\": \"1578\",\n    \"complemento\": \"Loja 3\",\n    \"bairro\": \"Bela Vista\",\n    \"cidade\": \"São Paulo\",\n    \"estado\": \"SP\",\n    \"cep\": \"01310100\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.parcelemais.com.br/integration/v1/establishment")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"documento\": \"12345678000199\",\n  \"razaoSocial\": \"Loja Centro LTDA\",\n  \"nomeFantasia\": \"Loja Centro\",\n  \"modeloDesembolso\": 1,\n  \"responsavel\": {\n    \"nome\": \"Maria Souza\",\n    \"email\": \"maria.souza@lojacentro.com.br\",\n    \"celular\": \"+5511999998888\"\n  },\n  \"contaBancaria\": {\n    \"banco\": \"341\",\n    \"agencia\": \"1234\",\n    \"digitoAgencia\": \"\",\n    \"conta\": \"56789\",\n    \"digitoConta\": \"0\",\n    \"tipoConta\": 1\n  },\n  \"endereco\": {\n    \"rua\": \"Av. Paulista\",\n    \"numero\": \"1578\",\n    \"complemento\": \"Loja 3\",\n    \"bairro\": \"Bela Vista\",\n    \"cidade\": \"São Paulo\",\n    \"estado\": \"SP\",\n    \"cep\": \"01310100\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.parcelemais.com.br/integration/v1/establishment")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"documento\": \"12345678000199\",\n  \"razaoSocial\": \"Loja Centro LTDA\",\n  \"nomeFantasia\": \"Loja Centro\",\n  \"modeloDesembolso\": 1,\n  \"responsavel\": {\n    \"nome\": \"Maria Souza\",\n    \"email\": \"maria.souza@lojacentro.com.br\",\n    \"celular\": \"+5511999998888\"\n  },\n  \"contaBancaria\": {\n    \"banco\": \"341\",\n    \"agencia\": \"1234\",\n    \"digitoAgencia\": \"\",\n    \"conta\": \"56789\",\n    \"digitoConta\": \"0\",\n    \"tipoConta\": 1\n  },\n  \"endereco\": {\n    \"rua\": \"Av. Paulista\",\n    \"numero\": \"1578\",\n    \"complemento\": \"Loja 3\",\n    \"bairro\": \"Bela Vista\",\n    \"cidade\": \"São Paulo\",\n    \"estado\": \"SP\",\n    \"cep\": \"01310100\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "estabelecimentoId": "9c0969d7-561e-4fae-88e7-790968fd1ddf"
}

{
  "tipo": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "titulo": "Requisição inválida.",
  "status": 400,
  "detalhe": "O campo 'cpf' é obrigatório.",
  "instancia": "/v1/order",
  "erros": {
    "cpf": [
      "O campo 'cpf' é obrigatório."
    ]
  },
  "correlationId": "0HN7E4B8Q9K3D:00000001"
}

Cadastra uma loja na rede do parceiro identificado automaticamente pelo token de acesso.

Modelos de desembolso

O modelo de desembolso define quem recebe o valor das vendas da loja.

Valor	Modelo	Quem recebe
`1`	Rede	A conta bancária da rede recebe o desembolso de todas as lojas.
`2`	Loja	A conta bancária da própria loja recebe.
`3`	Externo	Uma conta de terceiro recebe. Exige `nomeTitular` e `documentoTitular` na conta bancária.

A conta bancária é obrigatória no cadastro mesmo quando o desembolso é da rede (1) — ela fica registrada na loja para uso futuro.

Endereço

O endereço é opcional aqui. Se você ainda não tem o endereço no momento do cadastro, envie depois em Editar loja.

Resposta

A resposta traz estabelecimentoId. Guarde esse valor — é ele que identifica a loja nos demais endpoints.

O CNPJ e a razão social precisam ser únicos entre todas as lojas. Reenviar um CNPJ ou uma razão social já cadastrados retorna 409.

Authorizations

Authorization

string

header

required

Cabeçalho de autenticação Bearer no formato Bearer <token> onde <token> é seu TOKEN de autenticação

Body

application/json

documento

string

required

CNPJ da loja, somente números.

Example:

"12345678000199"

Razão social da loja. Não pode ser alterada depois do cadastro.

nomeFantasia

string

required

Nome fantasia da loja.

modeloDesembolso

enum<integer>

required

1: a rede recebe o desembolso; 2: a própria loja recebe (exige conta bancária da loja); 3: conta de terceiro (exige nomeTitular e documentoTitular).

Available options:

1,

2,

3

responsavel

object

required

Responsável pela loja.

Show child attributes

contaBancaria

object

required

Conta bancária da loja.

Show child attributes

endereco

object

Endereço da loja.

Show child attributes

Response

Loja cadastrada com sucesso.

estabelecimentoId

string<uuid>

Identificador da loja cadastrada. Guarde-o para consultar, editar, alterar o endereço ou a situação da loja.

​Modelos de desembolso

​Endereço

​Resposta

Authorizations

Body

Response

Modelos de desembolso

Endereço

Resposta