The marketplace/channel where the order will be assigned.
Please refer to marketplaces/channels list section to see the ID / codes you need to set.
| | ExternalOrderId \* | string |The external identification number of the order.
Is your own ID number to uniquely identify the order.
| | Integrated | boolean |
If ¨true¨ the order will be marked “as integrated” after creation.
Refer to mark order as integrated endpoint.
| | ErpStatus | string | Your internal integrated status. | | DateCreated \* | datetime (UTC with local user time zone) |
The original date and time when the order was created.
| | Items \* | [#orderinfoitems](#orderinfoitems "mention") | Collection of order’s items. | | Buyer \* | [#orderinfobuyer](#orderinfobuyer "mention") | Data of the order’s buyer (buyer or customer or client). | | Payments \* | [#orderinfopayments](#orderinfopayments "mention") | Collection of order’s payments. | | Shipping \* | [#orderinfoshipping](#orderinfoshipping "mention") | Data of the order’s shipping (shipping or delivery). | ### OrderInfoItems | Property | Type | Description | | ---------------- | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Product \* | [#orderinfoitemproduct](#orderinfoitemproduct "mention") |
The product that corresponds to the item of the order.
It should match a product in the product catalog. If not found, a product "disconnected" from the catalog is assumed.
| | Quantity \* | integer | The number of units of the product involved in the order item | | StockMovement \* | boolean |•When a new order is created, for each one of the items, it is possible to define whether the current inventory/stock in Alephee for that product will be updated. The “StockMovement” attribute in the items section us used for this.
If “StockMovement” attribute is “True” Alephee will update the product’s inventory current value.
If the attribute contains value of “False” no inventory will be updated.
| | UnitPrice \* | decimal |The individual unit price product involved in the order item.
This value may or may not match the retail price in the product catalog.
The price indicated here takes precedence over the price that corresponds to the product in the catalog.
| | UnitPriceCost | decimal |
The individual unit seller’s cost product involved in the order item.
This value may or may not match the retail price in the product catalog.
The price indicated here takes precedence over the price that corresponds to the product in the catalog.
| | Status \* | integer |The status of the order item. Available values are:
Confirmed = 10
Shipped = 20
Delivered = 80
Please use the integer value.
| | Notes | string | Free notes for the order item. | ### OrderInfoItemProduct | Property | Type | Description | | --------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Brand | string |
Product brand
Should match the brand in the Alephee product catalog.
(please refer to business rules)
| | SKU \* | string |Product SKU
Should match the SKU in the Alephee product catalog.
(please refer to business rules)
| | SellerSKU | string |Product own identification code
Should match the “OwnCode” in the Alephee product catalog.
(please refer to business rules)
| | Title \* | string |If you need to associate a product that is not existent in the Alephee catalog, complete this attribute and leave the previous attributes blank.
An order item associated with an "offline" product will be generated with the given title.
| ### OrderInfoBuyer | Property | Type | Description | | -------------- | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | OwnCode | string | Your own code for the selected buyer. | | Name \* | string | The name and last name of the buyer. | | Email | string | | | DocType \* | string |Identification document type.
Available document types:
Argentina: DNI, CUIT, CUIL, LC, LE, Otro.
Brazil: CPF, RG, CNPJ.
Chile: RUT, Otro.
Colombia: CC, CE, NIT, Otro.
Ecuador: CI, RUC, Otro.
México: RFC, CURP, Otro.
Perú: DNI, CE, RUC.
Uruguay: CI, RUT, Otro.
Venezuela: CI, RIF, Pasaporte, Otro.
| | DocNumber \* | string | Document number of the buyer. | | Phone \* | string | Buyer phone. | | BillingInfo \* | [#orderinfobillinginfo](#orderinfobillinginfo "mention") | Billing information data. | | Address \* | [#orderinfoaddress](#orderinfoaddress "mention") |Buyer address.
Maybe will match the shipping address.
| ### OrderInfoBillingInfo | Property | Type | Description | | --------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | DocType \* | string |Identification document type.
Available document types:
Argentina: DNI, CUIT, CUIL, LC, LE, Otro.
Brazil: CPF, RG, CNPJ.
Chile: RUT, Otro.
Colombia: CC, CE, NIT, Otro.
Ecuador: CI, RUC, Otro.
México: RFC, CURP, Otro.
Perú: DNI, CE, RUC.
Uruguay: CI, RUT, Otro.
Venezuela: CI, RIF, Pasaporte, Otro.
| | DocNumber \* | string | Document number of the billable buyer. | | TaxPayerType \* | string |Legal entity type (valid only for companies).
Free text.
| | BusinessName | string | Legal business name (valid only for companies) | | Address \* | [#orderinfoaddress](#orderinfoaddress "mention") | Address for billing purposes. | ### OrderInfoAddress | Property | Type | Description | | ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | CountryId \* | string |
Standarized country code
AR, MX, CL, UY, PE, CO or BR
| | StateCode \* | string |Standarized city code
Please note that the “State” attribute with the full name will be available on the GET order endpoint.
| | City \* | string | . | | Neighborhood | string | . | | StreetName \* | string | . | | StreetNumber | string | . | | ZipCode \* | string | . | | Phone \* | string | . | | AlternativePhone | string | . | | Description | string | Free notes. | ### OrderInfoPayments | Property | Type | Description | | ------------------------ | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ExternalPaymentId \* | string |The external identification number of the payment.
Is your own ID number to uniquely identify the payment.
| | Amount \* | decimal | Paid amount (including shipping, financial charges and after any discounts, if any) | | AmountNoDiscount \* | decimal | Paid amount before discounts (if any) | | ShippingAmount | decimal | Shipping portion of the paid amount (after discounts, if any) | | ShippingAmountNoDiscount | decimal | Shipping portion of the paid amount before discounts (if any) | | Installments | integer |
Installment’s quantity (if any).
In general, monthly payments.
| | InstallmentAmount | decimal | Amount of each one of the installments (if any). In general, amount of each monthly payment. | | Taxes | [#orderinfopaymenttaxes](#orderinfopaymenttaxes "mention") |Taxes details
(In general, most of the time it is blank)
| | Interests | decimal? |Interests applied to the payment (if any), as reported by the marketplace.
In general, these are interest charges for credit card installment payments.
The interest applied to the payment ONLY AFFECTS THE BUYER and does not affect the seller in any way.
In some countries (such as Brazil), it is required to disclose the interest paid by the buyer on the electronic invoice.
| | Discounts | [#orderinfopaymentdiscount](#orderinfopaymentdiscount "mention") |Discount collection details.
| | Method | integer |
The method used in the payment. Available values are:
Account\_money = 0,
//Money in the MercadoPago account
Ticket = 1
//Printed ticket
Bank\_transfer = 2
//Wire transfer
Atm = 3
//Payment by ATM
Credit\_card = 4
//Payment by credit card
Debit\_card = 5
//Payment by debit card
Prepaid\_card = 6
//Payment by prepaid card
Digital\_currency = 7
Digital\_wallet = 8
Cash = 99
//Cash
Please use the integer value.
| | Status \* | integer |The status of the payment. Available values are:
pending = 0
//El usuario aún no completó el proceso de pago
approved = 1
//El pago fue aprobado y acreditado
in\_process = 2
// El pago está siendo revisado.
in\_mediation = 3
//Los usuarios tienen iniciada una disputa
rejected = 4
// El pago fue rechazado. El usuario puede intentar pagar nuevamente.
cancelled = 5
//El pago fue cancelado por una de las partes, o porque el tiempo expiró
refunded = 6
// El pago fue devuelto al usuario.
charged\_back = 7
// Fue hecho un contracargo en la tarjeta del pagador.
Please use the integer value.
| | DateCreated \* | datetime (UTC with local user time zone) | Informational only. | | DateApproved \* | datetime (UTC with local user time zone) | Informational only. | | Notes | string | Free notes | .OrderInfoPaymentTaxes | Property | Type | Description | | -------- | ------- | --------------------------------------------- | | Amount | decimal | The amount of taxing involved in the payment. | ### OrderInfoPaymentDiscount | Property | Type | Description | | --------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Code\* | string |The given discount code type for the applied discount. Available values are:
• Coupon
• Discount
• Cashback
• Voucher
• Redeem
The discount value type. Allowed values are:
• Value (single amount)
• Percentage
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.
The external identification number of the shipping.
Is your own ID number to uniquely identify the shipping.
| | Method \* | integer |
The method used for the order shipping. Available values are:
AgreementWithSeller = 0
//Seller and buyer agreed where to ship the package
Pickup withdraw = 2
//The buyer picks up the order at the seller's branch or pickup point
Normal Shipping = 4
//Normal shipping to a selected address
Please use the integer value.
| | LogisticType \* | integer |The logistics type of the order shipping. Available values are:
To\_be\_agreed = 1
ME1 = 2
ME2 = 3
Custom = 4
Fulfillment = 5
Flex = 6
Pickup = 7
Cross\_docking = 8
Courier = 14
Please use the integer value.
| | CourierInfo \*\* | [#orderinfocourier](#orderinfocourier "mention") |The courier that collects and delivers the order.
Mandatory only if the LogisticType attribute is set to value “14”.
| | Cost | [#orderinfoshippingcost](#orderinfoshippingcost "mention") |
The shipping costs (if any) of the order.
| | Receiver \*\* |
|
Receiver data and address.
Always mandatory except if the Method attribute is set to value “2”.
| | Pickup \*\* | [#orderinfoshippingpickup](#orderinfoshippingpickup "mention") |
The pickup or branch information where the buyer will withdraw the package.
Mandatory only if the Method attribute is set to value “2”.
| | EstimatedDeliveryDate \* | datetime (UTC with local user time zone) | Informational only. | | DateCreated \* | datetime (UTC with local user time zone) | Informational only. | ### OrderInfoCourier | Property | Type | Description | | --------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | BusinessName \* | string | Legal business name | | DocType | string |
Identification document type.
Available document types:
Argentina: DNI, CUIT, CUIL, LC, LE, Otro.
Brazil: CPF, RG, CNPJ.
Chile: RUT, Otro.
Colombia: CC, CE, NIT, Otro.
Ecuador: CI, RUC, Otro.
México: RFC, CURP, Otro.
Perú: DNI, CE, RUC.
Uruguay: CI, RUT, Otro.
Venezuela: CI, RIF, Pasaporte, Otro.
| | 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 | [#orderinfoaddress](#orderinfoaddress "mention") | Address of the courier | ### OrderInfoShippingCost | Property | Type | Description | | ----------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Seller \* | decimal |The shipping cost (if any) that the seller of the order should pay.
If none, set this property to 0.00 (zero).
| | Receiver \* | decimal |The shipping cost (if any) that the receiver/buyer of the order should pay.
If none, set this property to 0.00 (zero).
| | Total \* | decimal |Total and complete shipping cost (if any) of the order. Should match seller + receiver costs.
If none, set this property to 0.00 (zero).
| ### OrderInfoShippingReceiver | Property | Type | Description | | -------- | ------------------------------------------------ | -------------------------------------------------------- | | Name \* | string | The name and last name of the receiver of the order. | | Phone | string | The phone number of the receiver of the order. | | Address | [#orderinfoaddress](#orderinfoaddress "mention") | The receiver address. The location to deliver the order. | ### OrderInfoShippingPickup | Property | Type | Description | | ------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Id \* | integer |The ID number of the pickup point. Should match Alephee internal ID of the pickup list for the given account.
Use the GET stores endpoint to find the ID for every pickup.
| | Name | string | Name of the pickup point. Informational only. | | BusinessName | string | BusinessName of the pickup point. Informational only. |