Ventas

Estados de venta y transiciones

Fulljaus tiene definida una lista de estados posibles para cada venta. Cada estado tiene un código interno, un nombre, y otros estados a los que puede transicionar desde ahí. La siguiente tabla detalla esto:

Estado	Código interno	Permite transiciones
Pendiente de pago	PEND	APRO, NOAPRO, ANUL
En revisión	REV	APRO, NOAPRO
Pago aprobado	APRO	PROC, FACT, ANUL, ENT, ENV
En proceso	PROC	FACT, ANUL
Facturado	FACT	SUC, ENV
Disponible para retirar en sucursal	SUC	ENT, ANUL
Enviado	ENV	ENT, TRANS
Entregado	ENT	DEVPARC, DEVTOT, ANUL
Devolución parcial	DEVPARC	DEVTOT
Devolución total	DEVTOT	No permite.
Anulado	ANUL	No permite.
Pago no aprobado	NOAPRO	APRO
En tránsito	TRANS	ENT

Importante: anulación y devolución total de ventas. Si el vendedor o el canal transiciona una venta al estado Anulado (ANUL) o devolución total (DEVTOT), la misma no podrá ser transicionada a ningún otro estado.

Las transiciones entre estados de venta pueden ser realizadas tanto por el vendedor desde su cuenta de Fulljaus como el canal a través de la API. Fulljaus no bloquea quién hace la transición, siempre y cuando el estado al que se quiera transicionar sea válido para el estado actual de la venta.

Por ejemplo, si una venta está en estado "Pendiente de pago", solo puede aprobarse (APRO), no aprobarse (NOAPRO) o anularse (ANUL). Esta transición puede hacerla el vendedor o el canal. Por el contrario, si una venta está en estado "En proceso" (PROC), NO puede transicionarse a "Pago aprobado" (APRO), ya que no está dentro de los estados permitidos para transicionar.

Facturas

Cada vendedor de Fulljaus tiene su propio circuito de operación al recibir una venta, por lo que puede adjuntar el comprobante en formato PDF en distintos estados de la venta. El canal no puede solicitar vía API la creación de un comprobante, pero sí puede ser notificado o darse cuenta cuando el vendedor la adjuntó a la venta.

Si el vendedor adjuntó la factura de la venta, la propiedad invoice del JSON de la venta contendrá un objeto con dos datos:

• El número de la factura (number), cargado a mano por el vendedor. Por defecto es cero.
• La URL al PDF del comprobante (url).

Direcciones de facturación y envío

Al crear una venta deben asignarse las direcciones de envío (para la entrega de los productos comprados) y de facturación (para generar los comprobantes). Los datos de cada dirección son opcionales. Cuanto más datos haya, más eficiente será el procesamiento de la venta.

Nombre interno	Descripción
name	Nombre de la persona.
surname	Apellido de la persona.
email	Correo electrónico de la persona.
province	Provincia de la dirección.
city	Ciudad de la dirección.
commune	Comuna/barrio de la dirección.
address	Nombre de la calle.
number	Altura de la calle.
extra_information	Información extra de la dirección.
phone	Número de teléfono de contacto.
zip_code	Código postal de la dirección.
floor	Piso
door	Departamento
document.type	Tipo de documento. Solo acepta "DNI".
document.number	Número de documento.

Pagos

Transacciones en pesos y puntos

Las ventas pueden tener varias transacciones/pagos como sean necesarias. Cuanta más información se provea, más sencilla será la operatoria para el vendedor al procesarla.

Fulljaus permite diferenciar las transacciones realizadas con dinero (tarjetas de crédito, débito, etc.) y las transacciones con puntos. Esto se indica en el campo type dentro de un payment.

• Si type es CARD, indica una transacción con dinero.
• Si type es POINTS indica una transacción con puntos.

Es posible combinar dos tipos de transacciones. Una venta puede tener una transacción del tipo CARD donde el cliente abonó con dinero, y otra transacción del tipo POINTS donde se abonó con puntos.

Al informar una transacción de puntos, el payment_amount debe reflejar en pesos el valor de los puntos canjeados por el cliente.

Financiación e intereses

Si la transacción es de tipo CARD y tiene financiación, puede informarse la cantidad de cuotas dentro del campo installments.

Identificador de transacción

Para mejorar el proceso de conciliación del vendedor, recomendamos brindar información sobre la transacción en el campo transaction_id, que permite texto libre.