YOM Docs

Untitled

Untitled

Untitled

Transacciones

Para tener el historial de compra que han concretado los Comercios a lo largo de su relación con el cliente, se manejan sus Transacciones.

¿Qué es una transacción? Una Transacción en YOM representa una compra concretada del Comercio. Contiene información sobre el Comercio, los Productos que compró, los Precios, Descuentos, Impuestos, y más.

Carpeta y nombre de archivos

Entidad → transaction

/integrations
	/<customer_id>
		/commerce
    /product
    /seller
    /transaction
	      /20251228
		        20251228_180000_transaction.csv
		...

Campos

Campo Tipo Carácter Descripción Ejemplos Validación
orderId 📝 Texto 🟢 Requerido Identificador único del pedido (independiente del tipo de documento). "TR12345" not null
internalOrderId 📝 Texto ⚪ Opcional Identificador del pedido hecho en YOM. (El que enviamos en la inyección hacia el ERP) "YOM12345" nullable
productId 📝 Texto 🟢 Requerido Identificador externo del producto "PROD5678" not null
commerceId 📝 Texto 🟢 Requerido Identificador externo del comercio "COM987" not null
sellerId 📝 Texto 🟢 Requerido Identificador externo del vendedor "SEL987" not null
date 📅 Fecha 🟢 Requerido Fecha del pedido o factura. La fecha debe estar en formato ISO 8601. "2018-10-22T00:00:00.000Z" not null, YYYY-mm-dd
documentType 📝 Texto 🟢 Requerido Tipo de documento.
"order" → pedido
"invoice" → factura
"bill" → boleta
"credit note" → nota de crédito
”debit note” → nota de débito

T**odos los valores deben ser valor absoluto (positivo)** | "order" "invoice" "credit note" "debit note" | not null | | documentCode | 📝 Texto | 🟢 Requerido | Código del documento, en caso de ser un pedido se repite orderId en este campo. | "12345" | not null | | quantity | #️⃣ Número | 🟢 Requerido | Cantidad de unidades pedidas del producto. | 10 | > 0 | | netPricePerUnit | #️⃣ Número flotante | 🟢 Requerido | Precio unitario sin descuento y sin impuesto del Producto. | 900 | ≥ 0 | | discountedNetPricePerUnit | #️⃣ Número flotante | 🟢 Requerido | Precio sin impuesto y con descuento del producto | 850 | ≥ 0 | | taxPerUnit | #️⃣ Número flotante | 🟢 Requerido | Monto del impuesto aplicado a cada unidad del Producto. | 190 | not null | | discountedTaxPerUnit | #️⃣ Número flotante | 🟢 Requerido | Monto del impuesto con descuento aplicado a cada unidad del Producto. | 170 | ≥ 0 | | discountPerUnit | #️⃣ Número flotante | 🟢 Requerido | Descuento unitario sin impuesto aplicado al Producto. | 50 | ≥ 0 | | grossPricePerUnit | #️⃣ Número flotante | 🟢 Requerido | Precio con impuesto y sin descuento del producto | 1100 | ≥ 0 | | discountedGrossPricePerUnit | #️⃣ Número flotante | 🟢 Requerido | Precio con impuesto y con descuento del producto | 950 | ≥ 0 | | currency | 📝 Texto | 🟢 Requerido | Moneda en la que se realiza la venta. "clp" | "clp" | not null | | origin | 📝 Texto | 🟢 Requerido | Origen de la Transacción. Esta es una definición propia del cliente | "carga inicial", ”ventas_yom” | not null | | sourceChannel | 📝 Texto | ⚪ Opcional | Canal de venta contacto | "app movil”, ”ecommerce | nullable | | deliveryDate | 📅 Fecha | ⚪ Opcional | Fecha en que se entregó el pedido. La fecha debe estar en formato ISO 8601. | "2018-10-22T00:00:00.000Z" | nullable | | referenceCode | 📝 Texto | ⚪ Opcional | Código del documento de referencia en caso de que documentType sea "credit note" o ”debit note”. Normalmente el código hace referencia a una “invoice”. | "REF123" | nullable | | couponCode | 📝 Texto | ⚪ Opcional | Código de cupón | "CUPON123" | nullable | | isDeleted | 🔘 Bool | ⚪ Opcional | ¿Fue eliminada la Transacción? | true | nullable |

CSV Aplanado

orderId;internalOrderId;productId;commerceId;sellerId;date;documentType;documentCode;quantity;netPricePerUnit;discountedNetPricePerUnit;taxPerUnit;discountedTaxPerUnit;discountPerUnit;grossPricePerUnit;discountedGrossPricePerUnit;currency;origin;sourceChannel;deliveryDate;referenceCode;couponCode;isDeleted
"TR12345";"YOM12345";"PROD5678";"COM987";"SEL987";"2018-10-22T00:00:00.000Z";"order";"12345";10;900;850;190;170;50;1100;950;"clp";"carga inicial";"app movil";"2018-10-22T00:00:00.000Z";"REF123";"CUPON123";true

Lista de campos CSV

Columna Valor
orderId 12345
internalOrderId TIPER123
productId PROD5678
commerceId COM1234
sellerId SEL001
date 2018-10-22T00:00:00.000Z
documentType order
documentCode 12345
quantity 10
netPricePerUnit 900
discountedNetPricePerUnit 850
taxPerUnit 190
discountedTaxPerUnit 170
discountPerUnit 50
grossPricePerUnit 1100
discountedGrossPricePerUnit 950
currency clp
origin carga inicial
sourceChannel app movil
deliveryDate 2018-10-22T00:00:00.000Z
referenceCode REF123
couponCode CUP123
isDeleted true

Con esta estructura puedes gestionar y consultar la información de los pedidos en YOM de manera eficiente.

Pasos anteriores

<aside> <img src="/icons/arrow-left_gray.svg" alt="/icons/arrow-left_gray.svg" width="40px" />

Productos

</aside>

Siguientes pasos

<aside> <img src="/icons/arrow-right_gray.svg" alt="/icons/arrow-right_gray.svg" width="40px" />

Vendedores

</aside>

Tabla de contenidos