Create a request
post
https://api.mercadoe.com/v1/requests
Creates a new purchase request by providing the category, status, request items information, and other details.
Request
Headers
X-ME-CORRELATION-ID
string
Internal client code to be identified in the webhook. It can be, for example, a product code in your ERP, an order number, etc.
Body
application/json
integrationTag
string
required
Identification of the ME user used in the integration.
status
int32
required
Status (The request enters as “Submitted”).
Possible status:
- 0 = Submitted
- 1 = Aproved
- 3 = Canceled
- 123 = ERP INCONSISTENCY
- 124 = WAITING FOR ERP INTEGRATION
- 125 = WAITING FOR ERP APPROVAL
Possible status:
- 0 = Submitted
- 1 = Aproved
- 3 = Canceled
- 123 = ERP INCONSISTENCY
- 124 = WAITING FOR ERP INTEGRATION
- 125 = WAITING FOR ERP APPROVAL
clientRequestId
string
required
Request Id in the client’s ERP.
category
string
required
The category is the request Type.
isCanceled
boolean | null
Was this request canceled? (True/False)
- True = then cancels the whole request.
- False = then check each item of the request.
- True = then cancels the whole request.
- False = then check each item of the request.
note
string | null
Request header text
isEmergency
boolean | null
Is this request an emergency?
clientDeliveryPlaceId
string
required
Delivery location code in the client’s system
clientBillingPlaceId
string | null
Billing location code in the client’s system
businessOrganizations
array of object | null
List with the business organizations of the request, consisting of the
code and entityType fields.attributes
array of object | null
List with the attributes of the request items, consisting of the
name, value and description fields.requestItems
array of object
List with the requested items.
Responses
202
400
Accepted
Body
application/json
correlationId
string