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.
Para ter acesso aos dados, é necessário um
token.
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
| Name | Type | Description |
|---|---|---|
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). |
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:
| Campos da transação | Descrição |
|---|---|
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.
Last updated