CasesPlataformas de e-commerce

Pedidos da loja virtual conciliados com o que foi recebido

Nuvemshop e Tray são plataformas de e-commerce. A integração com a Openi concilia os pedidos feitos nas lojas: cada pedido entra no Nexus por webhook e é casado com o pagamento que o lojista de fato recebeu.

Solicitar acesso Documentação

Do dado de origem ao resultado

1Pedido na loja
2Webhook
3Rule set
4Pedido conciliado

O desafio. Plataformas de e-commerce.

Em uma loja virtual, o pedido nasce na plataforma, o pagamento passa por um meio de pagamento (cartão, Pix ou boleto) e o dinheiro chega ao lojista dias depois, já sem as taxas e, no cartão, dividido em parcelas. O lojista vende em um lugar e recebe em outro. Conciliar é responder, pedido a pedido: foi pago? Quanto chegou? O que ainda falta receber? Com centenas de pedidos por dia, essa conta não fecha em planilha.

Pedidos da loja e recebimentos

Exemplo

Pedidos (webhook)Recebimentos

Pedido #48213 · Pix
R$ 89,00
Conciliado
Pix recebido
R$ 89,00
Pedido #48214 · Cartão 3x
R$ 349,90
Conciliado
3 parcelas liquidadas
R$ 349,90
Pedido #48215 · Cartão
R$ 199,90
Divergente
Liquidação
R$ 189,90
Pedido #48216 · Boleto
R$ 1.250,00
Sem recebimento
sem par

Dados fictícios, para ilustrar o fluxo.

Como funciona. Em 3 passos.

01
Cada pedido entra por webhook
Quando um pedido é criado, pago ou cancelado na loja, a plataforma envia o evento para um webhook de entrada do Nexus.
02
Os recebimentos são a outra origem
O que foi liquidado para o lojista entra como segunda origem de dados: por arquivo, banco de dados ou transações de Open Finance.
03
O rule set casa pedido e recebimento
A regra compara identificador, valor e data, e concilia também um pedido pago em várias parcelas. O que diverge fica separado para quem opera.

Como roda pela API. Em chamadas documentadas.

POST /hooks/{slug}
Os eventos chegam ao Nexus por webhook de entrada.
POST /v1/rule-sets/{ruleSetId}/run
O rule set roda e casa os dois datasets.
GET /v1/matches
Cada par volta com decisão e pontuação.

O que fica visível. Separado para quem opera.

Pedido pago sem recebimento correspondente
Valor recebido diferente do valor do pedido
Recebimento sem pedido de origem

Outros cases

Monte a sua conciliação. Com as mesmas chamadas.

Os cases usam apenas endpoints documentados. Solicite acesso e rode o fluxo com os dados da sua operação.