⌨️Type specifications
Response from the API endpoint...
Order
Id
integer
Alephee ID to identify the order
SellerAccount
The seller to whom the order belongs to.
ExternalOrderId
string
Marketplace-assigned ID of the order.
Not valid for Alephee B2B portals.
PackId
string
Shopping cart number associated with the order. Only if the order is part of a shopping cart purchase.
Only for the Mercado Libre marketplace. Please refer to the above notes.
SourcePackId
string
The original shopping cart number associated with the order. Only if the order is part of a shopping cart purchase.
Only for the Mercado Libre marketplace. Please refer to the above notes.
IsCompletePackOrder
bool?
When TRUE, the order is a shopping cart purchase and all items in the cart are present and available for download.
When FALSE, the order is a shopping cart purchase and NOT all items in the cart are present and available for download. You need to wait a while for all the items in the cart to arrive from the marketplace of origin and try to download the order again.
Please refer to the above notes.
If the attribute is not included or is not visible in the order, that order is NOT a purchase from the shopping
Items
List of the items contained in the order.
Payments
List of the payments.
Adjustments
List of adjustments made in the order. (If any)
Valid only for Alephee B2B portal orders.
Shipping
Shipping details
Buyer
Buyer details
Billing
Marketplace-regarding order billing information
Documents
Array or collection of all the documents attached by the user to the order with all the relevant attributes.
Please note the document-content is not included. You must use the GET orders/document endpoint in order to acquire the document content.
ActiveClaims
List of claims.
Marketplace ID of the claim, Date the claim was created
Notes
string
Order additional notes (if any)
Status
{
Key (integer),
Value (string)
}
Current status of the order. For further details see “Possible order statuses” section below
StatusType
{
Key (integer),
Value (string)
}
Current status type of the order. 0 = New
1 = Pending
2 = Closed
99 = Cancelled
Marketplace
{
Key (integer),
Value (string),
Channel (string)
}
ID of the marketplace in which the order originated.
The "Channel" property is available on the following scenarios:
Mercado Libre: When the sale came from a “Mercado Shops” sale the string contains this name.
B2W Marketplace: Contains the individual channel (Lojas Americanas, Shoptime, etc).
Alephee: For orders belonging to B2B portal.
Integrated
boolean
Indicates whether the order was marked as integrated or not
IntegratedOrderId
string
Your internal ID indicated for the order, informed in the PUT method (v2/orders/integrate)
DateCreated
datetime (UTC with local user time zone)
Date the order was created
LastUpdated
datetime (UTC with local user time zone)
Date the order was last updated
DateClosed
datetime (UTC with local user time zone)
Date the order was closed. It is considered closed when it reaches a final status
IsCancelled
boolean
Indicates whether the order was cancelled or not
ExternalJson
object
Complete order JSON from the corresponding marketplace. Please visit the marketplace API documentation for further details
Seller
Id
integer
Alephee internal ID to identify the seller
Name
string
Seller name
BusinessName
string
Seller legal business name
OwnCode
string
The sellers’s internal CODE (if any) that matches the customer's code in the user's ERP.
Item
Id
integer
Alephee ID to identify the order item
Type
{
Key (integer),
Value (string)
}
The item types. Available values are:
· Key = 0, Value = “Product”
(The item is a single product)
· Key = 1, Value = “Kit”
(The item is a Kit and a container for other components items)
· Key = 2, Value = “Component”
(The item is a component of a kit)
ParentItemId
integer?
In the items of type “Component”, this field identifies the corresponding item of type “Kit” this component belongs to.
Product
Product details
ProductListing
Product listing details
Quantity
integer
Item quantity
QuantitiesDetails
Item quantities details and disaggregation.
SaleFee
decimal?
Item marketplace-informed sale fee.
UnitPrice
decimal
Item unit price
FullUnitPrice
decimal
Complete pricing of the item without applying any changes for promotions, deals or other discounts.
Status
{
Key (integer),
Value (string)
}
Current status of the order item. For further details see “Possible order statuses” section below
StatusType
{
Key (integer),
Value (string)
}
Current status type of the order item.
Available StatusType key, values:
0 = New,
1 = Pending,
2 = Closed,
99 = Cancelled
IsCancelled
boolean
Indicates whether the order item was cancelled or not
CalculatedComponentUnitPrice
decimal
In the items of type “Component”, this field indicates its unit price within the kit, based on the final price the kit was sold at.
CalculatedComponentFullUnitPrice
decimal
In the items of type “Component”, this field indicates its unit price within the kit, based on the final price the kit was sold at, surpassed on the complete pricing of the item without applying any changes for promotions, deals or other discounts.
ItemQuantities
Requested
{
Value (decimal),
Measure (string)
}
The requested (from the buyer) quantity and measure of the item on this order.
The measure indicates the measure unit (“unit”, “kg”, “gr”, “tons”)
The value indicated the weight in the given unit.
This attribute is completed only for the Mercado Libre marketplace.
Picked
{
Value (decimal),
Measure (string)
}
The picked (from the picking process on the marketplace) quantity and measure of the item on this order.
The measure indicates the measure unit (“unit”, “kg”, “gr”, “tons”)
The value indicated the weight in the given unit.
This attribute is completed only for the Mercado Libre marketplace.
StockMovements
Collection of stock movements.
Provides information about the stock movement of the item order in the product catalog stock.
ItemQuantitiesStockMovement
Account
AccountType
The account information where the product stock movement was processed.
Quantity
integer
The number of units of the product stock movement
PrevStock
integer
Available quantity of units of the product stock AFTER the stock movement.
PostStock
integer
Available quantity of units of the product stock BEFORE the stock movement.
MinPublicationQuantity
integer?
Provides the product’s minimum publication quantity, that is set to the account (referenced above) that moved stock quantities.
MaxPublicationQuantity
integer?
Provides the product’s maximum publication quantity, that is set to the account (referenced above) that moved stock quantities.
DateCreated
datetime (UTC with local user time zone)
Date and time of the stock movement.
Product
Id
integer
Alephee ID to identify the product
SKU
string
SKU code that identifies the product
Brand
string
Product brand name
SellerSKU
string
Your internal SKU code indicated for the product (if any)
EAN
string
EAN that identifies the product
Attributes
/
Product attributes that are related to the order
Title
string
Product title
IntegrationCode
string
Publication identifier of each Marketplace
Category
{
Key (string), Value (string)
}
Category identifier, Category name of the marketplace.
ProductAttributes
Netweight
{
Value (decimal), Measure (string)
}
The net weight of the product.
The measure indicates the measure unit (“kg”, “gr”, “tons”)
The value indicated the weight in the given unit.
This attribute is completed only for the Mercado Libre marketplace, and it is valid for products that are weighed with units of measure.
SalesTag
ProductTagType
Product sales tags that are related to the order.
ProductListing
Reference
String
The product listing reference type. Available values are:
· “None”: It means that the publication corresponds to the sold product referenced in the order item.
· “Parent”: It means that the publication corresponds to another product that is the parent of the current product. Usually used in the case of KIT components. A component does not have an associated product listing, but the KIT that contains it does.
Id
integer
Internal ID of the product listing.
ExternalId
String
External marketplace-defined ID of the product listing.
Title
String
Title of the product listing.
ListingType
(Valid only for
the Mercado Libre marketplace)
{
Key (int),
Value (string),
Description (string)
}
The marketplace-assigned type for the product listing.
Available KEY, VALUE is:
0 = no type found
1 = gold_pro
2 = gold_premium
3 = gold_special
4 = gold
5 = silver
6 = bronze
7 = free
Each one of the above types mean different types of products listings on each country.
The description attribute gets the friendly name of the product listing type. Example: “Clásica”, “Premium”, “Gratis”.
PermanentLink
String
Public URL for the product listing.
Payment
ExternalPaymentId
string
Marketplace ID of the payment
Amount
decimal
Paid amount (including shipping, financial charges and after any discounts, if any)
AmountNoDiscount
decimal
Paid amount before discounts (if any)
TransactionAmount
decimal
Transactional amount of the order (without discounts, taxes, installments, or any other financial charges). This should match the product pricing.
ShippingAmount
decimal
Shipping portion of the paid amount (after discounts, if any). Shows only the buyer's paid amount. Do not includes the seller's paid amount.
ShippingAmountNoDiscount
decimal
Shipping portion of the paid amount before discounts (if any). Shows only the buyer's paid amount. Do not includes the seller's paid amount.
Discounts
Array of orders's discount details
Total
(Only for PedidosYa marketplace)
decimal?
Payment total
(Only for PedidosYa marketplace)
SubTotal
(Only for PedidosYa marketplace)
decimal?
Payment subtotal
(Only for PedidosYa marketplace)
Installments
integer?
Installment’s quantity (if any).
In general, monthly payments.
InstallmentAmount
integer?
Amount of each one of the installments (if any)
Notes
string
Payment notes
CurrencySymbol
string
Currency symbol
Method
{
Key (integer),
Value (string)
}
Payment method.
account_money = 0,
(MercadoPago account)
ticket = 1,
(Printed ticket)
bank_transfer = 2,
atm = 3,
(Payment via ATM machine)
credit_card = 4,
debit_card = 5,
prepaid_card = 6,
digital_currency = 7,
cash = 99,
other = 100
AuthorizationCode
string
Payment authorization code
Status
{
Key (integer),
Value (string)
}
Payment status.
Status value, Status Key:
pending = 0,
approved = 1,
in_process= 2,
in_mediation = 3,
rejected = 4,
cancelled = 5,
refunded = 6,
charged_back = 7
Condition
{
Key (integer),
Value (string)
}
The order’s payment selected condition.
(Valid only for Alephee B2B portal orders)
Condition key, Condition value:
0 = No information given,
1 = Payment on credit,
2 = Payment on advance
Taxes
{
Amount (decimal),
CurrencySymbol (string)
}
Taxes details
(In general, most of the time it is blank)
DateCreated
datetime (UTC with local user time zone)
Date and time the payment was created
DateApproved
datetime (UTC with local user time zone)
Date and time the payment was approved
LastUpdate
datetime (UTC with local user time zone)
Date and time the payment was last updated
Discount
Code
string
The marketplace discount code type for the applied discount. Available values are:
• Coupon • Discount • Cashback • Voucher • Redeem • Other (none of above values)
Type
string
The discount value type. Allowed values are: • Value (single amount) • Percentage
Amount
decimal?
The monetary amount of the applied discount. • Positive decimal numbers means a discount. • Negative decimal numbers means a surcharge/recharge.
Value
decimal?
The amount of the discount, depending on the “type” value type. • Positive decimal numbers means a discount. • Negative decimal numbers means a surcharge/recharge.
Seller
{
"Amount": decimal, "Value": decimal
}
The amount and value of the current discount absorbed by the seller.
Marketplace
{
"Amount": decimal, "Value": decimal
}
The amount and value of the current discount absorbed by the marketplace.
Quantity
integer
The quantity of the type of discount applied. This refers to the number of coupons, cashback, and other types of discounts applied. It is for informational purposes only. Total discounts take the quantity into consideration.
Priority
string
The order of priority in which the discount should be applied.
Notes
string
The marketplace notes for the applied discount.
Shipping
ExternalShippingId
integer
Marketplace ID of the shipping
Cost
decimal?
Total and complete shipping cost (if any) of the order.
SellerCost
decimal?
The shipping cost (if any) that the seller of the order should pay.
ReceiverCost
decimal?
The shipping cost (if any) that the receiver/buyer of the order should pay.
Method
{
Key (string), Value (string)
}
Method type, Method name:
0 = Agreement,
1 = DropShipping,
2 = ClientPickup,
3 = MarketplaceShipping,
4 = OwnShipment,
5 = ThirdPartyShipping
Status
{
Key (integer),
Value (string)
}
Current status of the shipping. For further details see “Possible order statuses” section below
ShippingLabels
Shipping labels detail (if any)
LogisticType
{
Key (integer),
Value (string)
}
LogisticType, LogisticName:
1 = to_be_agreed,
2 = me1,
3 = me2, 4 = custom,
5 = fulfillment,
6 = flex, 7 = pickup
8 = cross_docking,
14 = courier
CourierInfo
The courier’s information that collects and deliver the order.
Valid only when LogisticType attribute is value “14”.
Receiver
{
Name (string),
Phone (string)
}
Receiver personal details
ReceiverAddress
Receiver address details
Pickup
Pickup detail (if any)
EstimatedDeliveryDate
datetime (UTC with local user time zone)
Date the shipment is expected to arrive (might change overtime)
DateCreated
datetime (UTC with local user time zone)
Date and time the shipment was created
LastUpdated
datetime (UTC with local user time zone)
Date and time the shipment was last updated
Courier
Id
integer
Internal ID of the courier
BusinessName
string
Legal business name
DocType
string
Identification document type.
Available document types:
Argentina: DNI, CUIT, LC, LE, Otro.
Brazil: CPF, CNPJ.
Chile: RUT, Otro.
Colombia: CC, CE, NIT, Otro.
México: RFC, CURP, Otro.
Uruguay: CI, RUT, Otro.
Perú: DNI, CE, RUC.
Venezuela: CI, RIF, Pasaporte.
DocNumber
string
Document number of the courier.
LegalNumber
string
Legal inscription number of the courier.
OwnCode
string
The courier’s internal CODE (if any) that matches the code in the user's ERP.
Address
Address of the courier
Pickup
Id
integer
Alephee ID to identify the Pickup
Name
string
Pickup name
BusinessName
string
Pickup legal business name (valid only for companies)
ExternalPickupId
string
Marketplace ID of the pickup
IntegrationCode
string
Your internal code indicated for the pickup (if any)
SellerAccountId
integer
Alephee account ID associated to the pickup (if any)
Address
CountryId
string
Standarized country code
AR, MX, CL, UY, PE, CO or BR
StateCode
string
Standarized city code
State
string
.
City
string
.
Neighborhood
string
.
StreetName
string
.
StreetNumber
string
.
ZipCode
string
.
Notes
string
Buyer comments (if any)
Description
string
Complete address
Phone
string
.
AlternativePhone
string
.
Buyer
Name
string
.
Phone
string
.
string
.
Nickname
string
Nickname or alias (depends on each marketplace)
Code
integer
The buyer's code (if any)
OwnCode
string
The buyer's internal CODE (if any) that matches the customer's code in the user's ERP.
Valid only from Alephee B2B portal customers’ orders.
DocType
string
Identification document type.
Available document types:
Argentina: DNI, CUIT, LC, LE, Otro.
Brazil: CPF, CNPJ.
Chile: RUT, Otro.
Colombia: CC, CE, NIT, Otro.
México: RFC, CURP, Otro.
Uruguay: CI, RUT, Otro.
Perú: DNI, CE, RUC.
Venezuela: CI, RIF, Pasaporte.
DocNumber
string
Document number
Address
Buyer address details
BillingInfo
Billing information details
BuyerBillingInfo
DocType
string
Identification document type.
Available document types:
Argentina: DNI, CUIT, LC, LE, Otro.
Brazil: CPF, CNPJ.
Chile: RUT, Otro.
Colombia: CC, CE, NIT, Otro.
México: RFC, CURP, Otro.
Uruguay: CI, RUT, Otro.
Perú: DNI, CE, RUC.
Venezuela: CI, RIF, Pasaporte.
DocNumber
string
Document number
TaxPayerType
string
Legal entity type (valid only for companies). string values are subject to change without prior Mercado Libre notice.
Possible values:
· Mercado Libre Argentina:
o Monotributo
o IVA Responsable Inscripto
o IVA Exento
· Mercado Livre Brazil:
o Contribuinte
o Não contribuinte
BusinessName
string
Legal business name (valid only for companies)
Address
Billing address details
StateRegistration
Buyer state registration identification. Could be blank.
Valid only for the Mercado Livre Brazil marketplace.
BuyerStateReg
DocType
string
Buyer state registration type. Available values are:
· STATE_REGISTRATION
· OTHER
DocNumber
string
The buyer state registration identification document number.
ShippingLabels
ShippingLabelUrlPDF
string
Shipping label to be printed URL (if any), in PDF format
ShippingLabelUrlZIP
string
Shipping label to be printed URL (if any), in ZIP format, containing a TXT file for Zebra printers
Substatus
string
Shipping label substatus. Possible values:
· pending
· stale
· ready_to_print
· invoice_pending
· in_hub
· waiting_for_label_generation
· printed
· waiting_for_carrier_authorization
· ready_for_pickup,
· picked_up
· buffered
When substatus is “ready to print” or “printed” the client can obtain the definitive labelURL properties.
Billing
SaleFee
decimal?
Order total sale fee.
This value matches the sum of individual items sale fee.
Invoice
{
DanfePdfUrl (string),
XmlUrl (string)
}
Electronic invoice information.
(Only for the Mercado Libre marketplace and Brazilian accounts)
DanfePdfUrl includes the DANFE PDF file location.
XmlUrl includes the NFE-Model 55 XML file location.
Document
Type
integer
The order-attached document type. Available values are:
0 = Invoice
1 = Receipt
2 = Electronic fiscal invoice
(Only for Brazil)
7 = Shipping label (not available yet)
Name
string
The user-assigned document name.
Fullfilename
string
The document full filename
Extension
string
The document full filename extension
Size
integer
The document file size
DocumentDate
datetime (UTC with local user time zone)
The user-assigned document date.
DateCreated
datetime (UTC with local user time zone)
The date and time when user attached the document.
Number
string
Available only for document type=2 (Electronic fiscal invoice)
The fiscal invoice number.
SerialNumber
string
Available only for document type=2 (Electronic fiscal invoice)
The fiscal invoice series number.
FiscalKey
string
Available only for document type=2 (Electronic fiscal invoice)
The fiscal invoice fiscal key
ActiveClaims
ExternalClaimId
string
The ID of the claim
DateCreated
datetime (UTC with local user time zone)
Datetime of claim creation
Adjustment
Type
{
Key (integer),
Value (string)
}
Adjustment type, Adjustment name:
0 = No information given.
Could not find what type of adjustment was made on the order
1 = Pricing adjustment.
A price adjustment typically occurs when a promotion, coupon, discount, or similar is applied to an order.
2 = Inventory adjustment.
An inventory adjustment typically occurs when the seller changes the quantities of products requested in the order.
3 = Quantity adjustment.
A quantity adjustment typically occurs when a promotion is applied that modifies the quantities requested in the order.
4 = Availability adjustment
An availability adjustment typically occurs when the seller modifies the delivery time of the order.
Code
string
The code of the element that made the adjustment
Description
string
The description of the element that made the adjustment
Item
The item/product in the order that was affected by the adjustment.
Value
The value that was affected by the adjustment.
AdjustmentItem
Id
integer
Alephee ID to identify the product
Brand
string
Product brand name
SKU
string
SKU code that identifies the product
SellerSKU
string
Your internal SKU code indicated for the product (if any)
AdjustmentValue
Type
{
Key (integer),
Value (string)
}
Adjustment value type,
Adjustment value name:
0 = No information given.
Could not find what type of adjustment was made on the order
1 = Percentage over price adjustment.
A percentage over price adjustment.
2 = Fixed price amount adjustment.
A fixed price adjustment.
Value
decimal
The applied value.
(It depends on the type above)
Last updated