Professional Documents
Culture Documents
GUIDE O
MNICANAL TRANSACTIONAL PROCESSING
Definition
This process allows ICOMMKT to process daily purchase orders generated in POS, offline and online
stores, obtaining more than 75 indicators that can be used in dynamic segmentation and automation
processes.
Formats
4 plain text files must be generated:
Orders: Summary of invoiced purchase orders. Information related to the Purchase Order header.
OrderDetails: Detail of the purchase order lines.
OrderDetailCategories: Relationship between categories and products of the lines in the purchase
orders.
CustomersCustomer:information. The email field is required in this format.
The structure of each of the files is described below:
GUIDE O
MNICANAL TRANSACTIONAL PROCESSING
Name Descriptio Type Req Format Comment
n
OrderNumber Order CHAR (50) (*)
Number
StoreCode Store Code CHAR (30) (*)
UserId User ID CHAR (50) (*) Customer
PaymentMethodEnti Payment
ty Method CHAR (80) (See Private
Entity Note 1)
(Ex: Bank
XXXX)
PaymentTerms Payment
Terms CHAR (50) (See Private
(Ex: 1 Note 1)
Payment, 3
Payments)
GUIDE O
MNICANAL TRANSACTIONAL PROCESSING
OrderDetails
Name Description Type Req Format Comment
StoreCode Store Code CHAR (30) (*)
OrderNumbe Order Number CHAR (50) (*)
r
LineNumber Line Number INT (11) (*)
Quantity Quantity DECIMAL (*)
(5.2)
ItemCode Product Code CHAR (80) (*)
ItemName Product Name CHAR (200)
Brand Product Brand CHAR (200)
OrderDetailCategories
Name Descripti Type Req Format Comment
on
StoreCode Store Code CHAR (30) (*)
OrderNumber Order CHAR (50) (*)
Number
LineNumber Line INT (11) (*)
Number
Category Category CHAR(255) (*)
ofproduct
Note: When a product is assigned more than one category, one record must be sent for each category with the same StoreCode /
OrderNumber / LineNumber.
Customers
Name Descriptio Type Req Format Comment
n
UserId User ID CHAR (50) (*) Client
StoreCod Code CHAR (30) Report only when a customer has
eStore different IDs for each Store
Email Customer CHAR
(300)
Email
Customer Collection JSONKey / Key / Ex: { "Key": "FIRST_NAME", "Value":
Value
Data Value in "Juan"}, { "Key": "LAST_NAME", "Value":
Json "Sanchez"}
format
Special Notes
1) When there is more than one data to be reported for the field, they must be sent one after another using
a separate separator to the general file. For example: PROCOMOCODE1 ## PROMOCODE2
General Note:
1) As a delimiter it is recommended to use "|".
2) All fields of type DECIMAL must incorporate the period (“.”) As
a decimal separator. Do not use thousands separator.
3) In the fields that do not contain information replace by empty
or zero as appropriate.
4) Respect in the archives the order of the fields according to the
design sent.
5) Send 0 (zero) in all those integer or decimal fields in which it is
not applicable to send information.
GUIDE O
MNICANAL TRANSACTIONAL PROCESSING
NomenclatureFiles:
OrdersICOMMKT_ORDERS_ [ID SINGLE INSTANCE] _YYYYMMDD
OrderDetail:ICOMMKT_ORDERSDETAIL_ [ID SINGLE INSTANCE] _YYYYMMDD
OrderDetailCategories:ICOMMKT_ORDERSDETAILCATEGORIES_ [ID SINGLE INSTANCE] _YYYYMMDD
Customers:ICOMMKT_CUSTOMERS_ [ID SINGLE INSTANCE] _YYYYMMDD
Note: [ID SINGLE INSTANCE] It must be an identifier related to the instance, when there are multiple brands / countries /
business units represented in different instances of our platform.
Note2: Files must be generated daily, whether or not they contain information.
Transfer
The formats will be received in an SFTP repository. Said repository can be owned by the client or, if
required, ICOMMKT may have a space for this information exchange.
GUIDE O
MNICANAL TRANSACTIONAL PROCESSING
KPIs
Some of the KPI's after processing are available:
ICOMMKT_Fecha_Primera_Compra: Date recorded the first purchase
ICOMMKT_Fecha_Ultima_Compra: Date recorded last purchase
ICOMMKT_Dias_Primera_Compra:Days since first purchase
ICOMMKT_Dias_Ultima_Compra: D ays since last purchase
ICOMMKT_Monto_Ultima_Compra: A mount of last purchase
ICOMMKT_Items_30_Dias: items purchased in the last 30 days
ICOMMKT_Items_60_Dias: items purchased in the last 60 days
ICOMMKT_Items_90_Dias: items purchased in the past 90 days
ICOMMKT_Items_180_Dias: items purchased in the last 180 days
ICOMMKT_Items_360_Dias: items purchased in the last 360 days
ICOMMKT_Items_Total: i tems purchased
ICOMMKT_Marcas_30_Dias : M arks bought in the last 30 days
ICOMMKT_Marcas_60_Dias: Marks bought in the last 60 days
ICOMMKT_Marcas_90_Dias: Marks bought in the last 90 days
ICOMMKT_Marcas_180_Dias: Brand s purchased in the last 180 days
ICOMMKT_Marcas_360_Dias: Marks purchased in the last 360 days
ICOMMKT_Marcas_Total: M arks purchased
ICOMMKT_Categorias_30_Dias c ategories purchased in the last 30 days
ICOMMKT_Categorias_60_Dias c ategories purchased in the last 60 days
ICOMMKT_Categorias_90_Dias c ategories purchased in the past 90 days
ICOMMKT_Categorias_180_Dias categories bought in the last 180 days
ICOMMKT_Categorias_360_Dias: C ategories bought in the last 360 days
ICOMMKT_Categorias_Total: Categories bought
GUIDE O
MNICANAL TRANSACTIONAL PROCESSING