Cria um split

Cria um split de vendas para um estabelecimento.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Resposta da requisição

VariávelTipoDescrição
idStringId gerado para identificar esta configuração de split.
ruleStringRegra da divisão de valores.
sellingEstablishmentIdLongId do estabelecimento realizador da venda.
statusStringStatus do split. Ex.: ativo (ACTIVE) ou inativo (INACTIVE).
splitsList.Lista de estabelecimentos envolvidos no split.

Splits

VariávelTipoDescrição
typeStringTipo de estabelecimento no split, se MAIN ou DEFAULT.
establishmentIdLongId do estabelecimento envolvido no split.
planStringIdentificação de plano usado na venda (ORIGIN) ou não (DESTINATION).
taxPayerStringDefine quem paga a taxa deste split. Se o estabelecimento principal (SELLING) ou o estabelecimento do split (PARTICIPANT).
descriptionStringDescrição deste split.
valueDoubleValor percentual do valor recebido no split.

🚧

Para utilizar este endpoint, é necessário seguir o modelo de autenticação descrito na seção Access Token V2 e que o usuário possua uma das seguintes funções:

  • INTEGRADOR_SPLIT_MANAGE

Detalhes do envio da requisição

Regras de valores (rule)

  • GROSS_VALUE: com o valor bruto, a porcentagem de lucro dos splits é captada do valor bruto da venda. Entende-se splits, especificamente aqui neste campo, como os estabelecimentos que não realizaram a venda e que apenas recebem lucro sobre a mesma. Após os splits serem pagos sobre o valor bruto, o estabelecimento realizador da venda recebe o percentual restante subtraído das taxas de venda.
  • LIQUID_VALUE: com o valor líquido, as taxas de venda são debitadas do valor total e então as porcentagens são repassadas para os demais estabelecimentos envolvidos, sejam splits ou estabelecimento realizador da venda.
Body Params
string
required

Regra da divisão dos valores. Ex.: "GROSS_VALUE" ou "LIQUID_VALUE" (funcionamento descrito acima na documentação).

int64
required

Id do estabelecimento que realizará as vendas.

splits
array of objects
required

Splits configurados para o estabelecimento.

splits*
Headers
string
required

ID do integrador. Esse ID será provido pelo responsável por acompanhar a integração.

string
required

A autenticação do tipo Bearer deve ser enviada. O atributo {access_token} é gerado durante a solicitação ao servidor de autenticação da Justa, conforme detalhado na seção Access Token V2 deste documento.

string
required
Defaults to application/json

Tipo do corpo da requisição a ser enviado.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json