Pular para o conteúdo principal

Estrutura de um Pedido no Koncili

Um pedido no marketplace pode parecer simples - o cliente compra, paga e recebe -, mas na prática envolve diversos elementos financeiros, fiscais e operacionais.
O Koncili consolida todas essas informações, mesmo que diferentes marketplaces as apresentem com níveis distintos de detalhe, isso para garantir que ao olhar para o Pedido dentro do Koncili ele siga sempre o mesmo padrão.

Abaixo estão os elementos principais que compõe o pedido.

Itens do Pedido

Cada pedido é composto por um ou mais produtos (SKUs), que carregam atributos próprios:

  • Nome e descrição do produto
  • SKU e código interno
  • Quantidade
  • Valor unitário
  • Descontos aplicados
  • Campanha ou promoção vinculada

📦 Exemplo de Estrutura de Produtos em um Pedido

Um pedido pode conter diversos produtos com condições comerciais diferentes, mesmo que pertençam à mesma transação.
No exemplo abaixo, é possível visualizar situações comuns como frete grátis aplicado ao pedido e descontos promocionais aplicados por item.

ItemSKUProdutoQtdePreço UnitárioCampanhaDescontoPreço Final
1SKU-001Camiseta Branca1R$ 59,90Sem descontoR$ 0,0R$ 59,90
2SKU-002Calça Jeans2R$ 129,90Frete grátisR$ 0,0R$ 259,80
3SKU-100Shampoo 300ml1R$ 30,00Promoção "Leve 2, 2º com 50% off"R$ 0,0R$ 15,00
4SKU-100Shampoo 300ml1R$ 30,00Preço normalR$ 0,0R$ 30,00
5SKU-156Sabonete1R$ 2,00DiscountR$ 0,50R$ 1,50

Observações:

📌 O mesmo SKU pode aparecer mais de uma vez no pedido, com condições diferentes (ex.: um com e outro sem desconto).

📌Alguns SKU podem fazer parte de uma campanha enquanto outros não, exemplo Frete grátis em um SKU, ou 50% de desconto na segunda unidade

Campanhas e Descontos

Campanhas podem atuar no nível do pedido ou do produto individual.
Essas promoções precisam ser consideradas na conciliação, pois alteram diretamente o valor líquido a ser repassado.

📘 Exemplo - desconto por produto:
Pedido #5678 contém:

  • 1x Shampoo (SKU-100) sem desconto
  • 1x Shampoo (SKU-100) com promoção "Compre 1 e leve o 2º com 50%"

📘 Exemplo - desconto por pedido:
Pedido #9876 com 3 produtos diferentes → cliente ganha frete grátis ao atingir valor mínimo.

📌 O Koncili identifica se os descontos afetam o pedido inteiro ou apenas produtos específicos, ajustando a conciliação de valores.

Métodos de Pagamento

Um pedido pode ter um ou vários métodos de pagamento, sendo que inclusive um deles pode ter parcelas.

Ao selecionar a forma de pagamento na hora de finalizar a compra uma delas pode falar, exemplo: cartão recusado e ainda sim o pedido pode ser concluído com outro método de pagamento.

📘 Exemplo:
Pedido #91011

  • Cartão de Crédito (recusado)
  • Segundo Cartão (aprovado em 3x)
  • Pix (pagamento complementar à vista)

📌 O Koncili registra o método final aprovado, mas mantém o histórico de tentativas se disponível pelo marketplace

📌É importante saber que método de pagamento é diferente de repasse um pagamento pode ser parcelado e o repasse integral dependendo da negociação e do marketplace.

Parcelas

As parcelas estão ligadas ao método de pagamento e representam uma das maiores diferenças entre o pagamento do cliente e o repasse ao seller.

📘 Exemplo:

  • Cliente paga em 6x de R$ 50,00
  • Marketplace pode:
    • Repassar 6 parcelas de R$ 50,00, espelhando o pagamento, ou
    • Repassar R$ 280,00 à vista, já com desconto de taxa de antecipação.

📌 O Koncili nas conciliações considera o que foi efetivamente repassado ao seller, e não a forma como o cliente pagou.

Notas Fiscais

As notas fiscais (NFs) são o ponto de controle fiscal do pedido.
Um mesmo pedido pode ter uma ou várias notas, dependendo da forma de envio e do comportamento do seller.

Casos comuns:

  • Múltiplas Notas: partes do pedido enviadas em dias diferentes.
  • Nota Errada (cancelada e substituída): erros de imposto, CFOP ou valor, onde a nota precisa ser cancelada e reemitida.
  • Nota Complementar: adiciona informações fiscais faltantes.
  • Nota de Estorno/Devolução: usada em devoluções ou cancelamentos após emissão da NF.

📌 Para o Koncili, a nota fiscal é o marco que define quando o pedido é considerado faturado e apto à conciliação.

Status do Pedido

Apesar de pequenas variações entre marketplaces, o ciclo de vida de um pedido segue geralmente esta sequência:

EtapaDescrição
NovoPedido criado no marketplace.
PagoPagamento confirmado pelo cliente.
FaturadoNota fiscal emitida.
Em preparaçãoProdutos sendo separados e embalados.
Despachado / Em trânsitoPedido enviado à transportadora.
EntregueProduto recebido pelo cliente.

📌 O Koncili usa o status do pedido para determinar se ele está pronto para conciliação financeira.
Um pedido "Pago" mas não "Faturado" indica que a operação ainda não gerou repasse.

Cancelamentos

Os cancelamentos impactam diretamente notas fiscais, pagamentos e conciliações.
Eles podem ocorrer em dois níveis:

  • Parcial (item): apenas um produto é cancelado.
  • Total (pedido): todo o pedido é cancelado.
  • Tardio: quando a mercadoria já foi embarcada e será necessário fazer nota de devolução.

📘 Exemplo parcial:
Pedido #151617 - 1 Notebook + 1 Mochila → cliente cancela apenas a Mochila.

📘 Exemplo total:
Pedido #202122 - 2 produtos → cliente cancela o pedido inteiro antes do envio, o seller não emite NF e o marketplace estorna o pagamento.

📌 Cancelamentos geram lançamentos do tipo RETURN_SALE ou DEVOLUTION, que o Koncili usa para ajustar o saldo financeiro.

Particularidades de Parcelamento e Repasse

Em vendas parceladas, o cliente paga em parcelas, mas o repasse ao seller pode ser antecipado pelo marketplace (com desconto de taxa financeira).

📘 Exemplo:
Venda: R$ 1.000,00 em 10x → marketplace antecipa e repassa R$ 950,00 à vista (R$ 50,00 de taxa).

📌 O Koncili sempre considera o valor efetivamente repassado, e não o total parcelado.
📌 O ERP deve registrar a diferença como despesa financeira, classificando conforme a necessidade previamente alinhada entre o departamento financeiro e a contabilidade.