Saltar al contenido principal

Estructura de un pedido en Koncili

Un pedido en el marketplace puede parecer simple - el cliente compra, paga y recibe -, pero en la práctica involucra diversos elementos financieros, fiscales y operativos.
Koncili consolida toda esta información, aunque diferentes marketplaces la presenten con niveles distintos de detalle, para garantizar que, al mirar el Pedido dentro de Koncili, siempre siga el mismo estándar.

A continuación se muestran los elementos principales que componen el pedido.

Ítems del pedido​

Cada pedido se compone de uno o más productos (SKUs), que tienen atributos propios:

  • Nombre y descripción del producto
  • SKU y código interno
  • Cantidad
  • Precio unitario
  • Descuentos aplicados
  • Campaña o promoción vinculada

📦 Ejemplo de estructura de productos en un pedido

Un pedido puede contener diversos productos con condiciones comerciales diferentes, aunque pertenezcan a la misma transacción.
En el ejemplo siguiente, es posible ver situaciones comunes como envío gratis aplicado al pedido y descuentos promocionales aplicados por ítem.

ÍtemSKUProductoCant.Precio unitarioCampañaDescuentoPrecio final
1SKU-001Camiseta blanca1R$ 59,90Sin descuentoR$ 0,0R$ 59,90
2SKU-002Pantalón jean2R$ 129,90Envío gratisR$ 0,0R$ 259,80
3SKU-100Champú 300ml1R$ 30,00Promoción "Lleva 2, el 2º con 50% off"R$ 0,0R$ 15,00
4SKU-100Champú 300ml1R$ 30,00Precio normalR$ 0,0R$ 30,00
5SKU-156Jabón1R$ 2,00DiscountR$ 0,50R$ 1,50

Observaciones:

📌 El mismo SKU puede aparecer más de una vez en el pedido, con condiciones diferentes (p. ej.: uno con descuento y otro sin descuento).

📌Algunos SKU pueden formar parte de una campaña mientras que otros no, por ejemplo envío gratis en un SKU, o 50% de descuento en la segunda unidad

Campañas y descuentos​

Las campañas pueden actuar a nivel del pedido o del producto individual.
Estas promociones deben considerarse en la conciliación, pues alteran directamente el monto neto que se liquidará.

📘 Ejemplo - descuento por producto:
El pedido #5678 contiene:

  • 1x Champú (SKU-100) sin descuento
  • 1x Champú (SKU-100) con la promoción "Compra 1 y lleva el 2º con 50%"

📘 Ejemplo - descuento por pedido:
Pedido #9876 con 3 productos diferentes → el cliente obtiene envío gratis al alcanzar un monto mínimo.

📌 Koncili identifica si los descuentos afectan al pedido entero o solo a productos específicos, ajustando la conciliación de montos.

Métodos de pago​

Un pedido puede tener uno o varios métodos de pago, e incluso uno de ellos puede tener cuotas.

Al seleccionar la forma de pago al finalizar la compra, una de ellas puede fallar, por ejemplo: tarjeta rechazada, y aun así el pedido puede concluirse con otro método de pago.

📘 Ejemplo:
Pedido #91011

  • Tarjeta de crédito (rechazada)
  • Segunda tarjeta (aprobada en 3 cuotas)
  • Pix (pago complementario al contado)

📌 Koncili registra el método final aprobado, pero mantiene el historial de intentos si el marketplace lo pone a disposición

📌Es importante saber que el método de pago es diferente de la liquidación: un pago puede ser en cuotas y la liquidación integral, según la negociación y el marketplace.

Cuotas​

Las cuotas están ligadas al método de pago y representan una de las mayores diferencias entre el pago del cliente y la liquidación al seller.

📘 Ejemplo:

  • El cliente paga en 6 cuotas de R$ 50,00
  • El marketplace puede:
    • Liquidar 6 cuotas de R$ 50,00, reflejando el pago, o
    • Liquidar R$ 280,00 al contado, ya con el descuento de la tarifa de anticipación.

📌 En las conciliaciones, Koncili considera lo que fue efectivamente liquidado al seller, y no la forma en que pagó el cliente.

Notas fiscales​

Las notas fiscales (NF) son el punto de control fiscal del pedido.
Un mismo pedido puede tener una o varias notas, según la forma de envío y el comportamiento del seller.

Casos comunes:

  • Múltiples notas: partes del pedido enviadas en días diferentes.
  • Nota incorrecta (cancelada y sustituida): errores de impuesto, CFOP o monto, en los que la nota debe cancelarse y emitirse de nuevo.
  • Nota complementaria: agrega información fiscal faltante.
  • Nota de reversión/devolución: usada en devoluciones o cancelaciones después de la emisión de la NF.

📌 Para Koncili, la nota fiscal es el hito que define cuándo el pedido se considera facturado y apto para la conciliación.

Estado del pedido​

A pesar de pequeñas variaciones entre marketplaces, el ciclo de vida de un pedido sigue generalmente esta secuencia:

EtapaDescripción
NuevoPedido creado en el marketplace.
PagadoPago confirmado por el cliente.
FacturadoNota fiscal emitida.
En preparaciónProductos en separación y embalaje.
Despachado / En tránsitoPedido enviado a la transportadora.
EntregadoProducto recibido por el cliente.

📌 Koncili usa el estado del pedido para determinar si está listo para la conciliación financiera.
Un pedido "Pagado" pero no "Facturado" indica que la operación todavía no generó liquidación.

Cancelaciones​

Las cancelaciones impactan directamente en notas fiscales, pagos y conciliaciones.
Pueden ocurrir en dos niveles:

  • Parcial (ítem): solo se cancela un producto.
  • Total (pedido): se cancela todo el pedido.
  • Tardía: cuando la mercadería ya fue despachada y será necesario emitir una nota de devolución.

📘 Ejemplo parcial:
Pedido #151617 - 1 Notebook + 1 Mochila → el cliente cancela solo la Mochila.

📘 Ejemplo total:
Pedido #202122 - 2 productos → el cliente cancela el pedido entero antes del envío, el seller no emite la NF y el marketplace revierte el pago.

📌 Las cancelaciones generan movimientos de tipo RETURN_SALE o DEVOLUTION, que Koncili usa para ajustar el saldo financiero.

Particularidades de las cuotas y de la liquidación​

En las ventas en cuotas, el cliente paga en cuotas, pero la liquidación al seller puede ser anticipada por el marketplace (con el descuento de una tarifa financiera).

📘 Ejemplo:
Venta: R$ 1.000,00 en 10 cuotas → el marketplace anticipa y liquida R$ 950,00 al contado (R$ 50,00 de tarifa).

📌 Koncili siempre considera el monto efectivamente liquidado, y no el total en cuotas.
📌 El ERP debe registrar la diferencia como gasto financiero, clasificándola según lo acordado previamente entre el departamento financiero y la contabilidad.