Order

Swagger (for read only, can't try it out): https://api.v2.swagger.neomode.com.br/cp/management/commerce/index.html

Order Data Fields

Order Identifiers

Reference for the main identification fields used in order management and their respective API lookup routes.

Field	Data Type	Location / Function	API Routing Pattern
Id	string (GUID)	Primary identifier found in the page URL link.	N/A (Direct Resource ID)
ExternalId	string	Displayed in the first order information block.	cp/.../external/{id} or /orderNumber
SellerOrderId	string	Displayed in the first order information block.	cp/.../sellerOrderId/{id}

NEO In Store Order Details Page:

Full Order Body

Top Level Order Fields

Field	Type
id	string
createDate	string (ISO)
externalId	string
sellerOrderId	string	Seller-specific order ID
orderPackageId	string	Optional package grouping ID
channel	string
friendlyCode	string
cpfPickUp	string	CPF for pickup
cpfInvoice	string	CPF for invoice
invoiceUrl	string	URL to the invoice document
dealerCode	string	Optional dealer code
feeAmount	number
bonusAmount	number
isDelivery	boolean
isCvvValidated	boolean
maxPickUpTime	string	Maximum pickup time
orderNote	string	Optional note added to order
plp	string	PLP (postal list) reference
status	number	Separated

Buyer

Field	Type	Description
bonusCustomerId	string	null	Optional loyalty/bonus ID
cpf	string	CPF of the buyer
stateInscription	string	null	State registration
documentType	number	Type of document (1 = CPF, 2 = CNPJ)
phoneNumber	string	Buyer phone number
fullName	string	Buyer full name
email	string	Buyer email
cnpj	string	null	Buyer CNPJ if applicable
companyName	string	null	Buyer company name
address	object	Delivery address (see Address fields below)

Seller

Field	Type	Description
pointSaleId	string	Point of sale ID
fullName	string	Seller name
email	string	Seller email
cnpj	string	Seller CNPJ
address	object	Seller address (same structure as buyer address)
workingHours	array	Optional working hours for store
integrationConfig	object	Credentials and integration info for order, payment, fraud, promotion engine

Address

Field	Type	Description
street	string	Street name
number	string	Number
complement	string	null	Address complement
neighborhood	string	Neighborhood
cep	string	Postal code
city	string	City
state	string	State abbreviation
latitude	number	null	GPS latitude
longitude	number	null	GPS longitude
fullAddress	string	Formatted full address

Freight

Field	Type	Description
deliveryTime	number	Estimated delivery time
reference	string	Delivery service reference
description	string	Description of freight service
amount	number	Freight amount

PaymentInfo & PaymentList

Field	Type	Description
amount	number	Payment amount
quantityInstallments	number	Number of installments
paymentMethod	object	Payment method details

Payment Method

Field	Type	Description
info	string	Method name (e.g., Credit Card, Pix)
brand	string	null	Card brand if applicable
type	number	Numeric payment type
modality	number	Modality type
id	string	Unique ID for payment method

Invoice

Field	Type	Description
key	string	null	Invoice key
number	string	null	Invoice number
serieNumber	number	Series number
totalAmount	number	Total invoice amount
xmlUrl	string	null	XML URL
fileUrl	string	null	PDF file URL
issuanceDate	string	Date of issuance

Items Array

Field	Type	Description
quantity	number	Item quantity
unitPrice	number	Unit price of the item
subTotalAmount	number	Subtotal for the item
totalAmount	number	Total price for the item
sku	object	SKU details (code, name, attributes, linked product)
isGift	boolean	If item is a gift
coupon	object	null	Coupon applied

Custom Data Array

🚧

Here will be order key:value customizations

Field	Type	Description
key	string	Custom key name
value	string	Custom value

Order Status Reference Table

This table maps the internal Enum IDs to their respective status names, canonical summaries, and functional descriptions within the system.

ID	Status	Canonical // Summarized	Description
0	None	CreatedInternal	Order received by the system.
1	Pending	CreatedInternal	Order successfully created in Lori.
2	PendingCreate	AwaitingCreation	Waiting for the order creation trigger.
3	PendingApproval	AwaitingCreation	Waiting for Point of Sale (POS) confirmation.
4	ApprovedExternal	CreatedExternal	Order confirmed by the Point of Sale.
5	Processing	AwaitingInvoiceCreation	Order is currently being invoiced.
6	Separate	Separated	Products have been picked and separated.
7	InDelivery	Shipping	Order is in transit.
8	ReadyForPickup	ReadyForPickup	Order is ready for customer collection.
9	Finalized	Finalized	Order process completed.
10	CandeledBySeller	Canceled	Canceled by the Point of Sale.
11	CanceledByBuyer	Canceled	Canceled by the customer.
12	CanceledByAdmin	Canceled	Canceled by the system administrator.
13	PendingCancel	Canceled	Cancellation request is pending.
14	PendingCreatePreOrder	AwaitingCreation	Waiting for pre-order creation.
15	PreOrderCreated	CreatedExternal	Pre-order successfully created at the POS.
16	ErrorCancel	Error	Error occurred during the cancellation process.
17	PendingUpdate	InProgress	Order update is pending synchronization.
18	Updated	InProgress	Order details have been successfully updated.
19	ErrorUpdate	Error	Error occurred during the update process.
20	InvoiceCreated	InvoiceCreated	Fiscal invoice has been issued.
21	CanceledByProcessor	Canceled	Canceled via automated system process.