Get Order By Id

GET https://{environment}.neomode.com.br/management/commerce/orders/{orderId}

Retrieve a single order by its ID or ExternalId

Response

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