API Movimento de Vendas Split
A API de Movimento de Vendas Split tem como objetivo registrar as vendas split que foram realizadas pela máquina de POS da Blu com essa configuração.
Podemos dizer, que ela é o primeiro passo para a realização da conciliação uma vez que registrará todas as vendas reconhecidas pela Blu que geraram saldo atual ou agenda na conta Blu para as partes envolvidas no split. Vale frisar que esta API não registra o pagamento de parcelas, apenas a data em que a operação ocorreu, a previsão de pagamento e o percentual da venda para cada um dos envolvidos no split.
Orientações
Apenas as vendas split aparecerão nessa API, para vendas não splitadas deve ser utilizada a API Movimento de Vendas
Os dados devem ser buscados em D-1.
Os dados são carregados todos os dias às 9h, a consulta deve ser feita após esse horário.
O range de data não deve ser superior a um mês.
A API registra as vendas feitas no crédito, débito e Link de Pagamento.
É possível filtrar os resultados pelo status da venda.
É possível filtras vendas canceladas por range de data.
Para ter acesso aos dados, é necessário um
token.É possível consultar dados de produção ou homologação.
Esses parâmetros são disponibilizados pelo time de Integração da Blu quando solicitados pelo executivo de contas.
API
Fique atento! para visualizar os exemplos de retornos da API, clique no botão > para abrir o campo de leitura
Movimento de Vendas Split
GET https://api.blu.com.br/conciliations/sales_split
Esta API é responsável por retornar as vendas realizadas na maquininha Blu de acordo com as datas solicitadas a partir de D-1.
Objetivo
Possibilitar aos varejistas validar que as vendas realizadas na máquina de POS da Blu foram registrada pelo portal Blu.
Fique atento! para visualizar os exemplos dos responses abaixo, clique no botão > para abrir o campo de leitura.
Headers
token*
string
Bearer token de identificação do fornecedor
beginDate
string
Data inicial do período no formato AAAA-MM-DD. Não deve ser superior a D-1.
endDate
string
Data final do período no formato AAAA-MM-DD. Não deve ser superior a D-1.
nsuCode
string
Código NSU da Transação (Número Sequencial Único).
status
string
Filtro pelos status da cobrança: confirmed, canceled, system_rejected, pending, antifraud_analysis, acquirer_analysis.
begindatecancel
string
Filtrando pelo status: canceled. Data inicial do período de cancelamento no formato AAAA-MM-DD. Não deve ser superior a D-1.
enddatecancel
string
Filtrando pelo status: canceled. Data final do período de cancelamento no formato AAAA-MM-DD. Não deve ser superior a D-1.
O campo status é filtrado pelos campos beginDate e endDate , qualquer um dos status possíveis será filtrado por essa data. Caso nenhum status seja preenchido todos os status possíveis serão retornados.
Os campos begindatecancel e enddatecancel devem somente ser utilizados com o campo status filtrando cobranças canceled. Os campos beginDate e endDate não devem ser utilizados nesse caso.
Os parâmetros begindate e enddate se referem a data de ocorrência da transação e devem estar ambos preenchidos. Caso nenhum deles seja especificado, a resposta retornará todos os pagamentos realizados antes à data da consulta, ou seja, D-1.
O campo nsuCode pode ser utilizado na busca de forma independente a busca por data.
O retorno desta consulta é um arquivo JSON, contendo um conjunto (Array) das transações do período informado. Abaixo vemos todos os campos que serão retornados:
id_transacao
Identificador da transação dentro da Blu.
valor_venda_original_total_bruto
Valor bruto original da venda.
valor_participacao_total_bruto
Valor splitado bruto da venda.
valor_participacao_total_liquido
valor liquido splitado.
percentual_participacao
percentual da venda splitada.
valor_sem_taxas
Valor bruto da parcela.
valor_com_taxas
Valor líquido da parcela.
data_ocorrencia
Data de ocorrência da transação no formato AAAA-MM-DD.
data_liquidacao
Data de prevista para liquidação da transação no formato AAAA-MM-DD.
data_criacao
Data em que a transição foi criada AAAA-MM-DD
cod_autorizacao
Código de autorização da transação.
tipo_venda
Tipo de venda da transação, sendo débito ou crédito.
numero_pos
Número do POS que foi efetuada a transação.
serial_pos
Serial do POS que foi efetuada a transação.
banco
Banco emissor do cartão que efetuou a transação.
bandeira
Bandeira do cartão que efetuou a transação.
numero_cartao
Número do cartão que efetuou a transação.
razao_social_vendedor
Razão social daquele que realizou a venda
cnpj_vendedor
CNPJ do vendedor
razao_social_parceiro
Razão social do parceiro no split
cnpj_parceiro
CNPJ do parceiro
cnpj_cliente_blu
CNPJ do cliente Blu registrado no POS.
cv_nsu
NSU da transação.
status_transacao_pos_ou_cobranca
Status da transação.
data_cancelamento_pos_ou_cobranca
Data do cancelamento da transação no formato AAAA-MM-DD.
parcela
Número da parcela da transação.
parcelas
Número total de parcelas da transação.
valor_taxa_administracao
Valor da taxa de administração da transação.
valor_taxa_parceiro_repassada
Valor da taxa de administração do lojista parceiro repassada para o fornecedor da transação.
data_liquidacao_programada
Data de prevista para liquidação da transação no formato AAAA-MM-DD.
via_de_venda
Via que a transação foi realizada.
data_atualizacao
Data que a transação sofreu atualização no formato AAAA-MM-DD.
Abaixo vemos exemplos de retorno da API para uma transações do tipo crédito e débito:
O campo id_transaction presente neste retorno será utilizado para relacionar as vendas registradas pela API Movimento de Vendas com a API Débito, Crédito e Antecipações.
O cURL para executar a consulta é o exibido abaixo, bem como a collection com todas as APIs para ser importada no Postman está em anexo na página.
Movimento de Vendas Split - Homologação
A API Movimento de Vendas Split pode ser consultada diretamente no ambiente de produção caso já existam vendas split registradas para o CNPJ cadastrado no Portal Blu. Caso ainda não existam vendas é possível realizar a consulta em homologação.
Atenção! Os dados retornados na API Movimento de Vendas Split - Homologação são mockados, anonimizados e sem uso de CNPJs reais. O retorno dessa API só é positivo na data de 01/12/2025, que constará no cURL.
GET https://api-hlg.blu.com.br/conciliations/sales_split
Headers
token*
string
Bearer token de identificação do fornecedor
begindate
string
Data inicial do período no formato AAAA-MM-DD. Não deve ser superior a D-1.
enddate
string
Data final do período no formato AAAA-MM-DD. Não deve ser superior a D-1.
Os parâmetros begindate e enddate se referem a data de ocorrência da transação e devem estar ambos preenchidos. Caso nenhum deles seja especificado, a resposta retornará todos os pagamentos realizados antes à data da consulta, ou seja, D-1.
O retorno desta consulta é um arquivo JSON, contendo um conjunto (Array) das transações do período informado. Abaixo vemos todos os campos que serão retornados:
id_transacao
Identificador da transação dentro da Blu.
valor_venda_original_total_bruto
Valor bruto original da venda.
valor_participacao_total_bruto
Valor splitado bruto da venda.
valor_participacao_total_liquido
valor liquido splitado.
percentual_participacao
percentual da venda splitada.
valor_sem_taxas
Valor bruto da parcela.
valor_com_taxas
Valor líquido da parcela.
data_ocorrencia
Data de ocorrência da transação no formato AAAA-MM-DD.
data_liquidacao
Data de prevista para liquidação da transação no formato AAAA-MM-DD.
data_criacao
Data em que a transição foi criada AAAA-MM-DD
cod_autorizacao
Código de autorização da transação.
tipo_venda
Tipo de venda da transação, sendo débito ou crédito.
numero_pos
Número do POS que foi efetuada a transação.
serial_pos
Serial do POS que foi efetuada a transação.
banco
Banco emissor do cartão que efetuou a transação.
bandeira
Bandeira do cartão que efetuou a transação.
numero_cartao
Número do cartão que efetuou a transação.
razao_social_vendedor
Razão social daquele que realizou a venda
cnpj_vendedor
CNPJ do vendedor
razao_social_parceiro
Razão social do parceiro no split
cnpj_parceiro
CNPJ do parceiro
cnpj_cliente_blu
CNPJ do cliente Blu registrado no POS.
cv_nsu
NSU da transação.
status_transacao_pos_ou_cobranca
Status da transação.
data_cancelamento_pos_ou_cobranca
Data do cancelamento da transação no formato AAAA-MM-DD.
parcela
Número da parcela da transação.
parcelas
Número total de parcelas da transação.
valor_taxa_administracao
Valor da taxa de administração da transação.
valor_taxa_parceiro_repassada
Valor da taxa de administração do lojista parceiro repassada para o fornecedor da transação.
data_liquidacao_programada
Data de prevista para liquidação da transação no formato AAAA-MM-DD.
via_de_venda
Via que a transação foi realizada.
data_atualizacao
Data que a transação sofreu atualização no formato AAAA-MM-DD.
O cURL para executar a consulta já com a data 01/12/2025 é o exibido abaixo, bem como a collection com todas as APIs para ser importada no Postman está em anexo na página com o nome Varejo HLG - Movimento de Vendas Split ou APIs Varejo HLG.
Last updated