Pre-Order

We can understand Pre-Order as an Order that is in the approval phase.

---

The Pre-Order is an intermediate document that will be linked to the Order document in Mercado Eletrônico once it is approved.

There are two approval stages in the purchasing operational flow:

• Approval of the Requisition: to verify the necessity of purchasing that item;
• Approval of the Pre-Order: when the values of that item are evaluated according to the budget. Each value range requires approval by certain roles within the company, such as supervisor, manager, or director.

You can consult the list of Pre-Order approvers through the endpoint: Get Approvers list.

The pre-order consolidates the information and values provided by the supplier with the requisition data.

• To change the status of a Pre-Order, use the endpoint: PUT Update a pre-order status based on the pre-order Id. The statuses of a Pre-Order are:
  • 0 = Submitted
  • 1 = Approved
  • 3 = Canceled
  • 123 = ERP INCONSISTENCY
  • 124 = WAITING FOR ERP INTEGRATION
  • 125 = WAITING FOR ERP APPROVAL

This pre-order goes through approval, and once approved, it leads to the creation of the purchase order document which is sent to the supplier with a generated OrderId.

When the order arrives at the supplier, they may refuse an item, refuse the entire order (even after negotiation, they might find they cannot deliver on time, for example), or they may accept it fully if they can deliver the products/services, or accept it partially.

Learn more about Order Acceptance and Refusal.

📘 Note

The Pre-Order can also be generated from a quotation, a contract, or can simply formalize a purchase already made.

Example Scenario

Situation: A buyer generated a single quotation with 10 different requisitions because all items refer to the same product, but each region made its own purchase requisition.

• Pre-Order: When generating the pre-order, the buyer will generate 10 different pre-orders, one for each unit with its respective value. This process is called split, and after approval, an order is generated for each pre-order.
• Order: When the buyer generates the purchase order, they will respond with the value according to the delivery location.

❗️ Attention

The delivery location is a variable for generating more than one pre-order because depending on the state, taxes vary. Each region has a different price, resulting in orders with the same items but different prices.

For information on the Pre-Order API and all available endpoints, visit API > PRE-ORDERS API.